Метод create

HTTP-запрос
Параметры в теле запроса
Ответ

Создает API-ключ для указанного сервисного аккаунта.

HTTP-запрос

POST https://iam.api.cloud.yandex.net/iam/v1/apiKeys

Параметры в теле запроса

{
  "serviceAccountId": "string",
  "description": "string"
}

Поле	Описание
serviceAccountId	string Идентификатор сервисного аккаунта для создания API-ключа. Чтобы получить идентификатор сервисного аккаунта, используйте запрос list. Если параметр не указан, то используется идентификатор субъекта, который сделал запрос. Максимальная длина строки в символах — 50.
description	string Описание API-ключа. Максимальная длина строки в символах — 256.

Поле

Описание

serviceAccountId

string

Идентификатор сервисного аккаунта для создания API-ключа. Чтобы получить идентификатор сервисного аккаунта, используйте запрос list. Если параметр не указан, то используется идентификатор субъекта, который сделал запрос.

Максимальная длина строки в символах — 50.

description

string

Описание API-ключа.

Максимальная длина строки в символах — 256.

Ответ

HTTP Code: 200 - OK

{
  "apiKey": {
    "id": "string",
    "serviceAccountId": "string",
    "createdAt": "string",
    "description": "string"
  },
  "secret": "string"
}

Поле	Описание
apiKey	object Ресурс ApiKey. Ресурс ApiKey.
apiKey. id	string Идентификатор API-ключа.
apiKey. serviceAccountId	string Идентификатор сервисного аккаунта, которому принадлежит API-ключ.
apiKey. createdAt	string (date-time) Время создания. Строка в формате RFC3339.
apiKey. description	string Описание API-ключа. Длина описания должна быть от 0 до 256 символов.
secret	string Секретная часть API-ключа. Этот секретный ключ можно использовать для аутентификации при запросах.