Tous les produits
Search

Ce produit

    :ModifyHostAvailability

    Centre de documentation

    :ModifyHostAvailability

    Dernière mise à jour :Aug 08, 2026

    Modifie une tâche de surveillance de disponibilité.

    Cette rubrique explique comment modifier le nom de la tâche de surveillance de disponibilité 12345 du groupe d'applications 123456 pour le définir sur task2.

    Débogage

    OpenAPI Explorer calcule automatiquement la valeur de 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 ModifyHostAvailability

    Opération à effectuer. Définissez la valeur sur ModifyHostAvailability.

    GroupId Long Oui 123456

    ID du groupe d'applications.

    Id Long Oui 12345

    ID de la tâche de surveillance de disponibilité.

    TaskName String Oui task2

    Nom de la tâche de surveillance de disponibilité.

    TaskScope String Non GROUP

    Plage des instances surveillées par la tâche de surveillance de disponibilité. Valeurs valides :

    • GROUP : Toutes les instances ECS du groupe d'applications sont surveillées.
    • GROUP_SPEC_INSTANCE : Seules les instances ECS spécifiées dans le groupe d'applications sont surveillées. Utilisez ce paramètre conjointement avec le paramètre InstanceList.N, qui spécifie les instances ECS à surveiller.
    TaskOption.HttpURI String Non https://www.aliyun.com

    URI à surveiller. Si le paramètre TaskType est défini sur HTTP, ce paramètre est obligatoire.

    TaskOption.TelnetOrPingHost String Non www.aliyun.com

    Nom de domaine ou adresse IP à surveiller.

    Remarque Si le paramètre TaskType est défini sur PING ou TELNET, ce paramètre est obligatoire. Pour plus d'informations sur la définition du paramètre TaskType, consultez CreateHostAvailability.
    TaskOption.HttpResponseCharset String Non UTF-8

    Jeu de caractères utilisé dans la réponse HTTP.

    Remarque Valeur valide : UTF-8.
    TaskOption.HttpPostContent String Non params1=value1

    Contenu de la requête HTTP POST.

    TaskOption.HttpResponseMatchContent String Non ok

    Réponse attendue à la requête HTTP.

    TaskOption.HttpMethod String Non GET

    Méthode de requête HTTP. Valeurs valides :

    • GET
    • POST
    • HEAD
    Remarque Si le paramètre TaskType est défini sur HTTP, ce paramètre est obligatoire. Pour plus d'informations sur la définition du paramètre TaskType, consultez CreateHostAvailability.
    TaskOption.HttpNegative Boolean Non true

    Méthode de déclenchement d'une alerte. L'alerte se déclenche selon que la règle d'alerte spécifiée est incluse ou non dans le corps de la réponse. Valeurs valides :

    • true : Une alerte est déclenchée si le corps de la réponse HTTP inclut la règle d'alerte.
    • false : Une alerte est déclenchée si la réponse HTTP n'inclut pas la règle d'alerte.
    Remarque Si le paramètre TaskType est défini sur HTTP, ce paramètre est obligatoire. Pour plus d'informations sur la définition du paramètre TaskType, consultez CreateHostAvailability.
    TaskOption.HttpHeader String Non params1:value1

    En-tête de la requête HTTP. Format : Nom du paramètre:Valeur du paramètre. Séparez plusieurs paramètres par des retours à la ligne. Exemple :

    
params1:value1
params2:value2
    TaskOption.Interval Integer Non 60

    Intervalle d'envoi des requêtes de détection. Unité : secondes. Valeurs valides : 15, 30, 60, 120, 300, 900, 1800 et 3600.

    Remarque Ce paramètre est disponible uniquement pour l'agent CloudMonitor version 3.5.1 ou ultérieure.
    AlertConfig.NotifyType Integer Oui 0

    Méthodes de notification d'alerte. Valeurs valides :

    0 : Les notifications d'alerte sont envoyées par e-mail et via les robots de discussion DingTalk.

    AlertConfig.StartTime Integer Non 0

    Début de la période pendant laquelle la règle d'alerte est effective. Valeurs valides : 0 à 23.

    Par exemple, si le paramètre AlertConfig.StartTime est défini sur 0 et le paramètre AlertConfig.EndTime sur 22, la règle d'alerte est effective de 00:00:00 à 22:00:00.

    Remarque Les notifications d'alerte sont envoyées en fonction du seuil spécifié uniquement si la règle d'alerte est effective.
    AlertConfig.EndTime Integer Non 22

    Fin de la période pendant laquelle la règle d'alerte est effective. Valeurs valides : 0 à 23.

    Par exemple, si le paramètre AlertConfig.StartTime est défini sur 0 et le paramètre AlertConfig.EndTime sur 22, la règle d'alerte est effective de 00:00:00 à 22:00:00.

    Remarque Les notifications d'alerte sont envoyées en fonction du seuil spécifié uniquement si la règle d'alerte est effective.
    AlertConfig.SilenceTime Integer Non 86400

    Période de silence pendant laquelle aucune nouvelle alerte n'est envoyée, même si les conditions de déclenchement sont remplies. Unité : secondes. Valeur par défaut : 86400 (un jour).

    AlertConfig.WebHook String Non https://www.aliyun.com/webhook.json

    URL de rappel.

    AlertConfigEscalationList.N.MetricName String Oui HttpStatus

    Métrique pour laquelle la fonction d'alerte est activée. Valeurs valides de N : 1 à 21. Valeurs valides :

    • HttpStatus : Code d'état HTTP
    • HttpLatency : Temps de réponse HTTP
    • TelnetStatus : Code d'état Telnet
    • TelnetLatency : Temps de réponse Telnet
    • PingLostRate : Taux de perte de paquets Ping
    AlertConfigEscalationList.N.Value String Non 3

    Seuil d'alerte. Valeurs valides de N : 1 à 21.

    AlertConfigEscalationList.N.Times Integer Non 3

    Nombre consécutif de fois où la valeur de la métrique doit satisfaire à la condition d'alerte avant qu'une alerte ne soit déclenchée. Valeurs valides de N : 1 à 21.

    AlertConfigEscalationList.N.Operator String Non >

    Opérateur de comparaison utilisé dans la règle d'alerte. Valeurs valides de N : 1 à 21. Valeurs valides :

    • >
    • >=
    • <
    • <=
    • =
    AlertConfigEscalationList.N.Aggregate String Non Value

    Méthode utilisée pour calculer les valeurs de métrique qui déclenchent les alertes. Valeurs valides de N : 1 à 21. La valeur de ce paramètre varie selon la métrique. Les points suivants décrivent la correspondance entre les métriques et les méthodes de calcul :

    • HttpStatus : Value
    • HttpLatency : Average
    • TelnetStatus : Value
    • TelnetLatency : Average
    • PingLostRate : Average
    Remarque La valeur Value indique la valeur d'origine et est utilisée pour les métriques telles que les codes d'état. La valeur Average indique la valeur moyenne et est utilisée pour les métriques telles que la latence et le taux de perte de paquets.
    InstanceList.N String Non 2

    Instances ECS surveillées. Valeurs valides de N : 1 à 21.

    Remarque Si le paramètre TaskScope est défini sur GROUP_SPEC_INSTANCE, ce paramètre est obligatoire.
    AlertConfigTargetList.N.Id String Non 1

    ID de la ressource pour laquelle les alertes sont déclenchées.

    AlertConfigTargetList.N.Arn String Non acs:mns:cn-hangzhou:111:/queues/test/message

    Nom de ressource Alibaba Cloud (ARN) de la ressource.

    Format : acs:{Abréviation du nom du service}:{regionId}:{userId}:/{Type de ressource}/{Nom de la ressource}/message. Exemple : acs:mns:cn-hangzhou:120886317861****:/queues/test123/message. Champs :

    • {Abréviation du nom du service} : abréviation du nom du service. Valeur valide : mns.
    • {userId} : ID du compte Alibaba Cloud.
    • {regionId} : ID de la région de la file d'attente de messages ou du sujet.
    • {Type de ressource}: type de la ressource pour laquelle les alertes sont déclenchées. Valeurs valides : - **queues** - **topics** {Nom de la ressource} : nom de la ressource. - Si le type de ressource est défini sur **queues**, le nom de la ressource est le nom de la file d'attente de messages. - Si le type de ressource est défini sur **topics**, le nom de la ressource est le nom du sujet.
    AlertConfigTargetList.N.Level String Non ["INFO", "WARN", "CRITICAL"]

    Niveau de l'alerte. Valeurs valides :

    • INFO : information
    • WARN : avertissement
    • CRITICAL : critique
    AlertConfigTargetList.N.JsonParams String Non {"customField1":"value1","customField2":"$.name"}

    Paramètres du rappel d'alerte. Les paramètres sont au format JSON.

    Pour plus d'informations sur les paramètres de requête communs, consultez Paramètres communs.

    Paramètres de réponse

    Paramètre Type Exemple Description
    Code String 200

    Code d'état HTTP.

    Remarque Le code d'état 200 indique que l'appel a réussi.
    Message String The specified resource is not found.

    Message d'erreur.

    RequestId String 16E815A3-47E1-4290-87F9-D5C99471FF45

    ID de la requête.

    Success Boolean 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=ModifyHostAvailability
&AlertConfig.NotifyType=0
&AlertConfigEscalationList.1.MetricName=HttpStatus
&GroupId=123456
&Id=12345
&TaskName=task2
&<Common request parameters>

    Exemples de réponses réussies

    Format 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>

    Format JSON

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "16E815A3-47E1-4290-87F9-D5C99471FF45",
  "Code" : 200,
  "Success" : true
}

    Codes d'erreur

    HttpCode

    Code d'erreur

    Message d'erreur

    Description

    404

    ResourceNotFound

    The specified resource is not found.

    Message d'erreur renvoyé car la ressource spécifiée est introuvable.

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