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/ Bare Metal Server/ Referência de API/ APIs do BMS/ Gerenciamento de disco do BMS/ Anexar um disco EVS a um BMS
Atualizado em 2023-03-20 GMT+08:00
Ver PDF
Compartilhar

Anexar um disco EVS a um BMS

Função

Essa API é usada para anexar discos EVS a um BMS como discos de dados depois que o BMS é criado se os discos existentes forem insuficientes ou não puderem atender aos requisitos.

Restrições

  • Os discos EVS não podem ser anexados a um BMS em um lote.
  • Um máximo de 60 discos EVS podem ser anexados a um BMS.
  • Um disco inicializável não pode ser anexado a um BMS.
  • Um disco não pode ser anexado a um BMS no estado SUSPENDED ou PAUSED, que é especificado usando o parâmetro OS-EXT-STS:vm_state.
  • Somente um disco compartilhado ou um disco no estado available pode ser anexado a um BMS.
  • Somente discos EVS cujo tipo de dispositivo é SCSI podem ser conectados a um BMS.

URI

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

A Tabela 1 lista os parâmetros.

Tabela 1 Descrição do parâmetro

Parâmetro

Obrigatório

Descrição

project_id

Sim

Especifica o 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 o ID de BMS.

Você pode obter o ID do BMS no console do BMS ou usando a API do Consulta de BMSs (API OpenStack nativo).

Solicitação

  • Parâmetros de solicitação

    Parâmetro

    Obrigatório

    Tipo

    Descrição

    volumeAttachment

    Sim

    Object

    Especifica os discos a serem anexados. Para mais detalhes, consulte Tabela 2.
    Tabela 2 Descrição da estrutura de dados do campo volumeAttachment

    Parâmetro

    Obrigatório

    Tipo

    Descrição

    volumeId

    Sim

    String

    Especifica o ID do disco a ser anexado a um BMS.

    Você pode obter o ID do disco no console do EVS ou chamando a API de Consulta de discos EVS.

    device

    Não

    String

    Especifica o ponto de montagem, como /dev/sda e /dev/sdb.

    O novo ponto de montagem de disco não pode ser o mesmo que um existente.

    O ponto de montagem deve ser especificado com base na sequência de nomes de dispositivos existentes. Se este parâmetro for deixado em branco ou definido para "", o sistema gera automaticamente um ponto de montagem.
  • Exemplo de solicitação 
    1
    		 
    POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/attachvolume

    1
2
3
4
5
6
    		 
    {
    "volumeAttachment": {
        "volumeId": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6",
        "device": ""
    }
}

Resposta

  • Parâmetros de resposta
Tabela 3 Resposta normal

Parâmetro

Tipo

Descrição

job_id

String

Especifica o ID de tarefa retornada após a emissão de um comando de tarefa. O ID da tarefa pode ser usado para consultar o status de execução da tarefa.

Para obter detalhes sobre como consultar o status de execução da tarefa com base em job_id, consulte Consulta do status de tarefas.
Tabela 4 Resposta anormal

Parâmetro

Tipo

Descrição

error

Estrutura de dados do dicionário

Especifica o erro retornado quando um envio de tarefa encontra uma exceção. Para mais detalhes, consulte Tabela 5.
Tabela 5 Estrutura de dados de error

Parâmetro

Tipo

Descrição

message

String

Especifica a mensagem de erro.

code

String

Especifica o código de erro.

Exemplo de resposta

  • Resposta normal 
    1
2
3
    		 
    { 
    "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" 
}

Valores retornados

Valores normais

Valores retornados

Descrição

202

A solicitação foi aceita, mas o processamento foi atrasado.

Para obter detalhes sobre outros valores retornados, consulte Códigos de status.

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Gerenciamento de disco do BMS