Метод listTagHistory

HTTP-запрос
Path-параметры
Query-параметры
Ответ

Возвращает журнал тегов, назначенных версиям указанной функции.

HTTP-запрос

GET https://serverless-functions.api.cloud.yandex.net/functions/v1/functions/{functionId}:tagHistory

Path-параметры

Параметр	Описание
functionId	Обязательное поле. Идентификатор функции для получения истории тегов. Чтобы получить идентификатор функции, используйте запрос list .

Query-параметры

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

Ответ

HTTP Code: 200 - OK

{
  "functionTagHistoryRecord": [
    {
      "functionId": "string",
      "functionVersionId": "string",
      "tag": "string",
      "effectiveFrom": "string",
      "effectiveTo": "string"
    }
  ],
  "nextPageToken": "string"
}

Поле	Описание
functionTagHistoryRecord[]	object Запись в истории тегов.
functionTagHistoryRecord[]. functionId	string Идентификатор функции, для которой идет запись.
functionTagHistoryRecord[]. functionVersionId	string Идентификатор версии функции, для которой идет запись.
functionTagHistoryRecord[]. tag	string Тег, который был установлен для версии в какой-то момент.
functionTagHistoryRecord[]. effectiveFrom	string (date-time) Отметка времени, когда тег начал быть активным для функции. Строка в формате RFC3339.
functionTagHistoryRecord[]. effectiveTo	string (date-time) Отметка времени, когда тег перестал быть активным для функции. Строка в формате RFC3339.
nextPageToken	string Токен для получения следующей страницы списка. Если количество результатов больше чем pageSize, используйте `nextPageToken` в качестве значения параметра pageToken в следующем запросе списка ресурсов. Все последующие запросы будут получать свои значения `nextPageToken` для перебора страниц результатов.