Подключиться
Yandex Cloud Functions

Метод list

Возвращает список функций в указанном каталоге.

HTTP-запрос

GET https://serverless-functions.api.cloud.yandex.net/functions/v1/functions

Query-параметры

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

Ответ

HTTP Code: 200 - OK

{
  "functions": [
    {
      "id": "string",
      "folderId": "string",
      "createdAt": "string",
      "name": "string",
      "description": "string",
      "labels": "object",
      "logGroupId": "string",
      "httpInvokeUrl": "string",
      "status": "string"
    }
  ],
  "nextPageToken": "string"
}
Поле Описание
functions[] object

Бессерверная функция. Дополнительные сведения о концепции см. в разделе Функция.
functions[].
id		 string

Идентификатор функции. Генерируется во время создания.
functions[].
folderId		 string

Идентификатор каталога, к которому принадлежит функция.
functions[].
createdAt		 string (date-time)

Время создания функции.

Строка в формате RFC3339.
functions[].
name		 string

Имя функции. Имя уникально в рамках каталога.

Длина строки в символах должна быть от 3 до 63.
functions[].
description		 string

Описание функции.

Длина строки в символах должна быть от 0 до 256.
functions[].
labels		 object

Метки функций в виде пар key:value .

Не более 64 на ресурс.
functions[].
logGroupId		 string

Идентификатор группы журналов выполнения функции.
functions[].
httpInvokeUrl		 string

URL-адрес, который нужнозапросить для вызова функции.
functions[].
status		 string

Состояние функции.

  • CREATING: Функция создается.
  • ACTIVE: Функция готова к вызову.
  • DELETING: Функция удаляется.
  • ERROR: Сбой функции.
nextPageToken string

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

Все последующие запросы будут получать свои значения nextPageToken для перебора страниц результатов.
В этой статье: