Cancelamento de assinatura de discos EVS anuais/mensais
Função
Esta API é usada para cancelar a assinatura de discos EVS anuais/mensais. Tem as seguintes restrições:
Ela não pode ser usada para cancelar a assinatura de discos do sistema e discos inicializáveis. Eles deve ser cancelados junto com o servidor.
É possível cancelar a assinatura de um máximo de 60 discos ao mesmo tempo usando essa API.
Método de chamada
Para obter detalhes, consulte Chamada de APIs.
URI
POST /v2/{project_id}/cloudvolumes/unsubscribe
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
project_id | Sim | String | O ID do projeto. Para obter detalhes sobre como obter o ID de projeto, consulte Obtenção de um ID de projeto. |
Parâmetros de solicitação
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
X-Auth-Token | Sim | String | O token do usuário. O token pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário. |
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
volume_ids | Sim | Array of strings | Os IDs dos discos a serem cancelados. |
Parâmetros de resposta
Código de status: 202
Parâmetro | Tipo | Descrição |
|---|---|---|
[items] | Array of UnsubscribeVolumeResponseBody objects | A solicitação foi respondida. |
Parâmetro | Tipo | Descrição |
|---|---|---|
results | Array of UnsubscribeVolume objects | O resultado do cancelamento da assinatura. |
Parâmetro | Tipo | Descrição |
|---|---|---|
volume_id | String | O ID do disco. |
order_id | String | O ID do pedido de cancelamento de assinatura. Esse campo não será exibido se o disco tiver sido cancelado porque ele expirou. |
result | String | O resultado do cancelamento da assinatura. O valor pode ser SUCCESS ou FAIL. |
fail_reason | String | A causa de falha retornada se result for FAIL. Este campo não será exibido se result for SUCCESS. |
Exemplo de solicitações
Cancelar a assinatura de discos anuais/mensais cujos IDs são 8739ca48-1b86-46aa-9059-38623ee1346c e fc7d594d-e78f-49a8-ab6e-90ee6b560cb0
POST /v2/{project_id}/cloudvolumes/unsubscribe
{
"volume_ids" : [ "fc7d594d-e78f-49a8-ab6e-90ee6b560cb0", "8739ca48-1b86-46aa-9059-38623ee1346c" ]
} Exemplo de respostas
Código de status: 202
A solicitação foi respondida.
{
"results" : [ {
"volume_id" : "8739ca48-1b86-46aa-9059-38623ee1346c",
"order_id" : "CS23021116385NAOR",
"result" : "SUCCESS"
}, {
"volume_id" : "fc7d594d-e78f-49a8-ab6e-90ee6b560cb0",
"result" : "FAIL",
"fail_reason" : "INTERNAL ERROR, please contact customer service"
} ]
} Códigos de status
Código de status | Descrição |
|---|---|
202 | A solicitação foi respondida. |
Códigos de erro
Consulte Códigos de erro.

