Condividi tramite


Managed Clusters - List Cluster User Credentials

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=2024-09-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/listClusterUserCredential?api-version=2024-09-01&server-fqdn={server-fqdn}&format={format}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.

resourceName
path True

string

Nome della risorsa cluster gestita.

Criterio di espressione regolare: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$

subscriptionId
path True

string

uuid

ID della sottoscrizione di destinazione. Il valore deve essere un UUID.

api-version
query True

string

Versione dell'API da usare per questa operazione.

format
query

format

Si 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 file binario kubelogin nel percorso.

server-fqdn
query

string

tipo fqdn server per le credenziali da restituire

Risposte

Nome Tipo Descrizione
200 OK

CredentialResults

OK

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 rappresentare l'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=2024-09-01

Risposta di esempio

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

Definizioni

Nome Descrizione
CloudError

Risposta di errore dal servizio Contenitore.

CloudErrorBody

Risposta di errore dal servizio Contenitore.

CredentialResult

Risposta al risultato delle credenziali.

CredentialResults

Risposta al risultato delle credenziali dell'elenco.

format

Si 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 file binario kubelogin nel percorso.

CloudError

Risposta di errore dal servizio Contenitore.

Nome Tipo Descrizione
error

CloudErrorBody

Dettagli sull'errore.

CloudErrorBody

Risposta di errore dal servizio Contenitore.

Nome Tipo Descrizione
code

string

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

details

CloudErrorBody[]

Elenco di dettagli aggiuntivi sull'errore.

message

string

Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

target

string

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

CredentialResult

Risposta al risultato delle credenziali.

Nome Tipo Descrizione
name

string

Nome della credenziale.

value

string

File di configurazione Kubernetes con codifica Base64.

CredentialResults

Risposta al risultato delle credenziali dell'elenco.

Nome Tipo Descrizione
kubeconfigs

CredentialResult[]

File di configurazione Kubernetes con codifica Base64.

format

Si 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 file binario kubelogin nel percorso.

Nome Tipo Descrizione
azure

string

Restituire azure auth-provider kubeconfig. Questo formato è deprecato nella versione 1.22 e verrà rimosso completamente nella versione 1.26. Vedere: https://aka.ms/k8s/changes-1-26.

exec

string

Restituire il formato exec kubeconfig. Questo formato richiede il file binario kubelogin nel percorso.