You need to enable JavaScript to run this app.
导航
托管 Prometheus
  • 文档首页
    • /
  • 托管 Prometheus

UpdateContactGroup

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

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

我的收藏

更新告警联系人组信息。

请求说明

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

请求参数

参数名称类型是否必选示例值描述
ActionString是UpdateContactGroup公共参数，本接口值：UpdateContactGroup。
VersionString是2021-03-03公共参数，本接口值：2021-03-03。
IdString是f9626b5a-0c9e-420e-b6e5-4c66b84f080d联系人组 ID。

Name

String

否

test

联系人组名称。

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

请求示例

POST /?Action=UpdateContactGroup&Version=2021-03-03
Content-Type:application/json
{
    "Id": "f9626b5a-0c9e-420e-b6e5-4c66b84f080d",
    "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": "UpdateContactGroup",
        "Version": "2021-03-03",
        "Service": "vmp",
        "Region": "cn-beijing"
    },
    "Result": {
        "Id": "f9626b5a-0c9e-420e-b6e5-4c66b84f080d"
    }
}

错误码

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

HTTP 状态码错误码错误信息描述
400InvalidParameter.{{parameter}}The specified {{parameter}} is invalid.参数不合法，请检查参数正确性后重试。
400MissingParameter.{{parameter}}The required parameter {{parameter}} is missing.缺少必要的参数。
403ProductUnsubscribedYou are not subscribed to the Volcengine Managed Service for Prometheus (VMP). Please go to the VMP console web page to subscribe to the service当前账号未订阅 VMP 服务。
404NotFound.IdThe specified ContactGroup {{Id}} is not found.未找到指定联系人组。
409Conflict.NameThe specified name conflicts with existing ContactGroup.在同一账户下不能有相同名称的联系人组。