Query a list of permission policies using ListPolicies - Resource Management - Alibaba Cloud - Resource Management

Calls ListPolicies to query a list of access policies.

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
PolicyType	string	No	The type of the access policy. If this parameter is left empty, all types of access policies are listed. Custom: custom policy. System: system policy.	Custom
PageNumber	integer	No	The page number. Minimum value: 1. Default value: 1.	1
PageSize	integer	No	The number of entries per page. Valid values: 1 to 100. Default value: 10.	10
Language	string	No	The language type. The description of the system access policy is returned in the specified language. en: English. zh-CN: Chinese. ja: Japanese.	zh-CN

Response elements

Element	Type	Description	Example
	object	The response parameters.
PageNumber	integer	The page number.	1
PageSize	integer	The number of entries per page.	10
Policies	object
Policy	array<object>	The access policy information.
	object	The access policy information.
AttachmentCount	integer	The number of references to the access policy.	1
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 default version of the access policy.	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. Custom: custom policy. System: system policy.	Custom
UpdateDate	string	The time when the access policy was last updated. The time is in RFC 3339 UTC format, indicated by Z.	2016-02-11T18:39:12Z
RequestId	string	The request ID.	7B8A4E7D-6CFF-471D-84DF-195A7A241ECB
TotalCount	integer	The total number of entries.	2

Examples

Success response

JSON format

{
  "PageNumber": 1,
  "PageSize": 10,
  "Policies": {
    "Policy": [
      {
        "AttachmentCount": 1,
        "CreateDate": "2015-01-23T12:33:18Z",
        "DefaultVersion": "v1",
        "Description": "OSS管理员权限",
        "PolicyName": "OSS-Administrator",
        "PolicyType": "Custom",
        "UpdateDate": "2016-02-11T18:39:12Z"
      }
    ]
  },
  "RequestId": "7B8A4E7D-6CFF-471D-84DF-195A7A241ECB",
  "TotalCount": 2
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.