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.
