All Products
Search
Document Center

Key Management Service:ListPolicies

Last Updated:Mar 12, 2026

Queries all permission policies in the current region.

Operation description

For more information about the access policy required by a RAM user or RAM role to call this API, see Resource Access 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

PageNumber

integer

No

The page number. Default value: 1.

1

PageSize

integer

No

The number of entries per page. Valid values: 1 to 100. Default value: 20.

10

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

b66ad557-9c00-4064-9c8d-b621c3263308

PageNumber

integer

The page number.

1

PageSize

integer

The number of entries per page.

10

TotalCount

integer

The total number of entries returned.

1

Policies

object

Policy

array<object>

A list of permission policies.

object

A list of permission policies.

Name

string

The name of the permission policy.

policy_test

Examples

Success response

JSON format

{
  "RequestId": "b66ad557-9c00-4064-9c8d-b621c3263308",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1,
  "Policies": {
    "Policy": [
      {
        "Name": "policy_test"
      }
    ]
  }
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidParameter The specified parameter is not valid. An invalid value is specified for the parameter.
404 InvalidAccessKeyId.NotFound The Access Key ID provided does not exist in our records.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.