Projects - Get

  • Referenz
Dienst:
Core
API-Version:
7.1

Rufen Sie das 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.1
Mit optionalen Parametern: 
GET https://dev.azure.com/{organization}/_apis/projects/{projectId}?includeCapabilities={includeCapabilities}&includeHistory={includeHistory}&api-version=7.1

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.1" festgelegt werden, um diese Version der API zu verwenden.
includeCapabilities
 query

boolean

Fügen 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

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.

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-Referenzverknüpfungslinks darstellt.
TeamProject

Stellt ein Team Project -Objekt dar.
WebApiTeamRef

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

Enumeration

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

Wert Beschreibung
private

Das Projekt ist nur für Benutzer mit expliziten Zugriff sichtbar.
public

Das Projekt ist für alle sichtbar.
Objekt

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

Name Typ Beschreibung
links

object

Die schreibgeschützte Ansicht der Links. Da Referenzlinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.

TeamProject

Objekt

Stellt ein Team Project -Objekt dar.

Name Typ Beschreibung
_links

ReferenceLinks

Die Verknüpfungen zu anderen Objekten im Zusammenhang mit diesem Objekt.
abbreviation

string

Projektkürzel.
capabilities

object

Satz von Funktionen, die dieses Projekt hat (z. B. Prozessvorlage & Versionssteuerung).
defaultTeam

WebApiTeamRef

Der flache Verweis auf das Standardteam.
defaultTeamImageUrl

string

Url zum standardmäßigen Teamidentitätsbild.
description

string

Die Beschreibung des Projekts (falls vorhanden).
id

string (uuid)

Projektbezeichner.
lastUpdateTime

string (date-time)

Zeitpunkt der letzten Aktualisierung des Projekts.
name

string

Projektname.
revision

integer (int64)

Projektrevision.
state

ProjectState

Projektstatus.
url

string

Die URL zur Vollversion des Objekts.
visibility

ProjectVisibility

Projektsichtbarkeit.

WebApiTeamRef

Objekt
Name Typ Beschreibung
id

string (uuid)

Team-GUID. Eine Team Foundation-ID.
name

string

Teamname
url

string

Team-REST-API-URL