Exclusão de um PersistentVolume
Função
Essa API é usada para excluir um PersistentVolume de um namespace especificado. Usando essa API, você pode determinar se deve reter o armazenamento em nuvem associado ao PersistentVolume. Esta API foi preterida. Em vez disso, use a API PV do Kubernetes correspondente.
O formato do URL de gerenciamento de armazenamento é https://{clusterid}.Endpoint/uri. No URL, {clusterid} indica o ID do cluster e uri indica o caminho do recurso, ou seja, o caminho para acesso à API. Se https://Endpoint/uri for usado, o parâmetro X-Cluster-ID deve ser especificado no cabeçalho da solicitação.
URI
DELETE /api/v1/cloudpersistentvolumes/{name}
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
name | Sim | String | Nome do PersistentVolume a ser eliminado. Formato do nome: Volume name[?deleteVolume=BOOLEAN&storageType=Cloud storage volume type]. O conteúdo entre colchetes pode ser omitido. Exemplos:
No primeiro exemplo: deleteVolume: se deve excluir o armazenamento em nuvem de back-end associado depois que o PersistentVolume for excluído. O valor pode ser true ou false. NOTA: Se o tipo de volume de armazenamento for efs, esse parâmetro deve ser definido como false. storageType: tipo de volume de armazenamento em nuvem. Este parâmetro é utilizado em conjunto com deleteVolume. Ou seja, deleteVolume e storageType devem ser configurados ao mesmo tempo. NOTA:
|
Solicitação
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Content-Type | Sim | String | Tipo de corpo da mensagem (formato). Valores possíveis:
|
X-Auth-Token | Sim | String | As solicitações para chamar uma API podem ser autenticadas usando um token ou AK/SK. Se a autenticação baseada em token for usada, esse parâmetro é obrigatório e deve ser definido como um token de usuário. Para obter detalhes sobre como obter um token de usuário, consulte Autenticação. Comprimento máximo: 16.384 caracteres |
X-Cluster-ID | Não | String | ID do cluster. Este parâmetro é obrigatório quando o formato de URL https://Endpoint/uri é usado. Para obter detalhes sobre como obter o valor, consulte Como obter parâmetros no URI da API. |
Resposta
Código de status: 200
Parâmetro | Tipo | Descrição |
|---|---|---|
apiVersion | String | Versão da API. O valor é fixado em v1. Valor padrão: v1 |
kind | String | Tipo de API. O valor é fixado em PersistentVolume. Valor padrão: PersistentVolume |
metadata | PersistentVolumeMetadata object | Informações de metadados do PersistentVolume. |
spec | PersistentVolumeSpec object | Especificações do PersistentVolume. |
status | PersistentVolumeStatus object | Informações de status do PersistentVolume. |
Parâmetro | Tipo | Descrição |
|---|---|---|
name | String | Nome do PV. Digite de 1 a 253 caracteres começando e terminando com uma letra ou dígito. Use somente letras minúsculas, dígitos, hifens (-) e pontos (.). Nomes do PV devem ser exclusivos em um namespace. |
labels | Map<String,String> | Rótulos do PV, no formato de pares chave-valor.
Exemplo de rótulo: "foo": "bar" |
Parâmetro | Tipo | Descrição |
|---|---|---|
flexVolume | FlexVolume object | O plug-in de armazenamento do Kubernetes FlexVolume. |
persistentVolumeReclaimPolicy | String | Política de recuperação do PV. Valores possíveis:
|
accessModes | Array of strings | Modo de acesso do PersistentVolume.
|
Parâmetro | Tipo | Descrição |
|---|---|---|
driver | String | Nome do plug-in de armazenamento do FlexVolume. Defina este parâmetro com base no tipo de volume de armazenamento.
|
fsType | String | Tipo de sistema de arquivos. Defina este parâmetro com base no tipo de volume de armazenamento.
|
options | Options object | Itens de configuração do FlexVolume. |
Parâmetro | Tipo | Descrição |
|---|---|---|
fsType | String | Tipo de sistema de arquivos. Defina este parâmetro com base no tipo de volume de armazenamento.
|
region | String | Região onde o armazenamento em nuvem está localizado. |
volumeID | String | UUID do armazenamento em nuvem. Se o armazenamento em nuvem for um bucket do OBS, defina esse parâmetro como o nome do bucket. |
storageType | String | tipo de volume de armazenamento em nuvem.
|
Parâmetro | Tipo | Descrição |
|---|---|---|
accessModes | Array of strings | Modo de acesso do PersistentVolume. |
phase | String | Status do PV. Valores possíveis:
|
Exemplo de solicitação
Nenhum
Exemplo de resposta
Código de status: 200
A tarefa para excluir um PersistentVolume é entregue com sucesso.
{
"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 status
Código de status | Descrição |
|---|---|
200 | A tarefa para excluir um PersistentVolume é entregue com sucesso. |
Códigos de erro
Para mais detalhes, consulte Códigos de erro.
