ModifyAutoSnapshotPolicyEx - - Centro de documentación de Alibaba Cloud

Modifica una política de instantáneas automáticas. Después de modificar una política de instantáneas automáticas aplicada a discos específicos, la política modificada entra en vigor inmediatamente en dichos discos.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer 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í	ModifyAutoSnapshotPolicyEx	La operación que desea ejecutar. Establezca el valor en ModifyAutoSnapshotPolicyEx.
regionId	String	Sí	cn-hangzhou	El ID de región de la política de instantáneas automáticas por modificar. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.
autoSnapshotPolicyId	String	Sí	sp-bp12m37ccmxvbmi5****	El ID de la política de instantáneas automáticas. Llame a la operación DescribeAutoSnapshotPolicyEx para consultar las políticas de instantáneas automáticas disponibles.
autoSnapshotPolicyName	String	No	SPTestName	El nombre de la política de instantáneas automáticas. Si no se especifica este parámetro, se conserva el nombre original de la política.
timePoints	String	No	["0", "1"]	Las horas del día en las que se crearán las instantáneas automáticas. La hora debe estar en UTC+8. Unidad: horas. Los valores válidos van de 0 a 23 y corresponden a las 24 horas en punto desde 00:00:00 hasta 23:00:00. Por ejemplo, un valor de 1 indica 01:00:00. Para programar la creación de varias instantáneas automáticas en un día, especifique varias horas. Especifique hasta 24 horas del día. Establezca este parámetro como una matriz JSON, por ejemplo `["0", "1", ... "23"]`. Separe las horas con comas (,).
repeatWeekdays	String	No	["1", "7"]	Los días de la semana en los que se crearán las instantáneas automáticas. Los valores válidos van de 1 a 7 y corresponden a los días de la semana. Por ejemplo, un valor de 1 indica lunes. Para programar la creación de varias instantáneas automáticas en una semana, especifique varios días. Especifique hasta siete días en un periodo de una semana. Establezca este parámetro como una matriz JSON, por ejemplo `["1", "2" ... "7"]`. Separe los valores de la matriz con comas (,).
retentionDays	Integer	No	30	El periodo de retención de la instantánea automática. Unidad: días. Valores válidos: -1: La instantánea automática se conserva permanentemente. 1 a 65536: La instantánea automática se conserva durante el número de días especificado. Valor predeterminado: -1.
EnableCrossRegionCopy	Boolean	No	false	Indica si se habilita cross-region replication para la instantánea automática. true: Habilita cross-region replication para la instantánea automática. false: Deshabilita cross-region replication para la instantánea automática.
TargetCopyRegions	String	No	["cn-hangzhou"]	La región de destino a la que se copiará la instantánea. Solo puede especificar una región de destino.
CopiedSnapshotsRetentionDays	Integer	No	30	El periodo de retención de la copia de la instantánea en la región de destino. Unidad: días. Valores válidos: -1: La instantánea se conserva permanentemente. 1 a 65535: La instantánea automática se conserva durante el número de días especificado. Valor predeterminado: -1.

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=ModifyAutoSnapshotPolicyEx
&autoSnapshotPolicyId=sp-bp12m37ccmxvbmi5****
&regionId=cn-hangzhou
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<ModifyAutoSnapshotPolicyResponse>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ModifyAutoSnapshotPolicyResponse>

Formato JSON

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

{
  "RequestId" : "F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
403	ParameterInvalid	The specified RegionId parameter is invalid.	El mensaje de error devuelto porque el parámetro regionId especificado no es válido.
403	ParameterInvalid	The specified RepeatWeekDays parameter is invalid.	El mensaje de error devuelto porque el parámetro repeatWeekdays especificado no es válido.
403	ParameterInvalid	The specified TimePoints parameter is invalid.	El mensaje de error devuelto porque el parámetro timePoints especificado no es válido.
403	ParameterInvalid	The specified AutoSnapshotPolicyId is invalid.	El mensaje de error devuelto porque el parámetro autoSnapshotPolicyId especificado no es válido.
403	ParameterInvalid	The specified RetentionDays parameter is invalid.	El mensaje de error devuelto porque el parámetro retentionDays especificado no es válido.
404	ParameterInvalid	The specified automatic snapshot policy does not exist.	El mensaje de error devuelto porque el parámetro autoSnapshotPolicyId especificado no existe.
404	ParameterInvalid	The specified automatic snapshot policy does not exist in the region.	El mensaje de error devuelto porque el parámetro autoSnapshotPolicyId especificado no existe.

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