Creación de discos de EVS (obsoleto)
Función
Esta API se utiliza para crear uno o varios discos de EVS.
Método de invocación
Para obtener más información, consulte Invocación de las API.
URI
POST /v3/{project_id}/cloudvolumes
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| project_id | Sí | String | El ID del proyecto. |
Parámetros 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. |
| X-Client-Token | No | String | El identificador de idempotencia de una solicitud. Este valor de parámetro es generado por el cliente y debe ser único entre las solicitudes. El valor es una cadena de caracteres de 36 dígitos en formato UUID y es válido durante 8 horas. Si varias solicitudes contienen el mismo identificador idempotente, las solicitudes se consideran como una solicitud idempotente y se devuelve el mismo cuerpo de respuesta. |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| volume | Sí | CreateVolumeOptionV3 object | El disco que se va a crear. |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| 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. NOTA: Para obtener más información sobre cómo obtener el ID de copia de respaldo, consulte Consulta de todas las copias de respaldo. |
| availability_zone | Sí | String | La zona de disponibilidad donde se desea crear el disco. Si la zona de disponibilidad especificada no existe, el disco no se creará. NOTA: Para obtener más información sobre cómo obtener la zona de disponibilidad, consulte Consulta de todas las zonas de disponibilidad. |
| description | No | String | La descripción del disco. Puede ingresar hasta 85 caracteres. |
| size | No | 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. Si se crea el disco a partir de una instantánea, este parámetro es obligatorio y el tamaño del disco debe ser mayor o igual que el tamaño de la instantánea. Si se crea el disco a partir de una imagen, este parámetro es obligatorio y el tamaño del disco debe ser mayor o igual que la capacidad mínima requerida por el atributo de imagen min_disk. 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. NOTA: Si el valor especificado es un decimal, la parte numérica se utilizará de forma predeterminada. |
| name | No | String | El nombre del disco. Si crea un disco, el valor name será el nombre del disco. Puede ingresar hasta 85 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. Por ejemplo, los nombres de disco pueden ser volume-0001 y volume-0002. |
| 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. NOTA: Para obtener detalles acerca de cómo obtener el ID de instantánea, véase |
| imageRef | No | String | El ID de la imagen. Si se especifica este parámetro, el disco se crea a partir de una imagen. NOTA: Los discos del sistema de Bare Metal Server (BMS) no se pueden crear a partir de imágenes de BMS. Para obtener detalles acerca de cómo obtener el ID de la imagen, consulte Consulta de imágenes. |
| volume_type | Sí | String | El tipo de disco. El valor puede ser SATA, SAS, GPSSD o SSD.
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 tipos de disco, consulte Tipos de disco y rendimiento. |
| 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 los discos se crean a partir de copias de respaldo, no se admite la creación por lotes y este parámetro debe establecerse en 1. NOTA: Si el valor especificado es un decimal, la parte numérica se utilizará de forma predeterminada. |
| shareable | No | String | Si el disco es compartible. El valor puede ser true (se puede compartir) o false (no se puede compartir). NOTA: Este campo ha sido obsoleto. Utilice multiattach. |
| metadata | No | VolumeMetadataV3 object | La información del disco que se va a crear. |
| multiattach | No | String | Si el disco es compartible. El valor predeterminado es false. true: El disco es compartible. false: El disco no es compartible. Para obtener más información, consulte Gestión de discos de EVS compartidos. |
| tags | No | Map<String,String> | Las etiquetas agregadas al disco durante la creación del mismo. Se pueden agregar un máximo de 10 etiquetas a un disco. La clave de la etiqueta debe ser única. Se realizará la deduplicación para las claves duplicadas. Por lo tanto, solo una clave entre las claves duplicadas de una etiqueta es válida. Clave de etiqueta: Una clave de etiqueta puede contener un máximo de 36 caracteres. Puede contener letras, dígitos, guiones bajos (_), guiones medios (-) y caracteres Unicode (\u4E00-\u9FFF). Valor de la etiqueta: Un valor de etiqueta puede tener 43 caracteres y puede ser una cadena vacía. Puede contener letras, dígitos, guiones bajos (_), puntos (.), guiones medios (-) y caracteres Unicode (\u4E00-\u9FFF). |
| enterprise_project_id | No | String | El ID del proyecto empresarial. Este ID se asocia con el disco durante la creación del disco. Si este parámetro no se transfiere o su valor se establece en 0, el disco se asociará con el proyecto empresarial default. Para obtener más información, consulte la Guía del usuario de Enterprise Management. |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| __system__cmkid | No | String | 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 | No | String | El campo de encriptación en metadata. 0: no encriptación 1: encriptación Si este parámetro no aparece, el disco no está encriptado. |
| hw:passthrough | No | String | El parámetro que describe el tipo de dispositivo de disco en metadata.
|
| orderID | No | String | El parámetro que describe el modo de facturación de disco de metadata. Si este parámetro tiene un valor, el disco se factura anualmente/mensualmente. Si no es así, el disco se factura sobre una base de pago por uso. |
Parámetros de respuesta
Código de estado: 200
| Parámetro | Tipo | Descripción |
|---|---|---|
| job_id | String | El ID de la tarea devuelto en una respuesta normal. NOTA: Para consultar el estado de la tarea, consulte la sección "Consulta del estado de la tarea". |
Ejemplos de solicitudes
POST https://{endpoint}/v3/{project_id}/cloudvolumes
{
"volume" : {
"count" : 1,
"availability_zone" : "az-dc-1",
"description" : "test_volume_1",
"size" : 120,
"name" : "test_volume_1",
"volume_type" : "SSD",
"metadata" : {
"__system__encrypted" : "1",
"__system__cmkid" : "37b0d52e-c249-40d6-83cb-2b93f22445bd"
}
}
} Ejemplos de respuestas
Ninguno
Códigos de estado
| Código de estado | Descripción |
|---|---|
| 200 | OK |
Códigos de error
Consulte Códigos de error.
