开发者社区 问答 正文

云监控查询联系人组


描述
查询云账号下对应的报警规则联系人组。

请求类型
GET/POST

请求参数

名称类型是否必须描述
ActionString系统规定参数,取值:ListContactGroup
PageNumberPageNumber页数,默认值为第1页
PageSizePageNumber页大小,默认值为100


返回参数
名称类型描述
NextTokenInteger下一页,为空代表没有下一页
DatapointsList< String >联系组名称列表
TotalInteger符合条件数据总数
SuccessBoolean请求是否成功
RequestIdString请求的uuid,便于查询日志
CodeString请求失败状态码,200为成功,非200为失败
MessageString请求失败的提示信息


错误编码
错误代码描述语义
400Bad Request客户端请求中的语法错误
403Forbidden没有权限
404Not Found客户端错误,未找到
500Internal Server Error服务器内部错误
200OK正常


示例
  • 请求示例
  1. [backcolor=transparent]http[backcolor=transparent]:[backcolor=transparent]//metrics.cn-hangzhou.aliyuncs.com/?Action=ListContactGroup
  2. [backcolor=transparent]&[backcolor=transparent]PageSize[backcolor=transparent]=[backcolor=transparent]5
  3. [backcolor=transparent]&[backcolor=transparent]PageNumber[backcolor=transparent]=[backcolor=transparent]1
  4. [backcolor=transparent]&<公共请求参数>
  • 返回示例

XML格式
  1. [backcolor=transparent]<ListContactGroupResponse>
  2. [backcolor=transparent]  [backcolor=transparent]<RequestId>[backcolor=transparent]DCE1419F-D60C-441C-81C3-7425B9211AC5[backcolor=transparent]</RequestId>
  3. [backcolor=transparent]  [backcolor=transparent]<ContactGroups>
  4. [backcolor=transparent]    [backcolor=transparent]<ContactGroup>[backcolor=transparent]test4nudou[backcolor=transparent]</ContactGroup>
  5. [backcolor=transparent]    [backcolor=transparent]<ContactGroup>[backcolor=transparent]xzytestgroup[backcolor=transparent]</ContactGroup>
  6. [backcolor=transparent]    [backcolor=transparent]<ContactGroup>[backcolor=transparent]云账号报警联系人[backcolor=transparent]</ContactGroup>
  7. [backcolor=transparent]  [backcolor=transparent]</ContactGroups>
  8. [backcolor=transparent]  [backcolor=transparent]<Success>[backcolor=transparent]true[backcolor=transparent]</Success>
  9. [backcolor=transparent]  [backcolor=transparent]<Code>[backcolor=transparent]200[backcolor=transparent]</Code>
  10. [backcolor=transparent]  [backcolor=transparent]<Total>[backcolor=transparent]3[backcolor=transparent]</Total>
  11. [backcolor=transparent]</ListContactGroupResponse>

JSON格式
  1. [backcolor=transparent]{
  2. [backcolor=transparent]    [backcolor=transparent]"RequestId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"D3D03B0A-CF1A-4DAB-BF0D-D4B6ACD5677A"[backcolor=transparent],[backcolor=transparent]
  3. [backcolor=transparent]    [backcolor=transparent]"ContactGroups"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]{
  4. [backcolor=transparent]        [backcolor=transparent]"ContactGroup"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent][
  5. [backcolor=transparent]            [backcolor=transparent]"test4nudou"[backcolor=transparent],[backcolor=transparent]
  6. [backcolor=transparent]            [backcolor=transparent]"xzytestgroup"[backcolor=transparent],[backcolor=transparent]
  7. [backcolor=transparent]            [backcolor=transparent]"云账号报警联系人"
  8. [backcolor=transparent]        [backcolor=transparent]]
  9. [backcolor=transparent]    [backcolor=transparent]},[backcolor=transparent]
  10. [backcolor=transparent]    [backcolor=transparent]"Success"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]true[backcolor=transparent],[backcolor=transparent]
  11. [backcolor=transparent]    [backcolor=transparent]"Code"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"200"[backcolor=transparent],[backcolor=transparent]
  12. [backcolor=transparent]    [backcolor=transparent]"Total"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]3
  13. [backcolor=transparent]}

展开
收起
反向一觉 2017-10-31 13:57:33 1983 分享 版权
阿里云 AI 助理回答

根据您的描述,您想要查询阿里云账号下关联的报警规则联系人组。这里提供一个基于HTTP GET请求的示例说明如何调用阿里云监控服务(Cloud Monitor Service, CMS)的API来实现这一需求。

请求URL结构

http://metrics.{RegionId}.aliyuncs.com/?Action=ListContactGroup&PageNumber={PageNumber}&PageSize={PageSize}&Signature={Signature}&AccessKeyId={YourAccessKeyId}&SignatureMethod={SignatureMethod}&SignatureVersion={SignatureVersion}&Timestamp={Timestamp}&Format={ResponseFormat}

请求参数解释

  • {RegionId}: 阿里云地域ID,例如cn-hangzhou
  • Action: 必须参数,固定值ListContactGroup,表示查询联系人组列表。
  • PageNumber: 页码,默认为1。
  • PageSize: 每页显示的记录数,默认为100。
  • {YourAccessKeyId}{Signature}, {SignatureMethod}, {SignatureVersion}, {Timestamp}, {Format}: 这些是阿里云API调用的标准参数,用于身份验证和响应格式设置。具体值需要根据您的实际账户信息和调用规范生成。

注意事项

  1. 签名生成: {Signature}等安全相关的参数需要根据阿里云API签名算法生成,确保请求的安全性。这通常涉及到AccessKeySecret,并且每个请求都需要包含一个有效的时间戳(Timestamp)和签名。
  2. 响应处理: 根据返回的JSON数据,您可以解析出Datapoints(联系组名称列表)、Total(符合条件的总数)、NextToken(如果有下一页的数据,则会返回这个字段)等信息。
  3. 错误处理: 如果请求失败,通过检查CodeMessage字段可以了解失败原因,并进行相应的错误处理。

示例请求构造

假设您已经获取了AccessKeyId、并使用正确的签名方法计算出了Signature等参数,一个简单的请求示例可能如下:

http://metrics.cn-hangzhou.aliyuncs.com/?Action=ListContactGroup&PageNumber=1&PageSize=100&AccessKeyId=YourAccessKeyId&Signature=YourComputedSignature&SignatureMethod=HMAC-SHA1&SignatureVersion=1&Timestamp=2023-04-05T12%3A00%3A00Z&Format=json

请记得替换上述占位符(如YourAccessKeyId, YourComputedSignature等)为实际有效的值,并确保时间戳正确无误且符合阿里云API的要求。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答