Exclusão de uma PVC (a ser descartada)
Função
Essa API é usada para excluir uma PVC de um namespace especificado. Usando essa API, você pode determinar se deve reter o volume de armazenamento em nuvem associado à PVC. Esta API foi preterida. Em vez disso, use a API PV do Kubernetes correspondente.
O URL para gerenciamento de armazenamento está no formato 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 no cabeçalho da solicitação deve ser especificado.
URI
DELETE /api/v1/namespaces/{namespace}/cloudpersistentvolumeclaims/{name}
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| name | Sim | String | Nome da PVC a ser excluída. |
| namespace | Sim | String | Namespace onde a PVC está localizada. |
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| deleteVolume | Não | String | Se excluir o volume de armazenamento em nuvem de back-end associado após a exclusão da PVC. O valor pode ser true (delete) ou false (não delete). O valor padrão é false. |
| storageType | Não | String | Tipo de armazenamento em nuvem. Este parâmetro é utilizado em conjunto com deleteVolume. Ou seja, deleteVolume e storageType devem ser configurados ao mesmo tempo.
|
Parâmetros de solicitação
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| Content-Type | Sim | String | Tipo de corpo da mensagem (formato). |
| 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, consulte Obtenção de um token de usuário. |
| 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. |
Parâmetros de resposta
Código de status: 200
| Parâmetro | Tipo | Descrição |
|---|---|---|
| apiVersion | String | Versão da API. O valor é fixado em v1. |
| kind | String | Tipo de API. O valor é fixado em PersistentVolumeClaim. |
| metadata | Metadados de objeto de cluster, que é uma coleção de atributos. | |
| spec | PersistentVolumeClaimSpec object | Descrição detalhada do objeto de cluster. O CCE cria ou atualiza objetos definindo ou atualizando spec. |
| status | PersistentVolumeClaimStatus object | Estado da PVC. A solicitação para criar uma PVC não precisa carregar esse parâmetro. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| name | String | Nome da PVC. 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 finais (.). Nomes da PVC devem ser exclusivos em um namespace. |
| labels | String | Rótulos da PVC, no formato de pares chave-valor.
|
| Parâmetro | Tipo | Descrição |
|---|---|---|
| volumeID | String | ID de um volume de armazenamento existente.
|
| storageType | String | Classe de armazenamento em nuvem. Este parâmetro é usado em conjunto com volumeID. Ou seja, volumeID e storageType devem ser configurados ao mesmo tempo.
|
| accessModes | Array of strings | Modo de acesso do volume. Somente o primeiro valor em todas as opções selecionadas é válido.
|
| storageClassName | String | Nome da classe de armazenamento da PVC. |
| volumeName | String | Nome do PV vinculado à PVC. |
| resources | ResourceRequirements object | Solicitações e limites de recursos. |
| volumeMode | String | Tipo PV especificado pela PVC. |
Exemplo de solicitações
Nenhum
Exemplo de respostas
Nenhum
Códigos de status
| Código de status | Descrição |
|---|---|
| 200 | A tarefa para excluir uma PVC é entregue com êxito. |
Códigos de erro
Consulte Códigos de erro.