All Products
Search
Document Center

Resource Management:ListPolicies

Last Updated:Dec 15, 2025

Queries a list of permission policies.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
PolicyTypestringNo

The type of the permission policy. If you do not configure this parameter, all types of permission policies are returned. Valid values:

  • Custom
  • System
Custom
PageNumberintegerNo

The page number.

Pages start from page 1. Default value: 1.

1
PageSizeintegerNo

The number of entries per page.

Valid values: 1 to 100. Default value: 10.

10
LanguagestringNo

The language in which you want to return the descriptions of the system permission policies. Valid values:

  • en: English.
  • zh-CN: Chinese
  • ja: Japanese
zh-CN

Response parameters

ParameterTypeDescriptionExample
object

The returned data.

PageNumberinteger

The page number.

1
PageSizeinteger

The number of entries per page.

10
Policiesarray<object>

The information about the permission policies.

Policyobject

The information about the permission policy.

AttachmentCountinteger

The number of references to the permission policy.

1
CreateDatestring

The time when the permission policy was created.

2015-01-23T12:33:18Z
DefaultVersionstring

The default version of the permission policy.

v1
Descriptionstring

The description of the permission policy.

OSS administrator
PolicyNamestring

The name of the permission policy.

OSS-Administrator
PolicyTypestring

The type of the permission policy. Valid values:

  • Custom
  • System
Custom
UpdateDatestring

The time when the permission policy was updated.

2016-02-11T18:39:12Z
RequestIdstring

The request ID.

7B8A4E7D-6CFF-471D-84DF-195A7A241ECB
TotalCountinteger

The total number of entries returned.

2

Examples

Sample success responses

JSONformat

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

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history