ModifyInstanceMaintenanceAttributes - - Centro de documentación de Alibaba Cloud

Llame a esta operación para modificar las propiedades de mantenimiento de una o más instancias.

Descripción

Esta operación modifica la directiva de mantenimiento de una instancia. La directiva de mantenimiento consta de las siguientes propiedades:

Ventana de mantenimiento: el período que usted especifica para el mantenimiento.
Acción de mantenimiento: la directiva que usted especifica como respuesta al apagado de la instancia.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ModifyInstanceMaintenanceAttributes	La operación que desea ejecutar. Establezca el valor en ModifyInstanceMaintenanceAttributes.
RegionId	String	Sí	cn-hangzhou	El ID de región de la instancia. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.
InstanceId.N	RepeatList	No	i-bp67acfmxazb4ph****	El ID de la instancia N. Valores válidos de N: 1 a 100.
MaintenanceWindow.N.StartTime	String	No	02:00:00	La hora de inicio de la ventana de mantenimiento N. La hora debe ser exacta, con 0 minutos y 0 segundos. Los parámetros MaintenanceWindow.N.StartTime y MaintenanceWindow.N.EndTime deben especificarse simultáneamente. El valor de MaintenanceWindow.N.Endtime debe ser de 1 a 23 horas posterior al valor de MaintenanceWindow.N.StartTime. Especifique la hora en formato `HH:mm:ss`. La hora debe estar en UTC+8. Establezca el valor de N en 1.
MaintenanceWindow.N.EndTime	String	No	18:00:00	La hora de finalización de la ventana de mantenimiento N. La hora debe ser exacta, con 0 minutos y 0 segundos. Los parámetros MaintenanceWindow.N.StartTime y MaintenanceWindow.N.EndTime deben especificarse simultáneamente. El valor de MaintenanceWindow.N.Endtime debe ser de 1 a 23 horas posterior al valor de MaintenanceWindow.N.StartTime. Especifique la hora en formato `HH:mm:ss`. La hora debe estar en UTC+8. Establezca el valor de N en 1.
ActionOnMaintenance	String	No	AutoRecover	La acción de mantenimiento. Valores válidos: Stop: detiene la instancia. AutoRecover: recupera automáticamente la instancia. AutoRedeploy: ejecuta un failover de la instancia, lo cual puede dañar los discos de datos conectados a ella.
NotifyOnMaintenance	Boolean	No	false	Indica si se envía una notificación de evento antes del apagado de la instancia. Valores válidos: True: envía una notificación de evento. False: no envía una notificación de evento. Valor predeterminado: false.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
404	InvalidInstanceId.NotFound	%s	El mensaje de error devuelto porque la instancia especificada no existe.
403	InvalidParameter	%s	El mensaje de error devuelto porque un parámetro especificado no es válido.
403	OperationDenied.NotInWhiteList	%s	El mensaje de error devuelto porque no tiene autorización para realizar esta operación. Inténtelo de nuevo cuando tenga la autorización correspondiente.

Para obtener una lista de códigos de error, visite el Centro de errores de API.