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

CreateContactGroup

最近更新时间2024.04.19 11:53:53

首次发布时间2023.06.30 15:23:34

创建告警联系人组。

请求说明

  • 请求方式:POST
  • 请求地址:https://open.volcengineapi.com/?Action=CreateContactGroup&Version=2021-03-03

请求参数

参数名称类型是否必选示例值描述
ActionStringCreateContactGroup公共参数,本接口值:CreateContactGroup。
VersionString2021-03-03公共参数,本接口值:2021-03-03。

Name

String

test

联系人组名称:

  • 支持大小写字母、中文、数字、中划线或下划线。
  • 不能以数字、中划线、下划线或其他特殊字符开头。
  • 长度小于 128 个字符。
  • 账户内唯一。
ContactIdsArray of String["4a337d5b-0959-4cc7-a3ea-2f71332d4ff3"]配置该联系人组中的联系人 ID。

请求示例

POST /?Action=CreateContactGroup&Version=2021-03-03
Content-Type:application/json
{
    "Name": " test",
    "ContactIds":  ["4a337d5b-0959-4cc7-a3ea-2f71332d4ff3"]
}

返回参数

参数名称类型示例值描述
IdStringf9626b5a-0c9e-420e-b6e5-4c66b84f080d联系人组 ID。

返回示例

HTTP/1.1 200 OK
Content-Type:application/json
{
    "ResponseMetadata": {
        "RequestId": "202211302208xxxx",
        "Action": "CreateContactGroup",
        "Version": "2021-03-03",
        "Service": "vmp",
        "Region": "cn-beijing"
    },
    "Result": {
        "Id": "f9626b5a-0c9e-420e-b6e5-4c66b84f080d"
    }
}

错误码

本接口错误码如下表所示,公共错误码请参见 公共错误码

HTTP 状态码错误码错误信息描述
409Conflict.NameThe specified name conflicts with existing ContactGroup.在同一账户下不能有相同名称的联系人组。