DescribeInstanceMaintenanceAttributes - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Appelez cette opération pour interroger la politique de maintenance spécifiée d'une instance. Elle contient les principaux attributs de maintenance suivants :

Fenêtre de maintenance : période que vous spécifiez pour la maintenance.
Action de maintenance : action que vous spécifiez en réponse à l'arrêt de l'instance.

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

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeInstanceMaintenanceAttributes	Opération à effectuer. Définissez la valeur sur DescribeInstanceMaintenanceAttributes.
RegionId	String	Yes	cn-hangzhou	ID de région de l'instance. Appelez l'opération DescribeRegions pour interroger la liste des régions la plus récente.
PageNumber	Long	No	1	Numéro de page. La numérotation des pages commence à 1. Valeur par défaut : 1.
PageSize	Long	No	10	Nombre d'entrées par page. Valeurs valides : 1 à 100. Valeur par défaut : 10.
InstanceId.N	String	No	i-bp67acfmxazb4p****	ID de l'instance N.

Paramètres de réponse

Parameter	Type	Example	Description
PageSize	Integer	10	Nombre d'entrées par page.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la requête.
PageNumber	Integer	1	Numéro de page.
TotalCount	Integer	100	Nombre total d'attributs de maintenance interrogés.
MaintenanceAttributes	Array of MaintenanceAttribute		Attributs de maintenance.
MaintenanceAttribute
NotifyOnMaintenance	Boolean	false	Indique si une notification d'événement a été envoyée avant la maintenance.
InstanceId	String	i-bp67acfmxazb4p****	ID de l'instance.
MaintenanceWindows	Array of MaintenanceWindow		Fenêtres de maintenance.
MaintenanceWindow
EndTime	String	18:00:00	Heure de fin de la fenêtre de maintenance.
StartTime	String	02:00:00	Heure de début de la fenêtre de maintenance.
ActionOnMaintenance	Object		Attributs de l'action de maintenance de l'instance.
DefaultValue	String	AutoRecover	Action de maintenance par défaut.
Value	String	Stop	Action de maintenance actuelle. Valeurs valides : Stop : arrête l'instance. AutoRecover : récupère l'instance. AutoRedeploy : bascule l'instance, ce qui peut endommager les disques de données de l'instance.
SupportedValues	Array of String	Stop	Action de maintenance prise en charge.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com?Action=DescribeInstanceMaintenanceAttributes
&InstanceId.1=i-bp67acfmxazb4p****
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<DescribeInstanceMaintenanceAttributesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <TotalCount>100</TotalCount>
    <InstanceMaintenanceAttributes>
        <InstanceMaintenanceAttribute>
            <InstanceId>i-bp67acfmxazb4ph***</InstanceId>
            <NotifyOnMaintenance>false</NotifyOnMaintenance>
            <MaintenanceWindows >
                <MaintenanceWindow>
                    <StartTime>02:00:00</StartTime>
                    <EndTime>18:00:00</EndTime>
                </MaintenanceWindow>
            </MaintenanceWindows >
            <ActionOnMaintenance>
                <Value>Stop</Value>
                <DefaultValue>AutoRecover</DefaultValue>
                <SupportedValues>
                    <SupportedValue>Stop</SupportedValue>
                    <SupportedValue>AutoRecover</SupportedValue>
                </SupportedValues>
            </ActionOnMaintenance>
        </InstanceMaintenanceAttribute>
    </InstanceMaintenanceAttributes>
</DescribeInstanceMaintenanceAttributesResponse>

JSON format

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber" : 1,
  "PageSize" : 10,
  "TotalCount" : 100,
  "InstanceMaintenanceAttributes" : {
    "InstanceMaintenanceAttribute" : [ {
      "InstanceId" : "i-bp67acfmxazb4ph***",
      "NotifyOnMaintenance" : false,
      "MaintenanceWindows " : {
        "MaintenanceWindow" : [ {
          "StartTime" : "02:00:00",
          "EndTime" : "18:00:00"
        } ]
      },
      "ActionOnMaintenance" : {
        "Value" : "Stop",
        "DefaultValue" : "AutoRecover",
        "SupportedValues" : {
          "SupportedValue" : [ "Stop", "AutoRecover" ]
        }
      }
    } ]
  }
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	MissingParameter	%s	Un paramètre requis n'est pas spécifié.
403	InvalidParameter	%s	Valeur de paramètre non valide.
403	InstanceIdLimitExceeded	%s	Plus de 100 ID d'instance sont spécifiés.
403	OperationDenied.NotInWhiteList	%s	Vous n'êtes pas autorisé à effectuer cette opération. Réessayez après avoir obtenu l'autorisation.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	L'instance est introuvable. Vérifiez si l'ID d'instance spécifié est valide.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.