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
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
O ID do projeto. |
Parâmetros 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. |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
volume |
Sim |
CreateVolumeOptionV3 object |
O disco a ser criado. |
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 |
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.
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 |
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. |
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.
|
hw:passthrough |
Não |
String |
Especifica o parâmetro que descreve o tipo de dispositivo de disco em metadata.
|
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
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.