Querying a Single Task
Function
This API is used to query a task by task ID.
URI
GET /v3/{project_id}/operation-logs/{operation_log_id}
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
operation_log_id |
Yes |
String |
Task ID |
project_id |
Yes |
String |
Project ID |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
User token. Obtained by calling the corresponding IAM API. If the request is successfully processed, the value of X-Subject-Token included in the response header is the token value. |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
operation_log |
OperationLog object |
Parameter |
Type |
Description |
---|---|---|
checkpoint_id |
String |
Backup record ID |
created_at |
String |
Creation time, for example, 2020-02-23T01:00:32Z |
ended_at |
String |
Task end time, for example, 2020-02-23T01:00:32Z |
error_info |
OpErrorInfo object |
Task error message |
extra_info |
OpExtraInfo object |
Task extension information |
id |
String |
Task ID |
operation_type |
String |
Task type Enumeration values:
|
policy_id |
String |
Policy ID |
project_id |
String |
Project ID |
provider_id |
String |
Backup provider ID, which specifies whether the backup object is a server or disk |
started_at |
String |
Task start time, for example, 2020-02-23T01:00:32Z |
status |
String |
Task status Enumeration values:
|
updated_at |
String |
Modification time, for example, 2020-02-23T01:00:32Z |
vault_id |
String |
ID of the vault with which the target resource is associated |
vault_name |
String |
Name of the vault with which the target resource is associated |
Parameter |
Type |
Description |
---|---|---|
code |
String |
For details, see Error Codes. |
message |
String |
Error message |
Parameter |
Type |
Description |
---|---|---|
backup |
OpExtendInfoBckup object |
Extended parameters of backup |
common |
OpExtendInfoCommon object |
Common parameters |
delete |
OpExtendInfoDelete object |
Extended parameters of deletion |
sync |
OpExtendInfoSync object |
Extended parameters of synchronization |
remove_resources |
OpExtendInfoRemoveResources object |
Extended parameters of removing resources from a vault |
replication |
OpExtendInfoReplication object |
Extended parameters of replication |
resource |
Resource object |
Resource information |
restore |
OpExtendInfoRestore object |
Extended parameters of restoration |
vault_delete |
OpExtendInfoVaultDelete object |
Extended parameters of deleting a vault |
Parameter |
Type |
Description |
---|---|---|
app_consistency_error_code |
String |
Error code returned if application-consistent backup fails. For details, see Error Codes. |
app_consistency_error_message |
String |
Error message returned if application-consistent backup fails |
app_consistency_status |
String |
Application-consistent backup status, which can be set to 0 (non-application-consistent backup) or 1 (application-consistent backup) Enumeration values:
|
backup_id |
String |
Backup ID |
backup_name |
String |
Backup name |
incremental |
String |
Whether incremental backup is used Enumeration values:
|
Parameter |
Type |
Description |
---|---|---|
progress |
Integer |
Progress of the query task. The value ranges from 0 to 100. Minimum: 0 Maximum: 100 |
request_id |
String |
Request ID |
task_id |
String |
Backup task ID |
Parameter |
Type |
Description |
---|---|---|
backup_id |
String |
Backup ID |
backup_name |
String |
Backup name |
Parameter |
Type |
Description |
---|---|---|
sync_backup_num |
Integer |
Number of synchronized backups |
delete_backup_num |
Integer |
Number of deleted backups |
err_sync_backup_num |
Integer |
Number of backups that fail to be synchronized |
Parameter |
Type |
Description |
---|---|---|
fail_count |
Integer |
ID list of resources that fail to be deleted |
total_count |
Integer |
Number of deleted backups |
resources |
Array of Resource objects |
Parameter |
Type |
Description |
---|---|---|
extra_info |
ResourceExtraInfo object |
Extra information of the resource |
id |
String |
ID of the resource to be backed up |
name |
String |
Name of the resource to be backed up. The value consists of 0 to 255 characters. Minimum: 0 Maximum: 255 |
type |
String |
Parameter |
Type |
Description |
---|---|---|
destination_backup_id |
String |
Destination backup ID |
destination_checkpoint_id |
String |
Destination restore point ID |
destination_project_id |
String |
Destination project ID |
destination_region |
String |
Destination region |
source_backup_id |
String |
Source backup ID |
source_checkpoint_id |
String |
Source restore point ID |
source_project_id |
String |
Source project ID |
source_region |
String |
Source region |
source_backup_name |
String |
Source backup name |
destination_backup_name |
String |
Destination backup name |
Parameter |
Type |
Description |
---|---|---|
exclude_volumes |
Array of strings |
ID of the disk that is excluded from the backup. This parameter is used only when there are VM disk backups. |
include_volumes |
Array of ResourceExtraInfoIncludeVolumes objects |
Disk to be backed up |
Parameter |
Type |
Description |
---|---|---|
id |
String |
EVS disk ID. Only UUID is supported. |
os_version |
String |
OS type |
Parameter |
Type |
Description |
---|---|---|
backup_id |
String |
Backup ID |
backup_name |
String |
Backup name |
target_resource_id |
String |
ID of the resource to be restored |
target_resource_name |
String |
Name of the resource to be restored |
Parameter |
Type |
Description |
---|---|---|
fail_count |
Integer |
ID list of resources that fail to be deleted |
total_count |
Integer |
Number of deleted backups |
Status code: 404
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
For details, see Error Codes. |
error_msg |
String |
Error message |
Example Requests
None
Example Responses
Status code: 200
OK
{ "operation_log" : { "status" : "success", "provider_id" : "0daac4c5-6707-4851-97ba-169e36266b66", "checkpoint_id" : "b432511f-d889-428f-8b0e-5f47c524c6b6", "updated_at" : "2019-05-23T14:35:23.584418", "error_info" : { "message" : "", "code" : "" }, "started_at" : "2019-05-23T14:31:36.007230", "id" : "4827f2da-b008-4507-ab7d-42d0df5ed912", "extra_info" : { "resource" : { "type" : "OS::Nova::Server", "id" : "1dab32fa-ebf2-415a-ab0b-eabe6353bc86", "name" : "ECS-0001" }, "backup" : { "backup_name" : "manualbk_1234", "backup_id" : "0e5d0ef6-7f0a-4890-b98c-cb12490e31c1" }, "common" : { "progress" : 100, "request_id" : "req-cdb98cc4-e87b-4f40-9b4a-57ec036620bc" } }, "ended_at" : "2019-05-23T14:35:23.511155", "created_at" : "2019-05-23T14:31:36.039365", "operation_type" : "backup", "project_id" : "04f1829c788037ac2fb8c01eb2b04b95" } }
Status code: 404
The task ID does not exist.
{ "error_code" : "BackupService.6500", "error_msg" : "Operation log does not exist." }
Status Codes
Status Code |
Description |
---|---|
200 |
OK |
404 |
The task ID does not exist. |
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