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.

En esta página

Función
Método de invocación
URI
Parámetros de solicitud
Parámetros de respuesta
Ejemplo de solicitudes
Ejemplo de respuestas
Códigos de estado
Códigos de error

Mostrar todo

Centro de ayuda/ Elastic Volume Service/ Referencia de la API/ API/ Gestión de discos/ Creación de discos de EVS (obsoleto)

Creación de discos de EVS (obsoleto)

Actualización más reciente 2024-09-04 GMT+08:00

Ver PDF

Función

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

Método de invocación

Para obtener más información, consulte Invocación a las 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 autenticación, guarde un caché para evitar invocar con frecuencia a la API.

**Tabla 3** Parámetros del cuerpo de 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	云硬盘调度参数，可用于指定云硬盘创建到某个专属存储池中

**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	El número de discos que se crearán por un lote. Si no se especifica este parámetro, solo se creará un disco. Puede crear un máximo de 100 discos por un lote. Si el disco se crea a partir de una copia de respaldo, la creación por lotes no es posible y este parámetro debe establecerse en 1. Si el valor especificado es un número decimal, se utilizará la parte numérica por defecto.
description	No	String	La descripción del disco. Puede escribir hasta 85 caracteres.
enterprise_project_id	No	String	El ID del proyecto de empresa. 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. El valor puede ser los siguientes: __system__cmkid: El ID de CMK de encriptación de metadata. Este parámetro se utiliza junto con __system__encrypted para la encriptación. La longitud de cmkid se fija en 36 bytes. NOTA: Para obtener detalles sobre cómo obtener el ID de clave, véase Consulta de la lista de claves. __system__encrypted: El campo de encriptación de metadata. El valor puede ser 0 (no cifra) o 1 (cifra). Si no se especifica este parámetro, 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. [full_clone] Si el disco se crea a partir de una instantánea y es necesario utilizar la clonación vinculada, establezca este parámetro en 0. [hw:passthrough] Si el valor de este parámetro es true, el tipo de dispositivo de disco es SCSI, lo que permite que los sistemas operativos de ECS accedan directamente a los medios de almacenamiento subyacentes y admite comandos de reserva de SCSI. Si el valor de este parámetro es false, el tipo de dispositivo de disco es VBD, que solo admite comandos simples de lectura/escritura de SCSI. Si este parámetro no está disponible, el tipo de dispositivo de disco es VBD.
multiattach	No	Boolean	Si el disco se puede compartir. 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 name es el nombre del disco, que puede contener un máximo de 64 caracteres. Si crea varios discos (el valor de count es mayor que 1), el sistema automáticamente agrega 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 se puede compartir. El valor puede ser true (se puede compartir) o false (no se puede compartir). \n Este campo ha sido desaprobado. Use 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 menor que el de la imagen o la instantánea. Este parámetro es opcional si crea el disco a partir de una copia de respaldo. Si no se especifica, el tamaño del disco es el mismo que el de la 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, GPSSD2 o ESSD2. SATA: el tipo de E/S común (agotado) 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 V2 de SSD de uso general ESSD2: el tipo extremo de SSD V2 Si el tipo de disco especificado no está disponible en zona de disponibilidad, no se creará el disco. NOTA: Cuando cree un disco a partir de una instantánea, asegúrese de que el tipo de disco del nuevo disco coincida con el del disco de origen de la instantánea. NOTA: Para obtener detalles acerca de los tipos de disco, consulte Tipos de disco y rendimiento. Valores de enumeración: SATA SAS GPSSD SSD ESSD GPSSD2 ESSD2
tags	No	Map<String,String>	La información de la etiqueta del disco.

**Tabla 5** CreateVolumeSchedulerHints
Parámetro	Obligatorio	Tipo	Descripción
dedicated_storage_id	No	String	El ID del grupo de almacenamiento dedicado. Si se especifica este parámetro, los discos se crearán en el grupo de almacenamiento especificado.

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 se factura el disco según el pago por uso. > > >Puede consultar si la tarea de creación del disco se ha completado por ID de tarea. Para obtener más detalles, véase Consulta del estado de las tareas.
volume_ids	Array of strings	Los ID de los discos que se van a crear. >>Si se devuelve 404 al consultar los detalles de un disco por ID de disco, significa que el disco se está creando o no se ha podido crear. >Puede consultar si la tarea de creación del disco se ha completado por ID de tarea. Para obtener más detalles, véase Consulta del estado de las tareas.

Código de estado: 400

**Tabla 7** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error	Error object	El mensaje de error devuelto si se produce un error. Para obtener más detalles, consulte Parámetros en el campo error.

**Tabla 8** Error
Parámetro	Tipo	Descripción
code	String	El código de error devuelto si se produce un error. Para conocer los códigos de error y sus significados, véase Códigos de error.
message	String	El mensaje de error devuelto si se produce un error.

Ejemplo 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
    }
  }
}

Ejemplo de respuestas

Código de estado: 202

Aceptado

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

Código de estado: 400

Error en la solicitud

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

Códigos de estado

Código de estado	Descripción
202	Aceptado
400	Error en la solicitud

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 (obsoletos)

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.

¿Cuáles de los siguientes problemas se presentaron?

Contenido diferente a la de la IU del producto

Descripciones poco claras

Falta de ejemplos o código

Pasos incorrectos

No puedo encontrar lo que necesito

Falta de prácticas recomendadas

Comentarios (opcional)

0/500

Seleccione al menos un tipo de problema e ingrese sus comentarios o sugerencias.

Ingrese 500 caracteres como máximo.

Enviar Cancelar