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.