Modificación de configuraciones de clúster - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación ModifyCluster para modificar las configuraciones de un clúster mediante su ID.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Encabezado de solicitud

Esta operación utiliza únicamente encabezados de solicitud comunes. Para más información, consulte Parámetros de solicitud comunes.

Sintaxis de solicitud

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

Parámetros de solicitud

Parámetro	Tipo	Posición	Obligatorio	Ejemplo	Descripción
ClusterId	String	Path	Sí	cb95aa626a47740afbf6aa099b65****	ID del clúster.
	Object	Body	No		Parámetros de la solicitud.
api_server_eip	Boolean	Body	No	true	Especifica si se debe asociar una dirección IP elástica (EIP) con el servidor API del clúster. Esto habilita el acceso a Internet para el clúster. Valores válidos: `true`: asocia una EIP con el servidor API del clúster. `false`: no asocia una EIP con el servidor API del clúster.
api_server_eip_id	String	Body	No	eip-wz9fnasl6dsfhmvci****	ID de la EIP que desea asociar con el servidor API del clúster. Este parámetro solo surte efecto si `api_server_eip` se establece en `true`.
deletion_protection	Boolean	Body	No	true	Especifica si se debe habilitar la protección contra eliminación para el clúster. Si la protección contra eliminación está habilitada, el clúster no se puede eliminar desde la consola de Container Service ni mediante llamadas a operaciones de API. Valores válidos: `true`: habilita la protección contra eliminación para el clúster. De este modo, el clúster no se puede eliminar desde la consola de ACK ni mediante llamadas a operaciones de API. `false`: deshabilita la protección contra eliminación para el clúster. De este modo, el clúster se puede eliminar desde la consola de ACK o mediante llamadas a operaciones de API. Valor predeterminado: `false`.
instance_deletion_protection	Boolean	Body	No	true	Especifica si se debe habilitar la protección contra eliminación para las instancias del clúster. Si la protección contra eliminación está habilitada, las instancias del clúster no se pueden eliminar desde la consola ni mediante llamadas a la API. Valores válidos: `true`: habilita la protección contra eliminación para las instancias del clúster. No podrá eliminar las instancias del clúster desde la consola ni mediante llamadas a la API. `false`: deshabilita la protección contra eliminación para las instancias del clúster. Podrá eliminar las instancias del clúster desde la consola o mediante llamadas a la API. Valor predeterminado: `false`.
ingress_domain_rebinding	Boolean	Body	No	true	Especifica si se debe reasignar el nombre de dominio de prueba del clúster. Valores válidos: `true`: reasigna el nombre de dominio de prueba del clúster. `false`: no reasigna el nombre de dominio de prueba del clúster. Valor predeterminado: `false`.
ingress_loadbalancer_id	String	Body	No	lb-wz97kes8tnndkpodw****	ID de la instancia de Server Load Balancer (SLB) asociada con el clúster.
resource_group_id	String	Body	No	rg-acfmyvw3wjm****	ID del resource group al que pertenece el clúster.
maintenance_window	maintenance_window	Body	No		Ventana de mantenimiento del clúster. Este parámetro solo surte efecto en clústeres ACK Pro.
enable_rrsa	Boolean	Body	No	true	Especifica si se debe habilitar la función RAM Roles for Service Accounts (RRSA). Valores válidos: `true`: habilita la función RRSA. `false`: deshabilita la función RRSA.
access_control_list	Array of String	Body	No	192.168.1.0/24	Lista de control de acceso (ACL) de red de la instancia SLB asociada con el servidor API si el clúster es un clúster registrado. Nota: No introduzca 0.0.0.0/0.
cluster_name	String	Body	No	cluster-new-name	Nombre del clúster. El nombre debe tener entre 1 y 63 caracteres, y puede contener dígitos, letras y guiones (-). El nombre no puede comenzar con un guion (-).

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
cluster_id	String	cb95aa626a47740afbf6aa09****	ID del clúster.
request_id	String	687C5BAA-D103-4993-884B-C35E4314****	ID de la solicitud.
task_id	String	T-5a54309c80282e39ea00****	ID de la tarea.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

Para consultar más códigos de error, visite Códigos de error del servicio.