Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Elastic Cloud Server/ Referência de API/ As API (recomendado)/ Gerenciamento de disco/ Anexação de um disco a um ECS
Atualizado em 2025-08-25 GMT+08:00
Ver PDF
Compartilhar

Anexação de um disco a um ECS

Função

Esta API é usada para anexar um disco a um ECS.

URI

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

Tabela 1 descreve os parâmetros no URI.
Tabela 1 Descrição do parâmetro

Parâmetro

Obrigatório

Descrição

project_id

Sim

Especifica a ID do projeto.

Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto.

server_id

Sim

Especifica a ID de ECS.

Solicitação

Tabela 2 Parâmetros de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

volumeAttachment

Sim

Object

Especifica as informações de anexo do ECS. Para mais detalhes, consulte Tabela 3.

dry_run

Não

Boolean

Especifica se deve verificar a solicitação e anexar o disco.

  • true: indica que apenas a solicitação é enviada e nenhum disco será anexado. Os itens de verificação incluem parâmetros obrigatórios, formato de solicitação e restrições de serviço. Se a verificação falhar, o sistema retornará um erro. Se o resultado da verificação for o esperado, o sistema responderá corretamente.
  • false: indica que apenas a solicitação é enviada e o disco será anexado se o resultado da verificação for o esperado.

O valor padrão é false.
Tabela 3 volumeAttachment descrição do campo

Parâmetro

Obrigatório

Tipo

Descrição

volumeId

Sim

String

Especifica a ID do disco a ser anexado. O valor está no formato UUID.

device

Não

String

Indica o nome do dispositivo de disco.

NOTA:
  • O novo nome do dispositivo de disco não pode ser igual a um existente.
  • Este parâmetro é obrigatório para os ECS de Xen. Defina o valor do parâmetro para /dev/sda para os discos do sistema dos tais ECS e para /dev/sdx para discos de dados, onde x é uma letra em ordem alfabética. Por exemplo, se houver dois discos de dados, defina os nomes dos dispositivos dos dois discos de dados como /dev/sdb e /dev/sdc, respectivamente. Se você definir um nome de dispositivo começando com /dev/vd, o sistema usará /dev/sd por padrão.
  • Para os ECS de KVM, defina o valor do parâmetro para /dev/vda para discos do sistema. Os nomes de dispositivos para discos de dados dos ECS de KVM são opcionais. Se os nomes de dispositivos dos discos de dados forem necessários, defina-os em ordem alfabética. Por exemplo, se houver dois discos de dados, defina os nomes dos dispositivos dos dois discos de dados como /dev/vdb e /dev/vdc, respectivamente. Se você definir um nome de dispositivo começando com /dev/sd, o sistema usará /dev/vd por padrão.

volume_type

Não

String

Especifica o tipo de disco.

Se volumeId não estiver disponível e dry_run estiver definido como true, volume_type estará disponível e deverá ser especificado.

count

Não

Integer

Especifica o número de discos.

Se volumeId não estiver disponível e dry_run estiver definido como true, count estará disponível. Se a contagem não estiver disponível, o número de discos é 1 por padrão.

hw:passthrough

Não

String
  • Se esse parâmetro for definido como true, o tipo de dispositivo de disco será SCSI, o que permite que os ECS OS acessem diretamente a mídia de armazenamento subjacente. Os comandos de reserva SCSI são suportados.
  • Se este parâmetro é ajustado a false, o tipo de dispositivo do disco é VBD, que apoia somente comandos simples SCSI read/write.

Se volumeId não estiver disponível e dry_run estiver definido como true, hw:passthrough estará disponível e deverá ser especificado.

Resposta

Consulte Respostas (Tarefa).

Exemplo de solicitação

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
}

Exemplo de resposta

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

Valores retornados

Consulte Valores retornados para solicitações gerais.

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Gerenciamento de disco