Freigeben über


Managed Clusters - List Cluster User Credentials

Listet die Benutzeranmeldeinformationen eines verwalteten Clusters auf.

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}

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

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]$

Der Name der verwalteten Clusterressource.

subscriptionId
path True

string (uuid)

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

format
query

format

Nur auf AAD-Cluster anwenden, gibt das Format der zurückgegebenen kubeconfig an. Das Format 'azure' gibt azure auth-provider kubeconfig zurück. format 'exec' gibt exec format kubeconfig zurück, für das eine kubelogin-Binärdatei im Pfad erforderlich ist.

server-fqdn
query

string

Server-FQDN-Typ für die zurückzugebenden Anmeldeinformationen

Antworten

Name Typ Beschreibung
200 OK

CredentialResults

OKAY

Other Status Codes

ErrorResponse

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

Get Managed Cluster

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
CredentialResult

Die Ergebnisantwort für Anmeldeinformationen.

CredentialResults

Die Ergebnisantwort der Listenanmeldeinformationen.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

format

Nur auf AAD-Cluster anwenden, gibt das Format der zurückgegebenen kubeconfig an. Das Format 'azure' gibt azure auth-provider kubeconfig zurück. format 'exec' gibt exec format kubeconfig zurück, für das eine kubelogin-Binärdatei im Pfad erforderlich ist.

CredentialResult

Die Ergebnisantwort für Anmeldeinformationen.

Name Typ Beschreibung
name

string

Der Name der Anmeldeinformationen.

value

string (byte)

Base64-codierte Kubernetes-Konfigurationsdatei.

CredentialResults

Die Ergebnisantwort der Listenanmeldeinformationen.

Name Typ Beschreibung
kubeconfigs

CredentialResult[]

Base64-codierte Kubernetes-Konfigurationsdatei.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

format

Nur auf AAD-Cluster anwenden, gibt das Format der zurückgegebenen kubeconfig an. Das Format 'azure' gibt azure auth-provider kubeconfig zurück. format 'exec' gibt exec format kubeconfig zurück, für das eine kubelogin-Binärdatei im Pfad erforderlich ist.

Wert Beschreibung
exec

Geben Sie exec format kubeconfig zurück. Für dieses Format ist eine Kubelogin-Binärdatei im Pfad erforderlich.

azure

Geben Sie azure auth-provider kubeconfig zurück. Dieses Format ist in v1.22 veraltet und wird in Version 1.26 vollständig entfernt. Siehe: https://aka.ms/k8s/changes-1-26.