Users - Get

사용자 프로필을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{name}?api-version=2018-09-15
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{name}?$expand={$expand}&api-version=2018-09-15

URI 매개 변수

Name In Required Type Description
labName
path True
  • string

랩의 이름입니다.

name
path True
  • string

사용자 프로필의 이름입니다.

resourceGroupName
path True
  • string

리소스 그룹의 이름.

subscriptionId
path True
  • string

구독 ID입니다.

api-version
query True
  • string

클라이언트 API 버전입니다.

$expand
query
  • string

$expand 쿼리를 지정합니다. 예: 'properties($select=identity)'

응답

Name Type Description
200 OK

확인

Other Status Codes

BadRequest

보안

azure_auth

OAuth2 암시적 허용

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 액세스 Microsoft Azure

예제

Users_Get

Sample Request

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{devtestlabName}/users/{userName}?api-version=2018-09-15

Sample Response

{
  "properties": {
    "identity": {
      "principalName": "{principalName}",
      "principalId": "{principalId}",
      "tenantId": "{tenantId}",
      "objectId": "{objectId}",
      "appId": "{appId}"
    },
    "secretStore": {
      "keyVaultUri": "{keyVaultUri}",
      "keyVaultId": "{keyVaultId}"
    },
    "createdDate": "2018-10-01T18:40:48.1739018-07:00",
    "provisioningState": "Succeeded",
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "id": "/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}",
  "name": "{userName}",
  "type": "Microsoft.DevTestLab/labs/users",
  "location": "{location}",
  "tags": {
    "tagName1": "tagValue1"
  }
}

정의

CloudError

REST 요청에서 오류가 발생했습니다.

CloudErrorBody

REST 요청의 오류 본문입니다.

User

랩 사용자의 프로필입니다.

UserIdentity

랩 사용자의 ID 특성입니다.

UserSecretStore

사용자의 비밀 저장소 속성입니다.

CloudError

REST 요청에서 오류가 발생했습니다.

Name Type Description
error

발생한 클라우드 오류

CloudErrorBody

REST 요청의 오류 본문입니다.

Name Type Description
code
  • string

오류 코드입니다.

details

내부 오류입니다.

message
  • string

오류 메시지입니다.

target
  • string

오류 대상입니다.

User

랩 사용자의 프로필입니다.

Name Type Description
id
  • string

리소스의 식별자입니다.

location
  • string

리소스의 위치입니다.

name
  • string

리소스의 이름입니다.

properties.createdDate
  • string

사용자 프로필의 생성 날짜입니다.

properties.identity

사용자의 ID입니다.

properties.provisioningState
  • string

리소스의 프로비전 상태입니다.

properties.secretStore

사용자의 비밀 저장소입니다.

properties.uniqueIdentifier
  • string

리소스의 변경할 수 없는 고유 식별자(Guid)입니다.

tags
  • object

리소스의 태그입니다.

type
  • string

리소스 형식입니다.

UserIdentity

랩 사용자의 ID 특성입니다.

Name Type Description
appId
  • string

요청을 만드는 클라이언트 JWT의 앱 ID로 설정합니다.

objectId
  • string

요청을 만드는 클라이언트 JWT의 개체 ID로 설정합니다. 모든 사용자에게 개체 ID가 있는 것은 아닙니다. 예를 들어 CSP(재판매인) 시나리오의 경우 개체 ID를 사용할 수 없습니다.

principalId
  • string

요청을 만드는 클라이언트 JWT의 보안 주체 ID로 설정합니다. 서비스 주체에는 보안 주체 ID가 없습니다.

principalName
  • string

요청을 만드는 클라이언트 JWT의 주체 이름/UPN으로 설정합니다.

tenantId
  • string

요청을 만드는 클라이언트 JWT의 테넌트 ID로 설정합니다.

UserSecretStore

사용자의 비밀 저장소 속성입니다.

Name Type Description
keyVaultId
  • string

사용자 키 자격 증명 모음의 ID입니다.

keyVaultUri
  • string

사용자 키 자격 증명 모음의 URI입니다.