Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Atualizado em 2024-09-10 GMT+08:00

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}

Tabela 1 Parâmetros de caminho

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.

Tabela 2 Parâmetros de consulta

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.

  • bs: EVS

  • nfs: SFS

  • obs: OBS

  • efs: SFS Turbo

Parâmetros de solicitação

Tabela 3 Parâmetros de cabeçalho 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

Tabela 4 Parâmetros do corpo de resposta

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

PersistentVolumeClaimMetadata object

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.

Tabela 5 PersistentVolumeClaimMetadata

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.

  • Key: digite 1 a 63 caracteres começando com uma letra ou dígito. Apenas letras, dígitos, hifens (-), sublinhados (_) e pontos (.) são permitidos. Um subdomínio do DNS pode ser prefixo para uma chave e conter um máximo de 253 caracteres. Exemplo de subdomínio do DNS: example.com/my-key

  • Value: o valor pode ser deixado em branco ou conter de 1 a 63 caracteres que começam com uma letra ou dígito. Somente letras, dígitos, hifens (-), sublinhados (_) e pontos (.) são permitidos na cadeia de caracteres.

Tabela 6 PersistentVolumeClaimSpec

Parâmetro

Tipo

Descrição

volumeID

String

ID de um volume de armazenamento existente.

  • Se um volume do SFS, EVS ou SFS Turbo for usado, defina esse parâmetro como o ID do volume.

  • Se um bucket do OBS for usado, defina esse parâmetro como o nome do bucket do OBS.

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.

  • bs: EVS

  • nfs: SFS

  • obs: OBS

  • efs: SFS Turbo

accessModes

Array of strings

Modo de acesso do volume. Somente o primeiro valor em todas as opções selecionadas é válido.

  • ReadWriteOnce: o volume pode ser montado como leitura-escrita por um único nó.

    NOTA:

    Esta função é suportada apenas quando a versão do cluster é v1.13.10 e a versão do controlador de armazenamento é 1.0.19.

  • ReadOnlyMany (default): o volume pode ser montado como read-only por muitos nós.

  • ReadWriteMany: o volume pode ser montado como read-write por muitos nós.

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.

Tabela 7 ResourceRequirements

Parâmetro

Tipo

Descrição

limits

Map<String,String>

Limite de recursos. Este parâmetro é inválido durante a criação.

requests

Map<String,String>

Solicitação de recursos. Este parâmetro é inválido durante a criação.

Tabela 8 PersistentVolumeClaimStatus

Parâmetro

Tipo

Descrição

accessModes

Array of strings

Modo de acesso do PV.

capacity

String

Recursos reais e capacidade do PV.

phase

String

Situação atual da 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.