ListKeys#

Description#

Returns a list of KMS keys.

Request Parameters#

  • Limit — The maximum number of items that will be returned in the response.

    • Type: String

    • Required: No

    • Default value: 100

    • Valid range: from 1 to 1000

  • Marker — NextMarker from the previous call (see Response Elements).

    • Type: String

    • Required: No

Response Elements#

  • Keys — The list of KMS keys.

  • NextMarker — Contains the value to pass in the Marker parameter in a subsequent request to continue listing data. Returned when Truncated is true.

    • Type: String

  • Truncated — Indicates that the response could not return all list items.

    • Type: Boolean

Examples#

Sample Request#

POST / HTTP/1.1
Host: kms.<region>.<domain>
Content-Length: <PayloadSizeBytes>
Content-Type: application/x-amz-json-1.1
Authorization: AWS4-HMAC-SHA256 Credential=<Credential>, SignedHeaders=<Headers>, Signature=<Signature>
X-Amz-Date: <Date>
X-Amz-Target: TrentService.ListKeys

{}

Sample Response#

HTTP/1.1 200 OK
Content-Type: application/x-amz-json-1.1

{
    "Keys": [
        {
            "KeyId": "0d990263-018e-4e65-a703-eff731de951e"
        },
        {
            "KeyId": "144be297-0ae1-44ac-9c8f-93cd8c82f841"
        },
        {
            "KeyId": "21184251-b765-428e-b852-2c7353e72571"
        }
    ],
    "Truncated": false
}