Replicación de una imagen en una región
Función
Esta API es una extensión y se utiliza para copiar una imagen existente a otra imagen. Al replicar una imagen, puede cambiar los atributos de la imagen para cumplir con los requisitos de diferentes escenarios.
Esta API es asíncrona. Si se devuelve job_id, la tarea se entrega correctamente. Es necesario consultar el estado de la tarea asincrónica. Si el estado es success, la tarea se ejecuta correctamente. Si el estado es failed, se produce un error en la tarea. Para obtener más información sobre cómo consultar el estado de una tarea asincrónica, consulte Consulta de Trabajo Asincrónico.
Restricciones
- Las imágenes Full-ECS no se pueden replicar dentro de la misma región.
- Las imágenes privadas creadas con archivos ISO no admiten replicación dentro de la región.
URI
POST /v1/cloudimages/{image_id}/copy
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
image_id |
Sí |
String |
Especifica el ID de imagen. Para obtener más información sobre cómo obtener el ID de imagen, consulte Consulta de imágenes. |
Solicitud
- Parámetros de solicitud
Parámetro
Obligatorio
Tipo
Descripción
name
Sí
String
Especifica el nombre de la imagen. Para una descripción detallada, consulte Atributos de imagen.
description
No
String
Proporciona información adicional sobre la imagen. Para una descripción detallada, consulte Atributos de imagen. El valor contiene un máximo de 1024 caracteres y consta solo de letras y dígitos. No se permiten retornos de carro y corchetes angulares (< >). Este parámetro se deja en blanco por defecto.
cmk_id
No
String
Especifica la clave de encriptación. Este parámetro se deja en blanco por defecto.
enterprise_project_id
No
String
Indica el proyecto de empresa al que pertenece la imagen.
- Si el valor es 0 o se deja en blanco, la imagen pertenece al proyecto de empresa predeterminado.
- Si el valor es un UUID, la imagen pertenece al proyecto de empresa correspondiente al UUID.
Para obtener más información acerca de los proyectos de empresa y cómo obtener los ID de proyecto de empresa, consulte Centro de empresa.
- Ejemplo de solicitud
POST https://{Endpoint}/v1/cloudimages/465076de-dc36-4aec-80f5-ef9d8009428f/copy
1 2 3 4 5
{ "name": "ims_encrypted_copy3", "description": "test copy", "cmk_id": "bd66288c-9081-460a-8227-4cbd0c814cb4" }
Respuesta
- Parámetros de respuesta
Parámetro
Tipo
Descripción
job_id
String
Especifica el ID de trabajo asincrónico.
Para más detalles, consulte Consulta de Trabajo Asincrónico.
- Ejemplo de respuesta
STATUS CODE 200
1 2 3
{ "job_id": "edc89b490d7d4392898e19b2deb34797" }
Valor devuelto
- Normal
- Anormal
Valor devuelto
Descripción
400 Bad Request
Error de solicitud. Para más detalles, consulte Códigos de error.
401 Unauthorized
Error de autenticación.
403 Forbidden
Usted no tiene los derechos para realizar la operación.
404 Not Found
No se encontró el recurso solicitado.
500 Internal Server Error
Error interno del servicio.
503 Service Unavailable
El servicio no está disponible.