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 Cloud Server/ Referencia de la API/ API (recomendado)/ Gestión de discos/ Conexión de un disco a un ECS
Actualización más reciente 2025-08-25 GMT+08:00
Ver PDF
Compartir

Conexión de un disco a un ECS

Función

Esta API se utiliza para conectar un disco a un ECS.

URI

POST /v1/{project_id}/cloudservers/{server_id}/attachvolume

Tabla 1 describe los parámetros en el URI.
Tabla 1 Descripción del parámetro

Parámetro

Obligatorio

Descripción

project_id

Sí

Especifica el ID del proyecto.

Para obtener más información sobre cómo obtener el ID, consulte Obtención de un ID de proyecto.

server_id

Sí

Especifica el ID de ECS.

Solicitud

Tabla 2 Parámetros de solicitud

Parámetro

Obligatorio

Type

Descripción

volumeAttachment

Sí

Object

Especifica la información de los datos adjuntos con ECS. Para más detalles, consulte Tabla 3.

dry_run

No

Boolean

Especifica si se debe comprobar la solicitud y adjuntar el disco.

  • true: indica que solo se envía la solicitud y no se adjuntará ningún disco. Los elementos de verificación incluyen parámetros obligatorios, formato de solicitud y restricciones de servicio. Si la comprobación falla, el sistema devuelve un error. Si el resultado de la comprobación es el esperado, el sistema responde correctamente.
  • false: indica que solo se envía la solicitud y se adjuntará el disco si el resultado de la comprobación es el esperado.

El valor predeterminado es false.
Tabla 3 Descripción del campo volumeAttachment

Parámetro

Obligatorio

Type

Descripción

volumeId

Sí

String

Especifica el ID del disco que se va a conectar. El valor está en formato UUID.

device

No

String

Indica el nombre del dispositivo de disco.

NOTA:
  • El nuevo nombre del dispositivo de disco no puede ser el mismo que uno existente.
  • Este parámetro es obligatorio para los ECS Xen. Establezca el valor del parámetro en /dev/sda para los discos del sistema de tales ECS y en /dev/sdx para los discos de datos, donde x es una letra en orden alfabético. Por ejemplo, si hay dos discos de datos, establezca los nombres de dispositivo de los dos discos de datos en /dev/sdb y /dev/sdc, respectivamente. Si establece un nombre de dispositivo que comienza por /dev/vd, el sistema usa /dev/sd de forma predeterminada.
  • Para los ECS KVM, establezca el valor del parámetro en /dev/vda para los discos del sistema. Los nombres de dispositivos para los discos de datos de los ECS KVM son opcionales. Si se requieren los nombres de los dispositivos de los discos de datos, configúrelos en orden alfabético. Por ejemplo, si hay dos discos de datos, establezca los nombres de dispositivo de los dos discos de datos en /dev/vdb y /dev/vdc, respectivamente. Si establece un nombre de dispositivo que comienza por /dev/sd, el sistema usa /dev/vd de forma predeterminada.

volume_type

No

String

Especifica el tipo de disco.

Si volumeId no está disponible y dry_run está establecido en true, volume_type está disponible y debe especificarse.

count

No

Integer

Especifica el número de discos.

Si volumeId no está disponible y dry_run se establece en true, count está disponible. Si count no está disponible, el número de discos es 1 de forma predeterminada.

hw:passthrough

No

String
  • Si este parámetro se establece en true, el tipo de dispositivo de disco es SCSI, lo que permite que los SO de ECS accedan directamente a los medios de almacenamiento subyacentes. Se admiten comandos de reserva SCSI.
  • Si este parámetro se establece en false, el tipo de dispositivo de disco es VBD, que solo admite comandos simples de lectura/escritura SCSI.

Si volumeId no está disponible y dry_run está establecido en true, hw:passthrough está disponible y debe especificarse.

Respuesta

Consulte Respuestas (tarea).

Ejemplo de la solicitud

POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/attachvolume
{
    "volumeAttachment": {
         "volumeId": "a26887c6-c47b-4654-abb5-dfadf7d3f803",
         "device": "/dev/sda",
         "volume_type": "SSD",
         "count": 5,
         "hw:passthrough": "true"
    },
    "dry_run": false
}

Ejemplo de la respuesta

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

Valores devueltos

Consulte Valores devueltos para solicitudes generales

Códigos de error

Consulte Códigos de error

Tema principal: Gestión de discos