Modifica uma tarefa de monitoramento de disponibilidade.
Este tópico descreve como alterar o nome da tarefa de monitoramento de disponibilidade 12345 no grupo de aplicativos 123456 para task2.
Depuração
Parâmetros da solicitação
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| Action | String | Sim | ModifyHostAvailability | Operação a ser executada. Defina o valor como ModifyHostAvailability. |
| GroupId | Long | Sim | 123456 | ID do grupo de aplicativos. |
| Id | Long | Sim | 12345 | ID da tarefa de monitoramento de disponibilidade. |
| TaskName | String | Sim | task2 | Nome da tarefa de monitoramento de disponibilidade. |
| TaskScope | String | Não | GROUP | Escopo de instâncias monitoradas pela tarefa de disponibilidade. Valores válidos:
|
| TaskOption.HttpURI | String | Não | https://www.aliyun.com | URI a ser monitorada. Obrigatório se TaskType for HTTP. |
| TaskOption.TelnetOrPingHost | String | Não | www.aliyun.com | Nome de domínio ou endereço IP a ser monitorado. Nota Obrigatório se TaskType for PING ou TELNET. Para mais informações sobre como configurar TaskType, consulte CreateHostAvailability. |
| TaskOption.HttpResponseCharset | String | Não | UTF-8 | Conjunto de caracteres da resposta HTTP. Nota Valor válido: UTF-8. |
| TaskOption.HttpPostContent | String | Não | params1=value1 | Conteúdo da solicitação HTTP POST. |
| TaskOption.HttpResponseMatchContent | String | Não | ok | Conteúdo esperado na resposta à solicitação HTTP. |
| TaskOption.HttpMethod | String | Não | GET | Método da solicitação HTTP. Valores válidos:
Nota Obrigatório se TaskType for HTTP. Para mais informações sobre como configurar TaskType, consulte CreateHostAvailability. |
| TaskOption.HttpNegative | Boolean | Não | true | Critério para acionar alertas com base na presença da regra especificada no corpo da resposta. Valores válidos:
Nota Obrigatório se TaskType for HTTP. Para mais informações sobre como configurar TaskType, consulte CreateHostAvailability. |
| TaskOption.HttpHeader | String | Não | params1:value1 | Cabeçalho da solicitação HTTP. Formato:
|
| TaskOption.Interval | Integer | Não | 60 | Intervalo de envio das solicitações de detecção. Unidade: segundos. Valores válidos: 15, 30, 60, 120, 300, 900, 1800 e 3600. Nota Disponível apenas no agente CloudMonitor V3.5.1 ou superior. |
| AlertConfig.NotifyType | Integer | Sim | 0 | Métodos de notificação de alerta. Valores válidos: 0: Notificações enviadas por e-mail e chatbots do DingTalk. |
| AlertConfig.StartTime | Integer | Não | 0 | Hora inicial de vigência da regra de alerta. Valores válidos: 0 a 23. Por exemplo, se Nota Notificações baseadas no limiar especificado são enviadas apenas durante o período de vigência da regra. |
| AlertConfig.EndTime | Integer | Não | 22 | Hora final de vigência da regra de alerta. Valores válidos: 0 a 23. Por exemplo, se Nota Notificações baseadas no limiar especificado são enviadas apenas durante o período de vigência da regra. |
| AlertConfig.SilenceTime | Integer | Não | 86400 | Período de silêncio em que novos alertas não são enviados, mesmo se as condições de acionamento forem atendidas. Unidade: segundos. Valor padrão: 86400 (um dia). |
| AlertConfig.WebHook | String | Não | https://www.aliyun.com/webhook.json | URL de callback. |
| AlertConfigEscalationList.N.MetricName | String | Sim | HttpStatus | Métrica associada ao alerta. Valores válidos de N: 1 a 21. Valores válidos:
|
| AlertConfigEscalationList.N.Value | String | Não | 3 | Limiar do alerta. Valores válidos de N: 1 a 21. |
| AlertConfigEscalationList.N.Times | Integer | Não | 3 | Número consecutivo de vezes que o valor da métrica deve atender à condição antes de acionar o alerta. Valores válidos de N: 1 a 21. |
| AlertConfigEscalationList.N.Operator | String | Não | > | Operador de comparação da regra de alerta. Valores válidos de N: 1 a 21. Valores válidos:
|
| AlertConfigEscalationList.N.Aggregate | String | Não | Value | Método de cálculo dos valores da métrica para acionar alertas. Valores válidos de N: 1 a 21. O valor depende da métrica escolhida:
Nota Value representa o valor original (usado para códigos de status). Average representa a média (usada para latência e taxa de perda de pacotes). |
| InstanceList.N | String | Não | 2 | Instâncias ECS monitoradas. Valores válidos de N: 1 a 21. Nota Obrigatório se TaskScope for GROUP_SPEC_INSTANCE. |
| AlertConfigTargetList.N.Id | String | Não | 1 | ID do recurso alvo do alerta. |
| AlertConfigTargetList.N.Arn | String | Não | acs:mns:cn-hangzhou:111:/queues/test/message | Alibaba Cloud Resource Name (ARN) do recurso. Formato:
|
| AlertConfigTargetList.N.Level | String | Não | ["INFO", "WARN", "CRITICAL"] | Nível do alerta. Valores válidos:
|
| AlertConfigTargetList.N.JsonParams | String | Não | {"customField1":"value1","customField2":"$.name"} | Parâmetros do callback de alerta em formato JSON. |
Para obter mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros comuns.
Parâmetros de resposta
| Parâmetro | Tipo | Exemplo | Descrição |
| Code | String | 200 | Código de status HTTP. Nota O código 200 indica sucesso na chamada. |
| Message | String | The specified resource is not found. | Mensagem de erro. |
| RequestId | String | 16E815A3-47E1-4290-87F9-D5C99471FF45 | ID da solicitação. |
| Success | Boolean | true | Indica se a chamada foi bem-sucedida. Valores válidos:
|
Exemplos
Solicitações de exemplo
http(s)://[Endpoint]/?Action=ModifyHostAvailability
&AlertConfig.NotifyType=0
&AlertConfigEscalationList.1.MetricName=HttpStatus
&GroupId=123456
&Id=12345
&TaskName=task2
&<Common request parameters>
Respostas de sucesso de exemplo
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyHostAvailabilityResponse>
<RequestId>16E815A3-47E1-4290-87F9-D5C99471FF45</RequestId>
<Success>true</Success>
<Code>200</Code>
</ModifyHostAvailabilityResponse>
Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "16E815A3-47E1-4290-87F9-D5C99471FF45",
"Code" : 200,
"Success" : true
}
Códigos de erro
|
HttpCode |
Código de erro |
Mensagem de erro |
Descrição |
|
404 |
ResourceNotFound |
The specified resource is not found. |
Recurso especificado não encontrado. |
Para obter uma lista de códigos de erro, visite o API Error Center.