Creación de metadatos de imágenes (API de OpenStack nativo)

Función

Esta API se utiliza para crear metadatos de imágenes.

Una vez que se invoca correctamente la API, se crean los metadatos de la imagen, pero el archivo de imagen aún no existe.

NOTA:

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

URI

POST /v2/images

Solicitud

• Parámetros de solicitud

  Parámetro	Obligatorio	Tipo	Descripción
  __os_version	No	String	Especifica la versión del sistema operativo de la imagen. Consulte Valores de parámetros relacionados para conocer el rango de valores. Si no se especifica este parámetro, se usará el valor Other Linux(64 bit). En ese caso, la creación de ECS usando esta imagen puede fallar, y el ECS creado usando esta imagen puede fallar en ejecutarse correctamente.
  visibility	No	String	Especifica si la imagen está disponible para otros tenants. El valor predeterminado es private. Al crear metadatos de imagen, el valor de visibility se puede establecer en private únicamente.
  name	No	String	Especifica el nombre de la imagen. Si no se especifica este parámetro, su valor está vacío de forma predeterminada. En ese caso, la creación de ECS usando esta imagen fallará. El nombre contiene de 1 a 255 caracteres. Consulte Atributos de imagen para obtener una descripción detallada. Este parámetro se deja en blanco por defecto.
  protected	No	Boolean	Especifica si la imagen está protegida. No se puede eliminar una imagen protegida. El valor predeterminado es false.
  container_format	No	String	Especifica el formato del contenedor. El valor predeterminado es bare.
  disk_format	No	String	Especifica el formato de imagen. El valor puede ser zvhd2, vhd, raw, iso o qcow2. El valor predeterminado es zvhd2 para una imagen no ISO.
  tags	No	Array of strings	Muestra las etiquetas de imagen. La etiqueta contiene de 1 a 255 caracteres. El valor se deja en blanco de forma predeterminada. NOTA: La etiqueta es un par clave-valor. Ejemplo: "tagkey=tagvalue"
  min_ram	No	Integer	Especifica el tamaño mínimo de memoria (MB) necesario para ejecutar la imagen. El valor del parámetro depende de las especificaciones del . El valor predeterminado es 0.
  min_disk	No	Integer	Especifica el espacio mínimo en disco (GB) necesario para ejecutar la imagen. El valor oscila entre 40 GB y 255 GB. El valor de este parámetro debe ser mayor que la capacidad del disco del sistema de imágenes. De lo contrario, puede producirse un error en la creación del .

Ejemplo de solicitud

Creación de metadatos de imagen (SO: Ubuntu 14.04 server 64bit; formato de contenedor: bare; formato de imagen: vhd; disco mínimo: 100 GB; RAM mínima: 1024 MB)

POST https://{Endpoint}/v2/images
{
    "__os_version": "Ubuntu 14.04 server 64bit",
    "container_format": "bare",
    "disk_format": "vhd",
    "min_disk": 100,
    "min_ram": 1024,
    "name": "test",
    "tags": [
        "test=testvalue",
        "image=imagevalue"
    ],
    "visibility": "private",
    "protected": false
}

Respuesta

• Parámetros de respuesta

  Parámetro	Tipo	Descripción
  visibility	String	Especifica si la imagen está disponible para otros tenants. El valor es private.
  name	String	Especifica el nombre de la imagen. Si no se especifica este parámetro, su valor está vacío de forma predeterminada. En ese caso, la creación de ECS usando esta imagen fallará. El nombre contiene de 1 a 128 caracteres. Para una descripción detallada, consulte Atributos de imagen.
  protected	Boolean	Especifica si la imagen está protegida. No se puede eliminar una imagen protegida. El valor es false.
  container_format	String	Especifica el formato del contenedor. El valor es bare.
  disk_format	String	Especifica el formato de imagen. El valor puede ser zvhd2, vhd, raw, iso o qcow2. El valor predeterminado es zvhd2 para una imagen no ISO.
  tags	Array of strings	Muestra las etiquetas de imagen. La etiqueta contiene de 1 a 255 caracteres.
  min_ram	Integer	Especifica el tamaño mínimo de memoria (MB) necesario para ejecutar la imagen. El valor del parámetro depende del límite de especificaciones de ECS. El valor se establece generalmente en 0.
  min_disk	Integer	Especifica el espacio mínimo en disco (GB) necesario para ejecutar la imagen. Debe ser mayor que la capacidad del disco del sistema en la imagen. De lo contrario, se producirá un error en la creación del . El valor oscila entre 40 GB y 255 GB.
  status	String	Especifica el estado de la imagen. El valor puede ser uno de los siguientes: queued: indica que los metadatos de la imagen ya han sido creados, y que está listo para que el archivo de imagen se cargue. saving: indica que el archivo de imagen se está cargando en el almacenamiento de backend. deleted: indica que la imagen ha sido borrada. killed: indica que se produce un error al cargar la imagen. active: indica que la imagen está disponible para su uso.
  created_at	String	Especifica la hora en que se creó la imagen. El valor está en formato UTC.
  updated_at	String	Especifica la hora a la que se actualizó la imagen. El valor está en formato UTC.
  self	String	Especifica la dirección URL de la imagen.
  id	String	Especifica el ID de imagen. Después de invocar a la API de creación de imágenes, se debe guardar el ID de la imagen. El ID de imagen se utiliza para invocar la API de carga de imágenes y cargar la imagen.
  file	String	Especifica la dirección URL para cargar y descargar el archivo de imagen.
  schema	String	Especifica la dirección URL para acceder al esquema.
  __image_source_type	String	Especifica el tipo de almacenamiento de backend de imagen. Actualmente, solo se admite UDS.
  __image_size	String	Especifica el tamaño de la imagen. La unidad es byte.
  __isregistered	String	Especifica si la imagen está registrada. Solo las imágenes registradas pueden ser consultadas en el portal. El valor es true.
  __os_version	String	Especifica la versión del sistema operativo de la imagen. Consulte Valores de parámetros relacionados para conocer el rango de valores.
  __os_type	String	Especifica el tipo de sistema operativo de imagen. El valor de este parámetro depende del de __os_version. El valor puede ser Windows, Linux, u other.
  __platform	String	Especifica la plataforma del sistema operativo compatible con la imagen. El valor de este parámetro depende del de __os_version.
  __os_bit	String	Especifica el bit del sistema operativo. El valor de este parámetro depende del de __os_version. El valor puede ser 32 o 64.
  __imagetype	String	Especifica el tipo de imagen. private indica una imagen privada.
  virtual_env_type	String	Especifica el tipo de plataforma. Especifica el entorno en el que se utiliza la imagen. El valor puede ser FusionCompute, Ironic, DataImage, o IsoImage. Para una imagen de , el valor es FusionCompute. Para una imagen de disco de datos de , el valor es DataImage. Para una imagen de , el valor es Ironic. Para una imagen ISO, el valor es IsoImage.
  owner	String	Especifica el ID del proyecto al que pertenece la imagen.
  __root_origin	String	Especifica que la imagen se crea a partir de un archivo de imagen externo. Valor: file
  checksum	String	Especifica el valor MD5 del archivo de imagen.
  size	Long	Este parámetro no está disponible actualmente.
  virtual_size	Integer	Especifica el tamaño virtual de la imagen. La unidad es byte.
  properties	Properties object	Especifica una colección de atributos de imagen en lugar de un atributo especificado.

• Ejemplo de respuesta

  STATUS CODE 201

  {
      "schema": "/v2/schemas/image",
      "min_disk": 100,
      "created_at": "2016-06-02T07:49:48Z",
      "__image_source_type": "uds",
      "container_format": "bare",
      "__image_size": "0",
      "file": "/v2/images/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba86/file",
      "updated_at": "2016-06-02T07:49:49Z",
      "protected": false,
      "id": "4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba86",
      "__isregistered": "true",
      "min_ram": 1024,
      "owner": "b912fb4a4c464b568ecfca1071b21b10",
      "__os_type": "Linux",
      "__imagetype": "private",
      "visibility": "private",
      "virtual_env_type": "FusionCompute",
      "tags": [
          "test=testvalue",
          "image=imagevalue"
  
      ],
      "__platform": "Ubuntu",
      "__os_bit": "64",
      "__os_version": "Ubuntu 14.04 server 64bit",
      "name": "test",
      "self": "/v2/images/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba86",
      "disk_format": "vhd",
      "status": "queued"
  }

Valores devueltos

• Normal

  201

• Anormal

  Valor devuelto	Descripción
  400 Bad Request	Error de solicitud.
  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.