Compartilhar via


Managed Clusters - List Cluster User Credentials

Lista as credenciais de usuário de um cluster gerenciado.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/listClusterUserCredential?api-version=2025-10-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/listClusterUserCredential?api-version=2025-10-01&server-fqdn={server-fqdn}&format={format}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

resourceName
path True

string

minLength: 1
maxLength: 63
pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$

O nome do recurso de cluster gerenciado.

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser uma UUID.

api-version
query True

string

minLength: 1

A versão da API a ser usada para esta operação.

format
query

format

Aplica-se somente a clusters do AAD, especifica o formato do kubeconfig retornado. O formato 'azure' retornará azure auth-provider kubeconfig; format 'exec' retornará exec format kubeconfig, que requer o binário kubelogin no caminho.

server-fqdn
query

string

Tipo de FQDN do servidor para que as credenciais sejam retornadas

Respostas

Nome Tipo Description
200 OK

CredentialResults

OKEY

Other Status Codes

ErrorResponse

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation Personificar sua conta de usuário

Exemplos

Get Managed Cluster

Solicitação de exemplo

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/listClusterUserCredential?api-version=2025-10-01

Resposta de exemplo

{
  "kubeconfigs": [
    {
      "name": "credentialName1",
      "value": "Y3JlZGVudGlhbFZhbHVlMQ=="
    }
  ]
}

Definições

Nome Description
CredentialResult

A resposta do resultado da credencial.

CredentialResults

A resposta do resultado da credencial de lista.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

format

Aplica-se somente a clusters do AAD, especifica o formato do kubeconfig retornado. O formato 'azure' retornará azure auth-provider kubeconfig; format 'exec' retornará exec format kubeconfig, que requer o binário kubelogin no caminho.

CredentialResult

A resposta do resultado da credencial.

Nome Tipo Description
name

string

O nome da credencial.

value

string (byte)

Arquivo de configuração do Kubernetes codificado em Base64.

CredentialResults

A resposta do resultado da credencial de lista.

Nome Tipo Description
kubeconfigs

CredentialResult[]

Arquivo de configuração do Kubernetes codificado em Base64.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código do erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

format

Aplica-se somente a clusters do AAD, especifica o formato do kubeconfig retornado. O formato 'azure' retornará azure auth-provider kubeconfig; format 'exec' retornará exec format kubeconfig, que requer o binário kubelogin no caminho.

Valor Description
exec

Retorne o formato exec kubeconfig. Esse formato requer um binário kubelogin no caminho.

azure

Retorne azure auth-provider kubeconfig. Esse formato foi preterido na v1.22 e será totalmente removido na v1.26. Confira: https://aka.ms/k8s/changes-1-26.