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/ Elastic Volume Service/ Referencia de la API/ Las API obsoletas/ API de Cinder/ Gestión de discos/ Exportación de datos de discos de EVS como una imagen

Actualización más reciente 2026-04-23 GMT+08:00

Ver PDF

Exportación de datos de discos de EVS como una imagen

Función

Esta API se utiliza para exportar datos de un sistema o disco de datos como una imagen de IMS. La imagen exportada se mostrará en la lista de imágenes privadas de IMS y se podrá ver y utilizar.

Método de invocación

Para obtener más información, consulte Invocación de las API.

URI

POST /v3/{project_id}/volumes/{volume_id}/action

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	El ID del proyecto. Para obtener más información, consulte Obtención de un ID de proyecto.
volume_id	Sí	String	El ID del disco.

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	El token de usuario. Se puede obtener invocando la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.

**Tabla 3** Parámetros del cuerpo de la solicitud
Parámetro	Obligatorio	Tipo	Descripción
os-volume_upload_image	Sí	CinderExportToImageOption object	El marcador de la operación de exportación de imágenes.

**Tabla 4** CinderExportToImageOption
Parámetro	Obligatorio	Tipo	Descripción
container_format	No	String	El tipo de contenedor de la imagen exportada. El valor puede ser ami, ari, aki, ovf, o bare. El valor predeterminado es bare.
disk_format	No	String	El formato de la imagen exportada. El valor puede ser vhd, zvhd, zvhd2, raw, o qcow2. El valor predeterminado es vhd.
force	No	Boolean	Si la imagen se puede exportar forzosamente. El valor predeterminado es false. Si el valor de este parámetro es false, las imágenes no se pueden exportar forzosamente cuando el estado del disco es in-use. Si el valor de este parámetro es true, las imágenes se pueden exportar forzosamente incluso cuando el estado del disco es in-use.
image_name	Sí	String	El nombre de la imagen exportada. Puede contener de 1 a 128 caracteres. Puede contener letras, dígitos, guiones (-), puntos (.), guiones bajos (_) y espacios.
__os_type	No	String	El tipo de sistema operativo de la imagen que se va a exportar. Solo se admiten windows y linux. El valor predeterminado es linux. Nota: Esta configuración de parámetro solo tiene efecto cuando el campo __os_type no está incluido en volume_image_metadata y el estado del disco es available. Si este parámetro no se transfiere, se utiliza el valor predeterminado linux.

Parámetros de respuesta

Código de estado: 202

**Tabla 5** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
os-volume_upload_image	Image object	El marcador de la operación de exportación de imágenes.

**Tabla 6** Image
Parámetro	Tipo	Descripción
container_format	String	El tipo de contenedor de la imagen exportada. El valor puede ser ami, ari, aki, ovf, o bare. El valor predeterminado es bare.
disk_format	String	El formato de la imagen exportada. El valor puede ser vhd, zvhd, zvhd2, raw, o qcow2. El valor predeterminado es vhd.
display_description	String	La descripción del disco.
id	String	El ID del disco.
image_id	String	El ID de la imagen exportada.
image_name	String	El nombre de la imagen exportada.
size	Integer	La capacidad del disco.
status	String	El estado del disco después de exportar la imagen. El valor correcto es uploading.
updated_at	String	La hora en que se actualizó el disco. Formato de tiempo: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX
volume_type	VolumeType object	El tipo de disco.

**Tabla 7** VolumeType
Parámetro	Tipo	Descripción
id	String	El ID del tipo de disco.
name	String	El nombre del tipo de disco.
extra_specs	VolumeTypeExtraSpecs object	La variante del tipo de disco.
description	String	La descripción del tipo de disco.
qos_specs_id	String	El campo reservado.
is_public	Boolean	El campo reservado.

**Tabla 8** VolumeTypeExtraSpecs
Parámetro	Tipo	Descripción
RESKEY:availability_zones	String	La lista de AZ donde se admite el tipo de disco. Los elementos de la lista se separan con comas (,). Si no se especifica este parámetro, el tipo de disco se admite en todas las AZ.
availability-zone	String	El campo reservado.
os-vendor-extended:sold_out_availability_zones	String	La lista de AZ donde se agotó el tipo de disco. Los elementos de la lista se separan con comas (,).
volume_backend_name	String	El campo reservado.
HW:availability_zone	String	El campo reservado.

Código de estado: 400

**Tabla 9** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Error object	Definición La información de error devuelta si se produce un error. Rango N/D

**Tabla 10** Error
Parámetro	Tipo	Descripción
code	String	Definición El código de error devuelto si se produce un error. Rango Para obtener más información sobre el código de error, consulte Códigos de error.
message	String	Definición El mensaje de error devuelto si se produce un error. Rango N/D

Ejemplos de solicitudes

POST https://{endpoint}/v3/{project_id}/volumes/{volume_id}/action

{
  "os-volume_upload_image" : {
    "image_name" : "sxmatch2",
    "force" : true,
    "container_format" : "bare",
    "disk_format" : "vhd",
    "__os_type" : "linux"
  }
}

Ejemplos de respuestas

Código de estado: 202

Accepted

{
  "os-volume_upload_image" : {
    "status" : "uploading",
    "size" : 40,
    "id" : "16369c5d-384d-4e64-b37a-56d898769362",
    "image_id" : "c5333daa-fbc8-4d1d-bf79-b0567bb45d15",
    "image_name" : "evs-ims-test1027",
    "volume_type" : {
      "description" : "None",
      "deleted" : false,
      "created_at" : "2015-05-24T14:47:22.132268",
      "updated_at" : "2017-07-29T11:29:33.730076",
      "extra_specs" : {
        "volume_backend_name" : "<or> FusionStorage_SATA <or> FusionStorage_SAS <or> fusionstoragesata",
        "XX:availability_zone" : "kvmxen.dc1"
      },
      "is_public" : true,
      "deleted_at" : null,
      "id" : "8247b6ed-37f0-4c48-8ef1-f0027fb332bc",
      "name" : "SATA"
    },
    "container_format" : "bare",
    "disk_format" : "vhd",
    "display_description" : "",
    "updated_at" : "2018-01-11T01:50:25.800931"
  }
}

Código de estado: 400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

Códigos de estado

Código de estado	Descripción
202	Accepted
400	Bad Request

Códigos de error

Consulte Códigos de error.

Tema principal: Gestión de discos

Tema anterior: Configuración del indicador de arranque para un disco de EVS

Tema siguiente: Configuración del indicador de solo lectura para un disco de EVS

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.