调用DescribeDynamicTagRuleList接口查询智能标签的规则列表。

本文将提供一个示例,查找标签键tagkey1的规则列表。返回结果显示,共有2条规则,规则ID分别为1536df65-a719-429d-8813-73cc40d7****56e8cebb-b3d7-4a91-9880-78a8c84f****

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeDynamicTagRuleList

要执行的操作,取值:DescribeDynamicTagRuleList。

TagRegionId String cn-hangzhou

标签归属的地域ID。

TagKey String tagkey1

标签键。

关于如何获取标签键,请参见DescribeTagKeyList

TagValue String *

标签值。

关于如何获取标签值,请参见DescribeTagValueList

PageNumber String 1

页码。

起始值:1。默认值:1。

PageSize String 30

分页时每页显示的数据行数。

起始值:1。默认值:30。

关于公共请求参数的详情,请参见公共参数

返回数据

名称 类型 示例值 描述
Code String 200

状态码。

说明 200表示成功。
Message String The specified resource is not found.

错误信息。

PageNumber String 1

页码。

PageSize String 30

分页时每页显示的数据行数。

RequestId String 0D50523D-8D59-4A61-B58E-E2286ECFB3A9

请求ID。

Success Boolean true

操作是否成功。取值:

  • true:成功。
  • false:失败。
TagGroupList Array of TagGroup

应用分组的规则列表。

TagGroup
ContactGroupList List CloudMonitor

报警联系组。

DynamicTagRuleId String 1536df65-a719-429d-8813-73cc40d7****

标签规则ID。

MatchExpress Array of MatchExpress

标签生成应用分组的匹配表达式。

MatchExpress
TagValue String *

标签值。

TagValueTagValueMatchFunction配合使用。

TagValueMatchFunction String all

标签值的匹配方法。取值:

  • all:全部。
  • startWith:前缀。
  • endWith:后缀。
  • contains:包含。
  • notContains:不包含。
  • equals:相等。
MatchExpressFilterRelation String or

条件表达式之间的关系。取值:

  • and:和。
  • or:或。
说明 目前仅支持一种组合条件。
RegionId String cn-hangzhou

资源所属的地域ID。

Status String FINISH

标签同步到应用分组的状态。

  • RUNNING:进行中。
  • FINISH:已完成。
TagKey String tagkey1

标签键。

TemplateIdList List 71****

报警模板ID。

Total Integer 2

标签列表的条目总数。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeDynamicTagRuleList
&<公共请求参数>
&=tagkey1

正常返回示例

XML格式

<DescribeDynamicTagRuleListResponse>
	  <PageSize>30</PageSize>
	  <PageNumber>1</PageNumber>
	  <Total>2</Total>
	  <TagGroupList>
		    <TagGroup>
			      <Status>FINISH</Status>
			      <ContactGroupList>
				        <ContactGroupList>CloudMonitor</ContactGroupList>
			      </ContactGroupList>
			      <MatchExpressFilterRelation>or</MatchExpressFilterRelation>
			      <DynamicTagRuleId>1536df65-a719-429d-8813-73cc40d7****</DynamicTagRuleId>
			      <TemplateIdList>
				        <TemplateIdList>71****</TemplateIdList>
			      </TemplateIdList>
			      <TagKey>tagkey1</TagKey>
			      <MatchExpress>
				        <MatchExpress>
					          <TagValue>*</TagValue>
					          <TagValueMatchFunction>all</TagValueMatchFunction>
				        </MatchExpress>
			      </MatchExpress>
			      <RegionId>cn-hangzhou</RegionId>
		    </TagGroup>
		    <TagGroup>
			      <Status>FINISH</Status>
			      <ContactGroupList>
				        <ContactGroupList>CloudMonitor</ContactGroupList>
			      </ContactGroupList>
			      <MatchExpressFilterRelation>or</MatchExpressFilterRelation>
			      <DynamicTagRuleId>56e8cebb-b3d7-4a91-9880-78a8c84f****</DynamicTagRuleId>
			      <TemplateIdList>
				        <TemplateIdList>71****</TemplateIdList>
			      </TemplateIdList>
			      <TagKey>tagkey1</TagKey>
			      <MatchExpress>
				        <MatchExpress>
					          <TagValue>*</TagValue>
					          <TagValueMatchFunction>all</TagValueMatchFunction>
				        </MatchExpress>
			      </MatchExpress>
			      <RegionId>cn-hangzhou</RegionId>
		    </TagGroup>
	  </TagGroupList>
	  <Code>200</Code>
	  <Success>true</Success>
</DescribeDynamicTagRuleListResponse>

JSON格式

{
    "PageSize": 30,
    "PageNumber": 1,
    "Total": 2,
    "TagGroupList": {
        "TagGroup": [
            {
                "Status": "FINISH",
                "ContactGroupList": {
                    "ContactGroupList": [
                        "CloudMonitor"
                    ]
                },
                "MatchExpressFilterRelation": "or",
                "DynamicTagRuleId": "1536df65-a719-429d-8813-73cc40d7****",
                "TemplateIdList": {
                    "TemplateIdList": "71****"
                },
                "TagKey": "tagkey1",
                "MatchExpress": {
                    "MatchExpress": [
                        {
                            "TagValue": "*",
                            "TagValueMatchFunction": "all"
                        }
                    ]
                },
                "RegionId": "cn-hangzhou"
            },
            {
                "Status": "FINISH",
                "ContactGroupList": {
                    "ContactGroupList": [
                        "CloudMonitor"
                    ]
                },
                "MatchExpressFilterRelation": "or",
                "DynamicTagRuleId": "56e8cebb-b3d7-4a91-9880-78a8c84f****",
                "TemplateIdList": {
                    "TemplateIdList": "71****"
                },
                "TagKey": "tagkey1",
                "MatchExpress": {
                    "MatchExpress": [
                        {
                            "TagValue": "*",
                            "TagValueMatchFunction": "all"
                        }
                    ]
                },
                "RegionId": "cn-hangzhou"
            }
        ]
    },
    "Code": 200,
    "Success": true
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParameterValue Illegal parameters. 参数错误
404 ResourceNotFound The specified resource is not found. 未找到指定资源。

访问错误中心查看更多错误码。