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 IMS> Imagen> Creación de una imagen de disco de datos mediante un archivo de imagen externo
Actualización más reciente 2022-11-07 GMT+08:00

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 OBS. La API es asíncrona. Si se llama 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 más detalles, consulte Consulta de Trabajo Asincrónico.

URI

POST /v1/cloudimages/dataimages/action

Solicitud

  • Parámetros de solicitud

    Parámetro

    Obligatorio

    Tipo

    Descripción

    name

    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.

    os_type

    No

    String

    Especifica el tipo de sistema operativo.

    Solo puede ser Windows o Linux. El valor predeterminado es Linux.

    image_url

    String

    Especifica la dirección URL del archivo de imagen externo en el bucket OBS.

    El formato es OBS bucket name:Image file name.

    NOTA:

    La clase de almacenamiento del cucharón OBS debe ser Standard.

    min_disk

    Integer

    Especifica el tamaño mínimo del disco de datos.

    Rango de valores: 40 GB a 2048 GB

    cmk_id

    No

    String

    Especifica la clave maestra utilizada para cifrar una imagen. Para conocer su valor, consulte la Guía del usuario de Key Management Service.

    tags

    No

    Array of strings

    Especifica las etiquetas de imagen. Este parámetro se deja en blanco por defecto.

    Para una descripción detallada de los parámetros, consulte Formatos de datos de etiquetas de imagen.

    Usa 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.

    Usa tags o image_tags.

    enterprise_project_id

    No

    String

    Especifica 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.

    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.

  • Solicitudes de ejemplo
    • Solicitud de creación de una imagen (tags)
      POST https://{Endpoint}/v1/cloudimages/dataimages/action
       1
       2
       3
       4
       5
       6
       7
       8
       9
      10
      11
      {
        "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"
      }
      
    • Solicitud de creación de una imagen (image_tags)
      POST https://{Endpoint}/v1/cloudimages/dataimages/action
      1
      2
      3
      4
      5
      6
      7
      8
      {
        "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 más detalles, consulte Consulta de Trabajo Asincrónico.

  • Ejemplo de respuesta
    STATUS CODE 200
    1
    2
    3
    {
        "job_id": "4010a32b5f909853015f90aaa24b0015"
    }
    

Valores devueltos

  • Normal

    200

  • Anormal

    Valores devueltos

    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.