Projects - List

참조

Service:: Core

API Version:: 7.1-preview.4

인증된 사용자가 액세스할 수 있는 조직의 모든 프로젝트를 가져옵니다.

GET https://dev.azure.com/{organization}/_apis/projects?api-version=7.1-preview.4

With optional parameters:

GET https://dev.azure.com/{organization}/_apis/projects?stateFilter={stateFilter}&$top={$top}&$skip={$skip}&continuationToken={continuationToken}&getDefaultTeamImageUrl={getDefaultTeamImageUrl}&api-version=7.1-preview.4

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
organization	path	True	string	Azure DevOps 조직의 이름입니다.
api-version	query	True	string	사용할 API의 버전입니다. 이 버전의 API를 사용하려면 '7.1-preview.4'로 설정해야 합니다.
$skip	query		integer int32
$top	query		integer int32
continuationToken	query		integer int32	이미 페치된 프로젝트 수를 보여 주는 포인터입니다.
getDefaultTeamImageUrl	query		boolean
stateFilter	query		ProjectState	특정 팀 프로젝트 상태의 팀 프로젝트를 필터링합니다(기본값: WellFormed).

응답

Name	형식	Description
200 OK	TeamProjectReference[]	성공적인 작업

보안

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	프로필, 계정, 컬렉션, 프로젝트, 팀 및 기타 최상위 조직 아티팩트 읽기 기능을 부여합니다.
vso.project	프로젝트 및 팀을 읽을 수 있는 기능을 부여합니다.

예제

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/_apis/projects?api-version=7.1-preview.4

Sample Response

Status code:: 200

{
  "count": 3,
  "value": [
    {
      "id": "eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
      "name": "Fabrikam-Fiber-TFVC",
      "description": "Team Foundation Version Control projects.",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
      "state": "wellFormed"
    },
    {
      "id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
      "name": "Fabrikam-Fiber-Git",
      "description": "Git projects",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
      "state": "wellFormed"
    },
    {
      "id": "281f9a5b-af0d-49b4-a1df-fe6f5e5f84d0",
      "name": "TestGit",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/281f9a5b-af0d-49b4-a1df-fe6f5e5f84d0",
      "state": "wellFormed"
    }
  ]
}

정의

Name	Description
ProjectState	프로젝트의 현재 상태입니다.
ProjectVisibility	프로젝트가 표시되는 대상을 나타냅니다.
TeamProjectReference	TeamProject에 대한 단순 참조를 나타냅니다.

ProjectState

프로젝트의 현재 상태입니다.

Name	형식	Description
all	string	삭제됨을 제외한 모든 프로젝트는 상태에 관계 없이 수행됩니다.
createPending	string	프로젝트를 만들기 위해 큐에 대기했지만 프로세스가 아직 시작되지 않았습니다.
deleted	string	프로젝트가 삭제되었습니다.
deleting	string	프로젝트가 삭제되는 중입니다.
new	string	프로젝트가 만들어지는 중입니다.
unchanged	string	프로젝트가 변경되지 않았습니다.
wellFormed	string	프로젝트가 완전히 만들어지고 사용할 준비가 된 것입니다.

ProjectVisibility

프로젝트가 표시되는 대상을 나타냅니다.

Name	형식	Description
private	string	프로젝트는 명시적 액세스 권한이 있는 사용자에게만 표시됩니다.
public	string	프로젝트는 모두 볼 수 있습니다.

TeamProjectReference

TeamProject에 대한 단순 참조를 나타냅니다.

Name	형식	Description
abbreviation	string	프로젝트 약어입니다.
defaultTeamImageUrl	string	기본 팀 ID 이미지의 URL입니다.
description	string	프로젝트의 설명(있는 경우)입니다.
id	string	프로젝트 식별자입니다.
lastUpdateTime	string	프로젝트 마지막 업데이트 시간입니다.
name	string	프로젝트 이름입니다.
revision	integer	프로젝트 수정 버전입니다.
state	ProjectState	프로젝트 상태입니다.
url	string	개체의 전체 버전에 대한 URL입니다.
visibility	ProjectVisibility	프로젝트 표시 유형입니다.

Share via