Freigeben über


Projects - Update

Aktualisieren Sie den Namen, die Abkürzung, die Beschreibung eines vorhandenen Projekts, oder stellen Sie ein Projekt wieder her.

PATCH https://dev.azure.com/{organization}/_apis/projects/{projectId}?api-version=7.1-preview.4

URI-Parameter

Name In Erforderlich Typ Beschreibung
organization
path True

string

Der Name der Azure DevOps-Organisation.

projectId
path True

string

uuid

Die Projekt-ID des zu aktualisierenden Projekts.

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

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_write Gewährt die Möglichkeit, Projekte und Teams zu lesen und zu aktualisieren.

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.

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