调用ListAliasesByKeyId查询与指定主密钥（CMK）对应的所有别名。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListAliasesByKeyId

系统规定参数。

取值：ListAliasesByKeyId。
KeyId String 是 1234abcd-12ab-34cd-56ef-12345678****

CMK的全局唯一标识符。
PageNumber Integer 否 1

当前页数。

取值范围：大于0的整数。

默认值：1。
PageSize Integer 否 10

每页返回的结果个数。

取值范围：0~101。

默认值：10。

返回数据

名称 类型 示例值 描述
TotalCount Integer 1

返回的CMK总数。
PageNumber Integer 1

当前页数。
PageSize Integer 10

每页的返回结果个数。
RequestId String 1b57992c-834b-4811-a889-f8bac1ba0353

本次请求的ID。
Aliases Array

别名。
KeyId String 08c33a6f-4e0a-4a1b-a3fa-7ddfa1d4****

别名对应的CMK。
AliasName String alias/ExampleAlias1

别名的唯一标识符。
AliasArn String acs:kms:cn-hangzhou:123456:alias/ExampleAlias1

别名的ARN。

示例

请求示例

https://kms.cn-hangzhou.aliyuncs.com/?Action=ListAliasesByKeyId
&PageNumber=1
&PageSize=10
&KeyId=<cmkid>
&<公共请求参数>

正常返回示例

XML 格式 

//xml response
<KMS>
        <Aliases>
                <Alias>
                        <AliasName>alias/ExampleAlias1</AliasName>
                        <KeyId>08c33a6f-4e0a-4a1b-a3fa-7ddfa1d4****</KeyId>
                        <AliasArn>acs:kms:cn-hangzhou:123456:alias/ExampleAlias1</AliasArn>
                </Alias>
        </Aliases>
        <TotalCount>1</TotalCount>
        <PageNumber>1</PageNumber>
        <PageSize>10</PageSize>
        <RequestId>1b57992c-834b-4811-a889-f8bac1ba0353</RequestId>
</KMS>

JSON 格式 

//json response
{
        "Aliases": {
                "Alias": [
                        {
                                "AliasName": "alias/ExampleAlias1",
                                "KeyId": "08c33a6f-4e0a-4a1b-a3fa-7ddfa1d4****",
                                "AliasArn": "acs:kms:cn-hangzhou:123456:alias/ExampleAlias1"
                        }
        ]
        },
        "TotalCount": 1,
        "PageNumber": 1,
        "PageSize": 10,
        "RequestId": "1b57992c-834b-4811-a889-f8bac1ba0353"
}

错误码

HttpCode 错误码 错误信息 描述
400 Throttling Request was denied due to request throttling. 您这个时段的流量已经超限。如果不能满足现有业务要求可以提工单进行申请。

访问错误中心查看更多错误码。