ModifySiteMonitor - - Centre de documentation Alibaba Cloud

Cette rubrique fournit un exemple montrant comment modifier le nom d'une tâche de surveillance de site dont l'ID est 2c8dbdf9-a3ab-46a1-85a4-f094965e**** en HanZhou_ECS1. Le résultat renvoyé indique que le nom de la tâche a bien été modifié.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de la signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	ModifySiteMonitor	L'opération à effectuer. Définissez la valeur sur ModifySiteMonitor.
TaskId	String	Oui	2c8dbdf9-a3ab-46a1-85a4-f094965e****	L'ID de la tâche de surveillance de site.
Address	String	Non	http://www.aliyun.com	L'URL ou l'adresse IP surveillée par la tâche.
TaskName	String	Non	HanZhou_ECS1	Le nom de la tâche de surveillance de site. Le nom doit comporter entre 4 et 100 caractères et peut contenir des lettres, des chiffres et des traits de soulignement (_).
Interval	String	Non	1	La fréquence de surveillance. Valeurs valides : 1, 5, 15 et 15000. Unité : millisecondes. Valeur par défaut : 1.
IspCities	String	Non	[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]	Les points de détection. La valeur est un tableau JSON. Exemple : `[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]`. Les valeurs du champ `city` indiquent Pékin, Hangzhou et Qingdao. Remarque Vous pouvez appeler l'opération DescribeSiteMonitorISPCityList pour interroger les points de détection. Pour plus d'informations, consultez DescribeSiteMonitorISPCityList. Si vous laissez ce paramètre vide, le système sélectionne aléatoirement trois points de détection.
OptionsJson	String	Non	null	Les options étendues du protocole utilisé par la tâche de surveillance de site. Les options varient selon le protocole.
AlertIds	String	Non	49f7c317-7645-4cc9-94fd-ea42e122****	L'ID de la règle d'alerte. Vous pouvez appeler l'opération DescribeMetricRuleList pour interroger les ID des règles d'alerte existantes dans CloudMonitor. Pour plus d'informations, consultez DescribeMetricRuleList.
IntervalUnit	String	Non	ms	L'unité de la fréquence de surveillance. Ce paramètre et le paramètre `Interval` doivent être utilisés conjointement. Par exemple, vous pouvez définir ce paramètre sur `ms` et le paramètre `Interval` sur `15000` (15 secondes). Valeurs valides : s : secondes ms : millisecondes Remarque Avant de pouvoir définir ce paramètre, vous devez activer la fonctionnalité de surveillance haute précision. Pour plus d'informations sur l'activation de la fonctionnalité de surveillance haute précision, consultez Activate Hybrid Cloud Monitoring.

La surveillance de site prend en charge les huit protocoles suivants. Les tableaux ci-dessous décrivent les options étendues spécifiées par le paramètre OptionsJson pour chaque protocole.

HTTP

Paramètre	Type	Description
http_method	String	La méthode de requête HTTP. Valeurs valides : GET, POST et HEAD. Valeur par défaut : GET.
header	String	Les en-têtes HTTP personnalisés séparés par des sauts de ligne (\n). Chaque en-tête doit être conforme au protocole HTTP. Chaque en-tête doit être une paire clé-valeur dans laquelle la clé et la valeur sont séparées par deux-points (:).
cookie	String	Le cookie HTTP spécifié conformément à la norme de requête HTTP.
request_content	String	Le contenu de la requête. Le contenu peut être au format JSON ou formulaire. Si ce paramètre n'est pas spécifié, le corps de la requête est vide.
response_content	String	Le contenu attendu de la réponse. Les 64 premiers octets du contenu renvoyé par le serveur HTTP sont vérifiés lors de la surveillance de site.
match_rule	String	0 : Si la réponse ne contient pas le contenu spécifié par le paramètre response_content, la détection est réussie. 1 : Si la réponse contient le contenu spécifié par le paramètre response_content, la détection est réussie.
username	String	Si le paramètre username est spécifié, la requête HTTP contient l'en-tête d'authentification de base.
password	String	Le mot de passe utilisé pour authentifier la requête HTTP.
time_out	int	Le délai d'expiration. Unité : millisecondes. Valeur par défaut : 5.
max_redirect	int	Le nombre maximal de redirections. La valeur par défaut est 5 pour un point de détection exécuté sur une instance Elastic Compute Service (ECS) et 2 pour un point de détection fourni par un opérateur. Pour désactiver les redirections, définissez la valeur sur 0. Valeurs valides : 0 à 50.

PING

Paramètre

Type

Description

failure_rate

int

Si le taux d'échecs des pings dépasse la valeur de ce paramètre, la détection échoue et le code d'état 610 ou 615 est renvoyé. Le message d'erreur du code d'état 610 est PingAllFail et celui du code d'état 615 est PingPartialFail.

Valeur par défaut : 0,1.

ping_num

int

Le nombre de fois où l'adresse surveillée est pingée. Valeur par défaut : 20.

Valeurs valides : 1 à 100.

DNS

Paramètre	Type	Description
dns_server	string	Le nom de domaine ou l'adresse IP du serveur Domain Name System (DNS).
dns_type	string	Le type d'enregistrements DNS à interroger. Valeurs valides : A, NS, CNAME, MX, TXT et ANY.
expect_value	string	La liste des valeurs attendues. Séparez les valeurs attendues par des espaces.
match_rule	string	La relation entre la liste des valeurs attendues et la liste des résultats DNS. Si les deux listes ne respectent pas la relation spécifiée, la détection échoue. Valeurs valides : Chaîne vide ou IN_DNS : La liste des valeurs attendues est un sous-ensemble de la liste des résultats DNS. DNS_IN : La liste des résultats DNS est un sous-ensemble de la liste des valeurs attendues. EQUAL : La liste des résultats DNS est identique à la liste des valeurs attendues. ANY : La liste des résultats DNS intersecte avec la liste des valeurs attendues.

FTP

Paramètre	Type	Description
port	int	Le numéro de port du serveur FTP. Si ce paramètre n'est pas spécifié, la valeur par défaut est utilisée. Le numéro de port par défaut est 21 pour FTP et 990 pour FTPS.
username	string	Le nom d'utilisateur utilisé pour se connecter au serveur FTP. Si ce paramètre n'est pas spécifié, la connexion anonyme est utilisée.
password	string	Le mot de passe utilisé pour se connecter au serveur FTP.

POP3/SMTP

Paramètre	Type	Description
port	int	Le numéro de port du serveur POP3. Le numéro de port par défaut est 110 pour POP3 et 995 pour POP3S.
username	string	Le nom d'utilisateur utilisé pour se connecter au serveur POP3 ou SMTP.
password	string	Le mot de passe utilisé pour se connecter au serveur POP3 ou SMTP.

TCP/UDP

Paramètre	Type	Description
port	int	Le numéro de port du serveur TCP ou UDP.
request_content	string	Le contenu de la requête. Si le paramètre request_format est défini sur hex, la valeur du paramètre request_content est analysée au format hexadécimal.
request_format	string	Si le paramètre request_format est défini sur une autre valeur, la valeur du paramètre request_content est envoyée au serveur TCP ou UDP sous forme de chaîne régulière.
response_content	string	Le contenu de la réponse. Si la réponse du serveur TCP ou UDP ne contient pas le contenu spécifié par le paramètre response_content, la détection échoue. Si le paramètre response_format est défini sur hex, la valeur du paramètre response_content est analysée au format hexadécimal. Si le paramètre response_format est défini sur une autre valeur, la valeur du paramètre response_content est analysée comme une chaîne régulière.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Code	String	200	Le code d'état HTTP. Remarque Le code d'état 200 indique que l'appel a réussi.
Data	Struct		Le résultat de la modification de la tâche.
count	Integer	1	Le nombre de tâches de surveillance de site.
Message	String	successful	Le message renvoyé.
RequestId	String	68192f5d-0d45-4b98-9724-892813f86c71	L'ID de la requête.
Success	String	true	Indique si l'appel a réussi. Valeurs valides : true : L'appel a réussi. false : L'appel a échoué.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format XML

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

Format JSON

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

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.