Projects - Update

Usługa:

Core

Wersja interfejsu API:

7.1

Zaktualizuj nazwę istniejącego projektu, skrót, opis lub przywróć projekt.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
projectId	path	True	string (uuid)	Identyfikator projektu do zaktualizowania.
api-version	query	True	string	Wersja interfejsu API do użycia. Należy ustawić wartość "7.1", aby używać tej wersji interfejsu API.

Treść żądania

Nazwa	Typ	Opis
_links	ReferenceLinks	Łącza do innych obiektów powiązanych z tym obiektem.
abbreviation	string	Skrót projektu.
capabilities	object	Zestaw możliwości, które ma ten projekt (na przykład szablon procesu & kontroli wersji).
defaultTeam	WebApiTeamRef	Płytkie odwołanie do zespołu domyślnego.
defaultTeamImageUrl	string	Adres URL domyślnego obrazu tożsamości zespołu.
description	string	Opis projektu (jeśli istnieje).
id	string (uuid)	Identyfikator projektu.
lastUpdateTime	string (date-time)	Czas ostatniej aktualizacji projektu.
name	string	Nazwa projektu.
revision	integer (int64)	Poprawka projektu.
state	ProjectState	Stan projektu.
url	string	Adres URL do pełnej wersji obiektu.
visibility	ProjectVisibility	Widoczność projektu.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	OperationReference	operacja zakończona powodzeniem

Zabezpieczenia

oauth2

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Adres URL tokenu: 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

Zakresy

Nazwa	Opis
vso.project_write	Przyznaje możliwość odczytywania i aktualizowania projektów i zespołów.

Definicje

Nazwa	Opis
OperationReference	Odwołanie do operacji asynchronicznych.
OperationStatus	Bieżący stan operacji.
ProjectState	Bieżący stan projektu.
ProjectVisibility	Wskazuje, do kogo jest widoczny projekt.
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
TeamProject	Reprezentuje obiekt projektu zespołowego.
WebApiTeamRef

OperationReference

Objekt

Odwołanie do operacji asynchronicznych.

Nazwa	Typ	Opis
id	string (uuid)	Unikatowy identyfikator operacji.
pluginId	string (uuid)	Unikatowy identyfikator wtyczki.
status	OperationStatus	Bieżący stan operacji.
url	string	Adres URL umożliwiający pobranie obiektu pełnej operacji.

OperationStatus

Wyliczanie

Bieżący stan operacji.

Wartość	Opis
cancelled	Operacja została anulowana przez użytkownika.
failed	Operacja została ukończona z powodu błędu.
inProgress	Operacja jest w toku.
notSet	Operacja nie ma ustawionego stanu.
queued	Operacja została w kolejce.
succeeded	Operacja została ukończona pomyślnie.

ProjectState

Wyliczanie

Bieżący stan projektu.

Wartość	Opis
all	Wszystkie projekty niezależnie od stanu z wyjątkiem usuniętych.
createPending	Projekt został jeszcze w kolejce do utworzenia, ale proces nie został jeszcze uruchomiony.
deleted	Projekt został usunięty.
deleting	Projekt jest w trakcie usuwania.
new	Projekt jest w trakcie tworzenia.
unchanged	Projekt nie został zmieniony.
wellFormed	Projekt jest całkowicie tworzony i gotowy do użycia.

ProjectVisibility

Wyliczanie

Wskazuje, do kogo jest widoczny projekt.

Wartość	Opis
private	Projekt jest widoczny tylko dla użytkowników z jawnym dostępem.
public	Projekt jest widoczny dla wszystkich.

ReferenceLinks

Objekt

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa	Typ	Opis
links	object	Czytelny widok linków. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

TeamProject

Objekt

Reprezentuje obiekt projektu zespołowego.

Nazwa	Typ	Opis
_links	ReferenceLinks	Łącza do innych obiektów powiązanych z tym obiektem.
abbreviation	string	Skrót projektu.
capabilities	object	Zestaw możliwości, które ma ten projekt (na przykład szablon procesu & kontroli wersji).
defaultTeam	WebApiTeamRef	Płytkie odwołanie do zespołu domyślnego.
defaultTeamImageUrl	string	Adres URL domyślnego obrazu tożsamości zespołu.
description	string	Opis projektu (jeśli istnieje).
id	string (uuid)	Identyfikator projektu.
lastUpdateTime	string (date-time)	Czas ostatniej aktualizacji projektu.
name	string	Nazwa projektu.
revision	integer (int64)	Poprawka projektu.
state	ProjectState	Stan projektu.
url	string	Adres URL do pełnej wersji obiektu.
visibility	ProjectVisibility	Widoczność projektu.

WebApiTeamRef

Objekt

Nazwa	Typ	Opis
id	string (uuid)	Identyfikator GUID zespołu (tożsamości). Identyfikator team foundation.
name	string	Nazwa zespołu
url	string	Adres URL interfejsu API REST zespołu