文档中心

云监控

告警联系人

UpdateContacts

对指定联系人进行全量更新，即更新联系人的全部属性，包括名称、手机和邮箱。

请求说明

请求方式：POST

请求地址：https://cloudmonitor.cn-beijing.volcengineapi.com?Action=UpdateContacts&Version=2018-01-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
Action	String	是	UpdateContacts	接口名称。当前 API 的名称为 UpdateContacts。
Version	String	是	2018-01-01	接口版本。当前 API 的版本为 2018-01-01。
Id	String	是	1452*****7244	联系人 ID。可以调用 ListContacts 接口，获取联系人 ID。
Name	String	是	user-name	联系人的新名称。不能以数字、中划线开头。只能包含中文、字母、数字、下划线_和中划线-。长度限制在 1～128 字符之间。
Phone	String	否	1234567****	联系人的新手机号。若不填，则默认清空本参数原有值。
Email	String	是	user@example.com	联系人的新邮箱地址。

请求示例

POST https://cloudmonitor.cn-beijing.volcengineapi.com?Action=UpdateContacts&Version=2018-01-01​
Content-Type: application/json​
{​
    "Id": "1452*****7244",​
    "Name": "user-name",​
    "Email": "user@example.com",​
    "Phone": "1234567****"​
}​

返回参数

参数	类型	示例值	描述
Data	Array of String	["1452*****7244"]	联系人 ID。

返回示例

{​
    "ResponseMetadata": {​
        "Action": "UpdateContacts",​
        "Region": "cn-beijing",​
        "Service": "cloudmonitor",​
        "Version": "2018-01-01",​
        "RequestId": "20230604110420****100232280022D31"​
    },​
    "Result": {​
        "Data": [​
            "1452*****7244"​
        ]​
    }​
}​

错误码

本接口无特有的错误码。更多信息请参见错误码。

最近更新时间：2026.08.11 20:28:00

这个页面对您有帮助吗？

有用

无用