Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda> Image Management Service> Referencia de la API> Las API de Native OpenStack> Imagen (Native OpenStack APIs)> Creación de metadatos de imágenes (Native OpenStack API)

Actualización más reciente 2022-11-07 GMT+08:00

Ver PDF

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

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.

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. Para el rango de valores, consulte Valores de parámetros relacionados. 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 inquilinos. 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. Para una descripción detallada, consulte Atributos de imagen. 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 archivo de imagen. El valor puede ser vhd, zvhd, raw, zvhd2, o qcow2. El valor predeterminado es vhd.
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.
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 ECS especificaciones. El valor predeterminado es 0.
min_disk	No	Integer	Especifica el espacio mínimo en disco (GB) necesario para ejecutar la imagen. El valor varía de 40 GB a 255 GB. El valor de este parámetro debe ser mayor que la capacidad del disco del sistema de imágenes. De lo contrario, la ECS creación puede fallar.

Los parámetros del cuerpo de la solicitud son cadenas de no más de 255 caracteres y sus valores pueden dejarse en blanco. Ejemplo:

"key": "value"

Ejemplo de solicitud

POST https://{Endpoint}/v2/images

{
    "__os_version": "Ubuntu 14.04 server 64bit",
    "container_format": "bare",
    "disk_format": "vhd",
    "min_disk": 1,
    "min_ram": 1024,
    "name": "test",
    "tags": [
        "test",
        "image"
    ],
    "visibility": "private",
    "protected": false
}

Respuesta

Parámetros de respuesta

Parámetro	Tipo	Descripción
visibility	String	Especifica si la imagen está disponible para otros inquilinos. 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 archivo de imagen. El valor puede ser vhd, zvhd, raw, o qcow2. El valor predeterminado es vhd.
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. El valor oscila entre 40 GB y 255 GB. Debe ser mayor que la capacidad del disco del sistema en la imagen. De lo contrario, la ECS creación puede fallar.
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 llamar 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. Para el rango de valores, consulte Valores de parámetros relacionados.
__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, o 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 ECS imagen, el valor es de FusionCompute. Para una imagen de disco de datos, el valor es de DataImage. Para una ECS imagen, el valor es Ironic. Para una imagen ISO, el valor es de 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": 1,
    "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",
        "image"
    ],
    "__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.