Projects - List

Referensi

Service:: Core

API Version:: 7.1-preview.4

Dapatkan semua proyek di organisasi yang dapat diakses pengguna terautentikasi.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
organization	path	True	string	Nama organisasi Azure DevOps.
api-version	query	True	string	Versi API yang akan digunakan. Ini harus diatur ke '7.1-preview.4' untuk menggunakan versi api ini.
$skip	query		integer int32
$top	query		integer int32
continuationToken	query		integer int32	Pointer yang menunjukkan berapa banyak proyek yang sudah diambil.
getDefaultTeamImageUrl	query		boolean
stateFilter	query		ProjectState	Filter pada proyek tim dalam status proyek tim tertentu (default: WellFormed).

Respons

Nama	Jenis	Deskripsi
200 OK	TeamProjectReference[]	operasi berhasil

Keamanan

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

Nama	Deskripsi
vso.profile	Memberikan kemampuan untuk membaca profil, akun, koleksi, proyek, tim, dan artefak organisasi tingkat atas lainnya.
vso.project	Memberikan kemampuan untuk membaca proyek dan tim.

Contoh

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"
    }
  ]
}

Definisi

Nama	Deskripsi
ProjectState	Status proyek saat ini.
ProjectVisibility	Menunjukkan kepada siapa proyek terlihat.
TeamProjectReference	Mewakili referensi dangkal ke TeamProject.

ProjectState

Status proyek saat ini.

Nama	Jenis	Deskripsi
all	string	Semua proyek terlepas dari status kecuali Dihapus.
createPending	string	Proyek telah diantrekan untuk pembuatan, tetapi prosesnya belum dimulai.
deleted	string	Proyek telah dihapus.
deleting	string	Proyek sedang dalam proses dihapus.
new	string	Proyek sedang dalam proses dibuat.
unchanged	string	Proyek belum diubah.
wellFormed	string	Proyek benar-benar dibuat dan siap digunakan.

ProjectVisibility

Menunjukkan kepada siapa proyek terlihat.

Nama	Jenis	Deskripsi
private	string	Proyek ini hanya terlihat oleh pengguna dengan akses eksplisit.
public	string	Proyek ini terlihat oleh semua.

TeamProjectReference

Mewakili referensi dangkal ke TeamProject.

Nama	Jenis	Deskripsi
abbreviation	string	Singkatan proyek.
defaultTeamImageUrl	string	Url ke gambar identitas tim default.
description	string	Deskripsi proyek (jika ada).
id	string	Pengidentifikasi proyek.
lastUpdateTime	string	Waktu pembaruan terakhir proyek.
name	string	Nama proyek.
revision	integer	Revisi proyek.
state	ProjectState	Status proyek.
url	string	Url ke versi lengkap objek.
visibility	ProjectVisibility	Visibilitas proyek.

Share via