Serverless Containers Service, REST: Container.list
Retrieves the list of containers in the specified folder.
HTTP request
GET https://serverless-containers.api.cloud.yandex.net/containers/v1/containers
Query parameters
Parameter | Description |
---|---|
folderId | Required. ID of the folder to list containers in. To get a folder ID make a list request. |
pageSize | The maximum number of results per page to return. If the number of available results is larger than Default value: 100. |
pageToken | Page token. To get the next page of results, set |
filter | A filter expression that filters containers listed in the response. The expression must specify:
|
Response
HTTP Code: 200 - OK
{
"containers": [
{
"id": "string",
"folderId": "string",
"createdAt": "string",
"name": "string",
"description": "string",
"labels": "object",
"url": "string",
"status": "string"
}
],
"nextPageToken": "string"
}
Field | Description |
---|---|
containers[] | object List of containers in the specified folder. |
containers[]. id |
string ID of the container. Generated at creation time. |
containers[]. folderId |
string ID of the folder that the container belongs to. |
containers[]. createdAt |
string (date-time) Creation timestamp for the container. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the Protocol Buffers reference. In some languages, built-in datetime utilities do not support nanosecond precision (9 digits). |
containers[]. name |
string Name of the container. The name is unique within the folder. |
containers[]. description |
string Description of the container. |
containers[]. labels |
object Container labels as |
containers[]. url |
string URL that needs to be requested to call the container. |
containers[]. status |
string Status of the container.
|
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 |