Condividi tramite

Managed Clusters - Get Access Profile

Servizio:
AKS
Versione API:
2025-07-01

Ottiene un profilo di accesso di un cluster gestito.
ATTENZIONE: questa API sarà deprecata. Utilizza invece ListClusterUserCredentials o ListClusterAdminCredentials .

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/accessProfiles/{roleName}/listCredential?api-version=2025-07-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
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]$

Nome della risorsa cluster gestita.
roleName
 path True

string

Nome del ruolo per la risorsa accessProfile del cluster gestito.
subscriptionId
 path True

string (uuid)

ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version
 query True

string

minLength: 1

La versione dell'API da utilizzare per questa operazione.

Risposte

Nome Tipo Descrizione
200 OK

ManagedClusterAccessProfile

Va bene
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 Impersonare il tuo 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/accessProfiles/clusterUser/listCredential?api-version=2025-07-01

Risposta di esempio

Codice di stato:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/accessProfiles/clusterUser",
  "location": "location1",
  "name": "clusterUser",
  "properties": {
    "kubeConfig": "a3ViZUNvbmZpZzE="
  },
  "type": "Microsoft.ContainerService/ManagedClusters/AccessProfiles"
}

Definizioni

Nome Descrizione
CloudError

Risposta di errore dal servizio contenitore.
CloudErrorBody

Risposta di errore dal servizio contenitore.
createdByType

Tipo di identità che ha creato la risorsa.
ManagedClusterAccessProfile

Profilo di accesso del cluster gestito.
systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

CloudError

Object

Risposta di errore dal servizio contenitore.

Nome Tipo Descrizione
error

CloudErrorBody

Dettagli sull'errore.

CloudErrorBody

Object

Risposta di errore dal servizio contenitore.

Nome Tipo Descrizione
code

string

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

CloudErrorBody[]

Un elenco di dettagli aggiuntivi sull'errore.
message

string

Un messaggio che descrive l'errore, destinato ad essere adatto per la visualizzazione in un'interfaccia utente.
target

string

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

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore Descrizione
User
Application
ManagedIdentity
Key

ManagedClusterAccessProfile

Object

Profilo di accesso del cluster gestito.

Nome Tipo Descrizione
id

string (arm-id)

ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location

string

Posizione geografica in cui risiede la risorsa
name

string

Nome della risorsa
properties.kubeConfig

string (byte)

File di configurazione Kubernetes con codifica Base64.
systemData

systemData

Metadati di Azure Resource Manager contenenti informazioni createdBy e modifiedBy.
tags

object

Tag di risorsa.
type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

systemData

Object

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string (date-time)

Il timestamp di creazione della risorsa (UTC).
createdBy

string

Identità che ha creato la risorsa.
createdByType

createdByType

Tipo di identità che ha creato la risorsa.
lastModifiedAt

string (date-time)

Il timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy

string

L'identità che ha modificato per ultima la risorsa.
lastModifiedByType

createdByType

Tipo di identità che ha modificato per ultima la risorsa.