Managed Service for MySQL API, REST: Cluster.ListBackups
Retrieves a list of backups for a cluster.
To list all backups in a folder, make a BackupService.List request.
HTTP request
GET https://mdb.api.yandexcloud.kz/managed-mysql/v1/clusters/{clusterId}/backups
Path parameters
|
Field |
Description |
|
clusterId |
string Required field. ID of the cluster to list backups for. To get this ID, make a ClusterService.List request. |
Query parameters
|
Field |
Description |
|
pageSize |
string (int64) The maximum number of results per page to return. If the number of available results is larger than |
|
pageToken |
string Page token that can be used to iterate through multiple pages of results. To get the next page of results, set |
Response
HTTP Code: 200 - OK
{
"backups": [
{
"id": "string",
"folderId": "string",
"createdAt": "string",
"sourceClusterId": "string",
"startedAt": "string",
"size": "string",
"type": "string",
"status": "string"
}
],
"nextPageToken": "string"
}
|
Field |
Description |
|
backups[] |
List of the cluster backups. |
|
nextPageToken |
string The token that can be used to get the next page of results. If the number of results is larger than ListClusterBackupsRequest.pageSize, use the Each of the subsequent ClusterService.ListBackups requests should use the |
Backup
An object that represents MySQL backup.
See the documentation for details.
|
Field |
Description |
|
id |
string Required field. ID of the backup. |
|
folderId |
string ID of the folder that the backup belongs to. |
|
createdAt |
string (date-time) Creation timestamp (the time when the backup operation was completed). 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 |
|
sourceClusterId |
string ID of the cluster that the backup was created for. |
|
startedAt |
string (date-time) Start timestamp (the time when the backup operation was started). 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 |
|
size |
string (int64) Size of backup, in bytes |
|
type |
enum (BackupCreationType) How this backup was created (manual/automatic/etc...)
|
|
status |
enum (BackupStatus) Status of backup
|