Managed Clusters - List Cluster User Credentials

Szolgáltatás:

AKS

API-verzió:

2024-09-01

Egy felügyelt fürt felhasználói hitelesítő adatait sorolja fel.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/listClusterUserCredential?api-version=2024-09-01

Opcionális paraméterekkel:

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}

URI-paraméterek

Name	In	Kötelező	Típus	Description
resourceGroupName	path	True	string	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
resourceName	path	True	string	A felügyelt fürterőforrás neve. Reguláris kifejezési minta: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$
subscriptionId	path	True	string uuid	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string	A művelethez használni kívánt API-verzió.
format	query		format	Csak az AAD-fürtökre vonatkozik, a visszaadott kubeconfig formátumát adja meg. Az "azure" formátum az azure auth-provider kubeconfig; az "exec" formátum exec formátumú kubeconfigot ad vissza, amelyhez a kubelogin bináris fájl szükséges az elérési úton.
server-fqdn	query		string	kiszolgáló fqdn típusa a visszaadandó hitelesítő adatokhoz

Válaszok

Name	Típus	Description
200 OK	CredentialResults	OKÉ
Other Status Codes	CloudError	Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Get Managed Cluster

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:

200

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

Definíciók

Name	Description
CloudError	Hibaválasz a Container service-től.
CloudErrorBody	Hibaválasz a Container service-től.
CredentialResult	A hitelesítő adatok eredményének válasza.
CredentialResults	A lista hitelesítőadat-eredményének válasza.
format	Csak az AAD-fürtökre vonatkozik, a visszaadott kubeconfig formátumát adja meg. Az "azure" formátum az azure auth-provider kubeconfig; az "exec" formátum exec formátumú kubeconfigot ad vissza, amelyhez a kubelogin bináris fájl szükséges az elérési úton.

CloudError

Hibaválasz a Container service-től.

Name	Típus	Description
error	CloudErrorBody	A hibával kapcsolatos részletek.

CloudErrorBody

Hibaválasz a Container service-től.

Name	Típus	Description
code	string	A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
details	CloudErrorBody[]	A hiba további részleteinek listája.
message	string	A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.
target	string	Az adott hiba célja. Például a tulajdonság neve hibás.

CredentialResult

A hitelesítő adatok eredményének válasza.

Name	Típus	Description
name	string	A hitelesítő adatok neve.
value	string	Base64 kódolású Kubernetes-konfigurációs fájl.

CredentialResults

A lista hitelesítőadat-eredményének válasza.

Name	Típus	Description
kubeconfigs	CredentialResult[]	Base64 kódolású Kubernetes-konfigurációs fájl.

format

Csak az AAD-fürtökre vonatkozik, a visszaadott kubeconfig formátumát adja meg. Az "azure" formátum az azure auth-provider kubeconfig; az "exec" formátum exec formátumú kubeconfigot ad vissza, amelyhez a kubelogin bináris fájl szükséges az elérési úton.

Name	Típus	Description
azure	string	Azure auth-provider kubeconfig visszaadása. Ez a formátum elavult az 1.22-ben, és az 1.26-os verzióban teljesen el lesz távolítva. Lásd: https://aka.ms/k8s/changes-1-26.
exec	string	Exec formátumú kubeconfig visszatérése. Ehhez a formátumhoz kubelogin bináris fájl szükséges az elérési úton.