다음을 통해 공유


Managed Clusters - List Cluster User Credentials

관리되는 클러스터의 사용자 자격 증명을 나열합니다.

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}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
resourceGroupName
path True

string

리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.

resourceName
path True

string

관리되는 클러스터 리소스의 이름입니다.

regex 패턴: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$

subscriptionId
path True

string

uuid

대상 구독의 ID입니다. 값은 UUID여야 합니다.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

format
query

format

AAD 클러스터에만 적용되며 반환된 kubeconfig의 형식을 지정합니다. 형식 'azure'는 azure auth-provider kubeconfig를 반환합니다. 형식 'exec'는 경로에 kubelogin 이진이 필요한 exec 형식 kubeconfig를 반환합니다.

server-fqdn
query

string

자격 증명을 반환할 서버 fqdn 유형

응답

Name 형식 Description
200 OK

CredentialResults

그래

Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
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=2024-09-01

샘플 응답

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

정의

Name Description
CloudError

컨테이너 서비스의 오류 응답입니다.

CloudErrorBody

컨테이너 서비스의 오류 응답입니다.

CredentialResult

자격 증명 결과 응답입니다.

CredentialResults

목록 자격 증명 결과 응답입니다.

format

AAD 클러스터에만 적용되며 반환된 kubeconfig의 형식을 지정합니다. 형식 'azure'는 azure auth-provider kubeconfig를 반환합니다. 형식 'exec'는 경로에 kubelogin 이진이 필요한 exec 형식 kubeconfig를 반환합니다.

CloudError

컨테이너 서비스의 오류 응답입니다.

Name 형식 Description
error

CloudErrorBody

오류에 대한 세부 정보입니다.

CloudErrorBody

컨테이너 서비스의 오류 응답입니다.

Name 형식 Description
code

string

오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.

details

CloudErrorBody[]

오류에 대한 추가 세부 정보 목록입니다.

message

string

사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.

target

string

특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다.

CredentialResult

자격 증명 결과 응답입니다.

Name 형식 Description
name

string

자격 증명의 이름입니다.

value

string

Base64로 인코딩된 Kubernetes 구성 파일입니다.

CredentialResults

목록 자격 증명 결과 응답입니다.

Name 형식 Description
kubeconfigs

CredentialResult[]

Base64로 인코딩된 Kubernetes 구성 파일입니다.

format

AAD 클러스터에만 적용되며 반환된 kubeconfig의 형식을 지정합니다. 형식 'azure'는 azure auth-provider kubeconfig를 반환합니다. 형식 'exec'는 경로에 kubelogin 이진이 필요한 exec 형식 kubeconfig를 반환합니다.

Name 형식 Description
azure

string

Azure 인증 공급자 kubeconfig를 반환합니다. 이 형식은 v1.22에서 더 이상 사용되지 않으며 v1.26에서 완전히 제거됩니다. 참조: https://aka.ms/k8s/changes-1-26.

exec

string

exec 형식 kubeconfig를 반환합니다. 이 형식을 사용하려면 경로에 kubelogin 이진 파일이 필요합니다.