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 da Nova do OpenStack/ Gerenciamento de disco/ Anexação de um disco a um ECS

Atualizado em 2025-08-25 GMT+08:00

Ver PDF

Anexação de um disco a um ECS

Função

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

Para exibir exemplos de aplicativos sobre o anexo de disco ECS, consulte Anexação de um disco a um ECS.

Restrições

Se você anexar um disco inicializável a um ECS, deverá especificar a letra da unidade de disco.
Um disco criado usando um backup não pode ser anexado a um ECS como o disco do sistema.
Um ECS no estado SUSPENDED ou PAUSED, que é especificado usando o parâmetro OS-EXT-STS:vm_state do ECS, não pode ter um disco anexado.
O SVE deve estar no estado available.
O disco EVS e o ECS de destino devem estar localizados na mesma AZ.
Discos VBD EVS não podem ser conectados a BMSs.

URI

POST /v2.1/{project_id}/servers/{server_id}/os-volume_attachments

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 descreve os parâmetros de solicitação.

**Tabela 2** Parâmetros de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
volumeAttachment	Sim	Object	Especifica os volumes a serem anexados. Para mais detalhes, consulte Tabela 3.

**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	Especifica o nome do dispositivo, como /dev/sda ou /dev/sdb. O novo nome do dispositivo de disco não pode ser igual a um existente. O nome do dispositivo deve ser especificado com base na seqüência de nomes de dispositivos existentes. Caso contrário, o sistema gera um automaticamente. NOTA: Os nomes dos dispositivos de disco VBD só podem ser /dev/vdb até /dev/vdx. É aconselhável anexar os discos VBD em ordem alfabética. Caso contrário, as letras da unidade de disco podem estar incorretas no ECS.

Resposta

Tabela 4 descreve os parâmetros de resposta.

**Tabela 4** Parâmetros de resposta
Parâmetro	Tipo	Descrição
volumeAttachment	Object	Especifica os discos conectados a um ECS. Para mais detalhes, consulte Tabela 5.

**Tabela 5** **volumeAttachment** descrição do campo
Parâmetro	Tipo	Descrição
device	String	Especifica o nome do dispositivo.
serverId	String	Especifica a ID do ECS de destino no formato UUID.
id	String	Especifica a ID do disco no formato UUID.
volumeId	String	Especifica o ID de anexação, que é o mesmo que o UUID.

Exemplo de solicitação

POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-volume_attachments

{
    "volumeAttachment": {
        "volumeId": "54667652-3029-4af8-9222-2d53066fd61c",
        "device": "/dev/sdb"
    }
}

Exemplo de resposta

{
    "volumeAttachment": {
        "device": "/dev/vdb",
        "serverId": "ab258e25-e351-47c7-b6e3-0749c5d9ed6a",
        "id": "54667652-3029-4af8-9222-2d53066fd61c",
        "volumeId": "54667652-3029-4af8-9222-2d53066fd61c"
    }
}