Метод list

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

HTTP-запрос

GET https://iam.api.cloud.yandex.net/iam/v1/saml/certificates

Query-параметры

Параметр Описание
federationId Обязательное поле. Идентификатор ресурса федерации, для которой запрашивается список сертификатов. Максимальная длина строки в символах — 50.
pageSize Максимальное количество результатов на странице ответа на запрос. Если количество результатов больше чем pageSize , сервис вернет значение nextPageToken, которое можно использовать для получения следующей страницы. Значение по умолчанию: 100. Допустимые значения — от 0 до 1000 включительно.
pageToken Токен страницы. Установите значение pageToken равным значению поля [ListCertificateResponse.next_page_token] предыдущего запроса, чтобы получить следующую страницу результатов. Максимальная длина строки в символах — 100.
filter Параметры фильтрации ресурсов в ответе. В параметрах фильтрации указываются: 1. Оператор. Операторы = или != для одиночных значений, IN или NOT IN для списков значений. 2. Значение. Значение длиной от 3 до 63 символов, совпадающее с регулярным выражением ^[a-z][-a-z0-9]{1,61}[a-z0-9]$. Максимальная длина строки в символах — 1000.

Ответ

HTTP Code: 200 - OK

{
  "certificates": [
    {
      "id": "string",
      "federationId": "string",
      "name": "string",
      "description": "string",
      "createdAt": "string",
      "data": "string"
    }
  ],
  "nextPageToken": "string"
}
Поле Описание
certificates[] object

Сертификат.

certificates[].
id
string

Обязательное поле. Идентификатор сертификата.

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

certificates[].
federationId
string

Обязательное поле. Идентификатор федерации, которой принадлежит сертификат.

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

certificates[].
name
string

Имя сертификата.

Значение должно соответствовать регулярному выражению |[a-z][-a-z0-9]{1,61}[a-z0-9].

certificates[].
description
string

Описание сертификата. Длина описания должна быть от 0 до 256 символов.

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

certificates[].
createdAt
string (date-time)

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

Строка в формате RFC3339.

certificates[].
data
string

Обязательное поле. Содержимое сертификата в формате PEM.

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

nextPageToken string

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