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 desatualizadas/ Gerenciamento de disco (as API de Nova do OpenStack)/ Criação de um disco (Descartado)

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

Ver PDF

Criação de um disco (Descartado)

Função

Essa API é usada para criar um disco.

Esta API foi descartada. Use a API descrita em Criação de discos de EVS (OpenStack Cinder API v2).

URI

POST /v2.1/{project_id}/os-volumes

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.

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
availability_zone	Não	String	Especifica a AZ à qual pertence o volume a ser criado. Se a AZ especificada não existir, a criação do volume falhou e o volume está em estado de error. A AZ à qual o volume a ser criado pertence deve ser especificada no sistema de nuvem pública.
display_description	Não	String	Especifica a descrição do volume.
snapshot_id	Não	String	Especifica a ID do snapshot. Se esse parâmetro for especificado, o volume será criado a partir de um instantâneo.
size	Sim (Se o volume for criado a partir de um instantâneo, este parâmetro é opcional.)	Integer	Especifica o tamanho do volume. Unidade: GB
display_name	Não	String	Especifica o nome do volume.
volume_type	Não	String	Especifica o tipo de volume.
metadata	Não	Object	Especifica os metadados do volume.

Resposta

Tabela 3 descreve os parâmetros de resposta.

**Tabela 3** Parâmetros de resposta
Parâmetro	Tipo	Descrição
id	String	Especifica a ID do disco no formato UUID.
displayName	String	Especifica o nome do volume.
status	String	Especifica o status do volume.
attachments	Array of objects	Especifica as informações de anexo de volume.
availabilityZone	String	Especifica a AZ à qual o volume pertence.
createdAt	String	Especifica a hora em que o volume foi criado.
displayDescription	String	Especifica a descrição do volume.
volumeType	String	Especifica o tipo de volume.
snapshotId	String	Especifica a ID do snapshot.
metadata	Object	Especifica os metadados do volume.
size	Integer	Especifica o tamanho do volume.

Exemplo de solicitação

POST https://{endpoint}/v2.1/b84c367e4d1047fc9b54f28b400ddbc2/os-volumes

{
    "volume": {
        "availability_zone": "az1-dc1",
        "display_description": "test1",
        "snapshot_id": null,
        "size": 1,
        "display_name": "test",
        "volume_type": "SSD",
        "metadata": {
            "testkey": "testvalue"
        }
    }
}

Exemplo de resposta

{
  "volume": {
    "displayDescription": "test1",
    "volumeType": "SATA",
    "createdAt": "2018-05-18T01:17:03.871808",
    "metadata": {
      "testkey": "testvalue",
      "resourceSpecCode": "SATA"
    },
    "attachments": [
      {}
    ],
    "snapshotId": null,
    "size": 1,
    "displayName": "test",
    "id": "b4fb891c-c665-4478-92b0-8a7fa65a57cd",
    "availabilityZone": "az1.dc1",
    "status": "creating"
  }
}