Todos os produtos
Search
Central de documentação

:PutContact

Última atualização: Jun 26, 2026

Cria ou modifica um contato de alerta.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da requisição

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimPutContact

A operação a ser executada. Defina o valor como PutContact.

ContactNameStringSimAlice

O nome do contato de alerta.

DescribeStringSimECS_Instance

A descrição do contato de alerta.

Channels.SMSStringNão1333333****

O número de telefone do contato de alerta. Ao adicionar ou modificar um número de telefone, o destinatário receberá uma mensagem de texto contendo um link de ativação. O sistema só adiciona o destinatário à lista de contatos de alerta após a ativação do número de telefone.

Especifique pelo menos um dos seguintes canais de notificação de alerta: endereço de e-mail ou URL do webhook do robô do DingTalk.

Channels.MailStringNãotest@aliyun.com

O endereço de e-mail do contato de alerta. Ao adicionar ou modificar um endereço de e-mail, o destinatário receberá um e-mail contendo um link de ativação. O sistema só adiciona o destinatário à lista de contatos de alerta após a ativação do endereço de e-mail.

Especifique pelo menos um dos seguintes canais de notificação de alerta: endereço de e-mail ou URL do webhook do robô do DingTalk.

Channels.DingWebHookStringNãohttps://oapi.dingtalk.com/robot/send?access_token=7d49515e8ebf21106a80a9cc4bb3d247771305d52fb15d6201234565****

A URL do webhook do robô do DingTalk.

Especifique pelo menos um dos seguintes canais de notificação de alerta: endereço de e-mail ou URL do webhook do robô do DingTalk.

Channels.AliIMStringNãoJim

O ID do TradeManager do contato de alerta.

Especifique pelo menos um dos seguintes canais de notificação de alerta: endereço de e-mail ou URL do webhook do robô do DingTalk.

LangStringNãozh-cn

O idioma de exibição das informações de alerta. Valores válidos:

  • zh-cn: chinês simplificado
  • en: inglês
Nota Se você não especificar um valor para este parâmetro, o Cloud Monitor identificará o idioma das informações de alerta com base na região da sua conta Alibaba Cloud.

Parâmetros de resposta

ParâmetroTipoExemploDescrição
CodeString200

O código de status HTTP.

Nota O código de status 200 indica que a chamada foi bem-sucedida.
MessageStringThe Request is not authorization.

A mensagem retornada.

RequestIdString181C406E-9DE4-484C-9C61-37AE9A1A12EE

O ID da requisição.

SuccessBooleantrue

Indica se a chamada foi bem-sucedida. Valores válidos:

  • true: a chamada foi bem-sucedida.
  • false: a chamada falhou.

Exemplos

Exemplos de requisição

http(s)://[Endpoint]/?Action=PutContact
&ContactName=Alice
&Describe=ECS_Instance
&<Common request parameters>

Exemplos de resposta de sucesso

Formato XML

<PutContactResponse>
      <Code>200</Code>
      <RequestId>181C406E-9DE4-484C-9C61-37AE9A1A12EE</RequestId>
      <Success>true</Success>
</PutContactResponse>

Formato JSON

{
  "RequestId": "F7FA82F0-8627-441B-9B2B-8663617F36B9",
  "Success": true,
  "Code": "200"
}

Códigos de erro

Para obter uma lista de códigos de erro, acesse o Centro de Erros de API.