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.

Nesta página

Função
Método de chamada
URI
Parâmetros de solicitação
Parâmetros de resposta
Exemplo de solicitações
Exemplo de respostas
Códigos de status
Códigos de erro

Mostrar todos

Central de ajuda/ Elastic Volume Service/ Referência de API/ APIs desatualizadas/ API/ Gerenciamento de disco/ Criação de discos EVS (preterido)

Criação de discos EVS (preterido)

Atualizado em 2024-09-25 GMT+08:00

Ver PDF

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.

Tópico principal: Gerenciamento de disco

Tópico anterior: Consulta de detalhes sobre todos os discos EVS (preterido)

Próximo tópico: Consulta de detalhes sobre um disco EVS (preterido)

Feedback

Esta página foi útil?

Sim Não

Deixar um comentário

Obrigado por seus comentários. Estamos trabalhando para melhorar a documentação.

O sistema está ocupado. Tente novamente mais tarde.

Quais dos seguintes problemas você encontrou?

O conteúdo é inconsistente com a UI do produto

Descrições pouco claras

Falta de exemplos ou código

Passos incorretos

Não encontro o que preciso

Falta de melhores práticas

Feedback (opcional)

0/500

Selecione pelo menos um tipo de problema e insira seus comentários ou sugestões.

Insira um máximo de 500 caracteres.

Enviar Cancelar