Managed Clusters - List Cluster User Credentials

Служба:: AKS

Версия API:: 2026-02-01

Список учетных данных пользователя управляемого кластера.

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

С использованием необязательных параметров:

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя регистронезависимо.
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]$	Имя ресурса управляемого кластера.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.
format	query		Format	Применяется только к кластерам AAD, указывает формат возвращаемого kubeconfig. Формат Azure возвращает kubeconfig azure auth-provider; Формат exec возвращает kubeconfig формата exec, для которого требуется двоичный файл kubelogin в пути.
server-fqdn	query		string	Тип полного доменного имени сервера для возвращаемых учетных данных

Ответы

Имя	Тип	Описание
200 OK	CredentialResults	Операция Azure успешно завершена.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Get Managed Cluster

Образец запроса

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


/**
 * Samples for ManagedClusters ListClusterUserCredentials.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/ManagedClustersListClusterUserCredentials.json
     */
    /**
     * Sample code: Get Managed Cluster.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void getManagedCluster(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getManagedClusters().listClusterUserCredentialsWithResponse("rg1", "clustername1", null,
            null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to lists the user credentials of a managed cluster.
 *
 * @summary lists the user credentials of a managed cluster.
 * x-ms-original-file: 2026-02-01/ManagedClustersListClusterUserCredentials.json
 */
async function getManagedCluster() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.managedClusters.listClusterUserCredentials("rg1", "clustername1");
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Пример ответа

Код состояния:: 200

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

Определения

Имя	Описание
CredentialResult	Ответ результата учетных данных.
CredentialResults	Ответ результата учетных данных списка.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Детали ошибки.
ErrorResponse	Ответ на ошибку
Format	Применяется только к кластерам AAD, указывает формат возвращаемого kubeconfig. Формат Azure возвращает kubeconfig azure auth-provider; Формат exec возвращает kubeconfig формата exec, для которого требуется двоичный файл kubelogin в пути.

CredentialResult

Объект

Ответ результата учетных данных.

Имя	Тип	Описание
name	string	Имя учетных данных.
value	string (byte)	Файл конфигурации Kubernetes в кодировке Base64.

CredentialResults

Объект

Ответ результата учетных данных списка.

Имя	Тип	Описание
kubeconfigs	CredentialResult[]	Файл конфигурации Kubernetes в кодировке Base64.

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительная информация.
type	string	Тип дополнительной информации.

ErrorDetail

Объект

Детали ошибки.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Ошибка дополнительная информация.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

Format

Перечисление

Применяется только к кластерам AAD, указывает формат возвращаемого kubeconfig. Формат Azure возвращает kubeconfig azure auth-provider; Формат exec возвращает kubeconfig формата exec, для которого требуется двоичный файл kubelogin в пути.

Значение	Описание
azure	Возвращает azure auth-provider kubeconfig. Этот формат устарел в версии 1.22 и будет полностью удален в версии 1.26. См. https://aka.ms/k8s/changes-1-26.
exec	Возврат файла exec format kubeconfig. Для этого формата требуется двоичный файл kubelogin в пути.