DescribeMonitorGroups - 查询应用分组列表 - 云监控

调用DescribeMonitorGroups接口查询应用分组列表。

接口说明

本文将提供一个示例，查询当前账号的应用分组列表。返回结果显示当前账号存在两个应用分组testGroup124和test123。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

cms:DescribeMonitorGroups

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
SelectContactGroups	boolean	否	返回结果中是否需要包含报警联系组。取值： true：是。 false：否。	true
PageNumber	integer	否	页码。起始值：1。默认值：1。	1
PageSize	integer	否	分页时每页显示的数据行数。起始值：1。默认值：30。	30
Keyword	string	否	搜索关键字。	test
InstanceId	string	否	资源实例 ID。该参数用于查询指定实例所在的应用分组。	i-abcdefgh12****
GroupName	string	否	应用分组名称。	testGroup124
IncludeTemplateHistory	boolean	否	返回结果是否包含已应用到应用分组的报警模板历史。取值： true：是。 false：否。	true
Type	string	否	应用分组类型。取值： custom：自建的应用分组。 ehpc_cluster：从 EHPC 集群同步的应用分组。 kubernetes：从容器服务 Kubernetes 版同步的应用分组。	custom
DynamicTagRuleId	string	否	智能标签规则 ID。	6b882d9a-5117-42e2-9d0c-4749a0c6****
GroupFounderTagKey	string	否	通过智能标签创建应用分组的标签键。	GroupKey1
GroupFounderTagValue	string	否	通过智能标签创建应用分组的标签值。	GroupValue1
GroupId	string	否	应用分组 ID。多个应用分组 ID 之间用半角逗号（,）分隔。	92****
Tag	array<object>	否	应用分组的标签。
	object	否	应用分组的标签。
Key	string	否	应用分组的标签键。N 的取值范围：1~5。	tagKey1
Value	string	否	应用分组的标签值。N 的取值范围：1~5。	tagValue1
Types	string	否	应用分组类型。取值： custom：自建的应用分组。 ehpc_cluster：从 EHPC 集群同步的应用分组。 kubernetes：从容器服务 Kubernetes 版同步的应用分组。 tag：通过标签自动创建的应用分组。 resMgr：通过资源组创建的应用分组。 ess：从弹性伸缩 ESS 同步的应用分组。	custom

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

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求 ID。	F02B299A-D374-4595-9F55-7534D604F132
Success	boolean	操作是否成功。取值： true：成功。 false：失败。	true
Code	integer	状态码。说明 200 表示成功。	200
Message	string	错误信息。	The specified resource is not found.
PageNumber	integer	页码。	1
PageSize	integer	分页时每页显示的数据行数。	30
Total	integer	总记录条数。	10
Resources	object
Resource	array<object>	关联资源。
	array<object>	关联资源。
Type	string	应用分组类型。取值： custom：自建的应用分组。 ehpc_cluster：从 EHPC 集群同步的应用分组。 kubernetes：从容器服务 Kubernetes 版同步的应用分组。	custom
GroupFounderTagValue	string	通过智能标签创建应用分组的标签值。	GroupValue1
BindUrl	string	从容器服务 Kubernetes 版同步过来的 URL 地址。	https://aliyun.com
GroupName	string	应用分组名称。	test123
GroupId	integer	应用分组 ID。	12345
ServiceId	string	阿里云服务 ID。	49****
DynamicTagRuleId	string	智能标签规则 ID。	6b882d9a-5117-42e2-9d0c-4749a0c6****
GmtCreate	integer	创建应用分组的时间戳。单位：毫秒。	1603181891000
GroupFounderTagKey	string	通过智能标签创建应用分组的标签键。	GroupKey1
GmtModified	integer	修改应用分组的时间戳。单位：毫秒。	1603181891000
ContactGroups	object
ContactGroup	array<object>	报警联系组。
	object	报警联系组
Name	string	报警联系组名称。	CloudMonitor
Tags	object
Tag	array<object>	应用分组绑定的标签列表。
	object	应用分组绑定的标签列表。
Key	string	应用分组的标签键。	tagKey1
Value	string	应用分组的标签值。	tagValue1
TemplateIds	object
TemplateId	array	模板 ID。
	string	应用分组应用过的报警模板。	92****
ResourceGroupId	string	资源 ID。	rg-aek2hopjh*******
TemplateInfos	object
TemplateInfo	array<object>	模版信息。
	object	模版信息。
EffectTime	integer	生效时间	1603181891000
TemplateId	string	模板 ID。	123***
Ver	string	版本。	0

示例

正常返回示例

JSON格式

{
  "RequestId": "F02B299A-D374-4595-9F55-7534D604F132",
  "Success": true,
  "Code": 200,
  "Message": "The specified resource is not found.",
  "PageNumber": 1,
  "PageSize": 30,
  "Total": 10,
  "Resources": {
    "Resource": [
      {
        "Type": "custom",
        "GroupFounderTagValue": "GroupValue1",
        "BindUrl": "https://aliyun.com",
        "GroupName": "test123",
        "GroupId": 12345,
        "ServiceId": "49****",
        "DynamicTagRuleId": "6b882d9a-5117-42e2-9d0c-4749a0c6****",
        "GmtCreate": 1603181891000,
        "GroupFounderTagKey": "GroupKey1",
        "GmtModified": 1603181891000,
        "ContactGroups": {
          "ContactGroup": [
            {
              "Name": "CloudMonitor"
            }
          ]
        },
        "Tags": {
          "Tag": [
            {
              "Key": "tagKey1",
              "Value": "tagValue1"
            }
          ]
        },
        "TemplateIds": {
          "TemplateId": [
            "92****"
          ]
        },
        "ResourceGroupId": "rg-aek2hopjh*******",
        "TemplateInfos": {
          "TemplateInfo": [
            {
              "EffectTime": 1603181891000,
              "TemplateId": "123***",
              "Ver": "0"
            }
          ]
        }
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	ParameterInvalid	%s
401	AccessDeniedException	You donot have sufficient access to perform this action.
500	InternalError	The request processing has failed due to some unknown error.
402	LimitExceeded	The quota for this customer had been reached.
403	AccessForbidden	The X.509 certificate or cms access key ID provided does not exist in our records.
206	%s	%s
404	ResourceNotFound	The specified resource is not found.	未找到指定资源。
503	%s	%s
406	%s	%s
429	Throttli∂ngException	The request was denied due to request throttling.
409	%s	%s

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

变更历史

更多信息，参考变更详情。