Freigeben über


Projects - Update

Aktualisieren Sie den Namen, die Abkürzung, die Beschreibung oder das Wiederherstellen eines Projekts eines vorhandenen Projekts.

PATCH https://dev.azure.com/{organization}/_apis/projects/{projectId}?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 (uuid)

Die Projekt-ID des zu aktualisierenden Projekts.

api-version
query True

string

Version der zu verwendenden API. Dies sollte auf "7.1" festgelegt werden, um diese Version der API zu verwenden.

Anforderungstext

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.

Antworten

Name Typ Beschreibung
200 OK

OperationReference

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.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

Der aktuelle Status des Vorgangs.

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

OperationReference

Referenz für einen asynchronen Vorgang.

Name Typ Beschreibung
id

string (uuid)

Eindeutiger Bezeichner für den Vorgang.

pluginId

string (uuid)

Eindeutiger Bezeichner für das Plug-In.

status

OperationStatus

Der aktuelle Status des Vorgangs.

url

string

URL zum Abrufen des Vollständigen Vorgangsobjekts.

OperationStatus

Der aktuelle Status des Vorgangs.

Wert Beschreibung
cancelled

Der Vorgang wurde vom Benutzer abgebrochen.

failed

Der Vorgang wurde mit einem Fehler abgeschlossen.

inProgress

Der Vorgang wird ausgeführt.

notSet

Der Vorgang verfügt nicht über einen Statussatz.

queued

Der Vorgang wurde in die Warteschlange gestellt.

succeeded

Der Vorgang wurde erfolgreich abgeschlossen.

ProjectState

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

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.

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

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

Name Typ Beschreibung
id

string (uuid)

Team-GUID. Eine Team Foundation-ID.

name

string

Teamname

url

string

Team-REST-API-URL