资源分组管理-华为云

云监控服务 CES-查询资源分组列表:响应示例

响应示例状态码： 200 OK { "resource_groups" : [ { "group_name" : "group1", "create_time" : "2006-01-02T15:04:05.000Z", "group_id" : "rg0123456789xxxx", "enterprise_project_id" : "0", "type" : "Manual" }, { "group_name" : "band", "type" : "EPS", "create_time" : "2006-01-02T15:04:05.000Z", "group_id" : "rg0123456789xxxx", "enterprise_project_id" : "d61d4705-5658-42f5-8e0c-70eb34d17b02" }, { "group_name" : "group2", "type" : "TAG", "create_time" : "2006-01-02T15:04:05.000Z", "group_id" : "rg0123456789xxxx", "enterprise_project_id" : "0" } ], "count" : 3 }

云监控服务 CES 资源分组管理

云监控服务 CES-查询资源分组列表:URI

URI GET /v2/{project_id}/resource-groups 表1 路径参数参数是否必选参数类型描述 project_id 是 String 租户ID 最小长度：1 最大长度：64 表2 Query参数参数是否必选参数类型描述 enterprise_project_id 否 String 归属企业项目ID 正则匹配：^((([a-z]|[0-9]){8}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){12})|0)$ group_name 否 String 资源分组名称，支持模糊查询最小长度：1 最大长度：128 group_id 否 String 资源分组ID，以rg开头，后跟22位由字母或数字组成的字符串最小长度：2 最大长度：24 offset 否 Integer 分页查询时查询的起始位置，表示从第几条数据开始，默认为0 最小值：0 最大值：10000 limit 否 Integer 分页查询时每页的条目数，取值[1,100]，默认值为100 最小值：1 最大值：100 type 否 String 资源分组添加资源方式，取值只能为EPS（同步企业项目）,TAG（标签动态匹配）,Manual（手动添加），不传代表查询所有资源分组类型,COMB（智能添加-组合匹配）枚举值： EPS TAG Manual COMB origin_flag 否 String 来源标识，取值只能为resourcegroup（资源分组）,monitoroverview（监控概览），不传默认为资源分组枚举值： resourcegroup monitoroverview

云监控服务 CES 资源分组管理

云监控服务 CES-查询资源分组列表:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 count Integer 资源分组总数最小值：0 最大值：1000 resource_groups Array of OneResourceGroupResp objects 资源分组列表数组长度：0 - 100 表5 OneResourceGroupResp 参数参数类型描述 group_name String 资源分组的名称正则匹配：^((([a-z]|[0-9]){8}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){12})|0)$ group_id String 资源分组ID，以rg开头，后跟22位由字母或数字组成的字符串最小长度：2 最大长度：24 create_time String 资源分组的创建时间 enterprise_project_id String 资源分组归属企业项目ID 正则匹配：^((([a-z]|[0-9]){8}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){12})|0)$ type String 资源分组添加资源方式，取值只能为EPS（同步企业项目）,TAG（标签动态匹配）,Manual（手动添加）枚举值： EPS TAG Manual 状态码： 400 表6 响应Body参数参数参数类型描述 error_code String 请求异常内部业务状态码最小长度：0 最大长度：256 error_msg String 请求异常信息最小长度：0 最大长度：256 request_id String 请求ID 最小长度：0 最大长度：256 状态码： 401 表7 响应Body参数参数参数类型描述 error_code String 请求异常内部业务状态码最小长度：0 最大长度：256 error_msg String 请求异常信息最小长度：0 最大长度：256 request_id String 请求ID 最小长度：0 最大长度：256 状态码： 403 表8 响应Body参数参数参数类型描述 error_code String 请求异常内部业务状态码最小长度：0 最大长度：256 error_msg String 请求异常信息最小长度：0 最大长度：256 request_id String 请求ID 最小长度：0 最大长度：256 状态码： 500 表9 响应Body参数参数参数类型描述 error_code String 请求异常内部业务状态码最小长度：0 最大长度：256 error_msg String 请求异常信息最小长度：0 最大长度：256 request_id String 请求ID 最小长度：0 最大长度：256

云监控服务 CES 资源分组管理

云监控服务 CES-查询指定资源分组详情:响应示例

响应示例状态码： 200 OK { "group_name" : "band", "type" : "TAG", "tags" : [ { "key" : "Resource", "value" : "VPC" }, { "key" : "Usage", "value" : "Tmp" } ], "create_time" : "2006-01-02T15:04:05.000Z", "group_id" : "rg0123456789xxxx", "enterprise_project_id" : "0" }

云监控服务 CES 资源分组管理

云监控服务 CES-查询指定资源分组详情:响应参数

响应参数状态码： 200 表3 响应Body参数参数参数类型描述 group_name String 资源分组的名称正则匹配：^((([a-z]|[0-9]){8}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){12})|0)$ group_id String 资源分组ID，以rg开头，后跟22位由字母或数字组成的字符串最小长度：2 最大长度：24 create_time String 资源分组的创建时间 enterprise_project_id String 资源分组归属企业项目ID 正则匹配：^((([a-z]|[0-9]){8}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){12})|0)$ type String 资源分组添加资源方式，取值只能为EPS（同步企业项目）,TAG（标签动态匹配）,Manual（手动添加）枚举值： EPS TAG Manual association_ep_ids Array of strings 该资源分组内包含的资源来源的企业项目ID，type为EPS时必传数组长度：1 - 1 tags Array of ResourceGroupTagRelation objects 标签动态匹配时的关联标签,type为TAG时该字段不为空数组长度：1 - 10 表4 ResourceGroupTagRelation 参数参数类型描述 key String 键最小长度：1 最大长度：36 value String 值最小长度：1 最大长度：42 状态码： 400 表5 响应Body参数参数参数类型描述 error_code String 请求异常内部业务状态码最小长度：0 最大长度：256 error_msg String 请求异常信息最小长度：0 最大长度：256 request_id String 请求ID 最小长度：0 最大长度：256 状态码： 401 表6 响应Body参数参数参数类型描述 error_code String 请求异常内部业务状态码最小长度：0 最大长度：256 error_msg String 请求异常信息最小长度：0 最大长度：256 request_id String 请求ID 最小长度：0 最大长度：256 状态码： 403 表7 响应Body参数参数参数类型描述 error_code String 请求异常内部业务状态码最小长度：0 最大长度：256 error_msg String 请求异常信息最小长度：0 最大长度：256 request_id String 请求ID 最小长度：0 最大长度：256 状态码： 404 表8 响应Body参数参数参数类型描述 error_code String 请求异常内部业务状态码最小长度：0 最大长度：256 error_msg String 请求异常信息最小长度：0 最大长度：256 request_id String 请求ID 最小长度：0 最大长度：256 状态码： 500 表9 响应Body参数参数参数类型描述 error_code String 请求异常内部业务状态码最小长度：0 最大长度：256 error_msg String 请求异常信息最小长度：0 最大长度：256 request_id String 请求ID 最小长度：0 最大长度：256

云监控服务 CES 资源分组管理

云监控服务 CES-删除资源分组:返回值

返回值正常 204 异常返回值说明 400 Bad Request 请求错误。 401 Unauthorized 未提供认证信息，或认证信息错误。 403 Forbidden 请求页面被禁止访问。 408 Request Timeout 请求超出了服务器的等待时间。 429 Too Many Requests 当前请求过多。 500 Internal Server Error 请求未完成，服务异常。 503 Service Unavailable 系统暂时不可用，请求受限。

云监控服务 CES 资源分组管理

云监控服务 CES-删除资源分组:URI

URI DELETE /V1.0/{project_id}/resource-groups/{group_id} 参数说明表1 参数说明名称类型是否必选说明 project_id String 是项目ID。获取方式请参见获取项目ID。 group_id String String 资源分组ID。请求样例： DELETE https://{ 云监控的endpoint}/V1.0/{project_id}/resource-groups/{group_id}

云监控服务 CES 资源分组管理

云监控服务 CES-创建资源分组（V1）:请求示例

请求示例 { "group_name" : "Resource-Group-Test01", "resources" : [ { "namespace" : "SYS.E CS ", "dimensions" : [ { "name" : "instance_id", "value" : "063a83da-a2b5-4630-ab6b-9b4fcfc261ea" } ] }, { "namespace" : "SYS.ECS", "dimensions" : [ { "name" : "instance_id", "value" : "518ace88-abde-46bf-829b-0d1f0f2fb2e9" } ] } ] }

云监控服务 CES 资源分组管理

云监控服务 CES-创建资源分组（V1）:返回值

返回值正常 201 异常返回值说明 400 Bad Request 请求错误。 401 Unauthorized 未提供认证信息，或认证信息错误。 403 Forbidden 请求页面被禁止访问。 408 Request Timeout 请求超出了服务器的等待时间。 429 Too Many Requests 当前请求过多。 500 Internal Server Error 请求未完成，服务异常。 503 Service Unavailable 系统暂时不可用，请求受限。

云监控服务 CES 资源分组管理

云监控服务 CES-创建资源分组（V1）:请求消息

请求消息请求参数表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 Arrays of objects 是一个或者多个资源维度。详细参数说明请参见表4。表4 dimensions字段数据结构说明名称参数类型是否必选说明 name String 是资源维度，例如弹性云服务器维度为：instance_id，各资源的维度可查看支持监控的服务列表。 value String 是资源维度值，为资源的实例ID。如：4270ff17-aba3-4138-89fa-820594c39755。

云监控服务 CES 资源分组管理

云监控服务 CES-更新资源分组:请求消息

请求消息请求参数表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 Arrays of objects 是一个或者多个资源维度。详细参数说明请参见表4。表4 dimensions字段数据结构说明名称参数类型是否必选说明 name String 是资源维度，例如弹性云服务器维度为：instance_id，各资源的维度可查看支持监控的服务列表。 value String 是资源维度值，为资源的实例ID。如：4270ff17-aba3-4138-89fa-820594c39755。请求示例： { "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" } ] }, { "namespace": "SYS.ECS", "dimensions": [ { "name": "instance_id", "value": "675006b5-477a-4aab-948c-0aa467de9c68" } ] } ] }

云监控服务 CES 资源分组管理

云监控服务 CES-更新资源分组:返回值

返回值正常 204 异常返回值说明 400 Bad Request 请求错误。 401 Unauthorized 未提供认证信息，或认证信息错误。 403 Forbidden 请求页面被禁止访问。 408 Request Timeout 请求超出了服务器的等待时间。 429 Too Many Requests 当前请求过多。 500 Internal Server Error 请求未完成，服务异常。 503 Service Unavailable 系统暂时不可用，请求受限。

云监控服务 CES 资源分组管理

云监控服务 CES-更新资源分组:URI

URI PUT /V1.0/{project_id}/resource-groups/{group_id} 参数说明表1 参数说明名称类型是否必选说明 project_id String 是项目ID。获取方式请参见获取项目ID。 group_id String 是资源分组ID。请求样例： PUT https://{云监控的endpoint}/V1.0/{project_id}/resource-groups/{group_id}

云监控服务 CES 资源分组管理

云服务器内容精选

资源分组管理

7*24

备案

专业服务

退订

建议反馈

售前咨询热线