创建资源分组
功能介绍
创建资源分组。资源分组支持将各类资源按照业务集中进行分组管理,可以从分组角度查看监控与告警信息以提升运维效率。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /V1.0/{project_id}/resource-groups
- 参数说明
表1 参数说明 名称
类型
是否必选
说明
project_id
String
是
项目ID。
获取方式请参见获取项目ID。
- 请求样例:
POST https://{云监控的endpoint}/V1.0/{project_id}/resource-groups
请求消息
- 请求参数
表2 请求参数 名称
类型
是否必选
说明
group_name
String
是
资源分组的名称,长度为1-128,只能包含0-9/a-z/A-Z/_/-或汉字。如:ResourceGroup-Test01。
resources
Array of objects
是
创建的资源分组选择一个或者多个资源。
详细参数说明请参见表3。
表3 resources字段数据结构说明 名称
参数类型
是否必选
说明
namespace
String
是
资源命名空间,如弹性云服务器的资源命名空间为:SYS.ECS,各服务命名空间可查看支持监控的服务列表。
dimensions
Array of objects
是
一个或者多个资源维度。
详细参数说明请参见表4。
表4 dimensions字段数据结构说明 名称
参数类型
是否必选
说明
name
String
是
资源维度,例如弹性云服务器维度为:instance_id,各资源的维度可查看支持监控的服务列表。
value
String
是
资源维度值,为资源的实例ID。如:4270ff17-aba3-4138-89fa-820594c39755。
响应消息
- 响应参数
表5 响应参数 名称
参数类型
说明
group_id
String
资源分组的ID,如:rg1603786526428bWbVmk4rP。
请求示例
{ "group_name" : "Resource-Group-Test01", "resources" : [ { "namespace" : "SYS.ECS", "dimensions" : [ { "name" : "instance_id", "value" : "063a83da-a2b5-4630-ab6b-9b4fcfc261ea" } ] }, { "namespace" : "SYS.ECS", "dimensions" : [ { "name" : "instance_id", "value" : "518ace88-abde-46bf-829b-0d1f0f2fb2e9" } ] } ] }
响应示例
状态码: 201
OK
{ "group_id" : "rg1606377637506DmVOENVyL" }
返回值
错误码
请参考返回错误码说明。