ListKeys
調(diào)用ListKeys查詢調(diào)用者在調(diào)用地域的所有主密鑰ID。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | ListKeys | 要執(zhí)行的操作。取值:ListKeys。 |
PageNumber | Integer | 否 | 1 | 當(dāng)前頁數(shù)。 取值范圍:大于0。 默認(rèn)值:1。 |
PageSize | Integer | 否 | 10 | 每頁返回值的個數(shù)。 取值范圍:1~100。 默認(rèn)值:10。 |
Filters | String | 否 | [{"Key":"KeyState", "Values":["Enabled","Disabled"]}] | 主密鑰過濾器。由Key-Values鍵值對組成,長度為0~10。
Filters不同Key之間的邏輯關(guān)系為AND,同一個Key中的多個Value之間的邏輯關(guān)系為OR。例如:輸入
[ {"Key":"KeyState", "Values":["Enabled","Disabled"]},
{"Key":"KeyState", "Values":["PendingDeletion"]},
{"Key":"KeySpec", "Values":["Aliyun_AES_256"]}
]
時,語義為:
(KeyState=Enabled OR KeyState=Disabled OR KeyState=PendingDeletion)
AND (KeySpec=Aliyun_AES_256)。
|
返回數(shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
PageNumber | Integer | 1 | 當(dāng)前頁數(shù)。 |
PageSize | Integer | 10 | 每頁返回值的個數(shù)。 |
RequestId | String | 8252db58-2036-408c-a3d5-56e656dc2551 | 本次調(diào)用請求的ID,是由阿里云為該請求生成的唯一標(biāo)識符,可用于排查和定位問題。 |
TotalCount | Integer | 3 | 主密鑰的總數(shù)。 |
Keys | Array of Key | 主密鑰。 |
|
Key | |||
KeyId | String | 08c33a6f-4e0a-4a1b-a3fa-7ddfa1d4**** | 主密鑰的全局唯一標(biāo)識符。 |
KeyArn | String | acs:kms:cn-hangzhou:123456:key/80e9409f-78fa-42ab-84bd-83f40c81**** | 主密鑰的ARN。 |
示例
請求示例
http(s)://[Endpoint]/?Action=ListKeys
&PageNumber=1
&PageSize=10
&Filters=[{"Key":"KeyState", "Values":["Enabled","Disabled"]}]
&公共請求參數(shù)
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ListKeysResponse>
<PageNumber>1</PageNumber>
<PageSize>10</PageSize>
<RequestId>8252db58-2036-408c-a3d5-56e656dc2551</RequestId>
<TotalCount>3</TotalCount>
<Keys>
<KeyId>08c33a6f-4e0a-4a1b-a3fa-7ddfa1d4****</KeyId>
<KeyArn>acs:kms:cn-hangzhou:123456:key/80e9409f-78fa-42ab-84bd-83f40c81****</KeyArn>
</Keys>
</ListKeysResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"PageNumber" : 1,
"PageSize" : 10,
"RequestId" : "8252db58-2036-408c-a3d5-56e656dc2551",
"TotalCount" : 3,
"Keys" : [ {
"KeyId" : "08c33a6f-4e0a-4a1b-a3fa-7ddfa1d4****",
"KeyArn" : "acs:kms:cn-hangzhou:123456:key/80e9409f-78fa-42ab-84bd-83f40c81****"
} ]
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。