Modifique configurações do cluster - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo para diferentes SDKs.

Cabeçalho da requisição

Esta operação usa apenas cabeçalhos de requisição comuns. Para mais informações, consulte Parâmetros comuns de requisição.

Sintaxe da requisição

PUT /api/v2/clusters/{ClusterId} HTTP/1.1

Parâmetros da requisição

Parâmetro	Tipo	Posição	Obrigatório	Exemplo	Descrição
ClusterId	String	Path	Sim	cb95aa626a47740afbf6aa099b65****	ID do cluster.
	Object	Body	Não		Parâmetros da requisição.
api_server_eip	Boolean	Body	Não	true	Defina se um elastic IP address (EIP) deve ser associado ao servidor de API do cluster para ativar o acesso à Internet. Valores válidos: `true`: associa um EIP ao servidor de API do cluster. `false`: não associa um EIP ao servidor de API do cluster.
api_server_eip_id	String	Body	Não	eip-wz9fnasl6dsfhmvci****	ID do EIP a ser associado ao servidor de API do cluster. Este parâmetro só tem efeito se `api_server_eip` estiver definido como `true`.
deletion_protection	Boolean	Body	Não	true	Indica se a proteção contra exclusão do cluster está ativada. Se ativada, impede a exclusão do cluster pelo console do Container Service ou por chamadas de API. Valores válidos: `true`: ativa a proteção contra exclusão. O cluster não pode ser excluído pelo console do ACK ou por operações de API. `false`: desativa a proteção contra exclusão. O cluster pode ser excluído pelo console do ACK ou por operações de API. Valor padrão: `false`.
instance_deletion_protection	Boolean	Body	Não	true	Indica se a proteção contra exclusão das instâncias do cluster está ativada. Se ativada, impede a exclusão das instâncias pelo console ou via API. Valores válidos: `true`: ativa a proteção contra exclusão das instâncias. Não é possível excluir as instâncias pelo console ou via API. `false`: desativa a proteção contra exclusão das instâncias. É possível excluir as instâncias pelo console ou via API. Valor padrão: `false`.
ingress_domain_rebinding	Boolean	Body	Não	true	Defina se o nome de domínio de teste do cluster deve ser remapeado. Valores válidos: `true`: remapeia o nome de domínio de teste do cluster. `false`: não remapeia o nome de domínio de teste do cluster. Valor padrão: `false`.
ingress_loadbalancer_id	String	Body	Não	lb-wz97kes8tnndkpodw****	ID da instância do Server Load Balancer (SLB) associada ao cluster.
resource_group_id	String	Body	Não	rg-acfmyvw3wjm****	ID do grupo de recursos ao qual o cluster pertence.
maintenance_window	maintenance_window	Body	Não		Janela de manutenção do cluster. Este parâmetro tem efeito apenas em clusters ACK Pro.
enable_rrsa	Boolean	Body	Não	true	Defina se o recurso RAM Roles for Service Accounts (RRSA) deve ser ativado. Valores válidos: `true`: ativa o recurso RRSA. `false`: desativa o recurso RRSA.
access_control_list	Array of String	Body	Não	192.168.1.0/24	Lista de controle de acesso (ACL) de rede da instância SLB associada ao servidor de API, aplicável apenas a clusters registrados. Nota: Não insira 0.0.0.0/0.
cluster_name	String	Body	Não	cluster-new-name	Nome do cluster. O nome deve ter de 1 a 63 caracteres e pode conter dígitos, letras e hifens (-). Não pode começar com hífen (-).

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
cluster_id	String	cb95aa626a47740afbf6aa09****	ID do cluster.
request_id	String	687C5BAA-D103-4993-884B-C35E4314****	ID da requisição.
task_id	String	T-5a54309c80282e39ea00****	ID da tarefa.

Exemplos

Exemplos de requisições

PUT /api/v2/clusters/cb95aa626a47740afbf6aa099b65**** HTTP/1.1 
Content-Type:application/json
{
  "api_server_eip" : true,
  "api_server_eip_id" : "eip-wz9fnasl6dsfhmvci****",
  "deletion_protection" : true,
  "instance_deletion_protection" : true,
  "ingress_domain_rebinding" : "true",
  "ingress_loadbalancer_id" : "lb-wz97kes8tnndkpodw****",
  "resource_group_id" : "rg-acfmyvw3wjm****",
  "maintenance_window" : {
    "enable" : false,
    "maintenance_time" : "03:00:00Z",
    "duration" : "3h",
    "weekly_period" : "Monday,Thursday"
  }
}

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<cluster_id>cb95aa626a47740afbf6aa09****</cluster_id>
<request_id>687C5BAA-D103-4993-884B-C35E4314****</request_id>
<task_id>T-5a54309c80282e39ea00****</task_id>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

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

Códigos de erro

Para mais códigos de erro, consulte Códigos de erro do serviço.