Projects - List

Referenz

Dienst:: Core

API-Version:: 7.1

Ruft alle Projekte in der Organisation ab, auf die der authentifizierte Benutzer Zugriff hat.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.1" festgelegt werden, um diese Version der API zu verwenden.
$skip	query		integer (int32)
$top	query		integer (int32)
continuationToken	query		integer (int32)	Zeiger, der zeigt, wie viele Projekte bereits abgerufen wurden.
getDefaultTeamImageUrl	query		boolean
stateFilter	query		ProjectState	Filtern sie nach Teamprojekten in einem bestimmten Teamprojektstatus (Standard: WellFormed).

Antworten

Name	Typ	Beschreibung
200 OK	TeamProjectReference[]	Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-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

Bereiche

Name	Beschreibung
vso.profile	Gewährt die Möglichkeit, Ihr Profil, Konten, Sammlungen, Projekte, Teams und andere Organisationsartefakte auf oberster Ebene zu lesen.
vso.project	Gewährt die Möglichkeit, Projekte und Teams zu lesen.

Beispiele

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

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

Definitionen

Name	Beschreibung
ProjectState	Der aktuelle Status des Projekts.
ProjectVisibility	Gibt an, für wen das Projekt sichtbar ist.
TeamProjectReference	Stellt einen flachen Verweis auf ein TeamProject dar.

ProjectState

Enumeration

Der aktuelle Status des Projekts.

Wert	Beschreibung
all	Alle Projekte unabhängig vom Status außer "Gelöscht".
createPending	Projekt wurde zur Erstellung in die Warteschlange gestellt, aber der Prozess wurde noch nicht gestartet.
deleted	Projekt wurde gelöscht.
deleting	Project wird gerade gelöscht.
new	Projekt wird gerade erstellt.
unchanged	Projekt wurde nicht geändert.
wellFormed	Project wird vollständig erstellt und kann verwendet werden.

ProjectVisibility