Метод listTagHistory
Возвращает журнал тегов, назначенных версиям указанной функции.
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, используйте Все последующие запросы будут получать свои значения |