Projects - List

Reference

Service:: Core

API Version:: 7.1-preview.4

Získejte všechny projekty v organizaci, ke kterým má ověřený uživatel přístup.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
organization	path	True	string	Název organizace Azure DevOps.
api-version	query	True	string	Verze rozhraní API, která se má použít. Aby se tato verze rozhraní API používala, měla by být nastavená na 7.1-preview.4.
$skip	query		integer int32
$top	query		integer int32
continuationToken	query		integer int32	Ukazatel, který ukazuje, kolik projektů již bylo načteno.
getDefaultTeamImageUrl	query		boolean
stateFilter	query		ProjectState	Vyfiltrujte týmové projekty v konkrétním stavu týmového projektu (výchozí hodnota: WellFormed).

Odpovědi

Name	Typ	Description
200 OK	TeamProjectReference[]	úspěšná operace

Zabezpečení

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	Umožňuje číst váš profil, účty, kolekce, projekty, týmy a další artefakty organizace nejvyšší úrovně.
vso.project	Umožňuje číst projekty a týmy.

Příklady

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

Definice

Name	Description
ProjectState	Aktuální stav projektu
ProjectVisibility	Určuje, komu je projekt viditelný.
TeamProjectReference	Představuje mělký odkaz na TeamProject.

ProjectState

Aktuální stav projektu

Name	Typ	Description
all	string	Všechny projekty bez ohledu na stav s výjimkou Odstraněno.
createPending	string	Projekt byl zařazen do fronty k vytvoření, ale tento proces ještě nebyl zahájen.
deleted	string	Projekt byl odstraněn.
deleting	string	Projekt se právě odstraňuje.
new	string	Projekt se právě vytváří.
unchanged	string	Projekt nebyl změněn.
wellFormed	string	Projekt je zcela vytvořený a připravený k použití.

ProjectVisibility

Určuje, komu je projekt viditelný.

Name	Typ	Description
private	string	Projekt je viditelný pouze uživatelům s explicitním přístupem.
public	string	Projekt je viditelný pro všechny.

TeamProjectReference

Představuje mělký odkaz na TeamProject.

Name	Typ	Description
abbreviation	string	Zkratka projektu
defaultTeamImageUrl	string	Adresa URL výchozího obrázku týmové identity
description	string	Popis projektu (pokud existuje)
id	string	Identifikátor projektu.
lastUpdateTime	string	Čas poslední aktualizace projektu.
name	string	Název projektu.
revision	integer	Revize projektu.
state	ProjectState	Stav projektu.
url	string	Adresa URL na plnou verzi objektu.
visibility	ProjectVisibility	Viditelnost projektu.

Sdílet prostřednictvím