Call the CreatePolicy API to create a permission policy - Resource Management - Alibaba Cloud - Resource Management

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
PolicyName	string	Yes	Policy Name of the access policy. Policy Name must be 1 to 128 characters in length and can contain letters, digits, and hyphens (-).	OSS-Administrator
Description	string	No	The description of the access policy. The description must be 1 to 1,024 characters in length.	OSS administrator permissions
PolicyDocument	string	Yes	The content of the access policy. The content must be 1 to 6,144 characters in length.	{ "Statement": [{ "Action": ["oss:"], "Effect": "Allow", "Resource": ["acs:oss:::"]}], "Version": "1"}

Response elements

Element	Type	Description	Example
	object
Policy	object	The access policy information.
CreateDate	string	The time when the access policy was created. The time is in RFC 3339 UTC format, indicated by Z.	2015-01-23T12:33:18Z
DefaultVersion	string	The version number of the access policy. Default value: v1.	v1
Description	string	The description of the access policy.	OSS administrator permissions
PolicyName	string	The name of the access policy.	OSS-Administrator
PolicyType	string	The type of the access policy. Valid values: Custom: custom policy. System: system policy.	Custom
RequestId	string	The request ID.	9B34724D-54B0-4A51-B34D-4512372FE1BE

Examples

Success response

JSON format

{
  "Policy": {
    "CreateDate": "2015-01-23T12:33:18Z",
    "DefaultVersion": "v1",
    "Description": "OSS administrator",
    "PolicyName": "OSS-Administrator",
    "PolicyType": "Custom"
  },
  "RequestId": "9B34724D-54B0-4A51-B34D-4512372FE1BE"
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidParameter.PolicyName.InvalidChars	The policy name contains invalid characters. It must only contain upper or lower case letters, numbers, and dash (-).	The policy name contains invalid characters. It must only contain upper or lower case letters, numbers, and dash (-).
400	InvalidParameter.PolicyName.Length	The length of the policy name is invalid. It must be 1 to 128 characters in length.	The maximum length of the policy name is exceeded. It must be 1 to 128 characters in length.
400	InvalidParameter.PolicyDocument.Length	The maximum length of the policy document is exceeded. It must not exceed 6144 characters.
400	InvalidParameter.Description.Length	The maximum length of the description is exceeded. It must not exceed 1024 characters.	The maximum length of the description is exceeded. It must not exceed 1024 characters.
409	MalformedPolicyDocument	The policy format is invalid.	The policy format is invalid.
409	EntityAlreadyExists.Policy	The policy already exists.	The policy already exists.
409	LimitExceeded.Policy	The maximum number of policies is exceeded.	The maximum number of policies attached to this user is exceeded.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.