CreateSnapshot - - Centro de documentación de Alibaba Cloud

Crea una instantánea para un disco.

Descripción

La función de instantánea local ha sido reemplazada por la función de acceso instantáneo.

Si utilizó la función de instantánea local antes del 14 de diciembre de 2020, puede usar los parámetros Category o InstantAccess con normalidad y debe tener en cuenta lo siguiente:
- Los parámetros Category y InstantAccess no se pueden especificar al mismo tiempo.
- Si no se especifica ninguno de los parámetros Category y InstantAccess, se crean instantáneas normales.
Si no utilizó la función de instantánea local antes del 14 de diciembre de 2020, puede usar el parámetro InstantAccess pero no puede usar el parámetro Category.

En los siguientes escenarios, no es posible crear instantáneas para un disco:

El número de instantáneas manuales del disco ha alcanzado el límite de 256.
Se está creando una instantánea para el disco.
La instancia de Elastic Compute Service (ECS) a la que está conectado el disco nunca se ha iniciado.
La instancia de ECS a la que está conectado el disco no se encuentra en estado Stopped (Stopped) ni Running (Running).
Si la respuesta contiene {"OperationLocks": {"LockReason" : "security"}} al consultar la información de la instancia, significa que esta se encuentra bloqueada por motivos de seguridad y todas las operaciones están prohibidas.

Al crear una instantánea, tenga en cuenta lo siguiente:

Si se está creando una instantánea, no puede utilizarla para crear una imagen personalizada mediante la operación CreateImage.
Mientras se crea una instantánea para un disco conectado a una instancia de ECS, no cambie el estado de la instancia.
Es posible crear instantáneas para un disco que se encuentre en estado Expired (Expired). Si llega la hora de liberación programada de un disco mientras se crea una instantánea para este, la instantánea permanecerá en estado Creating (Creating) y se eliminará cuando se libere el disco.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente 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í	CreateSnapshot	La operación que desea realizar. Establezca el valor en CreateSnapshot.
DiskId	String	Sí	d-bp1s5fnvk4gn2tws0****	El ID del disco.
SnapshotName	String	No	testSnapshotName	El nombre de la instantánea. Debe tener entre 2 y 128 caracteres de longitud. Tiene que comenzar con una letra y no puede empezar con `http://` ni `https://`. Puede contener letras, dígitos, dos puntos (:), guiones bajos (_) y guiones (-). No puede comenzar con `auto`, ya que las instantáneas cuyos nombres inician con auto se reconocen como instantáneas automáticas.
Description	String	No	testDescription	La descripción de la instantánea. Debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con `http://` ni `https://`. Este parámetro está vacío de forma predeterminada.
RetentionDays	Integer	No	30	El periodo de retención de la instantánea. Valores válidos: de 1 a 65536. Unidad: días. La instantánea se libera automáticamente cuando expira su periodo de retención. Este parámetro está vacío de forma predeterminada, lo que indica que la instantánea no se libera automáticamente.
Category	String	No	Standard	El tipo de instantánea. Valores válidos: Standard: instantánea normal Flash: instantánea local Nota Este parámetro se eliminará en el futuro. Le recomendamos utilizar el parámetro `InstantAccess` para garantizar la compatibilidad futura. Este parámetro y `InstantAccess` no se pueden especificar al mismo tiempo. Para obtener más información, consulte la sección "Descripción" de este tema.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede generar el valor desde el cliente, pero debe asegurarse de que sea único entre distintas solicitudes. El valor de ClientToken solo puede contener caracteres ASCII y no debe exceder los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	El ID del resource group al que se asignará la instantánea.
InstantAccess	Boolean	No	false	Especifica si se habilita la función de acceso instantáneo. Valores válidos: true: habilita la función de acceso instantáneo. Esta función solo se puede habilitar para discos SSD mejorados (ESSD). Nota Una vez habilitada la función de acceso instantáneo, la instantánea se puede utilizar para restaurar discos o crear discos en distintas zonas incluso mientras se está creando. Esta función garantiza el acceso inmediato a una nueva instantánea para un ESSD, independientemente de su tamaño. false: no habilita la función de acceso instantáneo. Si InstantAccess se establece en false, se crea una instantánea normal. Valor predeterminado: false. Nota Este parámetro y `Category` no se pueden especificar al mismo tiempo. Para obtener más información, consulte la sección "Descripción" de este tema.
InstantAccessRetentionDays	Integer	No	1	El periodo de validez de la función de acceso instantáneo. Cuando finaliza este periodo, la función se deshabilita y la instantánea de acceso instantáneo (IA) se libera automáticamente. Este parámetro solo surte efecto cuando `InstantAccess` se establece en true. Unidad: días. Valores válidos: de 1 a 65535. De forma predeterminada, el valor de este parámetro es igual al de `RetentionDays`.
Tag.N.key	String	No	null	La clave de la etiqueta N que se añadirá a la instantánea. Nota Este parámetro se eliminará en el futuro. Le recomendamos utilizar el parámetro Tag.N.Key para garantizar la compatibilidad futura.
Tag.N.Key	String	No	TestKey	La clave de la etiqueta N que se añadirá a la instantánea. Valores válidos de N: de 1 a 20. La clave de la etiqueta no puede ser una cadena vacía. Puede tener hasta 128 caracteres de longitud y no puede comenzar con acs: ni aliyun. No puede contener http:// ni https://.
Tag.N.Value	String	No	TestValue	El valor de la etiqueta N que se añadirá a la instantánea. Valores válidos de N: de 1 a 20. El valor de la etiqueta puede ser una cadena vacía. Puede tener hasta 128 caracteres de longitud y no puede comenzar con acs: ni contener http:// ni https://.
Tag.N.value	String	No	null	El valor de la etiqueta N que se añadirá a la instantánea. Nota Este parámetro se eliminará en el futuro. Le recomendamos utilizar el parámetro Tag.N.Value para garantizar la compatibilidad futura.
StorageLocationArn	String	No	null	Nota Este parámetro no está disponible.

Parámetros de respuesta

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

Ejemplos

Solicitudes de ejemplo

https://ecs.aliyuncs.com/?Action=CreateSnapshot
&DiskId=d-bp1s5fnvk4gn2tws0****
&SnapshotName=testSnapshotName
&Description=testDescription
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<CreateSnapshotResponse>
        <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
        <SnapshotId>s-bp17441ohwka0yuh****</SnapshotId>
</CreateSnapshotResponse>

Formato JSON

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

{
  "RequestId" : "C8B26B44-0189-443E-9816-D951F59623A9",
  "SnapshotId" : "s-bp17441ohwka0yuh****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist.	El mensaje de error devuelto porque el ID de clave de Key Management Service (KMS) especificado no existe.
400	InvalidSnapshotName.Malformed	The specified SnapshotName is wrongly formed.	El mensaje de error devuelto porque el parámetro SnapshotName especificado no es válido.
400	IncorrectInstanceStatus	The current status of the resource does not support this operation.	El mensaje de error devuelto porque la operación no es compatible mientras el recurso se encuentra en su estado actual.
400	DiskCategory.OperationNotSupported	The operation is not supported to the specified disk due to its disk category	El mensaje de error devuelto porque la categoría del disco especificado no admite esta operación.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	El mensaje de error devuelto porque la clave de etiqueta especificada ya existe. Las claves de etiqueta deben ser únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	El mensaje de error devuelto porque el parámetro Tag.N.Key especificado no es válido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	El mensaje de error devuelto porque el parámetro Tag.N.Value especificado no es válido.
400	InvalidRetentionDays.Malformed	The specified RetentionDays is not valid.	El mensaje de error devuelto porque el parámetro RetentionDays especificado no es válido.
403	Throttling	Request was denied due to user flow control.	El mensaje de error devuelto porque su solicitud fue limitada. Inténtelo de nuevo más tarde.
403	IncorrectDiskStatus.CreatingSnapshot	A previous snapshot creation is in process.	El mensaje de error devuelto porque se está creando otra instantánea para el disco. Espere a que se cree la instantánea e inténtelo de nuevo.
403	InstanceLockedForSecurity	The disk attached instance is locked due to security.	El mensaje de error devuelto porque la instancia a la que está conectado el disco se encuentra bloqueada por motivos de seguridad.
403	IncorrectDiskStatus.NeverAttached	The specified disk has never been attached to any instance.	El mensaje de error devuelto porque el disco extraíble nunca se ha conectado a ninguna instancia y sus datos permanecen sin cambios.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.	El mensaje de error devuelto porque se alcanzó el número máximo de instantáneas. Para crear nuevas instantáneas, elimine las que ya no sean necesarias.
403	IncorrectDiskStatus.NeverUsed	The specified disk has never been used after creating.	El mensaje de error devuelto porque el disco especificado nunca se ha utilizado después de su creación y sus datos permanecen sin cambios.
403	CreateSnapshot.Failed	The process of creating snapshot is failed.	El mensaje de error devuelto porque no se pudo crear la instantánea.
403	DiskInArrears	The specified operation is denied as your disk has expired.	El mensaje de error devuelto porque el disco ha caducado debido a un pago pendiente.
403	DiskId.ValueNotSupported	The specified parameter diskid is not supported.	El mensaje de error devuelto porque la categoría del dispositivo Elastic Block Storage (EBS) especificado no admite esta operación.
403	IncorrectDiskStatus	The current disk status does not support this operation.	El mensaje de error devuelto porque la operación no es compatible mientras el disco se encuentra en su estado actual. Asegúrese de que el disco esté utilizable y de que no tenga pagos pendientes asociados.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	El mensaje de error devuelto porque el saldo de su cuenta es insuficiente. Agregue fondos a su cuenta e inténtelo de nuevo.
403	InvalidAccountStatus.SnapshotServiceUnavailable	Snapshot service has not been opened yet.	El mensaje de error devuelto porque la operación no es compatible mientras el servicio de instantáneas no esté activado.
403	IncorrectVolumeStatus	The current volume status does not support this operation.	El mensaje de error devuelto porque la operación no es compatible mientras el dispositivo Shared Block Storage se encuentra en su estado actual.
403	IdempotentParameterMismatch	The specified clientToken is used.	El mensaje de error devuelto porque el token de cliente especificado ya está en uso.
403	IncorrectDiskType.NotSupport	The specified device type is not supported.	El mensaje de error devuelto porque el tipo de disco especificado no admite la operación.
403	IncorrectDiskStatus.Transferring	The specified device is transferring, you can retry after the process is finished.	El mensaje de error devuelto porque el disco especificado se está migrando. Espere a que finalice la migración e inténtelo de nuevo.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	El mensaje de error devuelto porque la clave maestra del cliente (CMK) no está habilitada cuando se especifica un ID de clave de KMS para un disco. Puede llamar a la operación DescribeKey de KMS para consultar la información sobre la CMK especificada.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service have no right to access your KMS.	El mensaje de error devuelto porque ECS no tiene autorización para acceder a sus recursos de KMS.
403	IdempotentProcessing	The previous idempotent request(s) is still processing.	El mensaje de error devuelto porque se está procesando una solicitud idempotente anterior. Inténtelo de nuevo más tarde.
403	QuotaExceed.Tags	%s	El mensaje de error devuelto porque el número de etiquetas especificadas supera el límite superior. %s es una variable. Se devuelve dinámicamente un mensaje de error según las condiciones de la llamada.
403	InvalidSnapshotCategory.Malformed	The specified Category is not valid.	El mensaje de error devuelto porque el parámetro Category especificado no es válido.
403	IncorrectDiskStatus.Invalid	The specified disk status invalid, restart instance and try again.	El mensaje de error devuelto porque el estado del disco especificado no es válido. Reinicie la instancia e inténtelo de nuevo.
404	InvalidDiskId.NotFound	The specified DiskId does not exist.	El mensaje de error devuelto porque el parámetro DiskId especificado no existe.
404	InvalidDescription.Malformed	The specified description is wrongly formed.	El mensaje de error devuelto porque el parámetro Description especificado no es válido. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con http:// ni https://.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	El mensaje de error devuelto porque el ID de instancia especificado no existe. Compruebe si el ID de instancia es correcto.
404	InvalidVolumeId.NotFound	The specified volume does not exist.	El mensaje de error devuelto porque el dispositivo Shared Block Storage especificado no existe. Compruebe si el ID del dispositivo Shared Block Storage es correcto.
500	InternalError	The request processing has failed due to some unknown error.	El mensaje de error devuelto porque ocurrió un error interno. Inténtelo de nuevo más tarde.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	El mensaje de error devuelto porque ocurrió un error interno. Inténtelo de nuevo más tarde.

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