Expansão da capacidade de um disco EVS (preterido)
Função
Esta API é usada para expandir a capacidade de um disco EVS. Se o status do disco a ser expandido estiver available, não há restrições. A API de expansão usa notificação assíncrona e você precisa confirmar os resultados da expansão na VM. Essa chamada de API existe apenas por motivos de compatibilidade e não se destina a ser usada.
Restrições
Se o status do disco a ser expandido estiver in-use, as restrições serão as seguintes:
-
Um disco compartilhado não pode ser expandido, o que significa que o valor de multiattach deve ser false.
-
O status do servidor ao qual o disco está anexado deve ser ACTIVE, PAUSED, SUSPENDED ou SHUTOFF.
Método de chamada
Para obter detalhes, consulte Chamada de APIs.
URI
POST /v2/{project_id}/cloudvolumes/{volume_id}/action
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
project_id |
Sim |
String |
O ID do projeto. |
|
volume_id |
Sim |
String |
O ID do disco. |
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 |
|---|---|---|---|
|
os-extend |
Sim |
ResizeDiskOption object |
O marcador de expansão de capacidade. |
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|---|---|---|---|
|
new_size |
Sim |
Integer |
O novo tamanho do disco, em GiB. Esse valor de parâmetro deve ser maior que o tamanho original do disco e menor que o tamanho máximo permitido para um disco. O tamanho máximo do disco:
|
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 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
{
"os-extend" : {
"new_size" : 200
}
}
Exemplo de respostas
Código de status: 200
OK
{
"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 |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
Códigos de erro
Consulte Códigos de erro.
