Projects - Create
Stellt ein zu erstellende Projekt in die Warteschlange. Verwenden Sie GetOperation, um regelmäßig zu überprüfen, ob ein Projekt status erstellt wird.
POST https://dev.azure.com/{organization}/_apis/projects?api-version=7.1-preview.4
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-preview.4" festgelegt werden, um diese Version der API zu verwenden. |
Anforderungstext
Name | Typ | Beschreibung |
---|---|---|
_links |
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 |
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 |
Projektstatus. |
|
url |
string |
URL zur Vollversion des Objekts. |
visibility |
Projektsichtbarkeit. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
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.project_manage | Ermöglicht das Erstellen, Lesen, Aktualisieren und Löschen von Projekten und Teams. |
Beispiele
Sample Request
POST https://dev.azure.com/fabrikam/_apis/projects?api-version=7.1-preview.4
{
"name": "FabrikamTravel",
"description": "Frabrikam travel app for Windows Phone",
"capabilities": {
"versioncontrol": {
"sourceControlType": "Git"
},
"processTemplate": {
"templateTypeId": "6b724908-ef14-45cf-84f8-768b5384da45"
}
}
}
Sample Response
{
"id": "066488b8-b14e-43d1-befc-a2e655266e2b",
"status": "queued",
"url": "https://dev.azure.com/fabrikam/_apis/operations/066488b8-b14e-43d1-befc-a2e655266e2b"
}
Definitionen
Name | Beschreibung |
---|---|
Operation |
Referenz für einen asynchronen Vorgang. |
Operation |
Der aktuelle status des Vorgangs. |
Project |
Der aktuelle Status des Projekts. |
Project |
Gibt an, für wen das Projekt sichtbar ist. |
Reference |
Die Klasse, die eine Auflistung von REST-Verweislinks darstellt. |
Team |
Stellt ein Team Project-Objekt dar. |
Web |
OperationReference
Referenz für einen asynchronen Vorgang.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Eindeutiger Bezeichner für den Vorgang. |
pluginId |
string |
Eindeutiger Bezeichner für das Plug-In. |
status |
Der aktuelle status des Vorgangs. |
|
url |
string |
URL zum Abrufen des vollständigen Vorgangsobjekts. |
OperationStatus
Der aktuelle status des Vorgangs.
Name | Typ | Beschreibung |
---|---|---|
cancelled |
string |
Der Vorgang wurde vom Benutzer abgebrochen. |
failed |
string |
Der Vorgang wurde mit einem Fehler abgeschlossen. |
inProgress |
string |
Der Vorgang wird ausgeführt. |
notSet |
string |
Für den Vorgang ist kein status festgelegt. |
queued |
string |
Der Vorgang wurde in eine Warteschlange gestellt. |
succeeded |
string |
Der Vorgang wurde erfolgreich abgeschlossen. |
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 |
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 |
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 |
Projektstatus. |
|
url |
string |
URL zur Vollversion des Objekts. |
visibility |
Projektsichtbarkeit. |
WebApiTeamRef
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Team (Identität) Guid. Eine Team Foundation-ID. |
name |
string |
Teamname |
url |
string |
Team-REST-API-URL |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für