Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:DeleteCluster

Última atualização: Jun 29, 2026

Exclui um cluster e especifica se os recursos relevantes do cluster devem ser excluídos ou retidos. Antes de excluir um cluster, exclua manualmente as cargas de trabalho no cluster, como Deployments, StatefulSets, Jobs e CronJobs. Caso contrário, a exclusão do cluster poderá falhar.

Descrição da operação

Aviso:

  • As instâncias ECS por assinatura e os nós Lingjun em um cluster não podem ser liberados automaticamente. Para evitar custos desnecessários, recomendamos que você libere os recursos manualmente. Para obter mais informações, consulte Regras para exclusão de clusters e liberação de nós.

  • Se a instância SLB do servidor de API usar o método de faturamento por assinatura, ela não poderá ser liberada automaticamente. Para evitar custos desnecessários, recomendamos que você a libere manualmente.

  • Por padrão, as VPCs, vSwitches, grupos de segurança e funções RAM são retidos se forem usados por outros recursos. Para evitar custos desnecessários, recomendamos que você libere os recursos manualmente.

  • As instâncias de contêiner elásticas criadas em nós virtuais são liberadas automaticamente.

  • Alguns recursos criados junto com um cluster não são liberados automaticamente quando o cluster é excluído. Após a exclusão do cluster, você ainda será cobrado pelos recursos. Libere ou retenha os recursos com base em suas necessidades reais. Os recursos incluem projetos do Simple Log Service criados automaticamente pelo cluster e discos provisionados dinamicamente.

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 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

Especifica se todos os recursos devem ser retidos. Se você definir o parâmetro como true, o parâmetro retain_resources será ignorado. Os recursos de nuvem criados pelo cluster são retidos. Você pode chamar a operação DescribeClusterResources para consultar os recursos de nuvem criados pelo cluster. Se você definir o parâmetro como false, os recursos a serem retidos por padrão no parâmetro delete_options ainda serão retidos. Para excluir esses recursos, defina delete_mode como delete em delete_options.

  • true: retém todos os recursos, incluindo os recursos de nuvem criados pelo cluster.

  • false: não retém todos os recursos. Os recursos a serem retidos por padrão no parâmetro delete_options são retidos. Por exemplo, as instâncias ALB são retidas quando este parâmetro é definido como false.

Valor padrão: false.

false

keep_slb deprecated

boolean

Não

Especifica se os recursos do Server Load Balancer (SLB) criados pelo cluster devem ser retidos.

  • true: retém as instâncias SLB criadas pelo cluster.

  • false: não retém as instâncias SLB criadas pelo cluster.

Valor padrão: false. Defina resource_type como SLB no parâmetro delete_options para gerenciar instâncias SLB.

false

retain_resources

array

Não

A lista de recursos. Para reter recursos ao excluir um cluster, você precisa especificar os IDs dos recursos a serem retidos.

string

Não

O nome do recurso.

sg-2ze6ess9kho6fdn9****

delete_options

array<object>

Não

O tipo de recurso do cluster que você deseja excluir ou reter.

object

Não

resource_type

string

Não

O tipo do recurso. Valores válidos:

  • SLB: recursos SLB criados para Services. Por padrão, os recursos SLB são excluídos automaticamente.

  • ALB: recursos do Application Load Balancer (ALB) criados pelo controlador ALB Ingress. Por padrão, os recursos ALB são retidos.

  • SLS_Data: projetos do Simple Log Service usados pelo recurso de log do cluster. Por padrão, os projetos do Simple Log Service são retidos.

  • SLS_ControlPlane: projetos do Simple Log Service usados para armazenar os logs dos planos de controle em clusters gerenciados pelo ACK. Por padrão, os projetos do Simple Log Service são retidos.

  • PrivateZone: recursos do PrivateZone criados por clusters ACK Serverless. Por padrão, os recursos do PrivateZone são retidos.

SLS_Data

delete_mode

string

Não

A política de exclusão para o tipo de recurso especificado. Valores válidos:

  • delete: exclui o tipo de recurso especificado.

  • retain: retém o tipo de recurso especificado.

delete

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O corpo da resposta.

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.