Help Center/ MapReduce Service/ API Reference/ API V1.1/ Tag Management APIs/ Querying a List of Clusters with Specified Tags - ListClustersByTags
Updated on 2026-09-15 GMT+08:00
View PDF
Share

Querying a List of Clusters with Specified Tags - ListClustersByTags

Function

This API is used to query a list of MRS clusters by using tags as filters. It supports filtering by multiple tags, where the relationship between tags is AND. By default, clusters are sorted in descending order of creation time, allowing you to quickly locate target clusters by tags.

Constraints

None

Debugging

You can debug this API in API Explorer. Automatic authentication is supported. API Explorer can automatically generate sample SDK code and supports sample SDK code debugging.

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 permissions are required for calling this API.

URI

POST /v1.1/{project_id}/clusters/resource_instances/action
Table 1 URI parameter

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.

Constraints

N/A

Range

The value must consist of 1 to 64 characters. Only letters and digits are allowed.

Default Value

N/A

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

tags

No

Array of TagWithMultiValue objects

Definition

The returned results include resources corresponding to all tags in this parameter. For detailed parameter descriptions, see the parameter details list.

Constraints

This parameter can contain up to 10 keys, with up to 10 values per key. The structure must not be missing, and the key must not be left blank or an empty string.

Range

N/A

Default Value

N/A

tags_any

No

Array of TagWithMultiValue objects

Definition

The returned results include resources corresponding to any tag in this parameter. For detailed parameter descriptions, see the parameter details list.

Constraints

This parameter can contain up to 10 keys, with up to 10 values per key. The structure must not be missing, and the key must not be left blank or an empty string. Keys must be unique, and values within the same key must be unique.

Range

N/A

Default Value

N/A

not_tags

No

Array of TagWithMultiValue objects

Definition

The returned results do not include resources corresponding to all tags in this parameter. For detailed parameter descriptions, see the parameter details list.

Constraints

This parameter can contain up to 10 keys, with up to 10 values per key. The structure must not be missing, and the key must not be left blank or an empty string. Keys must be unique, and values within the same key must be unique.

Range

N/A

Default Value

N/A

not_tags_any

No

Array of TagWithMultiValue objects

Definition

The returned results do not include resources corresponding to any tag in this parameter. For detailed parameter descriptions, see the parameter details list.

Constraints

This parameter can contain up to 10 keys, with up to 10 values per key. The structure must not be missing, and the key must not be left blank or an empty string. Keys must be unique, and values within the same key must be unique.

Range

N/A

Default Value

N/A

action

Yes

String

Definition

Operation ID (only filter and count is available). If filter, it is a paginated query. If count, the total number of records is returned based on the conditions.

Constraints

N/A

Range

  • filter: Perform paginated query.

  • count: Query the total number of records.

Default Value

N/A

limit

No

Integer

Definition

Number of records to query.

Constraints

This parameter is not available when action is count. If action is filter, the default value is 1000.

Range

1-1000

Default Value

N/A

offset

No

Integer

Definition

Index position. The query starts from the next record after the specified offset. When querying the first page of data, this parameter does not need to be passed. When querying subsequent pages, pass the value from the response body of the previous page query into this parameter.

Constraints

This parameter is not available when action is count. If action is filter, the default value is 0.

Range

≥0

Default Value

N/A

matches

No

Array of Match objects

Definition

Search fields. The key is the field to match, such as resource_name. The value is the matching value. This field is a fixed dictionary value. Whether fuzzy match is required depends on the field. For example, resource_name defaults to fuzzy search. If the value is an empty string, exact match is used.

Constraints

N/A

Range

N/A

Default Value

N/A
Table 3 TagWithMultiValue

Parameter

Mandatory

Type

Description

key

Yes

String

Definition

Key name of a cluster tag.

Constraints

N/A

Range

The tag key can contain letters, digits, spaces, and the special characters (_.:=+-@). However, they must not start or end with a space, must not start with _sys_, and the length must be 1 to 128 characters.

Default Value

N/A

values

No

Array of strings

Definition

Value of the cluster tag key. Multiple tag parameters can be configured for the query.

Constraints

The tag value can contain letters, digits, spaces, and the special characters (_.:=+-@). However, they must not start or end with a space, must not start with _sys_, and the length must be 1 to 128 characters.

Range

N/A

Default Value

N/A
Table 4 Match

Parameter

Mandatory

Type

Description

key

No

String

Definition

Key. Currently, only resource_name is available, indicating the cluster name. Other keys will be supported later.

Constraints

N/A

Range

The value can contain 1 to 64 characters.

Default Value

N/A

value

No

String

Definition

Value. A value can contain a maximum of 64 Unicode characters.

Constraints

N/A

Range

The value can contain 0 to 64 characters.

Default Value

N/A

Response Parameters

Status code: 200

Table 5 Response parameter descriptions

Parameter

Type

Description

resources

Array of MRSResource objects

Definition

Resource list. For detailed parameter descriptions, see the parameter details list.

Range

N/A

total_count

Integer

Definition

Total number of resources.

Range

N/A
Table 6 MRSResource

Parameter

Type

Description

resource_id

String

Definition

MRS cluster ID.

Range

N/A

resource_detail

String

Definition

Resource details.

Range

N/A

tags

Array of TagPlain objects

Definition

Tags. For detailed parameter descriptions, see the parameter details list.

Range

N/A

resource_name

String

Definition

MRS cluster name.

Range

N/A
Table 7 TagPlain

Parameter

Type

Description

key

String

Definition

Tag key.

Range

The tag key can contain letters, digits, spaces, and the special characters (_.:=+-@). However, they must not start or end with a space, must not start with _sys_, and the length must be 1 to 128 characters.

value

String

Definition

Cluster tag value.

Range

The tag value can contain letters, digits, spaces, and the special characters (_.:=+-@). However, they must not start or end with a space, must not start with _sys_, and the length must be 1 to 128 characters.

Example Request

  • List clusters when action is set to filter. 
    POST https://{endpoint}/v1.1/{project_id}/{resource_type}/resource_instances/action

{
  "offset" : 100,
  "limit" : 100,
  "action" : "filter",
  "matches" : [ {
    "key" : "resource_name",
    "value" : "clusterA"
  } ],
  "not_tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "tags_any" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "not_tags_any" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ]
}
  • List clusters when action is set to count. 
    POST https://{endpoint}/v1.1/{project_id}/{resource_type}/resource_instances/action

{
  "action" : "count",
  "not_tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  }, {
    "key" : "key2",
    "values" : [ "value1", "value2" ]
  } ],
  "tags_any" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "not_tags_any" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "matches" : [ {
    "key" : "resource_name",
    "value" : "clusterA"
  } ]
}

Example Response

Status code: 200

The operation is successful.

{
  "resources" : [ {
    "resource_detail" : null,
    "resource_id" : "cdfs_cefs_wesas_12_dsad",
    "resource_name" : "clusterA",
    "tags" : [ {
      "key" : "key1",
      "value" : "value1"
    }, {
      "key" : "key2",
      "value" : "value1"
    } ]
  } ],
  "total_count" : "1000"
}

SDK Sample Code

The SDK sample code is as follows.

  • List clusters when action is set to filter.

      1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
    		 
    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.mrs.v1.region.MrsRegion;
import com.huaweicloud.sdk.mrs.v1.*;
import com.huaweicloud.sdk.mrs.v1.model.*;

import java.util.List;
import java.util.ArrayList;

public class ListClustersByTagsSolution {

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

        MrsClient client = MrsClient.newBuilder()
                .withCredential(auth)
                .withRegion(MrsRegion.valueOf("<YOUR REGION>"))
                .build();
        ListClustersByTagsRequest request = new ListClustersByTagsRequest();
        ListResourceReq body = new ListResourceReq();
        List<Match> listbodyMatches = new ArrayList<>();
        listbodyMatches.add(
            new Match()
                .withKey("resource_name")
                .withValue("clusterA")
        );
        List<String> listNotTagsAnyValues = new ArrayList<>();
        listNotTagsAnyValues.add("value1");
        listNotTagsAnyValues.add("value2");
        List<TagWithMultiValue> listbodyNotTagsAny = new ArrayList<>();
        listbodyNotTagsAny.add(
            new TagWithMultiValue()
                .withKey("key1")
                .withValues(listNotTagsAnyValues)
        );
        List<String> listNotTagsValues = new ArrayList<>();
        listNotTagsValues.add("value1");
        listNotTagsValues.add("value2");
        List<TagWithMultiValue> listbodyNotTags = new ArrayList<>();
        listbodyNotTags.add(
            new TagWithMultiValue()
                .withKey("key1")
                .withValues(listNotTagsValues)
        );
        List<String> listTagsAnyValues = new ArrayList<>();
        listTagsAnyValues.add("value1");
        listTagsAnyValues.add("value2");
        List<TagWithMultiValue> listbodyTagsAny = new ArrayList<>();
        listbodyTagsAny.add(
            new TagWithMultiValue()
                .withKey("key1")
                .withValues(listTagsAnyValues)
        );
        List<String> listTagsValues = new ArrayList<>();
        listTagsValues.add("value1");
        listTagsValues.add("value2");
        List<TagWithMultiValue> listbodyTags = new ArrayList<>();
        listbodyTags.add(
            new TagWithMultiValue()
                .withKey("key1")
                .withValues(listTagsValues)
        );
        body.withMatches(listbodyMatches);
        body.withOffset(100);
        body.withLimit(100);
        body.withAction(ListResourceReq.ActionEnum.fromValue("filter"));
        body.withNotTagsAny(listbodyNotTagsAny);
        body.withNotTags(listbodyNotTags);
        body.withTagsAny(listbodyTagsAny);
        body.withTags(listbodyTags);
        request.withBody(body);
        try {
            ListClustersByTagsResponse response = client.listClustersByTags(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());
        }
    }
}

  • List clusters when action is set to count.

      1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
    		 
    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.mrs.v1.region.MrsRegion;
import com.huaweicloud.sdk.mrs.v1.*;
import com.huaweicloud.sdk.mrs.v1.model.*;

import java.util.List;
import java.util.ArrayList;

public class ListClustersByTagsSolution {

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

        MrsClient client = MrsClient.newBuilder()
                .withCredential(auth)
                .withRegion(MrsRegion.valueOf("<YOUR REGION>"))
                .build();
        ListClustersByTagsRequest request = new ListClustersByTagsRequest();
        ListResourceReq body = new ListResourceReq();
        List<Match> listbodyMatches = new ArrayList<>();
        listbodyMatches.add(
            new Match()
                .withKey("resource_name")
                .withValue("clusterA")
        );
        List<String> listNotTagsAnyValues = new ArrayList<>();
        listNotTagsAnyValues.add("value1");
        listNotTagsAnyValues.add("value2");
        List<TagWithMultiValue> listbodyNotTagsAny = new ArrayList<>();
        listbodyNotTagsAny.add(
            new TagWithMultiValue()
                .withKey("key1")
                .withValues(listNotTagsAnyValues)
        );
        List<String> listNotTagsValues = new ArrayList<>();
        listNotTagsValues.add("value1");
        listNotTagsValues.add("value2");
        List<TagWithMultiValue> listbodyNotTags = new ArrayList<>();
        listbodyNotTags.add(
            new TagWithMultiValue()
                .withKey("key1")
                .withValues(listNotTagsValues)
        );
        List<String> listTagsAnyValues = new ArrayList<>();
        listTagsAnyValues.add("value1");
        listTagsAnyValues.add("value2");
        List<TagWithMultiValue> listbodyTagsAny = new ArrayList<>();
        listbodyTagsAny.add(
            new TagWithMultiValue()
                .withKey("key1")
                .withValues(listTagsAnyValues)
        );
        List<String> listTagsValues = new ArrayList<>();
        listTagsValues.add("value1");
        listTagsValues.add("value2");
        List<String> listTagsValues1 = new ArrayList<>();
        listTagsValues1.add("value1");
        listTagsValues1.add("value2");
        List<TagWithMultiValue> listbodyTags = new ArrayList<>();
        listbodyTags.add(
            new TagWithMultiValue()
                .withKey("key1")
                .withValues(listTagsValues1)
        );
        listbodyTags.add(
            new TagWithMultiValue()
                .withKey("key2")
                .withValues(listTagsValues)
        );
        body.withMatches(listbodyMatches);
        body.withAction(ListResourceReq.ActionEnum.fromValue("count"));
        body.withNotTagsAny(listbodyNotTagsAny);
        body.withNotTags(listbodyNotTags);
        body.withTagsAny(listbodyTagsAny);
        body.withTags(listbodyTags);
        request.withBody(body);
        try {
            ListClustersByTagsResponse response = client.listClustersByTags(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());
        }
    }
}

  • List clusters when action is set to filter.

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
    		 
    # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkmrs.v1.region.mrs_region import MrsRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkmrs.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"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

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

    try:
        request = ListClustersByTagsRequest()
        listMatchesbody = [
            Match(
                key="resource_name",
                value="clusterA"
            )
        ]
        listValuesNotTagsAny = [
            "value1",
            "value2"
        ]
        listNotTagsAnybody = [
            TagWithMultiValue(
                key="key1",
                values=listValuesNotTagsAny
            )
        ]
        listValuesNotTags = [
            "value1",
            "value2"
        ]
        listNotTagsbody = [
            TagWithMultiValue(
                key="key1",
                values=listValuesNotTags
            )
        ]
        listValuesTagsAny = [
            "value1",
            "value2"
        ]
        listTagsAnybody = [
            TagWithMultiValue(
                key="key1",
                values=listValuesTagsAny
            )
        ]
        listValuesTags = [
            "value1",
            "value2"
        ]
        listTagsbody = [
            TagWithMultiValue(
                key="key1",
                values=listValuesTags
            )
        ]
        request.body = ListResourceReq(
            matches=listMatchesbody,
            offset=100,
            limit=100,
            action="filter",
            not_tags_any=listNotTagsAnybody,
            not_tags=listNotTagsbody,
            tags_any=listTagsAnybody,
            tags=listTagsbody
        )
        response = client.list_clusters_by_tags(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

  • List clusters when action is set to count.

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
    		 
    # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkmrs.v1.region.mrs_region import MrsRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkmrs.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"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

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

    try:
        request = ListClustersByTagsRequest()
        listMatchesbody = [
            Match(
                key="resource_name",
                value="clusterA"
            )
        ]
        listValuesNotTagsAny = [
            "value1",
            "value2"
        ]
        listNotTagsAnybody = [
            TagWithMultiValue(
                key="key1",
                values=listValuesNotTagsAny
            )
        ]
        listValuesNotTags = [
            "value1",
            "value2"
        ]
        listNotTagsbody = [
            TagWithMultiValue(
                key="key1",
                values=listValuesNotTags
            )
        ]
        listValuesTagsAny = [
            "value1",
            "value2"
        ]
        listTagsAnybody = [
            TagWithMultiValue(
                key="key1",
                values=listValuesTagsAny
            )
        ]
        listValuesTags = [
            "value1",
            "value2"
        ]
        listValuesTags1 = [
            "value1",
            "value2"
        ]
        listTagsbody = [
            TagWithMultiValue(
                key="key1",
                values=listValuesTags1
            ),
            TagWithMultiValue(
                key="key2",
                values=listValuesTags
            )
        ]
        request.body = ListResourceReq(
            matches=listMatchesbody,
            action="count",
            not_tags_any=listNotTagsAnybody,
            not_tags=listNotTagsbody,
            tags_any=listTagsAnybody,
            tags=listTagsbody
        )
        response = client.list_clusters_by_tags(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

  • List clusters when action is set to filter.

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
    		 
    package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    mrs "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/mrs/v1"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/mrs/v1/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/mrs/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")
    projectId := "{project_id}"

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

    client := mrs.NewMrsClient(
        mrs.MrsClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListClustersByTagsRequest{}
	keyMatches:= "resource_name"
	valueMatches:= "clusterA"
	var listMatchesbody = []model.Match{
        {
            Key: &keyMatches,
            Value: &valueMatches,
        },
    }
	var listValuesNotTagsAny = []string{
        "value1",
	    "value2",
    }
	var listNotTagsAnybody = []model.TagWithMultiValue{
        {
            Key: "key1",
            Values: &listValuesNotTagsAny,
        },
    }
	var listValuesNotTags = []string{
        "value1",
	    "value2",
    }
	var listNotTagsbody = []model.TagWithMultiValue{
        {
            Key: "key1",
            Values: &listValuesNotTags,
        },
    }
	var listValuesTagsAny = []string{
        "value1",
	    "value2",
    }
	var listTagsAnybody = []model.TagWithMultiValue{
        {
            Key: "key1",
            Values: &listValuesTagsAny,
        },
    }
	var listValuesTags = []string{
        "value1",
	    "value2",
    }
	var listTagsbody = []model.TagWithMultiValue{
        {
            Key: "key1",
            Values: &listValuesTags,
        },
    }
	offsetListResourceReq:= int32(100)
	limitListResourceReq:= int32(100)
	request.Body = &model.ListResourceReq{
		Matches: &listMatchesbody,
		Offset: &offsetListResourceReq,
		Limit: &limitListResourceReq,
		Action: model.GetListResourceReqActionEnum().FILTER,
		NotTagsAny: &listNotTagsAnybody,
		NotTags: &listNotTagsbody,
		TagsAny: &listTagsAnybody,
		Tags: &listTagsbody,
	}
	response, err := client.ListClustersByTags(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

  • List clusters when action is set to count.

      1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
    		 
    package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    mrs "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/mrs/v1"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/mrs/v1/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/mrs/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")
    projectId := "{project_id}"

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

    client := mrs.NewMrsClient(
        mrs.MrsClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListClustersByTagsRequest{}
	keyMatches:= "resource_name"
	valueMatches:= "clusterA"
	var listMatchesbody = []model.Match{
        {
            Key: &keyMatches,
            Value: &valueMatches,
        },
    }
	var listValuesNotTagsAny = []string{
        "value1",
	    "value2",
    }
	var listNotTagsAnybody = []model.TagWithMultiValue{
        {
            Key: "key1",
            Values: &listValuesNotTagsAny,
        },
    }
	var listValuesNotTags = []string{
        "value1",
	    "value2",
    }
	var listNotTagsbody = []model.TagWithMultiValue{
        {
            Key: "key1",
            Values: &listValuesNotTags,
        },
    }
	var listValuesTagsAny = []string{
        "value1",
	    "value2",
    }
	var listTagsAnybody = []model.TagWithMultiValue{
        {
            Key: "key1",
            Values: &listValuesTagsAny,
        },
    }
	var listValuesTags = []string{
        "value1",
	    "value2",
    }
	var listValuesTags1 = []string{
        "value1",
	    "value2",
    }
	var listTagsbody = []model.TagWithMultiValue{
        {
            Key: "key1",
            Values: &listValuesTags1,
        },
        {
            Key: "key2",
            Values: &listValuesTags,
        },
    }
	request.Body = &model.ListResourceReq{
		Matches: &listMatchesbody,
		Action: model.GetListResourceReqActionEnum().COUNT,
		NotTagsAny: &listNotTagsAnybody,
		NotTags: &listNotTagsbody,
		TagsAny: &listTagsAnybody,
		Tags: &listTagsbody,
	}
	response, err := client.ListClustersByTags(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

Operation succeeded.

Error Codes

See Error Codes.

Parent Topic: Tag Management APIs