ModifyAutoSnapshotPolicyEx - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Modifica una política de instantáneas automáticas, como la hora de creación de la instantánea, la fecha de repetición y el período de retención.

Descripción de la operación

Al invocar esta operación, tenga en cuenta los siguientes puntos:

Las políticas del sistema no se pueden modificar.
Después de modificar una política de instantáneas automáticas, los discos a los que se ha aplicado la política ejecutan de inmediato la política de instantáneas automáticas modificada.
Si la replicación de instantáneas entre regiones está habilitada y no se han configurado parámetros de cifrado, las instantáneas cifradas se cifran mediante la clave de servicio de la región de destino de forma predeterminada.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ecs:ModifyAutoSnapshotPolicyEx

update

*Snapshot.

acs:ecs:{#regionId}:{#accountId}:snapshotpolicy/{#autoSnapshotPolicyId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
regionId	string	Sí	El ID de la región de la política de instantáneas automáticas. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
autoSnapshotPolicyId	string	Sí	El ID de la política de instantáneas automáticas. Puede llamar a DescribeAutoSnapshotPolicyEx para consultar las políticas de instantáneas automáticas disponibles.	sp-bp12m37ccmxvbmi5****
autoSnapshotPolicyName	string	No	El nombre de la política de instantáneas automáticas. Si este parámetro se deja vacío, no se modifica el nombre.	SPTestName
timePoints	string	No	Los puntos en el tiempo en los que se crean las instantáneas automáticas. La hora se muestra en UTC+8. Unidad: horas. Valores válidos: 0 a 23, que corresponden a los 24 puntos en el tiempo desde las 00:00 hasta las 23:00. Por ejemplo, 1 indica las 01:00. Para crear varias instantáneas automáticas en un día, especifique varios puntos en el tiempo: Puede especificar hasta 24 puntos en el tiempo. Especifique varios puntos en el tiempo en una matriz JSON, como `"0", "1", … "23"`. Separe los puntos en el tiempo con comas (,).	["0", "1"]
repeatWeekdays	string	No	Los días de la semana en los que se crean las instantáneas automáticas. Unidad: días. El ciclo es semanal. Valores válidos: 1 a 7. Por ejemplo, 1 indica el lunes. Para crear varias instantáneas automáticas en una semana, especifique varios días: Puede especificar hasta 7 días. Especifique varios días en una matriz JSON, como `"1", "2", … "7"`. Separe los días con comas (,).	["1", "7"]
retentionDays	integer	No	El período de retención de las instantáneas automáticas. Unidad: días. Valores válidos: -1: Las instantáneas automáticas se retienen de forma permanente. 1 a 65536: Las instantáneas automáticas se retienen durante el número de días especificado. Valor predeterminado: -1.	30
EnableCrossRegionCopy	boolean	No	Especifica si se debe permitir la replicación automática entre regiones. true: Permitido. false: No permitido.	false
TargetCopyRegions	string	No	La región de destino a la que se replican las instantáneas entre regiones. Actualmente, solo se puede configurar una región de destino.	["cn-hangzhou"]
CopiedSnapshotsRetentionDays	integer	No	El período de retención de las réplicas de instantáneas entre regiones. Unidad: días. Valores válidos: -1: Las réplicas de instantáneas se retienen de forma permanente. 1 a 65535: Las réplicas de instantáneas se retienen durante el número de días especificado. Valor predeterminado: -1.	30
CopyEncryptionConfiguration	object	No	El objeto de parámetros de cifrado para la replicación de instantáneas entre regiones.
Arn	array<object>	No	Este parámetro no está disponible públicamente.
	object	No
AssumeRoleFor	integer	No	Este parámetro no está disponible públicamente.	1000000000
RoleType	string	No	Este parámetro no está disponible públicamente.	hide
Rolearn	string	No	Este parámetro no está disponible públicamente.	hide
Encrypted	boolean	No	Especifica si se debe habilitar el cifrado para la replicación de instantáneas entre regiones. Valores válidos: true: Habilitado. false: Deshabilitado. Valor predeterminado: false.	false
KMSKeyId	string	No	El ID de la clave KMS utilizada para la replicación cifrada de instantáneas entre regiones.	0e478b7a-4262-4802-b8cb-00d3fb40826X
TargetTags	array<object>	No	La lista de etiquetas de recursos de destino. La política de instantáneas automáticas coincide con los recursos de destino en función de las etiquetas.
	object	No	La etiqueta de recurso de destino.
Key	string	No	La clave de la etiqueta. Valores válidos de N: 1 a 5. La clave de la etiqueta no puede ser una cadena vacía. La clave de la etiqueta puede tener hasta 128 caracteres de longitud y no puede empezar con aliyun ni con acs:. La clave de la etiqueta no puede contener http:// ni https://.
Value	string	No	El valor de la etiqueta. Valores válidos de N: 1 a 5. El valor de la etiqueta puede tener hasta 128 caracteres de longitud y no puede contener `http://` ni `https://`. Nota Si proporciona un valor vacío o una cadena vacía, el valor de la etiqueta coincide con cualquier valor.

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidParameter.EncryptedIllegal	The Encrypted parameter must be set to true when KMSKeyId is specified. Please adjust the parameters and try again.
400	InvalidParameter.KmsNotEnabled	The operation failed because KMS is not activated. Please activate KMS in the KMS console and try again.
400	InvalidParameter.Encrypted.KmsNotEnable	The operation failed because KMS is not activated. Please activate KMS in the KMS console and try again.
400	InvalidParam.EncryptedMismatch	Creating a disk from a shared encrypted image requires encryption with your own KMS key. Please set the Encrypted parameter to true.
400	InvalidTargetTags.NotSupported	When the parameter AssociationType is set to AssociatedWithDisk, the TargetTags parameter is not supported.
400	InvalidTargetTagKey.Malformed	The specified TargetTag.n.Key [%s] is not valid.
400	InvalidTargetTagValue.Malformed	The specified TargetTag.n.Value [%s] is not valid.
400	Duplicate.TargetTagKey	Duplicate keys exist in the specified parameter TargetTags. Please ensure key uniqueness.
400	InvalidTargetTag.LimitExceed	The number [%s] of the specified parameter TargetTag exceeds the limit [%s].
403	ParameterInvalid	The specified RegionId parameter is invalid.	La política de instantáneas automáticas especificada no existe. Verifique si la política de instantáneas automáticas es correcta.
403	InvalidParameter.TargetCopyRegions	The specified TargetCopyRegions is invalid.
403	InvalidParameter.CopiedSnapshotsRetentionDays	The specified CopiedSnapshotsRetentionDays is invalid.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service.
403	Abs.InvalidAction.RegionNotSupport	This region does not support this action.	La región no admite esta operación.
403	InvalidOperation.PolicyTypeUnsupported	The current policy type does not support this operation. Only custom policies are permitted.	El tipo de política actual no admite esta operación. Solo las políticas personalizadas permiten esta operación.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The specified KMS key must be in an enabled state. Please enable the key in the KMS console and try again.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The specified KMS key is not authorized for the ECS service. Please grant the ECS service permission to use the key in the KMS console and try again.
403	InvalidOperation.CopyingDataToThisRegionUnsupported	Data transfer to the current region from other regions is not supported.	Solo regiones específicas pueden replicar datos a la región actual.
404	ParameterInvalid	The specified automatic snapshot policy does not exist.
404	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.