Querying the Task List

Function

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.
limit	No	Integer	Number of items displayed on each page. The value is a positive integer. You are advised to explicitly define the value of the parameter.
offset	No	Integer	Offset value. The value must be a positive integer.
operation_type	No	String	Task type, which can be one of the following: backup: backup tasks replication: replication tasks delete: deletion tasks restore: restoration tasks vault_delete: vault deletion tasks remove_resource: resource removal tasks sync: synchronization tasks copy: replication tasks in the earlier version. Currently, replication tasks are all of the replication type.
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. The value can be: success: The task is executed successfully. skipped: The task is skipped because some checks fail. failed: The task fails to be executed. running: The task is running. timeout: The task times out. No error occurs during the process, but the running duration of some steps exceeds the system-specified time. waiting: The task is waiting to be executed.
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 The token can be obtained by calling the IAM API used to obtain a user token. The user token is the value of X-Subject-Token in the response header.

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
limit	Integer	Number of records displayed on each page
offset	Integer	Offset where the query starts

**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
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
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
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
backup_id	String	Backup ID. Default value: N/A
backup_name	String	Backup name. The value can contain a maximum of 64 characters, including digits, uppercase letters, lowercase letters, underscores (_), and hyphens (-). Default value: N/A
incremental	String	Whether incremental backup is used

**Table 9** OpExtendInfoCommon
Parameter	Type	Description
progress	Integer	Progress of the query task. The value ranges from 0 to 100.
request_id	String	Request ID
task_id	String	Backup task ID

**Table 10** OpExtendInfoDelete
Parameter	Type	Description
backup_id	String	Backup ID. Default value: N/A
backup_name	String	Backup name. The value can contain a maximum of 64 characters, including digits, uppercase letters, lowercase letters, underscores (_), and hyphens (-). Default value: N/A

**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 failed to be synchronized

**Table 12** OpExtendInfoRemoveResources
Parameter	Type	Description
fail_count	Integer	Number of resources that fail to be deleted
total_count	Integer	Number of deleted backups
resources	Array of Resource objects	Resource information

**Table 13** Resource
Parameter	Type	Description
id	String	ID of the resource to be backed up. The resource must have been associated with the vault and can be backed up. Default value: N/A
name	String	Name of the resource to be backed up. The value can contain a maximum of 255 characters. Default value: N/A
type	String	Type of the resource to be backed up: OS::Nova::Server: ECS; OS::Cinder::Volume: EVS disks; OS::Sfs::Turbo: SFS Turbo file systems Default value: N/A

**Table 14** OpExtendInfoRestore
Parameter	Type	Description
backup_id	String	ID of the backup replica. Default value: N/A
backup_name	String	Backup name. The value can contain a maximum of 64 characters, including digits, uppercase letters, lowercase letters, underscores (_), and hyphens (-). Default value: N/A
target_resource_id	String	Target resource ID in UUID format. Default value: N/A
target_resource_name	String	Name of the resource to be restored

**Table 15** OpExtendInfoVaultDelete
Parameter	Type	Description
fail_count	Integer	Number of resources that fail to be deleted in this task
total_count	Integer	Number of backups deleted in this task

Status code: 404

**Table 16** Response body parameters
Parameter	Type	Description
operation_logs	Array of OperationLog objects	Task list
count	Integer	Number of tasks
limit	Integer	Number of records displayed on each page
offset	Integer	Offset where the query starts

**Table 17** 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
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
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 18** OpErrorInfo
Parameter	Type	Description
code	String	For details, see Error Codes.
message	String	Error message

**Table 19** 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
resource	Resource object	Resource information
restore	OpExtendInfoRestore object	Extended parameters of restoration
vault_delete	OpExtendInfoVaultDelete object	Extended parameters of deleting a vault

**Table 20** OpExtendInfoBckup
Parameter	Type	Description
backup_id	String	Backup ID. Default value: N/A
backup_name	String	Backup name. The value can contain a maximum of 64 characters, including digits, uppercase letters, lowercase letters, underscores (_), and hyphens (-). Default value: N/A
incremental	String	Whether incremental backup is used

**Table 21** OpExtendInfoCommon
Parameter	Type	Description
progress	Integer	Progress of the query task. The value ranges from 0 to 100.
request_id	String	Request ID
task_id	String	Backup task ID

**Table 22** OpExtendInfoDelete
Parameter	Type	Description
backup_id	String	Backup ID. Default value: N/A
backup_name	String	Backup name. The value can contain a maximum of 64 characters, including digits, uppercase letters, lowercase letters, underscores (_), and hyphens (-). Default value: N/A

**Table 23** 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 failed to be synchronized

**Table 24** OpExtendInfoRemoveResources
Parameter	Type	Description
fail_count	Integer	Number of resources that fail to be deleted
total_count	Integer	Number of deleted backups
resources	Array of Resource objects	Resource information

**Table 25** Resource
Parameter	Type	Description
id	String	ID of the resource to be backed up. The resource must have been associated with the vault and can be backed up. Default value: N/A
name	String	Name of the resource to be backed up. The value can contain a maximum of 255 characters. Default value: N/A
type	String	Type of the resource to be backed up: OS::Nova::Server: ECS; OS::Cinder::Volume: EVS disks; OS::Sfs::Turbo: SFS Turbo file systems Default value: N/A

**Table 26** OpExtendInfoRestore
Parameter	Type	Description
backup_id	String	ID of the backup replica. Default value: N/A
backup_name	String	Backup name. The value can contain a maximum of 64 characters, including digits, uppercase letters, lowercase letters, underscores (_), and hyphens (-). Default value: N/A
target_resource_id	String	Target resource ID in UUID format. Default value: N/A
target_resource_name	String	Name of the resource to be restored

**Table 27** OpExtendInfoVaultDelete
Parameter	Type	Description
fail_count	Integer	Number of resources that fail to be deleted in this task
total_count	Integer	Number of backups deleted in this task

Example Requests

GET https://{endpoint}/v3/{project_id}/operation-logs

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.584+00:00",
    "error_info" : {
      "message" : "",
      "code" : ""
    },
    "started_at" : "2019-05-23T14:31:36.007+00:00",
    "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.511+00:00",
    "created_at" : "2019-05-23T14:31:36.039+00:00",
    "operation_type" : "backup",
    "project_id" : "04f1829c788037ac2fb8c01eb2b04b95"
  } ]
}