Todos os produtos
Search
Central de documentação

:ModifyInstanceMaintenanceAttributes

Última atualização: Jul 03, 2026

Use esta operação para modificar as propriedades de manutenção de uma ou mais instâncias.

Descrição

Esta operação modifica a política de manutenção de uma instância. A política consiste nas seguintes propriedades:

  • Janela de manutenção: período definido para realizar a manutenção.

  • Ação de manutenção: política configurada para responder ao desligamento da instância.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta operação no OpenAPI Explorer, que também gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

ModifyInstanceMaintenanceAttributes

Operação a ser executada. Defina o valor como ModifyInstanceMaintenanceAttributes.

RegionId

String

Sim

cn-hangzhou

ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

InstanceId.N

RepeatList

Não

i-bp67acfmxazb4ph****

ID da instância N. Valores válidos de N: 1 a 100.

MaintenanceWindow.N.StartTime

String

Não

02:00:00

Hora de início da janela de manutenção N. O horário deve ser em hora cheia (0 minuto e 0 segundo). Especifique os parâmetros MaintenanceWindow.N.StartTime e MaintenanceWindow.N.EndTime simultaneamente. O valor de MaintenanceWindow.N.Endtime deve ser de 1 a 23 horas posterior ao valor de MaintenanceWindow.N.StartTime. Use o formato HH:mm:ss e o fuso horário UTC+8. Defina N como 1.

MaintenanceWindow.N.EndTime

String

Não

18:00:00

Hora de término da janela de manutenção N. O horário deve ser em hora cheia (0 minuto e 0 segundo). Especifique os parâmetros MaintenanceWindow.N.StartTime e MaintenanceWindow.N.EndTime simultaneamente. O valor de MaintenanceWindow.N.Endtime deve ser de 1 a 23 horas posterior ao valor de MaintenanceWindow.N.StartTime. Use o formato HH:mm:ss e o fuso horário UTC+8. Defina N como 1.

ActionOnMaintenance

String

Não

AutoRecover

Ação de manutenção. Valores válidos:

  • Stop: interrompe a instância.

  • AutoRecover: recupera a instância automaticamente.

  • AutoRedeploy: executa failover na instância, o que pode danificar os discos de dados anexados.

NotifyOnMaintenance

Boolean

Não

false

Define se o sistema envia notificação de evento antes do desligamento da instância. Valores válidos:

  • True: envia notificação de evento.

  • False: não envia notificação de evento.

Valor padrão: false.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID da solicitação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com?Action=ModifyInstanceMaintenanceAttributes
&InstanceId.1=i-bp67acfmxazb4ph****
&ActionOnMaintenance=AutoRecover
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifyInstanceMaintenanceAttributesResponse>    
    <RequestId>E69FF3CC-94DD-42EF-8836-F33C45EDF9945ED</RequestId>
<ModifyInstanceMaintenanceAttributesResponse>

Formato JSON

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

{
    "RequestId": "E69FF3CC-94DD-42EF-8836-F33C45EDF9945ED"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

404

InvalidInstanceId.NotFound

%s

Mensagem de erro retornada porque a instância especificada não existe.

403

InvalidParameter

%s

Mensagem de erro retornada porque um parâmetro especificado é inválido.

403

OperationDenied.NotInWhiteList

%s

Mensagem de erro retornada porque você não tem autorização para executar esta operação. Tente novamente após obter a autorização necessária.

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