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