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. Essa chamada de API existe apenas por motivos de compatibilidade e não se destina a ser usada. Use outra API.

Método de chamada

Para obter detalhes, consulte Chamada de APIs.

URI

POST /v2/{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.

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

Parâmetro

Obrigatório

Tipo

Descrição

volume

Sim

CreateDiskOption object

As informações do disco a ser criado.

OS-SCH-HNT:scheduler_hints

No

CreateVolumeSchedulerHints object

Parâmetro de agendamento do disco de nuvem, que pode ser usado para especificar que o disco de nuvem seja criado em um pool de armazenamento dedicado.

Tabela 4 CreateDiskOption

Parâmetro

Obrigatório

Tipo

Descrição

availability_zone

Sim

String

A AZ onde você deseja criar o disco.

backup_id

Não

String

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

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 o disco for criado de um backup, a criação em lotes não será possível, e esse parâmetro deve ser definido como 1.

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

description

Não

String

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

enterprise_project_id

Não

String

O ID do projeto empresarial. Este ID é associado ao disco durante a criação do disco.

imageRef

Não

String

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

metadata

Não

Map<String,String>

As informações de metadados do disco. O valor pode ser o seguinte: __system__cmkid:

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.

NOTA:

Para obter detalhes sobre como obter o ID de chave, consulte Consulta da lista de chaves.

__system__encrypted:

O campo de encriptação nos metadata. O valor pode ser 0 (não criptografa) ou 1 (criptografa). Se esse parâmetro não for especificado, o atributo de encriptação do disco será o mesmo da fonte de dados. Se o disco não for criado a partir de uma fonte de dados, o disco não será criptografado por padrão.

[full_clone]

se o disco for criado a partir de um snapshot e a clonagem vinculada precisar ser usada, defina esse parâmetro como 0.

[hw:passthrough]

  • 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 esse parâmetro não estiver disponível, o tipo de dispositivo de disco será VBD.

multiattach

Não

Boolean

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

name

Não

String

O nome do disco.

Se você criar um disco, o valor do name será o nome do disco, que pode conter no máximo 64 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. Exemplo de nome de disco: volume-0001 ou volume-0002

shareable

Não

String

Se o disco é compartilhável. O valor pode ser true (compartilhável) ou false (não compartilhável). Este campo foi preterido. Use multiattach.

size

Sim

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 ou usa uma imagem, ou um snapshot para criar um disco. Se você usar uma imagem ou um snapshot para criar um disco, o tamanho do disco não poderá ser menor que o tamanho da imagem ou do snapshot.
  • 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.

snapshot_id

Não

String

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

volume_type

Sim

String

O tipo de disco.

O valor pode ser SATA, SAS, GPSSD, SSD, ESSD, GPSSD2 ou ESSD2.

  • 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
  • ESSD: o tipo de SSD extremo
  • GPSSD2: o tipo de SSD V2 de uso geral
  • ESSD2: o tipo de SSD V2 extremo

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.

NOTA:

Para obter detalhes sobre os tipos de disco, consulte

Tipos e desempenho de disco.

Valores de enumeração:

  • SATA
  • SAS
  • GPSSD
  • SSD
  • ESSD
  • GPSSD2
  • ESSD2

tags

Não

Map<String,String>

As informações sobre a tag de disco.

Tabela 5 CreateVolumeSchedulerHints

Parâmetro

Obrigatório

Tipo

Descrição

dedicated_storage_id

Não

String

O ID do pool de armazenamento dedicado. Se esse parâmetro for especificado, os discos serão criados no pool de armazenamento especificado.

Parâmetros de resposta

Código de status: 202

Tabela 6 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

job_id

String

O ID da tarefa. Esse parâmetro é retornado quando o disco é cobrado com base no pagamento por uso. > > > Você pode consultar se a tarefa de criação de disco foi concluída pelo ID da tarefa. Para obter detalhes, consulte Consulta de status da tarefa.

volume_ids

Array of strings

Os IDs dos discos a serem criados. >>Se 404 for retornado quando você consultar os detalhes de um disco pelo ID do disco, o disco está sendo criado ou falhou ao ser criado. >Você pode consultar se a tarefa de criação de disco foi concluída por ID de tarefa. Para obter detalhes, consulte Consulta de status da tarefa.

Código de status: 400

Tabela 7 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error

Error object

A mensagem de erro retornada se ocorrer um erro. Para obter detalhes, consulte Parâmetros no campo error.

Tabela 8 Error

Parâmetro

Tipo

Descrição

code

String

O código de erro retornado se ocorrer um erro. Para os códigos de erro e seus significados, consulte Códigos de erro.

message

String

A mensagem de erro retornada se ocorrer um erro.

Exemplo de solicitações

{
  "volume" : {
    "backup_id" : null,
    "count" : 1,
    "availability_zone" : "az1.dc1",
    "description" : "test_volume_1",
    "size" : 120,
    "name" : "test_volume_1",
    "imageRef" : null,
    "volume_type" : "SSD",
    "metadata" : {
      "__system__encrypted" : "0",
      "__system__cmkid" : null
    }
  }
}

Exemplo de respostas

Código de status: 202

Accepted

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

Código de status: 400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

Códigos de status

Código de status

Descrição

202

Accepted

400

Bad Request

Códigos de erro

Consulte Códigos de erro.