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.
Atualizado em 2024-09-25 GMT+08:00

Criação de discos EVS (preterido)

Função

Esta API é usada para criar um ou vários discos EVS.

Método de chamada

Para obter detalhes, consulte Chamada de APIs.

URI

POST /v3/{project_id}/cloudvolumes

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

O ID do projeto.

Parâmetros de solicitação

Tabela 2 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Um token obtido do IAM é válido por apenas 24 horas. Ao usar um token para autenticação, armazene-o em cache para evitar chamar a API com frequência.

X-Client-Token

Não

String

O identificador de idempotência de uma solicitação. Este valor de parâmetro é gerado pelo cliente e deve ser exclusivo entre as solicitações. O valor é uma cadeia de caracteres de 36 dígitos no formato UUID e é válido por 8 horas. Se várias solicitações tiverem o mesmo identificador idempotente, as solicitações serão consideradas como uma solicitação idempotente e o mesmo corpo de resposta será retornado.

Tabela 3 Parâmetros do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

volume

Sim

CreateVolumeOptionV3 object

O disco a ser criado.

Tabela 4 CreateVolumeOptionV3

Parâmetro

Obrigatório

Tipo

Descrição

backup_id

Não

String

O ID de backup. Esse parâmetro é obrigatório quando você cria o disco a partir de um backup.

NOTA:

Para obter detalhes sobre como obter o ID de backup, consulte Consulta de todos os backups.

availability_zone

Sim

String

A AZ onde você deseja criar o disco. Se a AZ especificada não existir, o disco falhará ao ser criado.

NOTA:

Para obter detalhes sobre como obter a AZ, consulte Consulta de todas as AZs.

description

Não

String

A descrição do disco. Você pode inserir até 85 caracteres.

size

Não

Integer

O tamanho do disco, em GiB. As restrições são as seguintes: Disco do sistema: 1 GiB a 1.024 GiB Disco de dados: 10 GiB a 32.768 GiB Este parâmetro é obrigatório quando você cria um disco vazio.

Se você criar o disco a partir de um snapshot, esse parâmetro será obrigatório e o tamanho do disco deverá ser maior ou igual ao tamanho do snapshot.

Se você criar o disco a partir de uma imagem, esse parâmetro será obrigatório e o tamanho do disco deverá ser maior ou igual à capacidade mínima exigida pelo atributo de imagem min_disk.

Esse parâmetro é opcional se você criar o disco a partir de um backup. Se não for especificado, o tamanho do disco será o mesmo que o tamanho do backup.

NOTA:

Se o valor especificado for um decimal, a parte do número será usada por padrão.

name

Não

String

O nome do disco. Se você criar um disco, o valor do name será o nome do disco. Você pode inserir até 85 caracteres. Se você criar vários discos (o valor de count maior que 1), o sistema adicionará automaticamente um hífen seguido por um número incremental de quatro dígitos, como -0000, ao final de cada nome de disco. Por exemplo, os nomes dos discos podem ser volume-0001 e volume-0002.

snapshot_id

Não

String

O ID do snapshot. Se esse parâmetro for especificado, o disco será criado a partir de um snapshot.

NOTA:

Para obter detalhes sobre como obter o ID do snapshot, consulte

Consulta de detalhes sobre snapshots do EVS.

imageRef

Não

String

O ID da imagem. Se este parâmetro for especificado, o disco será criado a partir de uma imagem.

NOTA:

Discos do sistema do Bare Metal Server (BMS) não podem ser criados a partir de imagens do BMS.

Para obter detalhes sobre como obter o ID de imagem, veja Consulta de imagens.

tipo_volume

Yes

String

O tipo de disco. O valor pode ser SATA, SAS, GPSSD ou SSD.

  • SATA: o tipo de I/O comum (esgotado)

  • SAS: o tipo de I/O alta

  • GPSSD: o tipo de SSD de uso geral

  • SSD: o tipo de I/O ultra-alta

Se o tipo de disco especificado não estiver disponível na AZ, o disco falhará ao ser criado.

NOTA:

Ao criar um disco a partir de um snapshot, verifique se o tipo de disco do novo disco é consistente com o do disco de origem do snapshot. Para obter detalhes sobre os tipos de disco, consulte

Tipos e desempenho de disco.

count

Não

Integer

O número de discos a serem criados em um lote. Se este parâmetro não for especificado, apenas um disco será criado. Você pode criar um máximo de 100 discos em um lote.

Se os discos forem criados a partir de backups, a criação de lotes não será suportada e esse parâmetro deve ser definido como 1.

NOTA:

Se o valor especificado for um decimal, a parte do número será usada por padrão.

shareable

Não

String

Se o disco é compartilhável. O valor pode ser true (compartilhável) ou false (não compartilhável).

NOTA:

Este campo foi preterido. Use multiattach.

metadata

Não

VolumeMetadataV3 object

As informações do disco a ser criado.

multiattach

Não

String

Se o disco é compartilhável. O valor padrão é false. true: o disco é compartilhável. false: o disco não pode ser compartilhado.

Para obter detalhes, consulte Discos EVS compartilhados e instruções de utilização.

tags

Não

Map<String,String>

As tags adicionadas ao disco durante a criação do disco.

Um máximo de 10 tags podem ser adicionadas a um disco.

A chave de uma tag deve ser única. A desduplicação será realizada para chaves duplicadas. Portanto, apenas uma chave entre as chaves duplicadas de uma tag é válida.

Chave de tag: uma chave de tag pode conter no máximo 36 caracteres. Pode conter letras, dígitos, sublinhados (_), hifens (-) e caracteres Unicode (\u4E00-\u9FFF).

Valor de tag: um valor de tag pode ter 43 caracteres e pode ser uma cadeia de caracteres vazia. Pode conter letras, dígitos, sublinhados (_), pontos (.), hifens (-) e caracteres Unicode (\u4E00-\u9FFF).

enterprise_project_id

Não

String

O ID do projeto empresarial. Este ID é associado ao disco durante a criação do disco. Se este parâmetro não for transferido ou seu valor for definido como 0, o disco será associado ao projeto empresarial default.

Para obter detalhes, consulte Guia de usuário do Enterprise Management.

Tabela 5 VolumeMetadataV3

Parâmetro

Obrigatório

Tipo

Descrição

__system__cmkid

Não

String

O ID da CMK de encriptação em metadata. Este parâmetro é utilizado em conjunto com __system__encrypted para encriptação. O comprimento do cmkid é fixado em 36 bytes.

__system__encrypted

Não

String

O campo de encriptação nos metadata. 0: sem criptografia 1: criptografia. Se este parâmetro não aparecer, o disco não será criptografado.

full_clone

Não

String

o método de criação quando o disco é criado a partir de um snapshot.

  • 0: clone vinculado

  • 1: clone completo

hw:passthrough

Não

String

Especifica o parâmetro que descreve o tipo de dispositivo de disco em metadata.

  • Se o valor desse parâmetro for true, o tipo de dispositivo de disco será SCSI, o que permite que os sistemas operacionais do ECS acessem diretamente a mídia de armazenamento subjacente e ofereça suporte a comandos de reserva SCSI.

  • Se valor deste parâmetro é false, o tipo de dispositivo do disco é VBD, que oferece suporte somente aos comandos SCSI de leitura/gravação simples.

  • Se este parâmetro não aparecer, o tipo de dispositivo de disco é VBD.

orderID

Não

String

O parâmetro que descreve o modo de cobrança do disco em metadata.

Se esse parâmetro tiver um valor, o disco será cobrado anualmente/mensalmente. Caso contrário, o disco é cobrado em uma base de pagamento por uso.

Parâmetros de resposta

Código de status: 200

Tabela 6 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

job_id

String

O ID da tarefa retornou em uma resposta normal.

NOTA:

Para consultar o status da tarefa, consulte a seção "Consulta de status da tarefa".

Exemplo de solicitações

POST https://{endpoint}/v3/{project_id}/cloudvolumes

{
  "volume" : {
    "count" : 1,
    "availability_zone" : "az-dc-1",
    "description" : "test_volume_1",
    "size" : 120,
    "name" : "test_volume_1",
    "volume_type" : "SSD",
    "metadata" : {
      "__system__encrypted" : "1",
      "__system__cmkid" : "37b0d52e-c249-40d6-83cb-2b93f22445bd"
    }
  }
}

Exemplo de respostas

Nenhum

Códigos de status

Código de status

Descrição

200

OK

Códigos de erro

Consulte Códigos de erro.