DeleteCluster - Container Service for Kubernetes: Central de Documentação do Alibaba Cloud

Descrição da operação

Importante.

Recursos baseados em assinatura, como instâncias ECS e nós de computação Lingjun, não são liberados automaticamente. Você deve liberá-los manualmente para evitar cobranças desnecessárias. Para mais detalhes, consulte Regras de exclusão de cluster e liberação de nós.
Recursos SLB do APIServer baseados em assinatura não são liberados automaticamente. Você deve liberá-los manualmente para evitar cobranças desnecessárias.
Se recursos como VPCs, VSwitches, grupos de segurança e funções RAM estiverem em uso por outros recursos, eles serão retidos por padrão. Você deve liberá-los manualmente.
ECIs criadas com nós virtuais são liberadas automaticamente.
Alguns recursos em nuvem criados com o cluster não são liberados automaticamente quando você exclui o cluster e continuam gerando cobranças. Você pode optar por retê-los ou liberá-los. Esses recursos incluem projetos SLS criados automaticamente pelo cluster e discos em nuvem adquiridos por meio de volumes dinâmicos.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cs:DeleteCluster

delete

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

Nenhuma

Sintaxe da solicitação

DELETE /clusters/{ClusterId} HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClusterId	string	Sim	O ID do cluster.	c905d1364c2dd4b6284a3f41790c4****

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
retain_all_resources	boolean	Não	Se todos os recursos associados devem ser retidos. Se você definir este parâmetro como `true`, o parâmetro `retain_resources` será ignorado e todos os recursos em nuvem criados com o cluster que podem ser consultados chamando `DescribeClusterResources` serão retidos. Se você definir este parâmetro como `false`, observe que os recursos configurados para serem retidos por padrão no parâmetro `delete_options` ainda serão retidos. Para excluir esses recursos, você deve definir explicitamente o parâmetro `delete_mode` como `delete` para eles em `delete_options`. `true`: Retém todos os recursos em nuvem associados criados com o cluster. `false`: Não retém todos os recursos em nuvem associados. Recursos configurados para serem retidos por padrão no parâmetro `delete_options`, como `ALB`, ainda serão retidos quando este parâmetro for definido como `false`. Valor padrão: `false`.	false
keep_slb `deprecated`	boolean	Não	Se os recursos SLB devem ser retidos. Valores válidos: `true`: Retém os recursos SLB criados para o cluster. `false`: Não retém os recursos SLB criados para o cluster. Valor padrão: `false`. Use o parâmetro `delete_options` para gerenciar recursos `SLB` em vez disso.	false
retain_resources	array	Não	Os IDs dos recursos a serem retidos quando o cluster for excluído.
	string	Não	O ID do recurso.	sg-2ze6ess9kho6fdn9****
delete_options	array<object>	Não	As opções para excluir os recursos associados ao cluster.
	object	Não	As opções de exclusão para um tipo específico de recurso.
resource_type	string	Não	O tipo de recurso. Valores válidos: SLB: os recursos SLB criados para Services. Esses recursos são excluídos por padrão, mas você pode optar por retê-los. ALB: os recursos ALB criados pelo ALB Ingress controller. Esses recursos são retidos por padrão, mas você pode optar por excluí-los. SLS_Data: o projeto SLS usado para logs do cluster. Este recurso é retido por padrão, mas você pode optar por excluí-lo. SLS_ControlPlane: o projeto SLS usado para logs do plano de controle em um cluster gerenciado. Este recurso é retido por padrão, mas você pode optar por excluí-lo. PrivateZone: o recurso PrivateZone criado por um cluster ACK Serverless. Este recurso é retido por padrão, mas você pode optar por excluí-lo.	SLS_Data
delete_mode	string	Não	A política de exclusão para o tipo de recurso especificado. Valores válidos: delete: Exclui os recursos. retain: Retém os recursos.	delete

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
cluster_id	string	O ID do cluster.	cb95aa626a47740afbf6aa099b650****
request_id	string	O ID da solicitação.	687C5BAA-D103-4993-884B-C35E4314****
task_id	string	O ID da tarefa.	T-5a54309c80282e39ea****

Exemplos

Resposta de sucesso

JSON formato

{
  "cluster_id": "cb95aa626a47740afbf6aa099b650****",
  "request_id": "687C5BAA-D103-4993-884B-C35E4314****",
  "task_id": "T-5a54309c80282e39ea****"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.