Managed Clusters - List Cluster User Credentials
Lista as credenciais de usuário de um cluster gerenciado.
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}
Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
resource
|
path | True |
string minLength: 1maxLength: 63 pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$ |
O nome do recurso de cluster gerenciado. |
|
subscription
|
path | True |
string (uuid) |
A ID da assinatura de destino. O valor deve ser uma UUID. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a ser usada para esta operação. |
|
format
|
query |
Aplica-se somente a clusters do AAD, especifica o formato do kubeconfig retornado. O formato 'azure' retornará azure auth-provider kubeconfig; format 'exec' retornará exec format kubeconfig, que requer o binário kubelogin no caminho. |
||
|
server-fqdn
|
query |
string |
Tipo de FQDN do servidor para que as credenciais sejam retornadas |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
OKEY |
|
| Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
| Nome | Description |
|---|---|
| user_impersonation | Personificar sua conta de usuário |
Exemplos
Get Managed Cluster
Solicitação de exemplo
Resposta de exemplo
{
"kubeconfigs": [
{
"name": "credentialName1",
"value": "Y3JlZGVudGlhbFZhbHVlMQ=="
}
]
}
Definições
| Nome | Description |
|---|---|
|
Credential |
A resposta do resultado da credencial. |
|
Credential |
A resposta do resultado da credencial de lista. |
|
Error |
As informações adicionais do erro de gerenciamento de recursos. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
| format |
Aplica-se somente a clusters do AAD, especifica o formato do kubeconfig retornado. O formato 'azure' retornará azure auth-provider kubeconfig; format 'exec' retornará exec format kubeconfig, que requer o binário kubelogin no caminho. |
CredentialResult
A resposta do resultado da credencial.
| Nome | Tipo | Description |
|---|---|---|
| name |
string |
O nome da credencial. |
| value |
string (byte) |
Arquivo de configuração do Kubernetes codificado em Base64. |
CredentialResults
A resposta do resultado da credencial de lista.
| Nome | Tipo | Description |
|---|---|---|
| kubeconfigs |
Arquivo de configuração do Kubernetes codificado em Base64. |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
| Nome | Tipo | Description |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Nome | Tipo | Description |
|---|---|---|
| additionalInfo |
As informações adicionais do erro. |
|
| code |
string |
O código do erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
| Nome | Tipo | Description |
|---|---|---|
| error |
O objeto de erro. |
format
Aplica-se somente a clusters do AAD, especifica o formato do kubeconfig retornado. O formato 'azure' retornará azure auth-provider kubeconfig; format 'exec' retornará exec format kubeconfig, que requer o binário kubelogin no caminho.
| Valor | Description |
|---|---|
| exec |
Retorne o formato exec kubeconfig. Esse formato requer um binário kubelogin no caminho. |
| azure |
Retorne azure auth-provider kubeconfig. Esse formato foi preterido na v1.22 e será totalmente removido na v1.26. Confira: https://aka.ms/k8s/changes-1-26. |