ModifySiteMonitor - Cloud Monitor: Central de Documentação do Alibaba Cloud

Modifica uma tarefa de monitoramento de site chamando a operação ModifySiteMonitor.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cms:ModifySiteMonitor

update

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Address	string	Não	A URL ou o endereço IP da tarefa de monitoramento.	http://www.aliyun.com
TaskId	string	Sim	O ID da tarefa de monitoramento.	2c8dbdf9-a3ab-46a1-85a4-f094965e****
TaskName	string	Não	O nome da tarefa de monitoramento. O nome deve ter de 4 a 100 caracteres e pode conter letras, dígitos, sublinhados (_) e caracteres chineses.	HanZhou_ECS2
Interval	string	Não	A frequência de monitoramento. Valores válidos: 1, 5 e 15. Unidade: minutos. Valor padrão: 1.	1
IspCities	string	Não	As informações do ponto de detecção. O valor está no formato JSONArray, por exemplo: `[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]`, onde `city` corresponde a Pequim, Hangzhou e Qingdao, respectivamente. Nota Você pode chamar a operação DescribeSiteMonitorISPCityList para consultar as informações do ponto de detecção. Para mais informações, consulte DescribeSiteMonitorISPCityList. Se este parâmetro for deixado vazio, o sistema selecionará aleatoriamente três pontos de detecção.	[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]
OptionsJson	string	Não	As opções avançadas estendidas para o tipo de protocolo da tarefa de monitoramento. Diferentes tipos de protocolo correspondem a diferentes opções estendidas.	{"time_out":5000}
AlertIds	string	Não	O ID da regra de alerta. O ID de uma regra de alerta existente no CloudMonitor. Você pode chamar a operação DescribeMetricRuleList para consultar os IDs das regras de alerta. Para mais informações, consulte DescribeMetricRuleList.	49f7c317-7645-4cc9-94fd-ea42e122****
IntervalUnit	string	Não	A unidade das métricas de monitoramento. Unidade: milissegundos (ms).	ms
CustomSchedule	string	Não	A programação de monitoramento personalizada. Você pode selecionar um período específico de segunda a domingo para o monitoramento.	{"start_hour":0,"end_hour":24, "days":[0], "time_zone":"Local"}

O monitoramento de site suporta os seguintes oito tipos de tarefa. As opções estendidas (OptionsJson) para cada tipo de tarefa são descritas nas tabelas a seguir.

HTTP.

Nome	Tipo	Descrição
http_method	String	O método de solicitação HTTP. Valores válidos: GET, POST e HEAD. Valor padrão: GET.
header	String	Cabeçalhos HTTP personalizados separados por quebras de linha (\n). Cada cabeçalho deve estar em conformidade com o formato do protocolo HTTP (pares chave-valor separados por dois pontos).
cookie	String	O cookie, que segue o formato padrão de solicitação HTTP.
request_content	String	O conteúdo da solicitação. Dois formatos são suportados: JSON e form. Se este parâmetro não for especificado, a solicitação não conterá um corpo.
response_content	String	O conteúdo de resposta esperado. Durante o monitoramento, os primeiros 64 bytes retornados pelo servidor HTTP são verificados.
match_rule	String	0: O monitoramento é bem-sucedido se a resposta não contiver response_content. 1: O monitoramento é bem-sucedido se a resposta contiver response_content.
username	String	Se um nome de usuário for fornecido, um cabeçalho BasicAuth será incluído na solicitação HTTP.
password	String	A senha para autenticação de solicitação HTTP.
time_out	int	O período de tempo limite. Unidade: milissegundos. Valor padrão: 5.
max_redirect	int	O número máximo de redirecionamentos. O valor padrão é 5 para pontos de detecção ECS e 2 para pontos de detecção de operadora. Para desativar redirecionamentos, defina este parâmetro como 0. Valores válidos: 0 a 50.

PING.

Nome	Tipo	Descrição
failure_rate	int	Se a taxa de falha do PING exceder este valor, o monitoramento falhará e retornará 610 (PingAllFail) ou 615 (PingPartialFail). Valor padrão: 0.1.
ping_num	int	O número de tentativas de PING. Valor padrão: 20. Valores válidos: 1 a 100.

DNS.

Nome	Tipo	Descrição
dns_server	string	O endereço do servidor DNS. O valor pode ser um nome de domínio ou um endereço IP.
dns_type	string	O tipo de consulta DNS. Valores válidos: A, NS, CNAME, MX, TXT e ANY.
expect_value	string	A lista de valores esperados separados por caracteres de espaço em branco.
match_rule	string	A relação entre a lista de valores esperados e a lista DNS. Se a relação especificada não for atendida, o monitoramento falhará. String vazia ou IN_DNS: A lista de valores esperados é um subconjunto da lista DNS. DNS_IN: A lista DNS é um subconjunto da lista de valores esperados. EQUAL: A lista DNS é igual à lista de valores esperados. ANY: A lista DNS e a lista de valores esperados têm uma interseção não vazia.

FTP.

Nome	Tipo	Descrição
port	int	O número da porta do servidor FTP. Se este parâmetro não for especificado, o valor padrão será usado. Valor padrão para FTP: 21. Valor padrão para FTPs: 990.
username	string	O nome de usuário FTP. Se este parâmetro não for especificado, o login anônimo será usado.
password	string	A senha FTP.

POP3/SMTP.

Nome	Tipo	Descrição
port	int	O número da porta do servidor POP3. Valor padrão para POP3: 110. Valor padrão para POP3s: 995.
username	string	O nome de usuário para POP3/SMTP.
password	string	A senha para POP3/SMTP.

TCP/UDP.

Nome	Tipo	Descrição
port	int	A porta do servidor TCP/UDP.
request_content	string	O conteúdo da solicitação. Se request_format estiver definido como hex, o valor de request_content estará no formato compacto hexadecimal.
request_format	string	Se request_format estiver definido com outros valores, request_content será enviado ao servidor TCP/UDP como uma string simples.
response_content	string	O conteúdo da resposta. Se o conteúdo retornado pelo servidor TCP/UDP não contiver response_content, o monitoramento falhará. Se response_format estiver definido como hex, o valor de response_content estará no formato compacto hexadecimal. Se response_content estiver definido com outros valores, response_content será uma string simples.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Code	string	O código de status. Nota O valor 200 indica sucesso.	200
Message	string	A mensagem retornada.	successful
RequestId	string	O ID da solicitação.	68192f5d-0d45-4b98-9724-892813f86c71
Success	string	Indica se a operação foi bem-sucedida. Valores válidos: true: A operação foi bem-sucedida. false: A operação falhou.	true
Data	object	Os detalhes do resultado da tarefa do nó.
count	integer	O número de tarefas de monitoramento.	1

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "200",
  "Message": "successful",
  "RequestId": "68192f5d-0d45-4b98-9724-892813f86c71",
  "Success": "true",
  "Data": {
    "count": 1
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidQueryParameter	%s
400	IllegalAddress	Illegal HTTP address
400	OperationError	Operation failed
400	TaskNotExists	Task does not exist
400	OperatorInvalid	%s
400	NameRepeat	Task name repeat
400	CreateAlarmError	Create alarm error
400	NameNotExists	Task name not exists
400	OperatorCityInvalid	Invalid Isp.	Invalid Isp
401	AccessDeniedException	You donot have sufficient access to perform this action.
500	InternalError	%s
500	InternetServerError	System internal error.	System internal error
402	LimitExceeded	The quota for this customer had been reached.
403	Forbidden	You are not authorized to operate the specified resource.	No permission, please use RAM to authorize
403	RestrictedUser	The user's operation is restricted, please register NAAM product code.
403	UnauthorizedTasks	You are not permitted to operate the specified tasks.	You are not permitted to operate the specified tasks.
404	TaskNotExist	The specified task does not exist.	The specified task does not exist.
406	ExceedingQuota	Exceeding quota limits.	The number of tasks exceeds the limit
429	ThrottlingException	The request was denied due to request throttling.
409	%s	%s

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.