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

Observações de uso

Use esta operação para consultar a política de manutenção especificada de uma instância, que inclui os seguintes atributos principais:

Janela de manutenção: período definido para manutenção.
Ação de manutenção: comportamento configurado em resposta ao desligamento da instância.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeInstanceMaintenanceAttributes	Operação a ser executada. Defina o valor como DescribeInstanceMaintenanceAttributes.
RegionId	String	Sim	cn-hangzhou	ID da região da instância. Chame a operação DescribeRegions para obter a lista mais recente de regiões.
PageNumber	Long	Não	1	Número da página. A numeração começa na página 1. Valor padrão: 1.
PageSize	Long	Não	10	Número de entradas por página. Valores válidos: 1 a 100. Valor padrão: 10.
InstanceId.N	String	Não	i-bp67acfmxazb4p****	ID da instância N.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
PageSize	Integer	10	Número de entradas por página.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID da solicitação.
PageNumber	Integer	1	Número da página retornada.
TotalCount	Integer	100	Total de atributos de manutenção consultados.
MaintenanceAttributes	Array of MaintenanceAttribute		Atributos de manutenção.
MaintenanceAttribute
NotifyOnMaintenance	Boolean	false	Indica se uma notificação de evento foi enviada antes da manutenção.
InstanceId	String	i-bp67acfmxazb4p****	ID da instância.
MaintenanceWindows	Array of MaintenanceWindow		Janelas de manutenção.
MaintenanceWindow
EndTime	String	18:00:00	Horário de término da janela de manutenção.
StartTime	String	02:00:00	Horário de início da janela de manutenção.
ActionOnMaintenance	Object		Atributos da ação de manutenção da instância.
DefaultValue	String	AutoRecover	Ação de manutenção padrão.
Value	String	Stop	Ação de manutenção atual. Valores válidos: Stop: interrompe a instância. AutoRecover: recupera a instância. AutoRedeploy: executa failover da instância, o que pode causar danos aos discos de dados nela contidos.
SupportedValues	Array of String	Stop	Ação de manutenção compatível.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato XML

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>

Formato JSON

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" ]
        }
      }
    } ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	MissingParameter	%s	Um parâmetro obrigatório não foi especificado.
403	InvalidParameter	%s	Valor de parâmetro inválido.
403	InstanceIdLimitExceeded	%s	Mais de 100 IDs de instância foram especificados.
403	OperationDenied.NotInWhiteList	%s	Você não tem autorização para executar esta operação. Tente novamente após receber a autorização.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Instância não encontrada. Verifique se o ID da instância especificado é válido.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.