Todos os produtos
Search
Central de documentação

:ModifyHostAvailability

Última atualização: Jun 26, 2026

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

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

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:

  • GROUP: monitora todas as instâncias ECS do grupo de aplicativos.
  • GROUP_SPEC_INSTANCE: monitora apenas instâncias ECS específicas do grupo. Use este parâmetro em conjunto com InstanceList.N para definir quais instâncias ECS serão monitoradas.
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:

  • GET
  • POST
  • HEAD
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:

  • true: aciona alerta se o corpo da resposta HTTP contiver a regra.
  • false: aciona alerta se o corpo da resposta HTTP não contiver a regra.
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: Parameter name:Parameter value. Separe múltiplos parâmetros com caracteres de retorno de carro. Exemplo:


params1:value1
params2:value2
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 AlertConfig.StartTime for 0 e AlertConfig.EndTime for 22, a regra vigorará das 00:00:00 às 22:00:00.

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 AlertConfig.StartTime for 0 e AlertConfig.EndTime for 22, a regra vigorará das 00:00:00 às 22:00:00.

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:

  • HttpStatus: código de status HTTP
  • HttpLatency: tempo de resposta HTTP
  • TelnetStatus: código de status Telnet
  • TelnetLatency: tempo de resposta Telnet
  • PingLostRate: taxa de perda de pacotes Ping
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:

  • HttpStatus: Value
  • HttpLatency: Average
  • TelnetStatus: Value
  • TelnetLatency: Average
  • PingLostRate: Average
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: acs:{Service name abbreviation}:{regionId}:{userId}:/{Resource type}/{Resource name}/message. Exemplo: acs:mns:cn-hangzhou:120886317861****:/queues/test123/message. Campos:

  • {Service name abbreviation}: abreviação do nome do serviço. Valor válido: mns.
  • {userId}: ID da conta Alibaba Cloud.
  • {regionId}: ID da região da fila de mensagens ou do tópico.
  • {Resource type}: tipo do recurso alvo do alerta. Valores válidos: - **queues** - **topics** {Resource name}: nome do recurso. - Se o tipo for **queues**, use o nome da fila de mensagens. - Se o tipo for **topics**, use o nome do tópico.
AlertConfigTargetList.N.Level String Não ["INFO", "WARN", "CRITICAL"]

Nível do alerta. Valores válidos:

  • INFO: informação
  • WARN: aviso
  • CRITICAL: crítico
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:

  • true: sucesso.
  • false: falha.

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.