Consultar o arquivo kubeconfig de um cluster - : Central de Documentação do Alibaba Cloud

Use a operação DescribeClusterUserKubeconfig para consultar o arquivo kubeconfig de um cluster do Container Service for Kubernetes (ACK). Esse arquivo contém as informações de identidade do usuário atual e permite acessar o cluster.

Nota

O período de validade padrão de um arquivo kubeconfig é de três anos. Você pode renovar esse arquivo até dois meses antes da data de expiração pelo console do ACK ou pela API. O novo arquivo kubeconfig terá validade de três anos, e o arquivo antigo permanecerá utilizável até o vencimento. Para visualizar a data de expiração, faça login no console do ACK ou chame a API. Recomendamos renovar os arquivos kubeconfig prestes a expirar assim que possível.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente exemplos de código para diferentes SDKs.

Sintaxe da solicitação

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

Parâmetros da solicitação

Parâmetros de caminho da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
ClusterId	String	Sim	c5b5e80b0b64a4bf6939d2d8fbbc5****	ID do cluster.

Parâmetros de consulta da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

PrivateIpAddress

Boolean

Não

true

Indica se o arquivo kubeconfig obtido serve para conexão ao cluster pela rede interna. Valores válidos:

true: obtém o arquivo kubeconfig para conexão à instância mestre pela rede interna.
false: obtém o arquivo kubeconfig para conexão à instância mestre pela Internet.

Valor padrão: false

TemporaryDurationMinutes

Long

Não

Período de validade de um arquivo kubeconfig temporário. Unidade: minutos. Valores válidos: 15 a 4320 (3 dias).

Nota

Caso este parâmetro não seja especificado, o sistema definirá automaticamente um período de validade maior, indicado pelo parâmetro expiration na resposta.

Sintaxe da resposta

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

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

Parâmetros da resposta

Parâmetros do corpo da resposta

Parâmetro	Tipo	Exemplo	Descrição
config	String	apiVersion: v1****	Conteúdo do arquivo kubeconfig. Para obter mais informações, consulte Configurar credenciais do cluster.
expiration	String	2024-03-10T09:56:17Z	Data de expiração do arquivo kubeconfig. O valor segue o formato RFC3339 em horário UTC.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato XML

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

<DescribeClusterUserKubeconfigResponse>
    <config>apiVersion: v1****</config>
    <expiration>2024-03-10T09:56:17Z</expiration>
</DescribeClusterUserKubeconfigResponse>

Formato JSON

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

{
  "config" : "apiVersion: v1****",
  "expiration" : "2024-03-10T09:56:17Z"
}

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.