Partilhar 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 URI

Nome Em Necessário Tipo Descrição
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 um UUID.

api-version
query True

string

minLength: 1

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

format
query

format

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

server-fqdn
query

string

Tipo de FQDN do servidor para credenciais a serem retornadas

Respostas

Nome Tipo Descrição
200 OK

CredentialResults

OK

Other Status Codes

ErrorResponse

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

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

Alcances

Nome Descrição
user_impersonation personificar a sua conta de utilizador

Exemplos

Get Managed Cluster

Pedido 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 Descrição
CredentialResult

A resposta do resultado da credencial.

CredentialResults

A resposta do resultado da credencial da lista.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

format

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

CredentialResult

A resposta do resultado da credencial.

Nome Tipo Descrição
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 da lista.

Nome Tipo Descrição
kubeconfigs

CredentialResult[]

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

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Nome Tipo Descrição
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Descrição
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de 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 Descrição
error

ErrorDetail

O objeto de erro.

format

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

Valor Descrição
exec

Retornar formato exec kubeconfig. Este formato requer binário kubelogin no caminho.

azure

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