Domain name for API request: cam.tencentcloudapi.com.
This API is used to set the operative policy version.
A maximum of 20 requests can be initiated per second for this API.
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 parameter. The value used for this API: SetDefaultPolicyVersion. |
| Version | Yes | String | Common parameter. The value used for this API: 2019-01-16. |
| Region | No | String | Common parameter. This parameter is not required for this API. |
| PolicyId | Yes | Integer | Policy ID |
| VersionId | Yes | Integer | Policy version ID |
| Parameter Name | Type | Description |
|---|---|---|
| RequestId | String | The unique request ID, which is returned for each request. RequestId is required for locating a problem. |
This example shows you how to set the effective policy version of a policy.
https://cam.tencentcloudapi.com/?Action=SetDefaultPolicyVersion
&PolicyId=17698703
&VersionId=1
&<Common request parameters>
{
"Response": {
"RequestId": "60e60a86-af67-4bbe-8377-7024a0e1d4c7"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
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.PolicyNameInUse | The policy name specified by the PolicyName field already exists. |
| FailedOperation.PolicyVersionAlreadyDefault | The policy version is already the default policy version. |
| InternalError.SystemError | Internal error. |
| InvalidParameter.ActionError | Action field of policy document invalid. |
| InvalidParameter.ActionNotExist | The action in the policy syntax does not exist. |
| InvalidParameter.ActionServiceNotExist | The action service in the policy syntax does not exist. |
| InvalidParameter.AttachmentFull | Limit on number of authorization object associated policies in the principal field reached. |
| InvalidParameter.ConditionError | condition field of policy document invalid. |
| InvalidParameter.DescriptionLengthOverlimit | The input parameter description cannot exceed 300 bytes in length. |
| InvalidParameter.EffectError | Effect field of policy document invalid. |
| InvalidParameter.NotSupportProduct | CAM does not support the resource type specified in the policy document. |
| InvalidParameter.ParamError | Invalid input parameter. |
| InvalidParameter.PolicyDocumentError | PolicyDocument field invalid. |
| InvalidParameter.PolicyDocumentLengthOverLimit | PolicyDocument field exceeds length restriction. |
| InvalidParameter.PolicyIdError | Input parameter PolicyId invalid. |
| InvalidParameter.PolicyIdNotExist | Policy ID does not exist. |
| InvalidParameter.PolicyNameError | PolicyName field invalid. |
| InvalidParameter.PolicyVersionNotExists | The policy version does not exist. |
| InvalidParameter.PrincipalError | principal field of policy document invalid. |
| InvalidParameter.ResourceContentError | The resource context in the policy syntax is incorrect. |
| InvalidParameter.ResourceError | Resource field of policy document invalid. |
| InvalidParameter.StatementError | Statement field of policy document invalid. |
| InvalidParameter.UserNotExist | User object does not exist |
| InvalidParameter.VersionError | Version field of policy document invalid. |
| ResourceNotFound.GroupNotExist | User group does not exist. |
| ResourceNotFound.NotFound | Resource does not exist. |
| ResourceNotFound.PolicyIdNotFound | Resources specified by PolicyId does not exist. |
| ResourceNotFound.UserNotExist | User does not exist. |
Was this page helpful?