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
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. |
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. |
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]
|
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:
|
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.
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 Valores de enumeração:
|
tags |
Não |
Map<String,String> |
As informações sobre a tag de disco. |
Parâmetros de resposta
Código de status: 202
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
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. |
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.