You need to enable JavaScript to run this app.
导航

CreateObjectGroup

最近更新时间2024.04.15 15:07:28

首次发布时间2024.03.18 17:01:10

调用CreateObjectGroup接口创建一个对象分组。

使用限制

  • 一个账户最多创建100个对象分组。
  • 一个对象分组最多包含100个云产品,每个云产品最多包含1000个资源;一个对象分组最多包含5000个云产品资源。
  • 一个对象分组只能绑定一个告警模板。

Request

POST https://open.volcengineapi.com?Action=CreateObjectGroup&Version=2018-01-01

ServiceName : Volc_Observe
Region : cn-beijing 
AccessKey : xxx
SecretKey : xxx

请求参数

参数

类型

是否必填

示例值

描述

Name

String

testgroup

对象分组名称。长度限制为64。支持中文、英文和下划线。例如"分组1"长度为3。

Objects

Array

-

需要分组的云产品资源列表,列表长度最大值100,具体请参见Object请求参数

Object请求参数

参数

类型

是否必填

示例值

描述

Namespace

String

VCM_EIP

云产品在云监控中所属的产品空间。具体请参见云产品监控指标下各产品的Namespace

Dimensions

Map

-

云产品资源ID集合。具体请参见Dimensions请求参数

Region

String

cn-beijing

当前Object下云产品所属可用区。

Dimensions请求参数

参数

类型

是否必填

示例值

描述

Key

String

ResourceID

云产品资源的Dimensions名称。例如:ResourceID、NodeName等。

Value

Array

["i-ycsa9lvgu8cva4******","i-ycr7e0gmwwcva4******"]

云产品资源的Dimension的值,填写所有纳入当前对象分组的云产品资源ID值。

返回数据

参数

类型

示例值

描述

Data

String

1764547228734******

创建对象分组的ID。

请求示例

POST https://open.volcengineapi.com?Action=CreateObjectGroup&Version=2018-01-01
ServiceName=Volc_Observe
Region=cn-beijing 
AccessKey=xxx 
SecretKey=xxx

{
    "Name": "OpenAPI测试",
    "Objects": [
        {
            "Namespace": "VCM_ECS",
            "Dimensions": {
                "ResourceID": [
                    "i-ycsa9lvgu8cva4******",
                    "i-ycr7e0gmwwcva4******"
                ]
            },
            "Region": "cn-beijing"
        }
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20240304150337F609773DD7E2C2******",
        "Action": "CreateObjectGroup",
        "Version": "2018-01-01",
        "Service": "Volc_Observe",
        "Region": ""
    },
    "Result": {
        "Data": "1764547228734******"
    }
}