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/ API/ Gestión de discos/ Creación de discos de EVS (obsoleto)

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

Ver PDF

Creación de discos de EVS (obsoleto)

Función

Esta API se utiliza para crear uno o varios discos de EVS. Esta invocación de la API existe solo por razones de compatibilidad y no está destinada a ser utilizada. Utilice otra API.

Método de invocación

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

Información de autorización

Cada cuenta tiene todos los permisos necesarios para invocar todas las API, pero los usuarios de IAM deben tener asignados los permisos requeridos.

Si está utilizando la autorización basada en roles/políticas, consulte Políticas de permisos y acciones admitidas para obtener más información sobre los permisos requeridos.
Si está utilizando la autorización basada en políticas de identidad, no se requiere ningún permiso basado en políticas de identidad para invocar esta API.

URI

POST /v2/{project_id}/cloudvolumes

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	El ID del proyecto.

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Un token obtenido de IAM tiene una validez de 24 horas. Cuando utilice un token para la autenticación, almacénelo en memoria caché para evitar invocar frecuentemente la API.

**Tabla 3** Parámetros del cuerpo de la solicitud
Parámetro	Obligatorio	Tipo	Descripción
volume	Sí	CreateDiskOption object	La información del disco que se va a crear.
OS-SCH-HNT:scheduler_hints	No	CreateVolumeSchedulerHints object	El parámetro de programación del disco, que puede utilizarse para crear el disco en un grupo de almacenamiento dedicado.

**Tabla 4** CreateDiskOption
Parámetro	Obligatorio	Tipo	Descripción
availability_zone	Sí	String	La zona de disponibilidad donde desea crear el disco.
backup_id	No	String	El ID de copia de respaldo. Este parámetro es obligatorio cuando se crea el disco a partir de una copia de respaldo.
count	No	Integer	La cantidad de discos que se crearán en un lote. Si no se especifica este parámetro, solo se creará un disco. Se pueden crear 100 discos como máximo en un lote. Si el disco se crea a partir de una copia de respaldo, no se puede crear en lote y este parámetro debe establecerse en 1. Si el valor especificado es un número decimal, la parte numérica se utilizará de forma predeterminada.
description	No	String	La descripción del disco. Puede ingresar hasta 85 caracteres.
enterprise_project_id	No	String	El ID del proyecto empresarial. Este ID se asocia con el disco durante la creación del disco.
imageRef	No	String	El ID de la imagen. Si se especifica este parámetro, el disco se crea a partir de una imagen.
metadata	No	Map<String,String>	La información de metadatos del disco. Los invocadores pueden agregar o eliminar la información de metadatos. Las claves de este parámetro utilizadas en EVS se describen a continuación: [__system__cmkid] El ID del CMK de encriptación en metadata. Este parámetro se utiliza junto con __system__encrypted para la encriptación. La longitud de cmkid se fija en 36 bytes. [__system__encrypted] El campo de encriptación en metadata. El valor puede ser 0 (sin encriptación) o 1 (encriptación). Si este parámetro no se especifica, el atributo de encriptación del disco es el mismo que el del origen de datos. Si el disco no se crea a partir de un origen de datos, el disco no se cifra de forma predeterminada. [hw:passthrough] Si el valor de este parámetro es true, el tipo de dispositivo de disco es SCSI, lo que permite que los SO de ECS accedan directamente al medio de almacenamiento subyacente y admitan comandos de reserva SCSI. Si el valor de este parámetro es false, el tipo de dispositivo de disco es VBD (tipo de dispositivo predeterminado), que solo admite comandos simples de lectura/escritura SCSI. Si no se especifica este parámetro, el tipo de dispositivo de disco es VBD. Si no se especifica este parámetro, el tipo de dispositivo de disco es VBD. " Para obtener más información sobre cómo obtener el ID de clave, consulte Consulta de la lista de claves.
multiattach	No	Boolean	Si el disco es compartible. El valor puede ser true (se puede compartir) o false (no se puede compartir).
name	No	String	El nombre del disco. Si crea un disco, el valor de name es el nombre del disco, que puede contener un máximo de 64 caracteres. Si crea varios discos (el valor count es mayor que 1), el sistema agrega automáticamente un guion seguido de un número incremental de cuatro dígitos, como -0000, al final de cada nombre de disco. Ejemplo de nombre de disco: volume-0001 o volume-0002
shareable	No	String	Si el disco es compartible. El valor puede ser true (se puede compartir) o false (no se puede compartir). \n Este campo ha sido obsoleto. Utilice multiattach.
size	Sí	Integer	El tamaño del disco, en GiB. Las restricciones son las siguientes: Disco del sistema: 1 GiB a 1,024 GiB Disco de datos: 10 GiB a 32,768 GiB Este parámetro es obligatorio cuando se crea un disco vacío o se utiliza una imagen o una instantánea para crear un disco. Si utiliza una imagen o una instantánea para crear un disco, el tamaño del disco no puede ser inferior al tamaño de la imagen o de la instantánea. Este parámetro es opcional si se crea el disco a partir de una copia de respaldo. Si no se especifica, el tamaño del disco es el mismo que el tamaño de copia de respaldo.
snapshot_id	No	String	El ID de la instantánea. Si se especifica este parámetro, el disco se crea a partir de una instantánea.
volume_type	Sí	String	El tipo de disco. El valor puede ser SATA, SAS, GPSSD, SSD, ESSD o GPSSD2. SATA: el tipo de E/S común (fin de venta) SAS: el tipo de E/S alta GPSSD: el tipo de SSD de uso general SSD: el tipo de E/S ultraalta ESSD: el tipo de SSD extrema GPSSD2: el tipo de SSD V2 de uso general Si el tipo de disco especificado no está disponible en la AZ, el disco no se creará. NOTA: Si crea el disco a partir de una instantánea, el valor de volume_type debe coincidir con el del disco de origen de la instantánea. Para obtener más información sobre los diferentes tipos de disco, consulte Tipos de disco y rendimiento.
tags	No	Map<String,String>	La información de la etiqueta del disco.
sys_tags	No	Map<String,String>	La información de la etiqueta del sistema de disco.

**Tabla 5** CreateVolumeSchedulerHints
Parámetro	Obligatorio	Tipo	Descripción
dedicated_storage_id	No	String	Definición El ID del grupo de almacenamiento dedicado. Si se especifica este parámetro, el disco se creará en el grupo de almacenamiento especificado. Restricciones N/D Rango N/D Valor predeterminado N/D
architecture_type	No	String	Definición Arquitectura del grupo utilizado para crear discos. El valor puede ser arm o x86. Restricciones N/D Rango arm or x86 Valor predeterminado N/D
fault_domain	No	String	Definición El dominio de fallas donde se crea el disco. Restricciones N/D Rango N/D Valor predeterminado N/D

Parámetros de respuesta

Código de estado: 202

**Tabla 6** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
job_id	String	El ID de la tarea. Este parámetro se devuelve cuando el disco se factura en función del pago por uso. Puede consultar si la tarea de creación de disco está completa por ID de tarea. Para obtener más información, consulte Consulta del estado de la tarea.
volume_ids	Array of strings	Los ID de los discos que se van a crear. >>Si se devuelve 404 cuando consulta los detalles de un disco por ID de disco, el disco se está creando o no se ha podido crear. Puede consultar si la tarea de creación de disco está completa por ID de tarea. Para obtener más información, consulte Consulta del estado de la tarea.

Código de estado: 400

**Tabla 7** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Error object	Definición El código de error devuelto si se produce un error. Para obtener más información sobre el código de error, consulte Códigos de error. Rango N/D

**Tabla 8** 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

{
  "volume" : {
    "backup_id" : null,
    "count" : 1,
    "availability_zone" : "az1.dc1",
    "description" : "test_volume_1",
    "size" : 120,
    "name" : "test_volume_1",
    "imageRef" : null,
    "volume_type" : "SSD",
    "metadata" : {
      "__system__encrypted" : "0",
      "__system__cmkid" : null
    }
  }
}

Ejemplos de respuestas

Código de estado: 202

Accepted

{
  "job_id" : "70a599e0-31e7-49b7-b260-868f441e862b"
}

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: Eliminación de un disco de EVS

Tema siguiente: Consulta de discos de EVS (obsoleto)

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.