Compute Cloud API, REST: SnapshotSchedule.List
Retrieves the list of snapshot schedules in the specified folder.
HTTP request
GET https://compute.api.cloud.yandex.net/compute/v1/snapshotSchedules
Query parameters
Field |
Description |
folderId |
string Required field. ID of the folder to list snapshot schedules in. To get the folder ID, make a yandex.cloud.resourcemanager.v1.FolderService.List request. |
pageSize |
string (int64) The maximum number of results per page to return. If the number of available |
pageToken |
string Page token. To get the next page of results, set |
filter |
string A filter expression that filters snapshot schedules listed in the response. The expression must specify:
|
orderBy |
string A sorting expression that sorts snapshot schedules listed in the response. The expression must specify the field name from SnapshotSchedule and Default value: |
Response
HTTP Code: 200 - OK
{
"snapshotSchedules": [
{
"id": "string",
"folderId": "string",
"createdAt": "string",
"name": "string",
"description": "string",
"labels": "string",
"status": "string",
"schedulePolicy": {
"startAt": "string",
"expression": "string"
},
// Includes only one of the fields `retentionPeriod`, `snapshotCount`
"retentionPeriod": "string",
"snapshotCount": "string",
// end of the list of possible fields
"snapshotSpec": {
"description": "string",
"labels": "string"
}
}
],
"nextPageToken": "string"
}
Field |
Description |
snapshotSchedules[] |
List of snapshot schedules in the specified folder. |
nextPageToken |
string Token for getting the next page of the list. If the number of results is greater than Each subsequent page will have its own |
SnapshotSchedule
A snapshot schedule. For details about the concept, see documentation.
Field |
Description |
id |
string ID of the snapshot schedule. |
folderId |
string ID of the folder that the snapshot schedule belongs to. |
createdAt |
string (date-time) Creation timestamp. String in RFC3339 To work with values in this field, use the APIs described in the |
name |
string Name of the snapshot schedule. The name is unique within the folder. |
description |
string Description of the snapshot schedule. |
labels |
string Snapshot schedule labels as |
status |
enum (Status) Status of the snapshot schedule.
|
schedulePolicy |
Frequency settings of the snapshot schedule. |
retentionPeriod |
string (duration) Retention period of the snapshot schedule. Once a snapshot created by the schedule reaches this age, it is Includes only one of the fields Retention policy of the snapshot schedule. |
snapshotCount |
string (int64) Retention count of the snapshot schedule. Once the number of snapshots created by the schedule exceeds this Includes only one of the fields Retention policy of the snapshot schedule. |
snapshotSpec |
Attributes of snapshots created by the snapshot schedule. |
SchedulePolicy
A resource for frequency settings of a snapshot schedule.
Field |
Description |
startAt |
string (date-time) Timestamp for creating the first snapshot. String in RFC3339 To work with values in this field, use the APIs described in the |
expression |
string Cron expression for the snapshot schedule (UTC+0). The expression must consist of five fields ( |
SnapshotSpec
A resource for attributes of snapshots created by the snapshot schedule.
Field |
Description |
description |
string Description of the created snapshot. |
labels |
string Snapshot labels as |