Method listTagHistory
Статья создана
Returns the log of tags assigned to versions of the specified function.
HTTP request
GET https://serverless-functions.api.cloud.yandex.net/functions/v1/functions/{functionId}:tagHistory
Path parameters
| Parameter | Description |
|---|---|
| functionId | Required. ID of the function to retrieve tag history for. To get a function ID, make a list request. |
Query parameters
| Parameter | Description |
|---|---|
| tag | Specific tag that history should be limited to. Value must match the regular expression `` [a-z][-_0-9a-z]* |
| pageSize | The maximum number of results per page that should be returned. If the number of available results is larger than pageSize, the service returns a nextPageToken that can be used to get the next page of results in subsequent list requests. Default value: 100. Acceptable values are 0 to 1000, inclusive. |
| pageToken | Page token. To get the next page of results, set pageToken to the nextPageToken returned by a previous list request. The maximum string length in characters is 100. |
| filter | A filter expression that filters resources listed in the response. The expression must specify: 1. The field name. Currently filtering can only be applied to the [FunctionTagHistoryRecord.effective_from] and [FunctionTagHistoryRecord.effective_to] fields. 2. An = or > or < operator. 3. The value in double quotes ("). Must be 3-63 characters long and match the regular expression [a-z][-a-z0-9]{1,61}[a-z0-9]. For example, effective_to>2021-01-01T12:00:00Z. The maximum string length in characters is 1000. |
Response
HTTP Code: 200 - OK
{
"functionTagHistoryRecord": [
{
"functionId": "string",
"functionVersionId": "string",
"tag": "string",
"effectiveFrom": "string",
"effectiveTo": "string"
}
],
"nextPageToken": "string"
}
| Field | Description |
|---|---|
| functionTagHistoryRecord[] | object A record in the tag history. |
| functionTagHistoryRecord[]. functionId |
string ID of the function that the record is about. |
| functionTagHistoryRecord[]. functionVersionId |
string ID of the function version that the record is about. |
| functionTagHistoryRecord[]. tag |
string Tag that was set for the version at some point. |
| functionTagHistoryRecord[]. effectiveFrom |
string (date-time) Timestamp when the tag started being active for the function. String in RFC3339 text format. |
| functionTagHistoryRecord[]. effectiveTo |
string (date-time) Timestamp when the tag stopped being active for the function. String in RFC3339 text format. |
| nextPageToken | string Token for getting the next page of the list. If the number of results is greater than the specified pageSize, use Each subsequent page will have its own |