1. Interface Description
Interface request domain name: cfs.api3.convergecloud.com.
This API (CreateCfsPGroup) is used to create permission groups.
Default interface request rate limit: 20 times per second.
Interface update time: 2019-09-26 06:39:58.
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: CreateCfsPGroup |
| 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 | Yes | No | String | Permission group name, 1-64 characters and can only include letters, digits, underscores, or hyphens Example: pg-zxcwsdasd |
| DescInfo | No | No | String | Permission group description, containing 1-255 characters Example: default_pgroup |
3. Output Parameters
| Parameter name | Type | Description |
|---|---|---|
| PGroupId | String | Permission group ID Example: pg-xqwqewe |
| Name | String | Permission group name Example: pg-yflei |
| DescInfo | String | Permission group description Example: pg-for-yf |
| BindCfsNum | Int64 | Number of file systems bound to the permission group Example: 0 |
| CDate | String | Permission group creation time Example: 2019-7-20 10:25:33 |
| 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 |
|---|---|
| InvalidParameterValue.DuplicatedPgroupName | Duplicate permission group name. |
| InvalidParameterValue.InvalidPgroupName | Invalid permission group name. |
| InvalidParameterValue.PgroupDescinfoLimitExceeded | Permission group description exceeds the length limit (255 bytes). |
| InvalidParameterValue.PgroupNameLimitExceeded | Permission group name exceeds the length limit (64 bytes). |
| ResourceInsufficient.PgroupNumberLimitExceeded | The number of permission groups has reached the limit. |
| FailedOperation | Operation failed |
| InvalidParameterValue.MissingPgroupName | Permission group name cannot be empty. |
| UnsupportedOperation.UnverifiedUser | User not authenticated with real name. |
| UnsupportedOperation.OutOfService | Out of service due to overdue payment. Top up and try again. |