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

Crea una política de instantáneas automáticas en una región especificada. Permite especificar el ciclo de repetición, el período de retención y la configuración de copias de seguridad entre regiones para generar copias de seguridad de instantáneas de discos del sistema o discos de datos.

Descripción de la operación

Antes de llamar a esta operación, lea atentamente Creación de una política de instantáneas automáticas.

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

Una cuenta de Alibaba Cloud puede crear hasta 100 políticas de instantáneas automáticas en una región. Cuando el número de instantáneas automáticas de un disco alcanza el límite de cuota, el sistema elimina la instantánea automática más antigua generada por la política de instantáneas automáticas al crear una nueva tarea de instantánea.
El sistema no ejecuta la política de instantáneas automáticas cuando una instancia de ECS tiene una tarea de detención o reinicio.
Si la replicación de instantáneas entre regiones está habilitada y no se configuran los parámetros de cifrado, las instantáneas cifradas se copian y cifran mediante la clave de servicio de destino de forma predeterminada. Para conocer las precauciones sobre la replicación de instantáneas entre regiones, consulte Copiar una instantánea.

Después de crear una política de instantáneas automáticas, debe llamar a ApplyAutoSnapshotPolicy para aplicar la política al disco de destino. Para modificar la política de instantáneas automáticas, llame a ModifyAutoSnapshotPolicyEx.

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:CreateAutoSnapshotPolicy

create

*AutoSnapshotPolicy.

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
regionId	string	Sí	La región a la que pertenece la política de instantáneas automáticas. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
autoSnapshotPolicyName	string	No	El nombre de la política de instantáneas automáticas. El nombre debe tener de 2 a 128 caracteres de longitud. Debe comenzar con una letra o un carácter chino, y no puede comenzar con http:// o https://. Puede contener dígitos, dos puntos (:), guiones bajos (_) y guiones (-). Valor predeterminado: null.	TestName
timePoints	string	Sí	Las horas en las que se crean las instantáneas automáticas. La hora está en UTC+8 y se mide en horas. Valores válidos: 0 a 23, que representan las 24 horas desde las 00:00 hasta las 23:00. Por ejemplo, 1 indica las 01:00. Descripción del formato: El parámetro debe estar en formato de matriz JSON. Por ejemplo, ["1"] indica que las instantáneas automáticas se crean a las 01:00. Si desea crear varias instantáneas automáticas en un día, puede especificar varias horas separadas por comas (,). Puede especificar hasta 24 horas. Por ejemplo, ["1","3","5"] indica que las instantáneas automáticas se crean a las 01:00, 03:00 y 05:00. Nota Si el disco contiene una gran cantidad de datos y la duración de la creación de una sola instantánea automática supera el intervalo entre dos horas, el sistema omite la siguiente hora. Por ejemplo, si establece las horas en 09:00, 10:00, 11:00 y 12:00, y la creación comienza a las 09:00 y termina a las 10:20, tardando 80 minutos, el sistema omite las 10:00 y crea la siguiente instantánea automática a las 11:00.	["0", "1", … "23"]
repeatWeekdays	string	Sí	Los días de la semana en los que se crean las instantáneas automáticas. Valores válidos: 1 a 7, que representan de lunes a domingo. Por ejemplo, 1 indica el lunes. Descripción del formato: El parámetro debe estar en formato de matriz JSON. Por ejemplo, ["1"] indica que las instantáneas automáticas se crean todos los lunes. Si desea crear instantáneas automáticas varias veces a la semana, puede especificar varios días separados por comas (,). Puede especificar hasta 7 días. Por ejemplo, ["1","3","5"] indica que las instantáneas automáticas se crean todos los lunes, miércoles y viernes.	["1","2"]
retentionDays	integer	Sí	El período de retención de las instantáneas automáticas. Unidad: días. Valores válidos: -1: Las instantáneas se conservan de forma permanente. 1 a 65535: Las instantáneas se conservan durante el número de días especificado. Valor predeterminado: -1.	30
EnableCrossRegionCopy	boolean	No	Especifica si se debe habilitar la replicación automática entre regiones. Valores válidos: true: Sí. false: No.	false
TargetCopyRegions	string	No	La región de destino para la replicación de instantáneas entre regiones. Solo puede especificar una región de destino.	["cn-hangzhou"]
StorageLocationArn	string	No	Nota Este parámetro no está disponible.	null
CopiedSnapshotsRetentionDays	integer	No	El período de retención de las instantáneas replicadas entre regiones. Unidad: días. Valores válidos: -1: Las instantáneas se conservan de forma permanente. 1 a 65535: Las instantáneas se conservan durante el número de días especificado. Valor predeterminado: -1.	30
CopyEncryptionConfiguration	object	No	El objeto de parámetros de cifrado de copia de seguridad para la georredundancia de instantáneas.
Arn	array<object>	No	Nota Este parámetro no está disponible.
	object	No
AssumeRoleFor	integer	No	Nota Este parámetro no está disponible.	1000000000
RoleType	string	No	Nota Este parámetro no está disponible.	hide
Rolearn	string	No	Nota Este parámetro no está disponible.	hide
Encrypted	boolean	No	Especifica si se debe habilitar el cifrado para la copia de seguridad de instantáneas entre regiones. Valores válidos: true: Sí. false: No. Valor predeterminado: false.	false
KMSKeyId	string	No	El ID de clave de KMS utilizado para el cifrado de copias de seguridad de la georredundancia de instantáneas.	0e478b7a-4262-4802-b8cb-00d3fb40826X
ResourceGroupId	string	No	El ID del grupo de recursos.	rg-aek2kkmhmhs****
Tag	array<object>	No	La lista de etiquetas de la política de instantáneas automáticas.
	object	No
Key	string	No	La clave de etiqueta de la política de instantáneas automáticas. Valores válidos de N: 1 a 20. Si especifica este parámetro, no puede ser una cadena vacía. La clave de etiqueta puede tener hasta 128 caracteres de longitud, y no puede comenzar con aliyun o acs:, ni contener http:// o https://.	TestKey
Value	string	No	El valor de etiqueta de la política de instantáneas automáticas. Valores válidos de N: 1 a 20. Si especifica este parámetro, puede ser una cadena vacía. El valor de etiqueta puede tener hasta 128 caracteres de longitud, y no puede comenzar con acs:, ni contener http:// o https://.	TestValue
AssociationType	string	No	El tipo de asociación entre la política de instantáneas automáticas y los recursos de destino. Valores válidos: AssociatedWithDisk: asocia con discos. AssociatedWithInstanceTag: asocia con etiquetas de instancia. Valor predeterminado: AssociatedWithDisk.	AssociatedWithDisk
TargetTags	array<object>	No	La lista de etiquetas de recursos de destino. La política de instantáneas automáticas identifica los recursos de destino en función de las etiquetas. Este parámetro es obligatorio cuando `AssociationType` se establece en `AssociatedWithInstanceTag`.
	object	No	La etiqueta del recurso de destino.
Key	string	No	La clave de la etiqueta. Valores válidos de N: 1 a 5. Si especifica este parámetro, no puede ser una cadena vacía. La clave de etiqueta puede tener hasta 128 caracteres de longitud, y no puede comenzar con aliyun o acs:, ni contener http:// o https://.	TestKey
Value	string	No	El valor de la etiqueta. Valores válidos de N: 1 a 5. El valor de etiqueta puede tener hasta 128 caracteres de longitud, y no puede contener `http://` o `https://`. Nota Si deja este parámetro vacío o especifica una cadena vacía, indica cualquier valor.	TestValue

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
AutoSnapshotPolicyId	string	El ID de la política de instantáneas automáticas.	sp-bp12m37ccmxvbmi5****
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Ejemplos

Respuesta exitosa

JSON Formato

{
  "AutoSnapshotPolicyId": "sp-bp12m37ccmxvbmi5****",
  "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	DiskCategory.OperationNotSupported	The type of the specified disk does not support creating a snapshot.	El tipo de disco actual no admite esta operación.
400	InvalidSnapshotPolicyName.Malformed	The specified autoSnapshotPolicyName is malformed.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Hay claves duplicadas en las etiquetas. Asegúrese de que todas las claves sean únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	El parámetro de clave de etiqueta especificado no es válido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	El parámetro de valor de etiqueta especificado no es válido.
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	InvalidAssociationType.Malformed	The specified parameter AssociationType is invalid. Please check the valid range for this parameter.
400	MissingParameter.TargetTags	When the parameter AssociationType is set to AssociatedWithInstanceTag, the TargetTags parameter is required.
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	AutoSnapshotPolicy.QuotaExceed	The maximum number of automatic snapshot policy has been reached.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	InvalidAccountStatus.SnapshotServiceUnavailable	Snapshot service has not been opened yet.	El servicio de instantáneas no está activado. No se puede realizar la operación.
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	InvalidOperation.KMSKeyIdNotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.
403	Abs.InvalidAction.RegionNotSupport	This region does not support this action.	La región no admite 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	InvalidStorageLocationArn.Malformed	The specified parameter StorageLocationArn is malformed.
403	InvalidOperation.UserNotInWhiteList	The current user is temporarily unable to use this feature. Please submit a ticket for assistance.
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	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	El grupo de recursos no se encuentra en los registros.

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.