Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Elastic Volume Service/ Referencia de la API/ API/ Gestión de discos/ Darse de baja de los discos EVS anuales/mensuales

Actualización más reciente 2024-09-04 GMT+08:00

Ver PDF

Darse de baja de los discos EVS anuales/mensuales

Función

Esta API se utiliza para cancelar la suscripción de discos de EVS anuales/mensuales. Tiene las siguientes limitaciones:

No se puede usar para cancelar la suscripción de discos del sistema y discos de arranque. Deben darse de baja junto con sus servidores.
Se puede cancelar la suscripción de un máximo de 60 discos al mismo tiempo utilizando esta API.

Método de invocación

Para obtener más información, consulte Invocación a las API.

URI

POST /v2/{project_id}/cloudvolumes/unsubscribe

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	El ID del proyecto. Para obtener más información sobre cómo obtener el ID de proyecto, consulte Obtención de un ID de proyecto.

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	El token del usuario. El token se puede obtener mediante invocación a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.

**Tabla 3** Parámetros del cuerpo de solicitud
Parámetro	Obligatorio	Tipo	Descripción
volume_ids	Sí	Array of strings	Los ID de los discos de los que se va a cancelar la suscripción.

Parámetros de respuesta

Código de estado: 202

**Tabla 4** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
[items]	Array of UnsubscribeVolumeResponseBody objects	Se responde a la solicitud.

**Tabla 5** UnsubscribeVolumeResponseBody
Parámetro	Tipo	Descripción
results	Array of UnsubscribeVolume objects	El resultado de la cancelación de la suscripción.

**Tabla 6** UnsubscribeVolume
Parámetro	Tipo	Descripción
volume_id	String	El ID del disco.
order_id	String	El ID del pedido de cancelación de suscripción. Este campo no aparece si se cancela la suscripción del disco por vencimiento.
result	String	El resultado de la cancelación de la suscripción. El valor puede ser SUCCESS o FAIL.
fail_reason	String	La causa del error devuelto si el valor de result es FAIL. Este campo no aparece si el valor de result es SUCCESS.

Ejemplo de solicitudes

La cancelación de la suscripción de discos anuales/mensuales cuyos ID sean 8739ca48-1b86-46aa-9059-38623ee1346c y fc7d594d-e78f-49a8-ab6e-90ee6b560cb0

POST /v2/{project_id}/cloudvolumes/unsubscribe

{
  "volume_ids" : [ "fc7d594d-e78f-49a8-ab6e-90ee6b560cb0", "8739ca48-1b86-46aa-9059-38623ee1346c" ]
}

Ejemplo de respuestas

Código de estado: 202

Se responde a la solicitud.

{
  "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"
  } ]
}