Querying the Task List in the Task Center

Function

This API is used to query the task list in the task center.

Calling Method

For details, see Calling APIs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.

If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
dcs:task:list	List	-	-	-	-

URI

GET /v2/{project_id}/tasks

**Table 1** Path Parameters
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

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
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
start_time	No	String	Definition Query start time. Constraints The time is in the UTC format. Format: yyyyMMddHHmmss, for example, 20200609160000. Range N/A Default Value N/A
end_time	No	String	Definition Query end time. Constraints The time is in the UTC format. Format: yyyyMMddHHmmss, for example, 20200609160000. Range N/A Default Value N/A

Request Parameters

None

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
task_count	String	Definition Number of tasks. Range N/A
tasks	Array of ListCenterTasksResp objects	Definition Array of task details in the task center.

**Table 4** ListCenterTasksResp
Parameter	Type	Description
id	String	Definition Background task ID. Range N/A
name	String	Definition Background task name. Range EXTEND: modifying specifications BindEip: enabling public access UnBindEip: disabling public access AddReplica: adding replicas DelReplica: deleting replicas AddWhitelist: configuring an IP whitelist UpdatePort: changing the port RemoveIpFromDns: removing IP addresses masterStandbySwapJob: master/standby switchover modify: changing the password
details	DetailsBody object	Definition Details.
user_name	String	Definition Username. Range N/A
user_id	String	Definition User ID. Range N/A
params	String	Definition Task parameters. Range N/A
status	String	Definition Task status. Range N/A
created_at	String	Definition Task start time, in the format 2020-06-17T07:38:42.503Z. Range N/A
updated_at	String	Definition Task end time, in the format 2020-06-17T07:38:42.503Z. Range N/A
error_code	String	Definition Error code. Range N/A
enable_show	Boolean	Definition Task details that can be expanded. Range true: Detailed progress is available. false: No detailed progress is available.
job_id	String	Definition Task ID. Range N/A

**Table 5** DetailsBody
Parameter	Type	Description
old_capacity	String	Definition Capacity before the modification. This parameter has a value only when the specifications are modified. Range N/A
new_capacity	String	Definition Capacity after the modification. This parameter has a value only when the specifications are modified. Range N/A
enable_public_ip	Boolean	Definition Indicates whether public access has been enabled. Range true: Yes false: No
public_ip_id	String	Definition Public IP address ID. Range N/A
public_ip_address	String	Definition Public IP address. Range N/A
enable_ssl	Boolean	Definition Whether SSL is enabled. Range true: Yes false: No
old_cache_mode	String	Definition Cache type before the modification. This parameter has a value only when the specifications are modified. Range N/A
new_cache_mode	String	Definition Cache type after the modification. This parameter has a value only when the specifications are modified. Range N/A
old_resource_spec_code	String	Definition Specification parameter before the modification. This parameter has a value only when the specifications are modified. Range N/A
new_resource_spec_code	String	Definition Specification parameter after the modification. This parameter has a value only when the specifications are modified. Range N/A
old_replica_num	Integer	Definition Number of replicas before the modification. This parameter has a value only when the specifications are modified. Range N/A
new_replica_num	Integer	Definition Number of replicas after the modification. This parameter has a value only when the specifications are modified. Range N/A
old_cache_type	String	Definition Cache type before the modification. This parameter has a value only when the specifications are modified. Range N/A
new_cache_type	String	Definition Specification type after the modification. This parameter has a value only when the specifications are modified. Range N/A
replica_ip	String	Definition Replica IP address. Range N/A
replica_az	String	Definition AZ where the replica is in. Range N/A
group_name	String	Definition Instance shard group name. Range N/A
old_port	Integer	Definition Old port. Range N/A
new_port	Integer	Definition New port. Range N/A
is_only_adjust_charging	Boolean	Definition Indicates whether to only change the billing mode. Range true: Yes false: No. Other changes are made or the billing mode is not changed.
account_name	String	Definition Account name. Range N/A
source_ip	String	Definition Source IP address. Range N/A
target_ip	String	Definition Target IP address. Range N/A
node_name	String	Definition Node information. Range N/A
rename_commands	Array of strings	Definition Renamed command.
updated_config_length	Integer	Definition Length of the updated configuration item. Range N/A

Status code: 400

**Table 6** Response body parameters
Parameter	Type	Description
error_msg	String	Definition Error information. 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

**Table 7** Response body parameters
Parameter	Type	Description
error_msg	String	Definition Error information. 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}/tasks

Example Responses

Status code: 200

Successfully queried the task list in the task center.

{
  "task_count" : 2,
  "tasks" : [ {
    "id" : "8abf6e1e72c12e7c0172c15b508500aa",
    "name" : "ChangeInstanceSpec",
    "job_id" : "8abf6e1e87bce0740187bd32748b0530",
    "user_name" : "paas_dcs_a00421997_02",
    "user_id" : "d53977d1adfb49c5b025ba7d33a13fd7",
    "details" : {
      "old_cache_mode" : "single",
      "new_cache_mode" : "single",
      "old_capacity" : 0.125,
      "new_capacity" : 0.25
    },
    "status" : "SUCCESS",
    "created_at" : "2023-06-17T08:18:06.597Z",
    "updated_at" : "2023-06-17T08:18:10.106Z",
    "error_code" : "111400063",
    "enable_show" : true
  }, {
    "id" : "ff80808188bfde180188c36bb9ca4a30",
    "name" : "dcsExportJob",
    "job_id" : "ff80808188bfde180188c36bb9c44a2f",
    "user_name" : "paas_dcs_004_01",
    "user_id" : "bb259bd2b8b644a1b4a573a20318af51",
    "details" : null,
    "status" : "SUCCESS",
    "created_at" : "2023-06-17T08:18:06.597Z",
    "updated_at" : "2023-06-17T08:18:10.106Z",
    "error_code" : "111400063",
    "enable_show" : true
  } ]
}

SDK Sample Code

The SDK sample code is as follows.

      
       
         
         
           package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.dcs.v2.region.DcsRegion;
import com.huaweicloud.sdk.dcs.v2.*;
import com.huaweicloud.sdk.dcs.v2.model.*;


public class ListCenterTaskSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        DcsClient client = DcsClient.newBuilder()
                .withCredential(auth)
                .withRegion(DcsRegion.valueOf("<YOUR REGION>"))
                .build();
        ListCenterTaskRequest request = new ListCenterTaskRequest();
        try {
            ListCenterTaskResponse response = client.listCenterTask(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

          

        

      
     

      
       
         
         
           # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkdcs.v2.region.dcs_region import DcsRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkdcs.v2 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = DcsClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(DcsRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ListCenterTaskRequest()
        response = client.list_center_task(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

          

        

      
     

      
       
         
         
           package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    dcs "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dcs/v2"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dcs/v2/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dcs/v2/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := dcs.NewDcsClient(
        dcs.DcsClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListCenterTaskRequest{}
	response, err := client.ListCenterTask(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

          

        

      
     