Profiles - Get

참조

Service:: Profile

API Version:: 7.1-preview.3

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

GET https://app.vssps.visualstudio.com/_apis/profile/profiles/{id}?api-version=7.1-preview.3

With optional parameters:

GET https://app.vssps.visualstudio.com/_apis/profile/profiles/{id}?details={details}&withAttributes={withAttributes}&partition={partition}&coreAttributes={coreAttributes}&forceRefresh={forceRefresh}&api-version=7.1-preview.3

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
id	path	True	string	동일한 organization 내의 대상 사용자 프로필 ID 또는 현재 인증된 사용자의 프로필을 가져오는 'me'입니다.
api-version	query	True	string	사용할 API의 버전입니다. 이 버전의 api를 사용하려면 '7.1-preview.3'으로 설정해야 합니다.
coreAttributes	query		string	반환할 핵심 프로필 특성의 쉼표로 구분된 목록입니다. 유효한 값은 Email, 아바타, DisplayName 및 ContactWithOffers입니다.
details	query		boolean	표시 이름, 전자 메일 주소, 국가 등과 같은 공개 프로필 정보를 반환합니다. false이면 withAttributes 매개 변수가 무시됩니다.
forceRefresh	query		boolean	이 버전의 API에서는 사용되지 않습니다.
partition	query		string	반환할 특성의 파티션(명명된 그룹)입니다.
withAttributes	query		boolean	true이면 프로필과 연결된 특성(임의 데이터의 명명된 키-값 쌍)을 가져옵니다. 파티션 매개 변수에도 값이 있어야 합니다.

응답

Name	형식	Description
200 OK	Profile	성공한 작업

보안

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Name	Description
vso.profile	프로필, 계정, 컬렉션, 프로젝트, 팀 및 기타 최상위 조직 아티팩트 읽기 기능을 부여합니다.

예제

Sample Request

HTTP

GET https://app.vssps.visualstudio.com/_apis/profile/profiles/{id}?api-version=7.1-preview.3

Sample Response

Status code:: 200

{
  "displayName": "Normal Paulk",
  "publicAlias": "d6245f20-2af8-44f4-9451-8107cb2767db",
  "emailAddress": "fabrikamfiber16@hotmail.com",
  "coreRevision": 1647,
  "timeStamp": "2014-05-12T22:23:07.727+00:00",
  "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
  "revision": 1647
}

정의

Name	Description
AttributeDescriptor	이름 및 컨테이너를 사용하여 특성을 식별합니다.
AttributesContainer	명명된 프로필 특성 집합을 저장합니다.
CoreProfileAttribute	항상 각 프로필에 대한 값이 있는 프로필 특성입니다.
Profile	사용자 프로필입니다.
ProfileAttribute	프로필과 연결된 명명된 개체입니다.
ProfileState	프로필의 현재 상태입니다.

AttributeDescriptor

이름 및 컨테이너를 사용하여 특성을 식별합니다.

Name	형식	Description
attributeName	string	특성 이름입니다.
containerName	string	특성이 있는 컨테이너입니다.

AttributesContainer

명명된 프로필 특성 집합을 저장합니다.

Name	형식	Description
attributes	<string, ProfileAttribute>	컨테이너에 의해 저장된 특성입니다.
containerName	string	컨테이너의 이름입니다.
revision	integer	컨테이너 내의 모든 특성의 최대 수정 번호입니다.

CoreProfileAttribute

항상 각 프로필에 대한 값이 있는 프로필 특성입니다.

Name	형식	Description
descriptor	AttributeDescriptor	특성의 설명자입니다.
revision	integer	특성의 수정 번호입니다.
timeStamp	string	특성이 마지막으로 변경된 시간입니다.
value	string	특성 값

Profile

사용자 프로필입니다.

Name	형식	Description
applicationContainer	AttributesContainer	이 프로필의 특성입니다.
coreAttributes	<string, CoreProfileAttribute>	이 프로필의 핵심 특성입니다.
coreRevision	integer	모든 특성의 최대 수정 버전 수입니다.
id	string	프로필의 고유 식별자입니다.
profileState	ProfileState	프로필의 현재 상태입니다.
revision	integer	모든 특성의 최대 수정 버전 수입니다.
timeStamp	string	이 프로필이 마지막으로 변경된 시간입니다.

ProfileAttribute

프로필과 연결된 명명된 개체입니다.

Name	형식	Description
descriptor	AttributeDescriptor	특성의 설명자입니다.
revision	integer	특성의 수정 번호입니다.
timeStamp	string	특성이 마지막으로 변경된 시간입니다.
value	string	특성 값

ProfileState

프로필의 현재 상태입니다.

Name	형식	Description
custom	string	프로필이 사용 중입니다.
customReadOnly	string	프로필이 사용 중이지만 읽기만 가능합니다.
readOnly	string	프로필은 읽기 전용일 수 있습니다.

다음을 통해 공유