Projects - List

Başvuru

Service:: Core

API Version:: 7.1-preview.4

Kimliği doğrulanmış kullanıcının erişimi olan kuruluştaki tüm projeleri alın.

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 Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
api-version	query	True	string	Kullanılacak API sürümü. Api'nin bu sürümünü kullanmak için bu değer '7.1-preview.4' olarak ayarlanmalıdır.
$skip	query		integer int32
$top	query		integer int32
continuationToken	query		integer int32	Zaten kaç projenin getirildiğini gösteren işaretçi.
getDefaultTeamImageUrl	query		boolean
stateFilter	query		ProjectState	Belirli bir takım projesi durumundaki ekip projelerine filtre uygulama (varsayılan: WellFormed).

Yanıtlar

Name	Tür	Description
200 OK	TeamProjectReference[]	başarılı işlem

Güvenlik

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	Profilinizi, hesaplarınızı, koleksiyonlarınızı, projelerinizi, ekiplerinizi ve diğer üst düzey kuruluş yapıtlarınızı okuma olanağı sağlar.
vso.project	Projeleri ve ekipleri okuma olanağı sağlar.

Örnekler

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

Tanımlar

Name	Description
ProjectState	Projenin geçerli durumu.
ProjectVisibility	Projenin kime görünür olduğunu gösterir.
TeamProjectReference	TeamProject'e basit bir başvuru temsil eder.

ProjectState

Projenin geçerli durumu.

Name	Tür	Description
all	string	Durumu ne olursa olsun, Silinmiş dışındaki tüm projeler.
createPending	string	Project oluşturma için kuyruğa alındı, ancak işlem henüz başlamadı.
deleted	string	Proje silindi.
deleting	string	Project silinme aşamasında.
new	string	Project oluşturulma aşamasındadır.
unchanged	string	Proje değiştirilmedi.
wellFormed	string	Proje tamamen oluşturuldu ve kullanıma hazır.

ProjectVisibility

Projenin kime görünür olduğunu gösterir.

Name	Tür	Description
private	string	Proje yalnızca açık erişimi olan kullanıcılar tarafından görülebilir.
public	string	Proje herkes tarafından görülebilir.

TeamProjectReference

TeamProject'e basit bir başvuru temsil eder.

Name	Tür	Description
abbreviation	string	Proje kısaltması.
defaultTeamImageUrl	string	Varsayılan ekip kimliği görüntüsünün URL'si.
description	string	Projenin açıklaması (varsa).
id	string	Proje tanımlayıcısı.
lastUpdateTime	string	Proje son güncelleştirme zamanı.
name	string	Proje adı.
revision	integer	Proje düzeltmesi.
state	ProjectState	Proje durumu.
url	string	Nesnenin tam sürümünün URL'si.
visibility	ProjectVisibility	Proje görünürlüğü.