다음을 통해 공유


Projects - List

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

GET https://dev.azure.com/{organization}/_apis/projects?api-version=7.1-preview.4
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

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

Sample Response

{
  "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

프로젝트 표시 유형입니다.