Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:CreateAutoscalingConfig

Última atualização: Jun 29, 2026

Cria uma configuração de dimensionamento para permitir que o sistema dimensione recursos com base nas regras de dimensionamento fornecidas. Ao criar uma configuração de dimensionamento, você pode especificar as métricas de dimensionamento, os limites, a ordem de dimensionamento e o intervalo de dimensionamento.

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

create

*Cluster.

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

Nenhuma Nenhuma

Sintaxe da solicitação

POST /cluster/{ClusterId}/autoscale/config/ HTTP/1.1

Parâmetros de caminho

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ClusterId

string

Sim

O ID do cluster.

cdde1f21ae22e483ebcb068a6eb7f****

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

body

object

Não

O corpo da solicitação.

cool_down_duration

string

Não

O tempo de espera antes que o recurso de dimensionamento automático execute uma atividade de redução de escala. É um intervalo entre o momento em que o limite de redução de escala é atingido e o momento em que a atividade de redução de escala (redução do número de pods) começa. Unidade: minutos. Valor padrão: 10.

10

unneeded_duration

string

Não

O período de cooldown. Após o autoscaler executar uma atividade de expansão de escala, ele aguarda um período de cooldown antes de poder executar uma atividade de redução de escala. Os nós recém-adicionados podem ser removidos em atividades de redução de escala somente após o término do período de cooldown. Unidade: minutos.

10

utilization_threshold

string

Não

O limite de redução de escala. Este limite especifica a proporção dos recursos solicitados pelos pods em relação ao total de recursos no nó.

Uma atividade de redução de escala é executada somente quando a utilização de CPU e a utilização de memória de um nó são inferiores ao limite de redução de escala.

0.5

gpu_utilization_threshold

string

Não

O limite de redução de escala de utilização de GPU. Este limite especifica a proporção dos recursos de GPU solicitados pelos pods em relação ao total de recursos de GPU no nó.

Uma atividade de redução de escala é executada somente quando a utilização de CPU, a utilização de memória e a utilização de GPU de um nó acelerado por GPU são inferiores ao limite de redução de escala de utilização de GPU.

0.3

scan_interval

string

Não

O intervalo no qual o sistema verifica eventos que acionam atividades de dimensionamento. Unidade: segundos. Valor padrão: 60.

30

scale_down_enabled

boolean

Não

Especifica se deve permitir atividades de redução de escala de nós. Valores válidos:

  • true: permite atividades de redução de escala de nós.

  • false: não permite atividades de redução de escala de nós.

Valores válidos:

  • true :

    true.

  • false :

    false.

true

expander

string

Não

A política de expansão de escala do pool de nós. Valores válidos:

  • least-waste: a política padrão. Se vários pools de nós atenderem ao requisito, esta política seleciona o pool de nós que terá menos recursos ociosos após a conclusão da atividade de expansão de escala.

  • random: a política aleatória. Se vários pools de nós atenderem ao requisito, esta política seleciona um pool de nós aleatório para a atividade de expansão de escala.

  • priority: a política baseada em prioridade. Se vários pools de nós atenderem ao requisito, esta política seleciona o pool de nós com a prioridade mais alta para a atividade de expansão de escala. A configuração de prioridade é armazenada no ConfigMap chamado cluster-autoscaler-priority-expander no namespace kube-system. Quando uma atividade de expansão de escala é acionada, a política obtém as prioridades do pool de nós a partir do ConfigMap com base nos IDs do pool de nós e, em seguida, seleciona o pool de nós com a prioridade mais alta para a atividade de expansão de escala.

Valores válidos:

  • random :

    random.

  • least-waste :

    least-waste.

  • priority :

    priority.

least-waste

skip_nodes_with_system_pods

boolean

Não

Especifica se o autoscaler do cluster reduz a escala de nós que hospedam pods no namespace kube-system. Este parâmetro não tem efeito em pods criados por DaemonSets e pods espelho. Valores válidos:

  • true: não permite que o autoscaler do cluster reduza a escala desses nós.

  • false: permite que o autoscaler do cluster reduza a escala desses nós.

Valores válidos:

  • true :

    true.

  • false :

    false.

true

skip_nodes_with_local_storage

boolean

Não

Especifica se o autoscaler do cluster reduz a escala de nós que hospedam pods montados com volumes locais, como volumes EmptyDir ou HostPath. Valores válidos:

  • true: não permite que o autoscaler do cluster reduza a escala desses nós.

  • false: permite que o autoscaler do cluster reduza a escala desses nós.

Valores válidos:

  • true :

    true.

  • false :

    false.

false

daemonset_eviction_for_nodes

boolean

Não

Especifica se deve despejar pods criados por DaemonSets quando o autoscaler do cluster executa uma atividade de redução de escala. Valores válidos:

  • true: despeja pods do DaemonSet.

  • false: não despeja pods do DaemonSet.

Valores válidos:

  • true :

    true.

  • false :

    false.

false

max_graceful_termination_sec

integer

Não

A quantidade máxima de tempo de espera para que os pods em um nó sejam encerrados durante uma atividade de redução de escala. Unidade: segundos.

14400

min_replica_count

integer

Não

O número mínimo de pods permitidos em cada ReplicaSet antes que uma atividade de redução de escala seja executada.

0

recycle_node_deletion_enabled

boolean

Não

Especifica se deve excluir os objetos de nó do Kubernetes correspondentes após a remoção dos nós no modo swift. Para obter mais informações sobre o modo swift, consulte Modo de dimensionamento. Valor padrão: false. Valores válidos:

  • true: exclui os objetos de nó do Kubernetes correspondentes após a remoção dos nós no modo swift. Recomendamos que você não defina o valor como true, pois pode ocorrer inconsistência de dados nos objetos do Kubernetes.

  • false: retém os objetos de nó do Kubernetes correspondentes após a remoção dos nós no modo swift.

Valores válidos:

  • true :

    true.

  • false :

    false.

false

scale_up_from_zero

boolean

Não

Especifica se o autoscaler do cluster executa uma atividade de expansão de escala quando o número de nós prontos no cluster é 0. Valor padrão: true. Valores válidos:

  • true: executa uma atividade de expansão de escala.

  • false: não executa uma atividade de expansão de escala.

Valores válidos:

  • true :

    true.

  • false :

    false.

true

scaler_type

string

Não

Tipo de componente elástico. O padrão é goatscaler para a versão 1.24 do cluster e superior, e cluster-autoscaler para versões inferiores. Valores:

  • goatscaler: elasticidade instantânea.

  • cluster-autoscaler: dimensionamento automático.

Valores válidos:

  • goatscaler :

    goatscaler.

  • cluster-autoscaler :

    cluster-autoscaler.

goatscaler

priorities

object

Não

Configuração de prioridade de dimensionamento automático. Após criar um pool de nós com a elasticidade ativada, você pode escolher se deseja configurar uma estratégia de prioridade e configurações de prioridade por meio de Ativação do dimensionamento automático de nós. Isso permite definir prioridades para o grupo de dimensionamento do pool de nós de dimensionamento automático especificado. O intervalo de valores de prioridade é [1, 100] e deve ser um número inteiro positivo.

array

Não

O ID do grupo de dimensionamento automático para o pool de nós com a mesma prioridade.

string

Não

O ID do grupo de dimensionamento automático para o pool de nós.

asg-bp1fe63lqz******

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

cluster_id

string

O ID do cluster.

cc212d04dfe184547bffaa596********

task_id

string

O ID da tarefa.

T-5fd211e924e1d007********

request_id

string

O ID da solicitação.

AF8BE105-C32B-1269-9774-5510********

Exemplos

Resposta de sucesso

JSON formato

{
  "cluster_id": "cc212d04dfe184547bffaa596********",
  "task_id": "T-5fd211e924e1d007********",
  "request_id": "AF8BE105-C32B-1269-9774-5510********"
}

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.