CreateAlias#

Description#

Создаёт алиас, ассоциированный с ключом KMS. Алиас можно использовать для идентификации ключа KMS в DescribeKey и криптографических операциях.

Request Parameters#

  • AliasName — Имя алиаса.

    • Type: String

    • Required: Yes

    • Ограничения: Не может начинаться с alias/aws/ и alias/cloud/

    • Ограничение длины: От 1 до 256 символов

    • Шаблон: ^alias/[a-zA-Z0-9/_-]+$

  • TargetKeyId — Идентификатор ключа KMS, с которым будет ассоциирован алиас.

    • Type: String

    • Required: Yes

Response Elements#

Тело ответа отсутствует.

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

{
    "AliasName": "alias/example",
    "TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
}

Sample Response#

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