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.
