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. |
project
|
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 |
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 |
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 |
Projektstatus. |
|
url |
string |
Die URL zur Vollversion des Objekts. |
visibility |
Projektsichtbarkeit. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
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 |
---|---|
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-Referenzverknüpfungslinks darstellt. |
Team |
Stellt ein Team Project -Objekt dar. |
Web |
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 |
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. |
ReferenceLinks
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 |
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 |
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 |
Projektstatus. |
|
url |
string |
Die URL zur Vollversion des Objekts. |
visibility |
Projektsichtbarkeit. |
WebApiTeamRef
Name | Typ | Beschreibung |
---|---|---|
id |
string (uuid) |
Team-GUID. Eine Team Foundation-ID. |
name |
string |
Teamname |
url |
string |
Team-REST-API-URL |