Подключиться
Yandex Identity and Access Management

Метод list

Возвращает список доступных ресурсов Key для указанного сервисного аккаунта.

HTTP-запрос

GET https://iam.api.cloud.yandex.net/iam/v1/keys

Query-параметры

Параметр Описание
format Формат ключа.
  • PEM_FILE: Формат Privacy-Enhanced Mail (PEM). Значение по умолчанию.
serviceAccountId Идентификатор сервисного аккаунта для вывода списка пар ключей. Чтобы получить идентификатор сервисного аккаунта, используйте запрос list. Если параметр не указан, то используется идентификатор субъекта, который сделал запрос. Максимальная длина строки в символах — 50.
pageSize Максимальное количество результатов на странице ответа на запрос. Если количество результатов больше чем pageSize, сервис вернет значение nextPageToken, которое можно использовать для получения следующей страницы. Значение по умолчанию: 100. Максимальное значение — 1000.
pageToken Токен страницы. Установите значение pageToken равным значению поля nextPageToken предыдущего запроса, чтобы получить следующую страницу результатов. Максимальная длина строки в символах — 100.

Ответ

HTTP Code: 200 - OK

{
  "keys": [
    {
      "id": "string",
      "createdAt": "string",
      "description": "string",
      "keyAlgorithm": "string",
      "publicKey": "string",

      // `keys[]` включает только одно из полей `userAccountId`, `serviceAccountId`
      "userAccountId": "string",
      "serviceAccountId": "string",
      // конец списка возможных полей`keys[]`

    }
  ],
  "nextPageToken": "string"
}
Поле Описание
keys[] object

Ресурс Key. Подробнее см. в разделе Авторизованные ключи.
keys[].
id		 string

Идентификатор ресурса Key
keys[].
createdAt		 string (date-time)

Время создания.

Строка в формате RFC3339.
keys[].
description		 string

Описание ресурса Key. Длина 0-256 символов.
keys[].
keyAlgorithm		 string
Алгоритм, используемый для создания пары ключей ресурса Key.
  • RSA_2048: RSA с длиной ключа 2048 бит. Значение по умолчанию.
  • RSA_4096: RSA с длиной ключа 4096 бит.
keys[].
publicKey		 string

Закрытый ключ из ресурса Key.
keys[].
userAccountId		 string
keys[] включает только одно из полей userAccountId, serviceAccountId

Идентификатор аккаунта пользователя, которому принадлежит ресурс Key.
keys[].
serviceAccountId		 string
keys[] включает только одно из полей userAccountId, serviceAccountId

Идентификатор сервисного аккаунта, которому принадлежит ресурс Key.
nextPageToken string

Токен для получения следующей страницы результатов в ответе. Если количество результатов больше чем pageSize, используйте nextPageToken в качестве значения параметра pageToken в следующем запросе списка ресурсов. Все последующие запросы будут получать свои значения nextPageToken для перебора страниц результатов.
В этой статье: