Help Center> Cloud Backup and Recovery> API Reference> CBR APIs> Tasks> Querying the Task List

Querying the Task List

Function

This API is used to query the task list.

URI

GET /v3/{project_id}/operation-logs

**Table 1** Path parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID

**Table 2** Query parameters
Parameter	Mandatory	Type	Description
end_time	No	String	End time of a task, in %YYYY-%mm-%ddT%HH:%MM:%SSZ format. For example, 2018-02-01T12:00:00Z.
enterprise_project_id	No	String	Enterprise project ID or all_granted_eps. all_granted_eps indicates querying the IDs of all enterprise projects on which the user has permissions.
limit	No	Integer	Number of records displayed per page. The value must be a positive integer. Minimum: 1
offset	No	Integer	Offset value. The value must be a positive integer. Minimum: 1
operation_type	No	String	Task type Enumeration values: backup copy replication delete restore vault_delete remove_resource sync
provider_id	No	String	Backup provider ID, which specifies whether the backup object is a server or disk
resource_id	No	String	Backup resource ID
resource_name	No	String	Backup resource name
start_time	No	String	Start time of a task, in %YYYY-%mm-%ddT%HH:%MM:%SSZ format. For example, 2018-01-01T12:00:00Z.
status	No	String	Task status Enumeration values: success skipped failed running timeout waiting
vault_id	No	String	ID of the vault with which the target resource is associated
vault_name	No	String	Name of the vault with which the target resource is associated

Request Parameters

**Table 3** Request header 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

**Table 4** Response body parameters
Parameter	Type	Description
operation_logs	Array of OperationLog objects	Task list
count	Integer	Number of tasks

**Table 5** OperationLog
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: backup copy replication restore delete sync vault_delete remove_resource
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: success skipped failed running timeout waiting
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

**Table 6** OpErrorInfo
Parameter	Type	Description
code	String	For details, see Error Codes.
message	String	Error message

**Table 7** OpExtraInfo
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

**Table 8** OpExtendInfoBckup
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: 0 1
backup_id	String	Backup ID
backup_name	String	Backup name
incremental	String	Whether incremental backup is used Enumeration values: "true" "false"

**Table 9** OpExtendInfoCommon
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

**Table 10** OpExtendInfoDelete
Parameter	Type	Description
backup_id	String	Backup ID
backup_name	String	Backup name

**Table 11** OpExtendInfoSync
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

**Table 12** OpExtendInfoRemoveResources
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

**Table 13** Resource
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	Type of the resource to be backed up. Possible values are as follows: OS::Nova::Server, OS::Cinder::Volume, OS::Ironic::BareMetalServer, OS::Native::Server, and OS::Sfs::Turbo

**Table 14** OpExtendInfoReplication
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

**Table 15** ResourceExtraInfo
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

**Table 16** ResourceExtraInfoIncludeVolumes
Parameter	Type	Description
id	String	EVS disk ID. Only UUID is supported.
os_version	String	OS type

**Table 17** OpExtendInfoRestore
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

**Table 18** OpExtendInfoVaultDelete
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

**Table 19** Response body parameters
Parameter	Type	Description
operation_logs	Array of OperationLog objects	Task list
count	Integer	Number of tasks

**Table 20** OperationLog
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: backup copy replication restore delete sync vault_delete remove_resource
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: success skipped failed running timeout waiting
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

**Table 21** OpErrorInfo
Parameter	Type	Description
code	String	For details, see Error Codes.
message	String	Error message

**Table 22** OpExtraInfo
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

**Table 23** OpExtendInfoBckup
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: 0 1
backup_id	String	Backup ID
backup_name	String	Backup name
incremental	String	Whether incremental backup is used Enumeration values: "true" "false"

**Table 24** OpExtendInfoCommon
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

**Table 25** OpExtendInfoDelete
Parameter	Type	Description
backup_id	String	Backup ID
backup_name	String	Backup name

**Table 26** OpExtendInfoSync
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

**Table 27** OpExtendInfoRemoveResources
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

**Table 28** Resource
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	Type of the resource to be backed up. Possible values are as follows: OS::Nova::Server, OS::Cinder::Volume, OS::Ironic::BareMetalServer, OS::Native::Server, and OS::Sfs::Turbo

**Table 29** OpExtendInfoReplication
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

**Table 30** ResourceExtraInfo
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

**Table 31** ResourceExtraInfoIncludeVolumes
Parameter	Type	Description
id	String	EVS disk ID. Only UUID is supported.
os_version	String	OS type

**Table 32** OpExtendInfoRestore
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

**Table 33** OpExtendInfoVaultDelete
Parameter	Type	Description
fail_count	Integer	ID list of resources that fail to be deleted
total_count	Integer	Number of deleted backups

Example Requests

None

Example Responses

Status code: 200

{
  "count" : 1,
  "operation_logs" : [ {
    "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_backup",
        "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 Codes

Status Code	Description
200	OK
404	Not Found

Error Codes

See Error Codes.

Parent topic: Tasks

Last Article: Querying a Single Task

Next Article: Backup Sharing

Did this article solve your problem?

Thank you for your score！Your feedback would help us improve the website.

Products

Compute

Application

Dedicated Cloud

Storage

Management & Deployment

Migration

Network

Enterprise Intelligence

Video

Database

Edge Cloud Services

DevCloud

Security

Cloud Communications

Internet of Things

Solutions

Industry-Specific Solutions

General-Purpose Solutions

Security

DevOps

Enterprise Intelligence

Essential Platform

Big Data

Visual Cognition

Speech and Semantics

Support

Help Center

Customer Services

Developers

Console

语言 - Language

中国站 - 简体中文

中国站 - English

International - 简体中文

International - English