Creación de una imagen de disco de datos mediante un archivo de imagen externo

Función

Esta API se utiliza para crear una imagen de disco de datos a partir de un archivo de imagen de disco de datos cargado en el bucket de OBS. La API es asincrónica. Si se invoca correctamente, el sistema de servicio en la nube recibe la solicitud. Sin embargo, debe usar la API de consulta de trabajo asincrónica para consultar el estado de creación de imágenes. Para obtener más información, véase Consulta del estado de un trabajo asincrónico.

URI

POST /v1/cloudimages/dataimages/action

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.
  os_type	No	String	Especifica el tipo de SO. Solo puede ser Windows o Linux. El valor predeterminado es Linux.
  image_url	Sí	String	Especifica la dirección URL del archivo de imagen externo en el bucket de OBS. El formato es OBS bucket name:Image file name. NOTA: La clase de almacenamiento del bucket de OBS debe ser Standard.
  min_disk	Sí	Integer	Especifica el tamaño mínimo del disco de datos. Rango de valores: 40 GB a 2048 GB
  cmk_id	No	String	Especifica una clave personalizada utilizada para cifrar una imagen. Para conocer su valor, consulte la Guía del usuario de Key Management Service.
  tags	No	Array of strings	Muestra las etiquetas de imagen. Este parámetro se deja en blanco por defecto. Consulte Formatos de datos de etiquetas de imagen para obtener una descripción detallada de los parámetros. Utilice tags o image_tags.
  image_tags	No	Array of ImageTag objects	Muestra las etiquetas de imagen. Este parámetro se deja en blanco por defecto. Utilice tags o image_tags.
  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.

  Tabla 1 Descripción de la estructura de datos del campo image_tags

  Parámetro	Obligatorio	Tipo	Descripción
  key	No	string	Especifica la clave de etiqueta.
  value	No	string	Especifica el valor de etiqueta.

Ejemplo de solicitud

• Creación de una imagen de disco de datos con el parámetro tags mediante un archivo en un bucket de OBS (dirección del archivo en el bucket: image-test:fedora_data1.qcow2; sistema operativo: Linux; tamaño mínimo del disco de datos: 40 GB)

  1 2 3 4 5 6 7 8 9 10 11 12

  POST https://{Endpoint}/v1/cloudimages/dataimages/action { "name": "fedora-data1", "image_url": "image-test:fedora_data1.qcow2", "description":"Data disk 1 of Fedora", "min_disk": 40, "tags": [ "aaa.111", "bbb.222" ], "os_type": "Linux" }

• Creación de una imagen de disco de datos con el parámetro image_tags mediante un archivo en un bucket de OBS (dirección del archivo en el bucket: image-test:fedora_data1.qcow2; sistema operativo: Linux; tamaño mínimo del disco de datos: 40 GB)

  1 2 3 4 5 6 7 8 9

  POST https://{Endpoint}/v1/cloudimages/dataimages/action { "name": "fedora-data2", "image_url": "image-test:fedora_data1.qcow2", "description":"Data disk 2 of Fedora", "min_disk": 40, "image_tags": [{"key":"aaa","value":"111"},{"key":"bbb","value":"222"}], "os_type": "Linux" }

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": "4010a32b5f909853015f90aaa24b0015" }

Valores devueltos

• Normal

  200

• Anormal

  Valor devuelto	Descripción
  400 Bad Request	Error de solicitud. Para obtener más información sobre el código de error devuelto, 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.