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

Este tópico apresenta um exemplo de alteração do nome de uma tarefa de monitoramento de site com ID 2c8dbdf9-a3ab-46a1-85a4-f094965e**** para HanZhou_ECS1. O resultado retornado confirma a alteração do nome da tarefa.

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	ModifySiteMonitor	Operação a executar. Defina o valor como ModifySiteMonitor.
TaskId	String	Sim	2c8dbdf9-a3ab-46a1-85a4-f094965e****	ID da tarefa de monitoramento de site.
Address	String	Não	http://www.aliyun.com	URL ou endereço IP monitorado pela tarefa.
TaskName	String	Não	HanZhou_ECS1	Nome da tarefa de monitoramento de site. Deve ter entre 4 e 100 caracteres, contendo letras, dígitos e sublinhados (_).
Interval	String	Não	1	Frequência de monitoramento. Valores válidos: 1, 5, 15 e 15000. Unidade: milissegundos. Valor padrão: 1.
IspCities	String	Não	[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]	Pontos de detecção. O valor é um array JSON. Exemplo: `[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]`. Os valores do campo `city` correspondem a Pequim, Hangzhou e Qingdao. Nota Chame a operação DescribeSiteMonitorISPCityList para consultar os pontos de detecção. Para mais informações, consulte DescribeSiteMonitorISPCityList. Se este parâmetro permanecer vazio, o sistema selecionará aleatoriamente três pontos de detecção.
OptionsJson	String	Não	null	Opções estendidas do protocolo usado na tarefa de monitoramento de site. As opções variam conforme o protocolo.
AlertIds	String	Não	49f7c317-7645-4cc9-94fd-ea42e122****	ID da regra de alerta. Chame a operação DescribeMetricRuleList para consultar os IDs das regras de alerta existentes no CloudMonitor. Para mais informações, consulte DescribeMetricRuleList.
IntervalUnit	String	Não	ms	Unidade da frequência de monitoramento. Use este parâmetro em conjunto com `Interval`. Por exemplo, defina este parâmetro como `ms` e `Interval` como `15000` (15 segundos). Valores válidos: s: segundos ms: milissegundos Nota Ative o recurso de monitoramento de alta precisão antes de definir este parâmetro. Para mais informações sobre como ativar o monitoramento de alta precisão, consulte Activate Hybrid Cloud Monitoring.

O monitoramento de site oferece suporte aos oito protocolos listados abaixo. As tabelas a seguir descrevem as opções estendidas especificadas pelo parâmetro OptionsJson para cada protocolo.

HTTP

Parâmetro	Tipo	Descrição
http_method	String	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 obedecer ao protocolo HTTP e consistir em um par chave-valor separado por dois pontos (:).
cookie	String	Cookie HTTP especificado conforme o padrão de solicitação HTTP.
request_content	String	Conteúdo da solicitação. Pode estar no formato JSON ou form. Se omitido, o corpo da solicitação ficará vazio.
response_content	String	Conteúdo esperado da resposta. O monitoramento verifica os primeiros 64 bytes retornados pelo servidor HTTP.
match_rule	String	0: Detecção bem-sucedida se a resposta não contiver o conteúdo especificado em response_content. 1: Detecção bem-sucedida se a resposta contiver o conteúdo especificado em response_content.
username	String	Se especificado, a solicitação HTTP incluirá o cabeçalho de autenticação básica.
password	String	Senha usada para autenticar a solicitação HTTP.
time_out	int	Tempo limite. Unidade: milissegundos. Valor padrão: 5.
max_redirect	int	Número máximo de redirecionamentos. O valor padrão é 5 para pontos de detecção em instâncias do Elastic Compute Service (ECS) e 2 para pontos fornecidos por operadoras. Defina como 0 para desativar redirecionamentos. Valores válidos: 0 a 50.

PING

Parâmetro

Tipo

Descrição

failure_rate

int

Se a taxa de pings com falha exceder este valor, a detecção falhará e retornará o código de status 610 ou 615. A mensagem de erro para 610 é PingAllFail; para 615, é PingPartialFail.

Valor padrão: 0,1.

ping_num

int

Quantidade de vezes que o endereço monitorado recebe ping. Valor padrão: 20.

Valores válidos: 1 a 100.

DNS

Parâmetro	Tipo	Descrição
dns_server	string	Nome de domínio ou endereço IP do servidor DNS (Domain Name System).
dns_type	string	Tipo de registros DNS a consultar. Valores válidos: A, NS, CNAME, MX, TXT e ANY.
expect_value	string	Lista de valores esperados. Separe-os com espaços.
match_rule	string	Relação entre a lista de valores esperados e a lista de resultados DNS. A detecção falhará se as listas não atenderem à relação especificada. Valores válidos: String vazia ou IN_DNS: A lista de valores esperados é um subconjunto dos resultados DNS. DNS_IN: A lista de resultados DNS é um subconjunto dos valores esperados. EQUAL: A lista de resultados DNS é idêntica à lista de valores esperados. ANY: Há interseção entre a lista de resultados DNS e a lista de valores esperados.

FTP

Parâmetro	Tipo	Descrição
port	int	Número da porta do servidor FTP. Se omitido, usa-se o valor padrão: 21 para FTP e 990 para FTPS.
username	string	Nome de usuário para login no servidor FTP. Se omitido, usa-se login anônimo.
password	string	Senha para login no servidor FTP.

POP3/SMTP

Parâmetro	Tipo	Descrição
port	int	Número da porta do servidor POP3. O valor padrão é 110 para POP3 e 995 para POP3S.
username	string	Nome de usuário para login no servidor POP3 ou SMTP.
password	string	Senha para login no servidor POP3 ou SMTP.

TCP/UDP

Parâmetro	Tipo	Descrição
port	int	Número da porta do servidor TCP ou UDP.
request_content	string	Conteúdo da solicitação. Se request_format for hex, o sistema analisará request_content em formato hexadecimal.
request_format	string	Se request_format tiver qualquer outro valor, o sistema enviará request_content ao servidor TCP ou UDP como string comum.
response_content	string	Conteúdo da resposta. A detecção falhará se a resposta do servidor TCP ou UDP não contiver o conteúdo especificado em response_content. Se response_format for hex, o sistema analisará response_content em formato hexadecimal. Se response_format tiver qualquer outro valor, o sistema analisará response_content como string comum.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Code	String	200	Código de status HTTP. Nota O código 200 indica chamada bem-sucedida.
Data	Struct		Resultado da modificação da tarefa.
count	Integer	1	Quantidade de tarefas de monitoramento de site.
Message	String	successful	Mensagem retornada.
RequestId	String	68192f5d-0d45-4b98-9724-892813f86c71	ID da solicitação.
Success	String	true	Indica se a chamada foi bem-sucedida. Valores válidos: true: Chamada bem-sucedida. false: Falha na chamada.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=ModifySiteMonitor
&TaskId=2c8dbdf9-a3ab-46a1-85a4-f094965e****
&TaskName=HanZhou_ECS2
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<ModifySiteMonitorResponse>
	  <Message>successful</Message>
	  <RequestId>32E77F32-B86E-4763-A0BB-0311581ABE67</RequestId>
	  <Data>
		    <count>1</count>
	  </Data>
	  <Code>200</Code>
	  <Success>true</Success>
</ModifySiteMonitorResponse>

Formato JSON

{
	"Message": "successful",
	"RequestId": "32E77F32-B86E-4763-A0BB-0311581ABE67",
	"Data": {
		"count": 1
	},
	"Code": "200",
	"Success": true
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.