Projects - Get

Referenz

Service:: Core

API Version:: 7.0

Rufen Sie ein Projekt mit der angegebenen ID oder dem angegebenen Namen ab, optional einschließlich Funktionen.

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

With optional parameters:

GET https://dev.azure.com/{organization}/_apis/projects/{projectId}?includeCapabilities={includeCapabilities}&includeHistory={includeHistory}&api-version=7.0

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
projectId	path	True	string
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.0" festgelegt werden, um diese Version der API zu verwenden.
includeCapabilities	query		boolean	Schließen Sie Funktionen (z. B. Quellcodeverwaltung) in das Teamprojektergebnis ein (Standard: false).
includeHistory	query		boolean	Suchen Sie in umbenannten Projekten (die in der Vergangenheit einen solchen Namen hatten).

Antworten

Name	Typ	Beschreibung
200 OK	TeamProject	Erfolgreicher Vorgang

Sicherheit

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	Beschreibung
vso.profile	Ermöglicht das Lesen Ihres Profils, Ihrer Konten, Sammlungen, Projekte, Teams und anderer Artefakte auf oberster Ebene.
vso.project	Ermöglicht das Lesen von Projekten und Teams.

Definitionen

Name	Beschreibung
ProjectState	Der aktuelle Status des Projekts.
ProjectVisibility	Gibt an, für wen das Projekt sichtbar ist.
ReferenceLinks	Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
TeamProject	Stellt ein Team Project-Objekt dar.
WebApiTeamRef

ProjectState

Der aktuelle Status des Projekts.

Name	Typ	Beschreibung
all	string	Alle Projekte unabhängig vom Zustand mit Ausnahme von "Gelöscht".
createPending	string	Project wurde für die Erstellung in die Warteschlange gestellt, aber der Prozess wurde noch nicht gestartet.
deleted	string	Project wurde gelöscht.
deleting	string	Project wird gerade gelöscht.
new	string	Das Projekt wird gerade erstellt.
unchanged	string	Project wurde nicht geändert.
wellFormed	string	Project ist vollständig erstellt und einsatzbereit.

ProjectVisibility

Gibt an, für wen das Projekt sichtbar ist.

Name	Typ	Beschreibung
private	string	Das Projekt ist nur für Benutzer mit explizitem Zugriff sichtbar.
public	string	Das Projekt ist für alle sichtbar.

ReferenceLinks

Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.

TeamProject

Stellt ein Team Project-Objekt dar.

Name	Typ	Beschreibung
_links	ReferenceLinks	Die Links zu anderen Objekten, die mit diesem Objekt verknüpft sind.
abbreviation	string	Projektkürzel.
capabilities	object	Eine Reihe von Funktionen dieses Projekts (z. B. Prozessvorlage & Versionskontrolle).
defaultTeam	WebApiTeamRef	Der flache Verweis auf das Standardteam.
defaultTeamImageUrl	string	URL zum Standardmäßigen Teamidentitätsimage.
description	string	Die Projektbeschreibung (falls vorhanden).
id	string	Projektbezeichner.
lastUpdateTime	string	Zeitpunkt der letzten Aktualisierung des Projekts.
name	string	Der Projektname.
revision	integer	Projektrevision.
state	ProjectState	Projektstatus.
url	string	URL zur Vollversion des Objekts.
visibility	ProjectVisibility	Projektsichtbarkeit.

WebApiTeamRef

Name	Typ	Beschreibung
id	string	Team (Identität) Guid. Eine Team Foundation-ID.
name	string	Teamname
url	string	Team-REST-API-URL