Help Center/ Tag Management Service/ API Reference/ API Description/ Services Supported by Tag Management Service/ Querying Services Supported by TMS

Updated on 2026-07-30 GMT+08:00

View PDF

Querying Services Supported by TMS

Function

This API is used to query services supported by TMS.

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, no identity policy-based permission required for calling this API.

URI

GET /v1.0/tms/providers

**Table 1** Query Parameters
Parameter	Mandatory	Type	Description
locale	No	String	Definition Display language. Constraints N/A Range zh-cn: Chinese en-us: English. Default Value zh-cn
limit	No	Integer	Definition Number of records returned by a query. Constraints N/A Range 1–200 Default Value 10
offset	No	Integer	Definition Index position. The query starts from the next piece of data indexed by this parameter. Constraints N/A Range ≥ 0 Default Value 0
provider	No	String	Definition Cloud service name. Cloud service names can be found on the Huawei Cloud official website, for example, ecs, vpc, and elb. Constraints N/A Range N/A Default Value N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition User token. For details about how to obtain it, see Authentication. Constraints TMS is a global service. Set scope to domain when you call the IAM API to obtain a user token. Range N/A Default Value N/A

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
providers	Array of ProviderResponseBody objects	Definition Cloud service list. Each element contains the cloud service name (provider), internationalized service name (provider_i18n_display_name), and resource types (resource_types).
total_count	Integer	Definition Total number of supported cloud services. Range N/A

**Table 4** ProviderResponseBody
Parameter	Type	Description
provider	String	Definition Cloud service name. Cloud service names can be found on the Huawei Cloud official website, for example, ecs, vpc, and elb. Range N/A
provider_i18n_display_name	String	Definition Internationalized name of a service. Range N/A
resource_types	Array of ResourceTypeBody objects	Definition Resource type list. Each element contains the resource type (resource_type), internationalized resource type name (resource_type_i18n_display_name), supported regions (regions), and whether the resource is a global resource (global).

**Table 5** ResourceTypeBody
Parameter	Type	Description
resource_type	String	Definition Resource type. Range N/A
resource_type_i18n_display_name	String	Definition Internationalized name of a resource type. Range N/A
regions	Array of strings	Definition List of supported regions. Example: cn-north-1 and cn-north-4.
global	Boolean	Definition Whether a resource is a global resource. Range true: a global service. false: not a global service.

Status code: 400

**Table 6** Response body parameters
Parameter	Type	Description
error	RespErrorMessage object	Definition Error message in the response.

**Table 7** RespErrorMessage
Parameter	Type	Description
error_code	String	Definition Error code. For details about the error codes of the corresponding cloud service, see Error Codes. Range N/A
error_msg	String	Definition Error description. Range N/A

Status code: 401

**Table 8** Response body parameters
Parameter	Type	Description
error	RespErrorMessage object	Definition Error message in the response.

**Table 9** RespErrorMessage
Parameter	Type	Description
error_code	String	Definition Error code. For details about the error codes of the corresponding cloud service, see Error Codes. Range N/A
error_msg	String	Definition Error description. Range N/A

Status code: 402

**Table 10** Response body parameters
Parameter	Type	Description
error	RespErrorMessage object	Definition Error message in the response.

**Table 11** RespErrorMessage
Parameter	Type	Description
error_code	String	Definition Error code. For details about the error codes of the corresponding cloud service, see Error Codes. Range N/A
error_msg	String	Definition Error description. Range N/A

Status code: 403

**Table 12** Response body parameters
Parameter	Type	Description
error	RespErrorMessage object	Definition Error message in the response.

**Table 13** RespErrorMessage
Parameter	Type	Description
error_code	String	Definition Error code. For details about the error codes of the corresponding cloud service, see Error Codes. Range N/A
error_msg	String	Definition Error description. Range N/A

Status code: 404

**Table 14** Response body parameters
Parameter	Type	Description
error	RespErrorMessage object	Definition Error message in the response.

**Table 15** RespErrorMessage
Parameter	Type	Description
error_code	String	Definition Error code. For details about the error codes of the corresponding cloud service, see Error Codes. Range N/A
error_msg	String	Definition Error description. Range N/A

Status code: 405

**Table 16** Response body parameters
Parameter	Type	Description
error	RespErrorMessage object	Definition Error message in the response.

**Table 17** RespErrorMessage
Parameter	Type	Description
error_code	String	Definition Error code. For details about the error codes of the corresponding cloud service, see Error Codes. Range N/A
error_msg	String	Definition Error description. Range N/A

Status code: 406

**Table 18** Response body parameters
Parameter	Type	Description
error	RespErrorMessage object	Definition Error message in the response.

**Table 19** RespErrorMessage
Parameter	Type	Description
error_code	String	Definition Error code. For details about the error codes of the corresponding cloud service, see Error Codes. Range N/A
error_msg	String	Definition Error description. Range N/A

Status code: 407

**Table 20** Response body parameters
Parameter	Type	Description
error	RespErrorMessage object	Definition Error message in the response.

**Table 21** RespErrorMessage
Parameter	Type	Description
error_code	String	Definition Error code. For details about the error codes of the corresponding cloud service, see Error Codes. Range N/A
error_msg	String	Definition Error description. Range N/A

Status code: 408

**Table 22** Response body parameters
Parameter	Type	Description
error	RespErrorMessage object	Definition Error message in the response.

**Table 23** RespErrorMessage
Parameter	Type	Description
error_code	String	Definition Error code. For details about the error codes of the corresponding cloud service, see Error Codes. Range N/A
error_msg	String	Definition Error description. Range N/A

Status code: 409

**Table 24** Response body parameters
Parameter	Type	Description
error	RespErrorMessage object	Definition Error message in the response.

**Table 25** RespErrorMessage
Parameter	Type	Description
error_code	String	Definition Error code. For details about the error codes of the corresponding cloud service, see Error Codes. Range N/A
error_msg	String	Definition Error description. Range N/A

Status code: 500

**Table 26** Response body parameters
Parameter	Type	Description
error	RespErrorMessage object	Definition Error message in the response.

**Table 27** RespErrorMessage
Parameter	Type	Description
error_code	String	Definition Error code. For details about the error codes of the corresponding cloud service, see Error Codes. Range N/A
error_msg	String	Definition Error description. Range N/A

Status code: 501

**Table 28** Response body parameters
Parameter	Type	Description
error	RespErrorMessage object	Definition Error message in the response.

**Table 29** RespErrorMessage
Parameter	Type	Description
error_code	String	Definition Error code. For details about the error codes of the corresponding cloud service, see Error Codes. Range N/A
error_msg	String	Definition Error description. Range N/A

Status code: 502

**Table 30** Response body parameters
Parameter	Type	Description
error	RespErrorMessage object	Definition Error message in the response.

**Table 31** RespErrorMessage
Parameter	Type	Description
error_code	String	Definition Error code. For details about the error codes of the corresponding cloud service, see Error Codes. Range N/A
error_msg	String	Definition Error description. Range N/A

Status code: 503

**Table 32** Response body parameters
Parameter	Type	Description
error	RespErrorMessage object	Definition Error message in the response.

**Table 33** RespErrorMessage
Parameter	Type	Description
error_code	String	Definition Error code. For details about the error codes of the corresponding cloud service, see Error Codes. Range N/A
error_msg	String	Definition Error description. Range N/A

Status code: 504

**Table 34** Response body parameters
Parameter	Type	Description
error	RespErrorMessage object	Definition Error message in the response.

**Table 35** RespErrorMessage
Parameter	Type	Description
error_code	String	Definition Error code. For details about the error codes of the corresponding cloud service, see Error Codes. Range N/A
error_msg	String	Definition Error description. Range N/A

Example Requests

None

Example Responses

Status code: 200

{
  "providers" : [ {
    "provider" : "evs",
    "provider_i18n_display_name" : "Elastic Volume Service",
    "resource_types" : [ {
      "resource_type_i18n_display_name" : "EVS-Disk",
      "global" : false,
      "resource_type" : "disk",
      "regions" : [ "regionId1" ]
    } ]
  } ],
  "total_count" : 1
}

SDK Sample Code

The SDK sample code is as follows.

Java

     package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.GlobalCredentials;
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.tms.v1.region.TmsRegion;
import com.huaweicloud.sdk.tms.v1.*;
import com.huaweicloud.sdk.tms.v1.model.*;


public class ListProvidersSolution {

    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");

        ICredential auth = new GlobalCredentials()
                .withAk(ak)
                .withSk(sk);

        TmsClient client = TmsClient.newBuilder()
                .withCredential(auth)
                .withRegion(TmsRegion.valueOf("<YOUR REGION>"))
                .build();
        ListProvidersRequest request = new ListProvidersRequest();
        try {
            ListProvidersResponse response = client.listProviders(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());
        }
    }
}
 
 
  

Python

     # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import GlobalCredentials
from huaweicloudsdktms.v1.region.tms_region import TmsRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdktms.v1 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"]

    credentials = GlobalCredentials(ak, sk)

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

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

Go

     package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/global"
    tms "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/tms/v1"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/tms/v1/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/tms/v1/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")

    auth, err := global.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        SafeBuild()

    if err != nil {
        fmt.Println(err)
        return
    }

    hcClient, err := tms.TmsClientBuilder().
         WithRegion(region.ValueOf("<YOUR REGION>")).
         WithCredential(auth).
         SafeBuild()


    if err != nil {
        fmt.Println(err)
        return
    }

    client := tms.NewTmsClient(hcClient)

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

For SDK sample code of more programming languages, see the Sample Code tab in API Explorer. SDK sample code can be automatically generated.

Status Codes

Status Code	Description
200	OK
400	Bad Request
401	Unauthorized
402	Payment Required
403	Forbidden
404	Not Found
405	Method Not Allowed
406	Not Acceptable
407	Proxy Authentication Required
408	Request Timeout
409	Conflict
500	Internal Server Error
501	Not Implemented
502	Bad Gateway
503	Service Unavailable
504	Gateway Timeout