Accounts - List

서비스:

Accounts

API 버전:

7.1

특정 소유자 또는 특정 멤버에 대한 계정 목록을 가져옵니다. 다음 매개 변수 중 하나가 필요합니다. ownerId, memberId.

GET https://app.vssps.visualstudio.com/_apis/accounts?api-version=7.1

선택적 매개 변수:

GET https://app.vssps.visualstudio.com/_apis/accounts?ownerId={ownerId}&memberId={memberId}&properties={properties}&api-version=7.1

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
api-version	query	True	string	사용할 API의 버전입니다. 이 버전의 API를 사용하려면 '7.1'로 설정해야 합니다.
memberId	query		string (uuid)	계정의 멤버에 대한 ID입니다.
ownerId	query		string (uuid)	계정 소유자의 ID입니다.
properties	query		string

응답

Name	형식	Description
200 OK	Account[]	성공한 작업

보안

oauth2

형식: oauth2
Flow: accessCode
권한 부여 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
토큰 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

범위

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

예제

By member

By owner

By member

샘플 요청

HTTP

GET https://app.vssps.visualstudio.com/_apis/accounts?memberId=d6245f20-2af8-44f4-9451-8107cb2767db&api-version=7.1

샘플 응답

상태 코드:

200

{
  "count": 2,
  "value": [
    {
      "accountId": "6affcbef-fe5d-44c6-8a29-439b79aaa118",
      "accountUri": "https://vssps.dev.azure.com/Fabrikam-Fiber-Inc/",
      "accountName": "Fabrikam-Fiber-Inc",
      "properties": {}
    },
    {
      "accountId": "bf83696f-383b-4980-95b5-1f1127640a8a",
      "accountUri": "https://vssps.dev.azure.com/NormalPaulk/",
      "accountName": "NormalPaulk",
      "properties": {}
    }
  ]
}

By owner

샘플 요청

HTTP

GET https://app.vssps.visualstudio.com/_apis/accounts?ownerId=d6245f20-2af8-44f4-9451-8107cb2767db&api-version=7.1

샘플 응답

상태 코드:

200

{
  "count": 1,
  "value": [
    {
      "accountId": "bf83696f-383b-4980-95b5-1f1127640a8a",
      "accountUri": "https://NormalPaulk.vssps.visualstudio.com:443/",
      "accountName": "NormalPaulk",
      "properties": {}
    }
  ]
}

정의

Name	Description
Account
AccountStatus	현재 계정 상태
AccountType	계정 유형: 개인, 조직
PropertiesCollection	클래스는 키-값 쌍의 컬렉션으로 속성 모음을 나타냅니다. DBNull 제외한 모든 기본 형식(TypeCode != TypeCode.Object있는 모든 형식)의 값이 허용됩니다. Byte[], Int32, Double, DateType 및 String 형식의 값은 해당 형식을 유지하며, 다른 기본 형식은 문자열로 다시 조정됩니다. Byte[]가 base64로 인코딩된 문자열로 필요합니다.

Account

Object

Name	형식	Description
accountId	string (uuid)	계정의 식별자
accountName	string	계정 이름
accountOwner	string (uuid)	계정 소유자
accountStatus	AccountStatus	현재 계정 상태
accountType	AccountType	계정 유형: 개인, 조직
accountUri	string	계정에 대한 URI
createdBy	string (uuid)	계정을 만든 사람
createdDate	string (date-time)	만든 날짜 계정
hasMoved	boolean
lastUpdatedBy	string (uuid)	계정을 업데이트할 마지막 사용자의 ID
lastUpdatedDate	string (date-time)	날짜 계정이 마지막으로 업데이트됨
namespaceId	string (uuid)	계정의 네임스페이스
newCollectionId	string (uuid)
organizationName	string	계정을 만든 조직
properties	PropertiesCollection	확장 속성
statusReason	string	현재 상태의 이유

AccountStatus

열거형

현재 계정 상태

값	Description
deleted	이 계정은 삭제 일괄 처리의 일부이며 삭제 예정입니다.
disabled	이 호스팅 계정은 사용할 수 없습니다.
enabled	이 호스팅 계정은 활성 상태이며 고객에게 할당됩니다.
moved	이 계정은 로컬에서 마스터되지 않으며 물리적으로 이동되었습니다.
none

AccountType

열거형

계정 유형: 개인, 조직

값	Description
organization
personal

PropertiesCollection

Object

클래스는 키-값 쌍의 컬렉션으로 속성 모음을 나타냅니다. DBNull 제외한 모든 기본 형식(TypeCode != TypeCode.Object있는 모든 형식)의 값이 허용됩니다. Byte[], Int32, Double, DateType 및 String 형식의 값은 해당 형식을 유지하며, 다른 기본 형식은 문자열로 다시 조정됩니다. Byte[]가 base64로 인코딩된 문자열로 필요합니다.

Name	형식	Description
count	integer (int32)	컬렉션의 속성 수입니다.
item	object
keys	string[]	컬렉션의 키 집합입니다.
values	string[]	컬렉션의 값 집합입니다.