UpdateCfsPGroup

Last Updated At: 2026-08-02 00:05:04

1. Interface Description

Interface request domain name: cfs.api3.convergecloud.com.

This API (UpdateCfsPGroup) is used to update permission group information.

Default interface request rate limit: 20 times per second.

Interface update time: 2019-09-21 03:42:39.

The interface is both signature verification and authentication.

2. Input Parameters

The following list of request parameters only lists interface request parameters and some public parameters, For a complete list of public parameters see public request parameters.

Parameter name Required Allow NULL Type Description
Action Yes No String Public parameter, The value of this interface: UpdateCfsPGroup
Version Yes No String Public parameter, The value of this interface: 2019-07-19
Region No No String Public parameter,Regional information A list of supported geographies is available through the DescribeRegions interface
Name No No String Permission group name, 1-64 characters and can only include letters, digits, underscores, or hyphens. The permission group name and description cannot both be empty.
Example: gzgroup
PGroupId Yes No String Permission group ID
Example: pg-xqwqewe
DescInfo No No String Permission group description, containing 1-255 characters
Example: pg-group-for-yanfa

3. Output Parameters

Parameter name Type Description
PGroupId String Permission Group ID
Example: pg-xqwqewe
Name String Permission Group Name
Example: default_pgroup_name
DescInfo String Description
Example: default_pgroup_name
RequestId String Unique request id, Each request will return. The RequestId of the request needs to be provided when locating the problem.

4. Error Code

The following lists only the error codes related to the interface business logic, For other error codes, see public ErrorCode.

Error Code Description
InternalError Internal error
InternalError.GetAccountStatusFailed Failed to obtain user fee status.
FailedOperation.MountTargetExists Mount target exists in the file system.
InvalidParameterValue.DuplicatedPgroupName Duplicate permission group name.
InvalidParameterValue.InvalidPgroupName Invalid permission group name.
InvalidParameterValue.MissingNameOrDescinfo Permission group name and description cannot both be empty.
InvalidParameterValue.PgroupDescinfoLimitExceeded Permission group description exceeds the length limit (255 bytes).
InvalidParameterValue.PgroupNameLimitExceeded Permission group name exceeds the length limit (64 bytes).
ResourceNotFound.PgroupNotFound Permission group does not exist.
FailedOperation Operation failed
UnsupportedOperation Operation unsupported.
UnsupportedOperation.UnverifiedUser User not authenticated with real name.
UnsupportedOperation.OutOfService Out of service due to overdue payment. Top up and try again.