UpdateCfsPGroup

PDF

Modo Foco

Tamanho da Fonte

Última atualização: 2026-03-24 17:02:15

1. API Description

Domain name for API request: cfs.intl.tencentcloudapi.com.

This API is used to update the information of a permission group.

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer

Try it

API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name	Required	Type	Description
Action	Yes	String	Common Params. The value used for this API: UpdateCfsPGroup.
Version	Yes	String	Common Params. The value used for this API: 2019-07-19.
Region	Yes	String	Common Params. For more information, please see the list of regions supported by the product.
PGroupId	Yes	String	Permission group ID, which can be obtained through the api DescribeCfsPGroups.
Name	No	String	Permission group name, which can contain 1-64 Chinese characters, letters, numbers, underscores, or dashes
DescInfo	No	String	Permission group description, 1-255 characters. Name and Descinfo cannot be empty at the same time.

3. Output Parameters

Parameter Name	Type	Description
PGroupId	String	Permission group ID
Name	String	Permission group name
DescInfo	String	Description
RequestId	String	The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

4. Example

Example1 Update permission group information

Update permission group information

Input Example

POST / HTTP/1.1
Host: cfs.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: UpdateCfsPGroup
<Common request parameters>

{
    "PGroupId": "pgroup-12345",
    "DescInfo": "pgroup-default",
    "Name": "pgroup-default"
}

Output Example

{
    "Response": {
        "RequestId": "fjo8aejo-fjei-32eu-2je9-fhue83nd81",
        "PGroupId": "pgroup-12345",
        "Name": "pgroup-default",
        "DescInfo": "pgroup-default"
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

Tencent Cloud CLI 3.0

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code	Description
FailedOperation	Operation failed.
FailedOperation.MountTargetExists	There are mount targets on the file system.
InternalError	Internal error.
InternalError.GetAccountStatusFailed	Failed to get the payment status of the user.
InvalidParameterValue.DuplicatedPgroupName	The permission group name already exists.
InvalidParameterValue.InvalidPgroupName	Invalid permission group name.
InvalidParameterValue.MissingNameOrDescinfo	The permission group name and description cannot both be empty.
InvalidParameterValue.MissingPgroupName	The permission group name cannot be empty.
InvalidParameterValue.PgroupDescinfoLimitExceeded	The length of the permission group description exceeds the limit (255 bytes).
InvalidParameterValue.PgroupNameLimitExceeded	The length of the permission group name exceeds the limit (64 bytes).
ResourceNotFound.PgroupNotFound	The permission group does not exist.
UnsupportedOperation	Unsupported operation.
UnsupportedOperation.OutOfService	Your account is in arrears. Please top up and try again.
UnsupportedOperation.UnverifiedUser	Unverified user.

Ajuda e Suporte

Esta página foi útil?

Você também pode entrar em contato com a Equipe de vendas ou Enviar um tíquete em caso de ajuda.

comentários

tencent cloud

Cloud File Storage