CopyImage - - Centro de documentación de Alibaba Cloud

Copia una imagen personalizada de una región a otra. Puede copiar imágenes personalizadas para desplegar o replicar instancias de Elastic Compute Service (ECS) entre regiones.

Notas de uso

Después de copiar una imagen personalizada a la región de destino, puede usar la copia de la imagen (nueva imagen) para crear instancias de ECS mediante la operación RunInstances o reemplazar los discos del sistema de las instancias mediante la operación ReplaceSystemDisk en la región de destino.

Tenga en cuenta los siguientes puntos:

Solo se pueden copiar las imágenes personalizadas que se encuentran en estado Available.
Las imágenes personalizadas que desea copiar deben pertenecer a su cuenta de Alibaba Cloud o haber sido compartidas con usted por otros usuarios; no se pueden copiar entre cuentas distintas.
Mientras se copia una imagen, no se puede eliminar mediante la operación DeleteImage. Sin embargo, puede cancelar la tarea de copia en curso mediante la operación CancelCopyImage.
Una región solo admite una tarea de copia de imagen activa a la vez. Las demás tareas de copia se colocan en una cola y se ejecutan secuencialmente una vez que finaliza la tarea actual.
Configure ResourceGroupId para especificar el resource group al que pertenecerá la nueva imagen. Si no configura ResourceGroupId, la nueva imagen se asignará al resource group predeterminado.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, le recomendamos ejecutar 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í	CopyImage	La operación que se va a ejecutar. Establezca el valor en CopyImage.
DestinationImageName	String	No	YourImageName	El nombre de la nueva imagen. Debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede empezar con `acs:` ni con `aliyun`. No puede contener `http://` ni `https://`. Puede incluir letras, dígitos, puntos (.), dos puntos (:), guiones bajos (_) y guiones (-).
DestinationDescription	String	No	This is a description example.	La descripción de la nueva imagen. Debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con `http://` ni con `https://`.
ImageId	String	Sí	m-bp1h46wfpjsjastc****	El ID de la imagen personalizada de origen.
RegionId	String	Sí	cn-hangzhou	El ID de la región de la imagen personalizada de origen. Puede llamar a la operación DescribeRegions para consultar la lista más reciente de regiones.
DestinationRegionId	String	No	cn-shanghai	El ID de la región de destino donde se copiará la imagen personalizada de origen.
Encrypted	Boolean	No	false	Especifica si se debe cifrar la nueva imagen. true false Valor predeterminado: false.
KMSKeyId	String	No	e522b26d-abf6-4e0d-b5da-04b7******3c	El ID de la clave utilizada para cifrar la nueva imagen.
EncryptAlgorithm	String	No	hide	Nota Este parámetro no está disponible públicamente.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	El ID del resource group al que pertenecerá la nueva imagen. Si no especifica este parámetro, la nueva imagen se asignará al resource group predeterminado. Nota Si llama a la operación CopyImage como usuario de Resource Access Management (RAM) sin autorización para gestionar el resource group predeterminado y no especifica el parámetro `ResourceGroupId`, se devolverá el mensaje de error `Forbbiden: User not authorized to operate on the specified resource`. Debe especificar el ID de un resource group que el usuario de RAM tenga autorizado para gestionar, o bien otorgar al usuario permisos para gestionar el resource group predeterminado antes de volver a llamar a la operación CopyImage.
Tag.N.Key	String	No	TestKey	La clave de la etiqueta N que se agregará a la nueva imagen. Valores válidos de N: 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 contener `http://` ni `https://`. Tampoco puede comenzar con `acs:` ni con `aliyun`.
Tag.N.Value	String	No	TestValue	El valor de la etiqueta N que se agregará a la nueva imagen. Valores válidos de N: 1 a 20. El valor de la etiqueta puede ser una cadena vacía. Puede tener hasta 128 caracteres de longitud y no puede contener `http://` ni `https://`. El valor de la etiqueta no puede comenzar con `acs:`.

Parámetros de respuesta

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

Ejemplos

Solicitudes de ejemplo

http(s)://ecs.aliyuncs.com/?Action=CopyImage
&ImageId=m-bp1h46wfpjsjastc****
&RegionId=cn-hangzhou
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<CopyImageResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
    <ImageId>m-bp1h46wfpjsjastd****</ImageId>
</CopyImageResponse>

Formato JSON

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

{
  "RequestId" : "C8B26B44-0189-443E-9816-D951F59623A9",
  "ImageId" : "m-bp1h46wfpjsjastd****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidDescription.Malformed	The specified destination description is wrongly formed.	Valor de DestinationDescription no válido. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con http:// ni con https://.
400	SourceRegion.NotFound	The source region not found.	No se encontró la región de origen especificada.
400	DestinationRegion.NotFound	The destination region not found.	No se encontró la región de destino.
400	IncorrectImageStatus	The image not available.	La imagen especificada no está disponible.
400	InvalidSnapshotId.NotFound	The specified SnapshotId does not exist.	No se encontró la instantánea especificada. Compruebe si el ID de la imagen es correcto.
400	InvalidImageName.Duplicated	The destination image is exist.	El nombre de la imagen ya existe.
400	InvalidParameter.EncryptedIllegal	The specified parameter Encrypted must be true when kmsKeyId is not empty.	Debe habilitar la función de cifrado después de especificar un ID de clave de Key Management Service (KMS).
400	OperationDenied.CommunityImage	Community image does not support copy.	Las imágenes comunitarias no admiten la operación de copia.
400	InvalidImageName.Malformed	The specified destination image name is wrongly formed.	Valor de DestinationImageName no válido. Para obtener más información, consulte la descripción del parámetro DestinationImageName.
400	InvalidParameter.KmsNotEnabled	The specified operation need enable KMS.	Debe activar KMS.
403	Forbbiden	User not authorized to operate on the specified resource.	No tiene autorización para realizar operaciones en el recurso especificado.
403	QuotaExceed.Image	The Image Quota exceeds.	Se ha agotado la cuota de imágenes personalizadas.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.	Se superó el número máximo de instantáneas. Para crear nuevas instantáneas, elimine las que ya no necesite.
403	OperationDenied.ImageCopying	The Image are coping.	La imagen se está copiando. Inténtelo de nuevo más tarde.
403	RegionNotSupportCopy	The region not support copy.	La región de origen o de destino especificada no admite la copia de imágenes.
403	InvalidSnapshot.TooOld	This operation is denied because the specified snapshot is created before 2013-07-15.	La operación se denegó porque la instantánea especificada se creó antes del 15 de julio de 2013.
403	OperationDenied	The specified snapshot is not allowed to create image.	La instantánea especificada no se puede utilizar para crear imágenes.
403	IncorrectDestinationRegion	The destination region is not equal the target region.	La región de origen debe ser diferente de la región de destino al copiar una imagen entre regiones.
403	SizeExceed.Image	The image exceeds the maximum size. Please open a ticket to add the account to the white list.	Se superó el tamaño máximo de imagen.
403	OperationDeined.EncryptedSnapshot	The image contains encrypted snapshots, which do not support copying.	La imagen especificada contiene instantáneas cifradas y no se puede copiar.
403	OperationDenied.SameRegionOnly	The image shared from others can not be copied to another region directly.	Las imágenes compartidas por otras cuentas de Alibaba Cloud no se pueden copiar directamente a otra región.
403	OperationDenied.NotPublished	The operation is denied because corresponding marketplace image is not published in destination region.	La operación se denegó porque la imagen de Alibaba Cloud Marketplace de la cual deriva la imagen especificada no está publicada en la región de destino.
403	OperationDeined.EncryptedSnapshot	The image contains encrypted snapshots, which do not support copying to non-encrypted ones.	La imagen contiene instantáneas cifradas y no se puede copiar a instantáneas no cifradas.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	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.	ECS no tiene autorización para acceder a sus recursos de KMS.
403	InvalidRegion.NotSupport	The specified region does not support byok.	La función Bring Your Own Key (BYOK) no es compatible con la región especificada.
403	UserNotInTheWhiteList	The user is not in byok white list.	No tiene autorización para usar la función BYOK. Inténtelo de nuevo después de obtener la autorización correspondiente.
403	OperationDenied.KmsServiceUnauthorized	The account is not authorized to kms service, please authorize it.	No tiene autorización para acceder a KMS. Solicite los permisos necesarios para acceder a KMS.
404	InvalidImageId.NotFound	The specified ImageId does not exist.	No se encontró la imagen especificada en la cuenta. Compruebe si el ID de la imagen es correcto.
404	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist.	No se encontró el ID de clave de KMS especificado.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	No se encontró el resource group.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocurrió un error interno. Inténtelo de nuevo más tarde.

Para consultar la lista de códigos de error, visite Códigos de error del servicio.