ListAliases#

Description#

Возвращает список алиасов.

Request Parameters#

  • KeyId — Идентификатор ключа KMS.

    • Тип: String

    • Необходимо: Нет

  • Limit — Максимальное количество элементов, которые будут возвращены в ответе.

    • Тип: String

    • Необходимо: Нет

    • Значение по умолчанию: 50

    • Диапазон: От 1 до 100

  • Marker — NextMarker из предыдущего вызова (см. Response Elements).

    • Тип: String

    • Необходимо: Нет

Response Elements#

  • Aliases — Список алисов.

  • NextMarker — Содержит значение, которое нужно передать в параметре Marker в повторном запросе, чтобы продолжить вывод данных. Возвращается, когда Truncated имеет значение true.

    • Тип: String

  • Truncated — Указывает, что в ответе не удалось вернуть все элементы списка.

    • Тип: Boolean

Examples#

Пример запроса#

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.ListAliases

{
    "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
}

Пример ответа#

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

{
    "Aliases": [
        {
          "AliasName": "alias/example1",
          "TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
          "CreationDate": 1774439912.925000,
          "LastUpdatedDate": 1774439912.925000
        },
        {
          "AliasName": "alias/example2",
          "TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
          "CreationDate": 1774439916.473000,
          "LastUpdatedDate": 1774439916.473000
        },
        {
          "AliasName": "alias/example3",
          "TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
          "CreationDate": 1774439918.935000,
          "LastUpdatedDate": 1774440029.749000
        }
    ],
    "Truncated": false
}