Condividi tramite

Managed Clusters - List Cluster User Credentials

Servizio:
AKS
Versione API:
2025-07-01

Elenca le credenziali utente di un cluster gestito.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
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]$

Nome della risorsa cluster gestita.
subscriptionId
 path True

string (uuid)

ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version
 query True

string

minLength: 1

La versione dell'API da utilizzare per questa operazione.
format
 query

format

Applica solo ai cluster AAD, specifica il formato di kubeconfig restituito. Il formato 'azure' restituirà azure auth-provider kubeconfig; Il formato 'exec' restituirà il formato exec kubeconfig, che richiede il binario kubelogin nel percorso.
server-fqdn
 query

string

Tipo di FQDN del server per le credenziali da restituire

Risposte

Nome Tipo Descrizione
200 OK

CredentialResults

Va bene
Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation Impersonare il tuo account utente

Esempio

Get Managed Cluster

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
200 
{
  "kubeconfigs": [
    {
      "name": "credentialName1",
      "value": "Y3JlZGVudGlhbFZhbHVlMQ=="
    }
  ]
}

Definizioni

Nome Descrizione
CloudError

Risposta di errore dal servizio contenitore.
CloudErrorBody

Risposta di errore dal servizio contenitore.
CredentialResult

Risposta del risultato delle credenziali.
CredentialResults

Risposta del risultato dell'elenco delle credenziali.
format

Applica solo ai cluster AAD, specifica il formato di kubeconfig restituito. Il formato 'azure' restituirà azure auth-provider kubeconfig; Il formato 'exec' restituirà il formato exec kubeconfig, che richiede il binario kubelogin nel percorso.

CloudError

Object

Risposta di errore dal servizio contenitore.

Nome Tipo Descrizione
error

CloudErrorBody

Dettagli sull'errore.

CloudErrorBody

Object

Risposta di errore dal servizio contenitore.

Nome Tipo Descrizione
code

string

Identificatore dell'errore. I codici sono invarianti e sono destinati a essere utilizzati a livello di codice.
details

CloudErrorBody[]

Un elenco di dettagli aggiuntivi sull'errore.
message

string

Un messaggio che descrive l'errore, destinato ad essere adatto per la visualizzazione in un'interfaccia utente.
target

string

L'obiettivo dell'errore specifico. Ad esempio, il nome della proprietà in errore.

CredentialResult

Object

Risposta del risultato delle credenziali.

Nome Tipo Descrizione
name

string

Il nome della credenziale.
value

string (byte)

File di configurazione Kubernetes con codifica Base64.

CredentialResults

Object

Risposta del risultato dell'elenco delle credenziali.

Nome Tipo Descrizione
kubeconfigs

CredentialResult[]

File di configurazione Kubernetes con codifica Base64.

format

Enumerazione

Applica solo ai cluster AAD, specifica il formato di kubeconfig restituito. Il formato 'azure' restituirà azure auth-provider kubeconfig; Il formato 'exec' restituirà il formato exec kubeconfig, che richiede il binario kubelogin nel percorso.

Valore Descrizione
exec

Restituisci exec format kubeconfig. Questo formato richiede il binario kubelogin nel percorso.
azure

Restituire azure auth-provider kubeconfig. Questo formato è deprecato nella v1.22 e verrà completamente rimosso nella v1.26. Vedi: https://aka.ms/k8s/changes-1-26.