调用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。
DynamicTagRuleId String 否 004155fa-15ba-466d-b61a-***********

智能标签规则ID。

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

返回数据

名称 类型 示例值 描述
RequestId String 0D50523D-8D59-4A61-B58E-E2286ECFB3A9

请求ID。
Success Boolean true

操作是否成功。取值：

  • true：成功。
  • false：失败。
Code String 200

状态码。

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

错误信息。
PageSize String 30

分页时每页显示的数据行数。
PageNumber String 1

页码。
Total Integer 2

标签列表的条目总数。
TagGroupList Array of TagGroup

应用分组的规则列表。
TagGroup
Status String FINISH

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

  • RUNNING：进行中。
  • FINISH：已完成。
MatchExpressFilterRelation String or

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

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

资源所属的地域ID。
TagKey String tagkey1

标签键。
DynamicTagRuleId String 1536df65-a719-429d-8813-73cc40d7****

标签规则ID。
MatchExpress Array of MatchExpress

标签生成应用分组的匹配表达式。
MatchExpress
TagValue String *

标签值。

TagValue和TagValueMatchFunction配合使用。
TagValueMatchFunction String all

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

  • all：全部。
  • startWith：前缀。
  • endWith：后缀。
  • contains：包含。
  • notContains：不包含。
  • equals：相等。
TagKey String azone-version

标签键。
TemplateIdList Array of String 71****

报警模板ID。
ContactGroupList Array of String CloudMonitor

报警联系组。

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/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格式

HTTP/1.1 200 OK
Content-Type:application/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 错误码 错误信息 描述
404 ResourceNotFound The specified resource is not found. 未找到指定资源。

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