Consulta del archivo kubeconfig de un clúster - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación DescribeClusterUserKubeconfig para consultar el archivo kubeconfig de un clúster de Container Service for Kubernetes (ACK). Este archivo contiene los detalles del usuario actual y permite configurar el acceso al clúster.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Sintaxis de la solicitud

GET /k8s/ClusterId/user_config?PrivateIpAddress=Boolean&TemporaryDurationMinutes=Long HTTP/1.1
Content-Type:application/json

Parámetros de la solicitud

Tabla 1. Parámetros de ruta de la solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
ClusterId	String	Sí	c5b5e80b0b64a4bf6939d2d8fbbc5****	ID del clúster de ACK que desea consultar

Tabla 2. Parámetros de consulta de la solicitud

Parámetro Tipo Obligatorio Ejemplo Descripción

PrivateIpAddress

Boolean

true

Indica si se debe obtener la credencial para conectarse al clúster mediante la red interna. Valores válidos:

true: obtiene la credencial para conectarse al clúster mediante la red interna.
false: obtiene la credencial para conectarse al clúster mediante Internet.

Valor predeterminado: false.

TemporaryDurationMinutes

Long

Periodo de validez de un archivo kubeconfig temporal. Unidad: minutos. Valores válidos: de 15 a 4320.

Nota Si no especifica este parámetro, el sistema asigna automáticamente un periodo de validez, indicado en el campo expiration de la respuesta.

Sintaxis de la respuesta

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

{
  "config" : "String",
  "expiration" : "String"
}

Parámetros de la respuesta

Tabla 3. Parámetros del cuerpo de la respuesta

Parámetro	Tipo	Ejemplo	Descripción
config	String	apiVersion: v1****	Contenido del archivo kubeconfig. Para obtener más información sobre el contenido del archivo kubeconfig, consulte Configurar credenciales de clúster.
expiration	String	2024-03-10T09:56:17Z	Hora de vencimiento del archivo kubeconfig. El valor corresponde a la hora UTC en formato RFC3339.

Ejemplos

Solicitudes de ejemplo

GET /k8s/c5b5e80b0b64a4bf6939d2d8fbbc5****/user_config?PrivateIpAddress=true&TemporaryDurationMinutes=15 HTTP/1.1
Host:cs.aliyuncs.com
Content-Type:application/json

Respuestas exitosas de ejemplo

Formato XML

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

<config>
apiVersion: v1
clusters:
- cluster:
...
</config>
<expiration>2021-03-25T10:01:20Z</expiration>

Formato JSON

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

{
  "config" : "\napiVersion: v1\nclusters:\n- cluster:\n...\n",
  "expiration" : "2021-03-25T10:01:20Z"
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.