Eliminación de un PersistentVolume
Función
Esta API se utiliza para eliminar un PersistentVolume de un espacio de nombres especificado. Con esta API, puede determinar si desea conservar el almacenamiento en la nube asociado con PersistentVolume. Esta API ha sido obsoleta. Utilice la API de PV de Kubernetes correspondiente en su lugar.
El formato del URL de gestión de almacenamiento es https://{clusterid}.Endpoint/uri. En el URL, {clusterid} indica un ID del clúster y uri indica la ruta de acceso al recurso, es decir, la ruta de acceso a la API. Si se utiliza https://Endpoint/uri, el parámetro X-Cluster-ID debe especificarse en el encabezado de solicitud.
URI
DELETE /api/v1/cloudpersistentvolumes/{name}
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
name |
Sí |
String |
Nombre del PersistentVolume que debe suprimirse. Formato de nombre: Volume name[?deleteVolume=BOOLEAN&storageType=Cloud storage volume type]. Se puede omitir el contenido entre corchetes. Ejemplos:
En el primer ejemplo: deleteVolume: Si desea eliminar el almacenamiento en la nube de backend asociado después de eliminar el PersistentVolume. El valor puede ser true o false.
NOTA:
Si el tipo de volumen de almacenamiento es efs, este parámetro debe establecerse en false. storageType: Tipo de volumen de almacenamiento en la nube. Este parámetro se utiliza junto con deleteVolume. Es decir, deben configurarse deleteVolume y storageType al mismo tiempo.
NOTA:
|
Solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
Content-Type |
Sí |
String |
Tipo de cuerpo del mensaje (formato). Valores posibles:
|
X-Auth-Token |
Sí |
String |
Las solicitudes para invocar a una API pueden autenticarse usando un token o AK/SK. Si se utiliza la autenticación basada en token, este parámetro es obligatorio y se debe establecer en un token de usuario. Para obtener más información sobre cómo obtener un token de usuario, consulte Autenticación. Longitud máxima: 16,384 caracteres |
X-Cluster-ID |
No |
String |
ID del clúster. Este parámetro es obligatorio cuando se utiliza el formato de URL https://Endpoint/uri. Para obtener más información sobre cómo obtener el valor, consulte Cómo obtener parámetros en el URI de la API. |
Respuesta
Código de estado: 200
Parámetro |
Tipo |
Descripción |
---|---|---|
apiVersion |
String |
Versión de la API. El valor se fija a v1. Valor predeterminado: v1 |
kind |
String |
Tipo de la API. El valor se fija a PersistentVolume. Valor predeterminado: PersistentVolume |
metadata |
Objeto de PersistentVolumeMetadata |
Información de metadatos de PersistentVolume. |
spec |
Objeto de PersistentVolumeSpec |
Especificaciones de PersistentVolume. |
status |
Objeto de PersistentVolumeStatus |
Información de estado de PersistentVolume. |
Parámetro |
Tipo |
Descripción |
---|---|---|
name |
String |
Nombre del PV. Escriba de 1 a 253 caracteres que comiencen y terminen con una letra o un dígito. Solo se permiten letras minúsculas, dígitos, guiones (-) y puntos (.). Los nombres de PV deben ser únicos en un espacio de nombres. |
labels |
Map<String,String> |
Etiquetas de PV, en formato de pares de clave y valor.
Etiqueta de ejemplo: "foo": "bar" |
Parámetro |
Tipo |
Descripción |
---|---|---|
flexVolume |
Objeto de FlexVolume |
Complemento de FlexVolume de almacenamiento de Kubernetes. |
persistentVolumeReclaimPolicy |
String |
Política de recuperación de PV. Valores posibles:
|
accessModes |
Matriz de strings |
Modo de acceso del PersistentVolume.
|
Parámetro |
Tipo |
Descripción |
---|---|---|
driver |
String |
Nombre del complemento de almacenamiento de FlexVolume. Establezca este parámetro en función del tipo de volumen de almacenamiento.
|
fsType |
String |
Tipo del sistema de archivos. Establezca este parámetro en función del tipo de volumen de almacenamiento.
|
options |
Objeto de Options |
Elementos de configuración de FlexVolume. |
Parámetro |
Tipo |
Descripción |
---|---|---|
fsType |
String |
Tipo del sistema de archivos. Establezca este parámetro en función del tipo de volumen de almacenamiento.
|
region |
String |
Región donde se encuentra el almacenamiento en la nube. |
volumeID |
String |
UUID del almacenamiento en la nube. Si el almacenamiento en la nube es un bucket de OBS, establezca este parámetro en el nombre del bucket. |
storageType |
String |
Tipo de volumen de almacenamiento en la nube.
|
Parámetro |
Tipo |
Descripción |
---|---|---|
accessModes |
Matriz de strings |
Modo de acceso del PersistentVolume. |
phase |
String |
Estado de PV. Valores posibles:
|
Ejemplo de solicitud
No hay
Ejemplo de la respuesta
Código de estado: 200
El trabajo para eliminar un PersistentVolume se entrega correctamente.
{ "kind" : "PersistentVolume", "apiVersion" : "v1", "metadata" : { "name" : "pv-test", "selfLink" : "/api/v1/persistentvolumes/pv-test", "uid" : "0d93181d-3628-11e7-9093-fa163e8c373b", "resourceVersion" : "180886", "creationTimestamp" : "2017-05-11T08:58:51Z", "labels" : { "app" : "test" } }, "spec" : { "flexVolume" : { "driver" : "huawei.com/fuxivol", "fsType" : "ext4", "options" : { "fsType" : "ext4", "kubernetes.io/namespace" : "default", "volumeID" : "0781b22f-4d89-4e9c-b026-80e545cea16c" } }, "capacity" : { "storage" : "1Gi" }, "accessModes" : [ "ReadWriteMany" ], "persistentVolumeReclaimPolicy" : "Delete" }, "status" : { "phase" : "Available" } }
Código de estado
Código de estado |
Descripción |
---|---|
200 |
El trabajo para eliminar un PersistentVolume se entrega correctamente. |
Códigos de error
Para obtener más información, véase Códigos de error.