Projects - Create

Referenz

Service:: Core

API Version:: 7.0

Stellt ein zu erstellende Projekt in die Warteschlange. Verwenden Sie getOperation, um in regelmäßigen Abständen nach projekt erstellen status zu suchen.

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

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

Anforderungstext

Name	Typ	Beschreibung
_links	ReferenceLinks	Die Links zu anderen Objekten, die sich auf dieses Objekt beziehen.
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ätsbild.
description	string	Die Beschreibung des Projekts (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.

Antworten

Name	Typ	Beschreibung
200 OK	OperationReference	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	Gewährt die Möglichkeit, Projekte und Teams zu erstellen, zu lesen, zu aktualisieren und zu löschen.

Beispiele

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/_apis/projects?api-version=7.0

{
  "name": "FabrikamTravel",
  "description": "Frabrikam travel app for Windows Phone",
  "capabilities": {
    "versioncontrol": {
      "sourceControlType": "Git"
    },
    "processTemplate": {
      "templateTypeId": "6b724908-ef14-45cf-84f8-768b5384da45"
    }
  }
}

Sample Response

Status code:: 202

{
  "id": "066488b8-b14e-43d1-befc-a2e655266e2b",
  "status": "queued",
  "url": "https://dev.azure.com/fabrikam/_apis/operations/066488b8-b14e-43d1-befc-a2e655266e2b"
}

Definitionen

Name	Beschreibung
OperationReference	Referenz für einen asynchronen Vorgang.
OperationStatus	Die aktuelle status des Vorgangs.
ProjectState	Der aktuelle Zustand 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

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	OperationStatus	Die aktuelle status des Vorgangs.
url	string	URL zum Abrufen des vollständigen Vorgangsobjekts.

OperationStatus

Die 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 die Warteschlange gestellt.
succeeded	string	Der Vorgang wurde erfolgreich abgeschlossen.

ProjectState

Der aktuelle Zustand des Projekts.

Name	Typ	Beschreibung
all	string	Alle Projekte unabhängig vom Status außer Gelöscht.
createPending	string	Das Projekt wurde für die Erstellung in die Warteschlange eingereiht, 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	Das Projekt 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ützter Sind, möchten wir sie nur als schreibgeschützter Link verfügbar machen.

TeamProject

Stellt ein Team Project-Objekt dar.

Name	Typ	Beschreibung
_links	ReferenceLinks	Die Links zu anderen Objekten, die sich auf dieses Objekt beziehen.
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ätsbild.
description	string	Die Beschreibung des Projekts (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äts-)GUID. Eine Team Foundation-ID.
name	string	Teamname
url	string	Team-REST-API-URL