Replicación de una imagen dentro de 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 asincrónica. 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 del estado de un trabajo asincrónico.

Huawei Cloud ha dejado de proporcionar imágenes de Windows. Esta API ya no se utilizará para replicar imágenes de Windows.

Restricciones

• Las imágenes completas de 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

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 ni 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	Especifica el proyecto empresarial al que pertenece la imagen. Si el valor es 0 o se deja en blanco, la imagen pertenece al proyecto empresarial predeterminado. Si el valor es un UUID, la imagen pertenece al proyecto empresarial correspondiente al UUID. Para obtener más información sobre proyectos empresariales y cómo obtener los ID de proyectos empresariales, consulte Centro empresarial.

Ejemplo de solicitud

Replicación de una imagen (nombre: ims_encrypted_copy3) dentro de una región

1
2
3
4
5
6

POST https://{Endpoint}/v1/cloudimages/465076de-dc36-4aec-80f5-ef9d8009428f/copy
{
    "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 obtener más información, véase Consulta del estado de un trabajo asincrónico.

• Ejemplo de respuesta.

  STATUS CODE 200

  1 2 3

  { "job_id": "edc89b490d7d4392898e19b2deb34797" }

Valores devueltos

• Normal

  200

• Anormal

  Valor devuelto	Descripción
  400 Bad Request	Error de solicitud. Para obtener más información, véase 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.