Listing DCS Instance Backup Records
Function
This API is used to query the backup records of a specific DCS instance.
URI
GET /v2/{project_id}/instances/{instance_id}/backups
Parameter | Mandatory | Type | Description |
|---|---|---|---|
project_id | Yes | String | Definition: Project ID. For details, see Obtaining a Project ID. Constraints: N/A Range: N/A Default Value: N/A |
instance_id | Yes | String | Definition: Instance ID. It can be viewed on the instance details page on the DCS console. Constraints: N/A Range: N/A Default Value: N/A |
Parameter | Mandatory | Type | Description |
|---|---|---|---|
begin_time | No | String | Definition: Query start time. Constraints: Format: yyyyMMddHHmmss, for example, 20170718235959. Range: N/A Default Value: N/A |
end_time | No | String | Definition: Query end time. Constraints: Format: yyyyMMddHHmmss, for example, 20170718235959. Range: N/A Default Value: N/A |
offset | No | Integer | Definition: Offset, which indicates that the generated list is displayed from this offset. For example, if the offset is 3, the generated list is displayed from the fourth record. Constraints: N/A Range: ≥ 0 Default Value: 0 |
limit | No | Integer | Definition: Number of records displayed on each page. Constraints: N/A Range: 1–1000 Default Value: 10 |
Request Parameters
None
Response Parameters
Status code: 200
Parameter | Type | Description |
|---|---|---|
total_num | Integer | Definition: Number of records returned for instance backup. Range: N/A |
backup_record_response | Array of BackupRecordResponse objects | Definition: Array of the backup details. |
Parameter | Type | Description |
|---|---|---|
backup_id | String | Definition: Backup record ID. Range: N/A |
period | String | Definition: Backup execution time. Range: N/A |
backup_name | String | Definition: Backup record name. Range: N/A |
instance_id | String | Definition: Instance ID. Range: N/A |
size | Long | Definition: Size of the backup file (byte). Range: N/A |
backup_type | String | Definition: Backup type. Range:
|
created_at | String | Definition: Time when the backup task is created. Range: N/A |
updated_at | String | Definition: Time at which DCS instance backup is completed. Range: N/A |
progress | String | Definition: Backup progress. Range: N/A |
error_code | String | Definition: Error code displayed for a backup failure. Range:
|
remark | String | Definition: Description of DCS instance backup. Range: N/A |
status | String | Definition: Backup status. Range:
|
is_support_restore | String | Definition: Whether restoration is supported. Range:
|
execution_at | String | Definition: Execution time. Range: N/A |
backup_format | String | Definition: Backup type. Range:
|
Status code: 204
No DCS instance backup record is found.
Status code: 400
Parameter | Type | Description |
|---|---|---|
error_msg | String | Definition: Error message. Range: N/A |
error_code | String | Definition: Error code. Range: For details, see Error Codes. |
error_ext_msg | String | Definition: Extended error information. This parameter is not used currently and is set to null. Range: N/A |
Status code: 500
Parameter | Type | Description |
|---|---|---|
error_msg | String | Definition: Error message. Range: N/A |
error_code | String | Definition: Error code. Range: For details, see Error Codes. |
error_ext_msg | String | Definition: Extended error information. This parameter is not used currently and is set to null. Range: N/A |
Example Requests
GET https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/backups?offset={offset}&limit={limit}&beginTime={begin_Time}&end_time={end_Time} Example Responses
Status code: 200
DCS instance backup records queried successfully.
{
"total_num" : 1,
"backup_record_response" : [ {
"period" : { },
"backup_type" : "manual",
"created_at" : "2019-05-10T08:31:16.166Z",
"remark" : "001",
"is_support_restore" : "TRUE",
"backup_id" : "4631832a-14c6-45b0-a0b3-3abd8f591ad1",
"backup_name" : "backup_20190510163116",
"instance_id" : "5560df16-cebf-4473-95c4-d1b573c16e79",
"size" : 880232,
"updated_at" : "2019-05-10T08:32:30.546Z",
"progress" : "100.00",
"error_code" : { },
"status" : "succeed",
"execution_at" : "2019-05-11T08:31:16.166Z",
"backup_format" : "aof"
} ]
} Status Codes
Status Code | Description |
|---|---|
200 | DCS instance backup records queried successfully. |
204 | No DCS instance backup record is found. |
400 | Invalid request. |
500 | Internal service error. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot
