Crea una imagen personalizada. Puede usar la imagen personalizada creada para crear instancias de ECS (RunInstances) o reemplazar el disco del sistema de una instancia (ReplaceSystemDisk).
Descripción de la operación
Precauciones
-
Esta es una operación asíncrona. Después de enviar una solicitud para crear una imagen personalizada, se devuelve el ID de la imagen. Sin embargo, la creación de la imagen no se completa de inmediato. Llame a DescribeImage para consultar la información de la imagen. Cuando el estado en la respuesta sea
Available, la imagen se habrá creado y estará lista para su uso. Para obtener más información, consulte Información general sobre imágenes personalizadas. -
Si consulta la información de una instancia de ECS y la respuesta contiene {"OperationLocks": {"LockReason" : "security"}}, no puede crear una imagen personalizada.
-
Configure el parámetro de detección de imágenes
DetectionStrategyal crear una imagen para permitir que el sistema optimice la imagen. Para obtener más información, consulte Información general sobre la detección de imágenes.
La siguiente sección describe tres métodos para crear una imagen personalizada mediante esta operación. La prioridad de los parámetros de solicitud es: InstanceId > DiskDeviceMapping > SnapshotId. Si su solicitud contiene dos o más de estos parámetros, la imagen se crea de forma predeterminada en función del parámetro con la prioridad más alta.
-
Crear una imagen personalizada a partir de una instancia: Especifique el ID de la instancia (
InstanceId).La instancia debe estar en el estado En ejecución (
Running) o Detenida (Stopped).Después de llamar a la operación, se crea una nueva instantánea para cada disco de la instancia.
Importante Dado que una instancia en ejecución puede tener datos en caché que no se han escrito en los discos, los datos de la imagen personalizada creada pueden no coincidir con los datos de la instancia. Detenga la instancia (StopInstances) antes de crear una imagen. -
Crear una imagen personalizada a partir de una instantánea (la instantánea especificada no puede ser una creada el 15 de julio de 2013 o antes).
Crear una imagen personalizada a partir de una instantánea de disco del sistema: Especifique únicamente el ID de la instantánea del disco del sistema (
SnapshotId).- Crear una imagen personalizada a partir de instantáneas de disco del sistema y de disco de datos: Establezca asociaciones de datos entre varios discos (
DiskDeviceMapping).Solo se puede especificar una instantánea de disco del sistema.
Se pueden especificar varias instantáneas de disco de datos, hasta un máximo de 16. Si no se especifica
DiskDeviceMapping.N.SnapshotId, se crea un disco de datos vacío con la capacidad predeterminada.
Cuando se libera una instancia, el disco del sistema se conserva como un disco de datos de pago por uso. Las instantáneas creadas a partir de este disco no admiten la creación de imágenes personalizadas. Cree una imagen personalizada antes de liberar la instancia según sea necesario.
Pruébelo ahora
Test
Autorización de RAM
|
Action |
Nivel de acceso |
Tipo de recurso |
Clave de condición |
Acción dependiente |
|
ecs:CreateImage |
create |
*Image.
Instance.
Snapshot.
|
Ninguna | Ninguna |
Parámetros de la solicitud
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
| RegionId |
string |
Sí |
El ID de la región de la imagen. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente. |
cn-hangzhou |
| SnapshotId |
string |
No |
El ID de la instantánea que se usa para crear la imagen personalizada. Nota
Si desea crear una imagen personalizada solo a partir de la instantánea del disco del sistema de una instancia, puede usar este parámetro o el parámetro |
s-bp17441ohwkdca0**** |
| InstanceId |
string |
No |
El ID de la instancia. Este parámetro es obligatorio cuando se crea una imagen personalizada a partir de una instancia. |
i-bp1g6zv0ce8oghu7**** |
| ImageName |
string |
No |
El nombre de la imagen. El nombre debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra o un carácter chino y no puede comenzar con http:// o https://. El nombre puede contener dígitos, dos puntos (:), guiones bajos (_) o guiones (-). |
TestCentOS |
| ImageFamily |
string |
No |
El nombre de la familia de imágenes. El nombre debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra o un carácter chino y no puede comenzar con aliyun o acs:. El nombre no puede contener http:// o https://. El nombre puede contener dígitos, dos puntos (:), guiones bajos (_) o guiones (-). |
hangzhou-daily-update |
| ImageVersion |
string |
No |
La versión de la imagen. Nota
Si especifica un ID de instancia ( |
2017011017 |
| Description |
string |
No |
La descripción de la imagen. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con http:// o https://. |
ImageTestDescription |
| Platform |
string |
No |
La distribución del sistema operativo. Después de usar una instantánea de disco de datos como disco del sistema de la imagen, especifique la distribución del sistema operativo del disco del sistema mediante este parámetro. Valores válidos:
Valor predeterminado: Others Linux. |
CentOS |
| BootMode |
string |
No |
El modo de arranque de la imagen. Valores válidos:
Importante
Para evitar que las instancias no se inicien debido a un modo de arranque no compatible, asegúrese de comprender los modos de arranque admitidos por la imagen de destino antes de especificar este parámetro. Para obtener más información sobre los modos de arranque de imágenes, consulte Modos de arranque de imágenes. Valores válidos:
|
BIOS |
| Architecture |
string |
No |
La arquitectura del sistema. Después de usar una instantánea de disco de datos como disco del sistema de la imagen, especifique la arquitectura del sistema del disco del sistema mediante este parámetro. Valores válidos:
Valor predeterminado: x86_64. |
x86_64 |
| ClientToken |
string |
No |
El token de cliente que se usa para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el token, pero asegúrese de que el token sea único entre diferentes solicitudes. ClientToken solo puede contener caracteres ASCII y no puede superar los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia. |
123e4567-e89b-12d3-a456-426655440000 |
| ResourceGroupId |
string |
No |
El ID del grupo de recursos al que pertenece la imagen personalizada. Si no establece este parámetro en un valor específico, la imagen creada pertenece al grupo de recursos predeterminado. Nota
Si invoca esta operación como usuario de Resource Access Management (RAM) y |
rg-bp67acfmxazb4p**** |
| DiskDeviceMapping |
array<object> |
No |
La colección de información de discos e instantáneas que se usa para crear la imagen personalizada. Si desea crear una imagen personalizada a partir de instantáneas de disco del sistema y de disco de datos, use este parámetro para especificar las instantáneas. |
|
|
object |
No |
El disco y la instantánea que se usan para crear la imagen personalizada. |
||
| Device |
string |
No |
El nombre del dispositivo en la imagen personalizada. Valores válidos:
|
/dev/xvdb |
| DiskType |
string |
No |
El tipo de disco en la nueva imagen. Puede usar este parámetro para establecer una instantánea de disco de datos como disco del sistema de la imagen. Si no especifica este parámetro, el tipo de disco toma de forma predeterminada el tipo del disco correspondiente a la instantánea. Valores válidos:
|
system |
| Size |
integer |
No |
El tamaño del disco. Unidad: GiB. Los valores válidos y el valor predeterminado de DiskDeviceMapping.N.Size dependen de DiskDeviceMapping.N.SnapshotId:
|
2000 |
| SnapshotId |
string |
No |
El ID de la instantánea. |
s-bp17441ohwkdca0**** |
| Tag |
array<object> |
No |
Las etiquetas. |
|
|
object |
No |
Las etiquetas. |
||
| Key |
string |
No |
La clave de etiqueta de la imagen. Valores válidos de N: 1 a 20. La clave de etiqueta no puede ser una cadena vacía. La clave de etiqueta puede tener hasta 128 caracteres de longitud y no puede comenzar con |
KeyTest |
| Value |
string |
No |
El valor de etiqueta de la imagen. Valores válidos de N: 1 a 20. El valor de etiqueta puede ser una cadena vacía. El valor de etiqueta puede tener hasta 128 caracteres de longitud y no puede comenzar con |
ValueTest |
| key |
string |
No |
La clave de etiqueta de la imagen. Nota
Para una mejor compatibilidad, use Tag.N.Key en su lugar. |
null |
| value |
string |
No |
El valor de etiqueta de la imagen. Nota
Para una mejor compatibilidad, use Tag.N.Value en su lugar. |
null |
| DetectionStrategy |
string |
No |
La estrategia de detección de imágenes. Si no se especifica este parámetro, no se activa la detección. Solo se admite el modo de detección Estándar. Nota
La mayoría de las versiones de Linux y Windows son compatibles. Para obtener más información sobre los elementos de detección de imágenes y las limitaciones del sistema operativo, consulte Información general sobre la detección de imágenes y Limitaciones del sistema operativo para la detección de imágenes. |
Standard |
| Features |
object |
No |
Las propiedades relacionadas con las características de la imagen. |
|
| ImdsSupport |
string |
No |
El modo de acceso a metadatos de la imagen. Valores válidos:
Valor predeterminado: Cuando se usa una instantánea para crear la imagen, el valor predeterminado es v1. Cuando se usa una instancia para crear la imagen, el valor predeterminado es la propiedad ImdsSupport de la imagen utilizada para crear la instancia. |
v2 |
| DryRun |
boolean |
No |
||
| SecureBootOptions |
object |
No |
Los parámetros relacionados con el arranque seguro. |
|
| SecureBootSupport |
string |
No |
Especifica si la imagen admite el arranque seguro. Valores válidos:
Nota
El arranque seguro solo admite el modo de arranque UEFI o UEFI-Preferred. |
Elementos de la respuesta
|
Elemento |
Tipo |
Descripción |
Ejemplo |
|
object |
|||
| ImageId |
string |
El ID de la imagen. |
m-bp146shijn7hujku**** |
| RequestId |
string |
El ID de la solicitud. |
C8B26B44-0189-443E-9816-******* |
Ejemplos
Respuesta exitosa
JSON Formato
{
"ImageId": "m-bp146shijn7hujku****",
"RequestId": "C8B26B44-0189-443E-9816-*******"
}
Códigos de error
|
Código de estado HTTP |
Código de error |
Mensaje de error |
Descripción |
|---|---|---|---|
| 400 | InvalidImageName.Malformed | The specified Image name is wrongly formed. | El nombre de la imagen no es válido. Para obtener más información sobre las convenciones de nomenclatura, consulte la descripción de la métrica del parámetro DestinationImageName. |
| 400 | InvalidImageName.Duplicated | The specified image name is already in use. | El nombre de la imagen ya existe. |
| 400 | InvalidDescription.Malformed | The specified description is wrongly formed. | El formato de descripción del recurso especificado no es válido. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con http:// o https://. |
| 400 | InvalidImageVersion.Malformed | The specified ImageVersion is wrongly formed. | El número de versión de la imagen no es válido o usted no tiene el permiso para usar la instantánea especificada. |
| 400 | IncorrectInstanceStatus | The current status of the instance does not support this operation. | El estado actual de la instancia no admite esta operación. |
| 400 | InstanceLockedForSecurity | The specified operation is denied as your instance is locked for security reasons. | |
| 400 | InvalidDevice.Malformed | The specified parameter DiskDeviceMapping.n.Device is not valid. | El nombre del dispositivo de disco especificado no existe. |
| 400 | MissingParameter | The input parameter SnapshotId or InstanceId or DiskDeviceMapping that is mandatory for processing this request is not supplied. | Falta un parámetro obligatorio. |
| 400 | InvalidSize.ValueNotSupported | The specified parameter DiskDeviceMapping.n.Size beyond the permitted range. | El parámetro DiskDeviceMapping.n.Size está fuera del rango válido. |
| 400 | InvalidDevice.InUse | The specified parameter DiskDeviceMapping.n.Device has been occupied. | El dispositivo especificado ya tiene un disco conectado. |
| 400 | OperationDenied | The specified parameter DiskDeviceMapping.n.SnapshotId does not contain system disk snapshot. | La instantánea especificada no permite la creación de volúmenes de datos. |
| 400 | InvalidDiskCategory.CreateImage | The specified diskCategory is not allowed to create image. | El tipo de disco especificado no permite la creación de imágenes. |
| 400 | InvalidArchitecture.Malformed | The specified Architecture is wrongly formed. | El formato del parámetro Architecture no es válido. |
| 400 | InvalidPlatform.Malformed | The specified Platform is wrongly formed. | La distribución del sistema operativo de la imagen especificada no es válida. |
| 400 | InvalidParameter.AllEmpty | %s | |
| 400 | InvalidParameter.DiskType | The specified disk type which has kms key can't convert to system disk. | |
| 400 | Duplicate.TagKey | The Tag.N.Key contain duplicate key. | Existen 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 | InvalidInstance.NotFoundSystemDisk | The specified instance does not have system disk. | |
| 400 | InvalidImageFamily.Malformed | The format of the specified image family is invalid. | El formato de la familia de imágenes especificada no es válido. |
| 400 | ImageQuotaExceed.ImageFamily | The specified image family exceeds the maximum number of images for one image family. | |
| 400 | ImageFamilyQuotaExceed | The number of image families exceeds the limit in the region. | |
| 400 | InvalidDiskType.ValueNotSupported | The specified disk type is not supported. | El atributo de disco especificado no es compatible. |
| 400 | IdempotenceParamNotMatch | Request uses a client token in a previous request but is not identical to that request. | Los parámetros de la solicitud no coinciden con la solicitud que tiene el mismo ClientToken. |
| 400 | InvalidBootMode.NotSupport | The specified parameter BootMode is not supported for current image architecture. | La arquitectura de la imagen actual no admite el modo de arranque especificado. |
| 400 | InvalidParameter.FeaturesImdsSupport | The specified parameter Features.ImdsSupport is not supported. | El parámetro Features.ImdsSupport especificado no es compatible. |
| 400 | InvalidOperation.DiskCategoryUnsupported | The current category of the disk does not support this operation. | Los discos efímeros elásticos no admiten la separación independiente. |
| 400 | AccountForbidden.CreateOrder | Order cannot be created due to abnormal account. | La cuenta actual no tiene permiso para crear órdenes. |
| 400 | InvalidBootMode.Malformed | The specified parameter BootMode is invalid. Valid options are BIOS, UEFI, and UEFI-Preferred. | El parámetro BootMode especificado no es válido. |
| 400 | InvalidDetectionStrategy.Malformed | The specified value for parameter DetectionStrategy is not supported. Please refer to the documentation for accepted values. | El valor del parámetro DetectionStrategy especificado no es compatible. Consulte las referencias para ver los valores aceptables. |
| 400 | InvalidParameter.SecureBootSupport | The specified parameter SecureBootOptions.SecureBootSupport is not valid. | El parámetro SecureBootOptions.SecureBootSupport especificado no es válido. |
| 500 | InternalError | The process of creating snapshot has failed due to some unknown error. | Ocurrió un error interno. Inténtelo de nuevo. |
| 403 | IncorrectDiskStatus.NeverAttached | The specified disk has never been attached to instance. | |
| 403 | InvalidSnapshotId.NotReady | The current status of the DiskDeviceMapping.n.SnapshotId or SnapshotId does not support this operation. | La instantánea especificada no se ha completado. |
| 403 | InvalidSnapshot.TooOld | This operation is denied because the specified snapshot by DiskDeviceMapping.n.SnapshotId or SnapshotId is created before 2013-07-15. | La instantánea de origen del disco especificado se creó el 15 de julio de 2013 o antes, y no se puede reinicializar. |
| 403 | OperationDenied | The specified snapshot is not allowed to create image. | La instantánea especificada no permite la creación de volúmenes de datos. |
| 403 | QuotaExceed.Image | The Image Quota exceeds. | |
| 403 | InvalidParamter.Conflict | The specified same token is trying to make requests with different parameters. | El security group autorizado y el security group que autoriza deben ser diferentes. |
| 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. La operación no se puede realizar. |
| 403 | UserNotInTheWhiteList | The user is not in the white list of create image by data disk snapshot. | El usuario no se encuentra en la lista blanca de Shared Block Storage. Envíe un ticket para solicitar el acceso a la lista blanca. |
| 403 | IncorrectDiskStatus.Invalid | Device status is invalid, please restart instance and try again. | El estado del disco actual no es válido. Reinicie la instancia e inténtelo de nuevo. |
| 403 | OperationDenied.InvalidSnapshotCategory | %s | El tipo de instantánea no admite esta operación. |
| 403 | QuotaExceed.Snapshot | The snapshot quota exceeds. | |
| 403 | IncorrectDiskStatus.Transferring | The specified device is transferring, you can retry after the process is finished. | El disco especificado se está migrando. Inténtelo de nuevo después de que finalice la migración. |
| 403 | IncorrectDiskStatus | The current disk status does not support this operation. | |
| 403 | InvalidSystemSnapshot.Missing | %s | |
| 403 | IncorrectDiskStatus.CreatingSnapshot | A previous snapshot creation is in process. | |
| 403 | InvalidParameter.KMSKeyId.CMKUnauthorized | The CMK needs to be added ECS tag. | Se debe agregar la etiqueta de ECS a la clave maestra del cliente (CMK). |
| 403 | InvalidParameter.KMSKeyId.CMKNotEnabled | The CMK needs to be enabled. | |
| 403 | InvalidParameter.KMSKeyId.KMSUnauthorized | The ECS service is not authorized to access your KMS key. Please grant the ECS service permission to use the key and try again. | |
| 403 | QuotaExceed.Tags | %s | El número de etiquetas supera el máximo que se puede configurar. %s es una variable. El mensaje de error real se devuelve dinámicamente según la llamada a la API. |
| 403 | InvalidSnapshotCategory.NotSupportImageCreation | The specified snapshot category does not support create image. | |
| 403 | TooManySnapshot.Unfinished | There are too many snapshots being created, please wait for them to be created done. | |
| 403 | HibernationConfigured.InstanceOperationForbidden | The operation is not permitted due to limit of the hibernation configured instance. | La operación no está permitida porque la instancia no cumple los requisitos para habilitar la opción de hibernación. |
| 403 | SnapshotNotReady | The specified snapshot is not ready. | La instantánea no se ha creado. No se puede utilizar para crear una imagen. |
| 403 | IncorrectInstanceStatus.NeedRestart | The instance needs to be restarted after adding a disk in a shutdown status. | Después de conectar un disco a una instancia que se encuentra en estado Stopped, reinicie la instancia antes de crear una imagen personalizada. |
| 403 | QuotaExceed.ConcurrentSnapshotQuota | The number of snapshots being created for the disk %s has exceeded the concurrent quota (%s). Please wait for the previous snapshots to complete before trying again. | El número de instantáneas que se están creando para este disco ha superado la cuota simultánea. Espere a que finalicen las instantáneas anteriores e inténtelo de nuevo. |
| 403 | InvalidOperation.SnapshotStorageLocationUnsupported | Snapshots with storage location in CloudBox do not support the current operation. | Las instantáneas almacenadas en CloudBox no admiten la operación actual. |
| 403 | AccountEnterpriseStatusInvalid | Your enterprise registration is marked as revoked/deregistered in the National Enterprise Credit Information Publicity System. Account transaction features (purchase/renewal/recharge) are disabled. Please update real-name certification via Account Center. Restrictions will auto-remove after verification. | El estado de registro de su empresa es Cancelado (o Revocado) en el Sistema Público de Información Crediticia Empresarial Nacional. Su cuenta no puede realizar operaciones de transacción como la compra de nuevos productos, renovación o recarga de saldo. Cambie su registro de nombre real a través del Centro de cuentas lo antes posible. Una vez completado el cambio, Alibaba Cloud desactivará automáticamente la restricción de compra. |
| 403 | InvalidOperation.DefaultFreeSnapshotNotSupport | The specified snapshot is a default free snapshot and does not support this operation. | La instantánea especificada es una instantánea gratuita predeterminada y no admite la operación actual. |
| 403 | InvalidBootMode.SecureBootUnsupported | Secure Boot requires UEFI or UEFI-Preferred boot mode. Please check the BootMode and try again. | El parámetro BootMode especificado no es válido. El modo de arranque no admite el arranque seguro. |
| 404 | InvalidSnapshotId.NotFound | The specified SnapshotId does not exist. | |
| 404 | InvalidInstanceId.NotFound | The specified instance %s does not exist. | La instancia especificada no existe. Verifique si el ID de la instancia es correcto. |
| 404 | InvalidResourceGroup.NotFound | The ResourceGroup provided does not exist in our records. | No se encuentra el grupo de recursos 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.