Projects - Update

Servizio:

Core

Versione API:

7.1

Aggiornare il nome, l'abbreviazione, la descrizione o il ripristino di un progetto esistente.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
projectId	path	True	string (uuid)	ID del progetto da aggiornare.
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '7.1' per usare questa versione dell'API.

Corpo della richiesta

Nome	Tipo	Descrizione
_links	ReferenceLinks	Collegamenti ad altri oggetti correlati a questo oggetto.
abbreviation	string	Abbreviazione del progetto.
capabilities	object	Set di funzionalità di questo progetto, ad esempio il modello di processo & controllo della versione.
defaultTeam	WebApiTeamRef	Riferimento superficiale al team predefinito.
defaultTeamImageUrl	string	URL dell'immagine di identità del team predefinita.
description	string	Descrizione del progetto (se presente).
id	string (uuid)	Identificatore del progetto.
lastUpdateTime	string (date-time)	Ora dell'ultimo aggiornamento del progetto.
name	string	Nome progetto.
revision	integer (int64)	Revisione del progetto.
state	ProjectState	Stato del progetto.
url	string	URL della versione completa dell'oggetto.
visibility	ProjectVisibility	Visibilità del progetto.

Risposte

Nome	Tipo	Descrizione
200 OK	OperationReference	operazione riuscita

Sicurezza

oauth2

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL token: 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

Ambiti

Nome	Descrizione
vso.project_write	Concede la possibilità di leggere e aggiornare progetti e team.

Definizioni

Nome	Descrizione
OperationReference	Riferimento per un'operazione asincrona.
OperationStatus	Stato corrente dell'operazione.
ProjectState	Stato corrente del progetto.
ProjectVisibility	Indica a chi è visibile il progetto.
ReferenceLinks	Classe per rappresentare una raccolta di collegamenti di riferimento REST.
TeamProject	Rappresenta un oggetto Team Project.
WebApiTeamRef

OperationReference

Object

Riferimento per un'operazione asincrona.

Nome	Tipo	Descrizione
id	string (uuid)	Identificatore univoco per l'operazione.
pluginId	string (uuid)	Identificatore univoco per il plug-in.
status	OperationStatus	Stato corrente dell'operazione.
url	string	URL per ottenere l'oggetto operazione completa.

OperationStatus

Enumerazione

Stato corrente dell'operazione.

Valore	Descrizione
cancelled	L'operazione è stata annullata dall'utente.
failed	Operazione completata con un errore.
inProgress	L'operazione è in corso.
notSet	L'operazione non dispone di un set di stato.
queued	L'operazione è stata accodata.
succeeded	Operazione completata correttamente.

ProjectState

Enumerazione

Stato corrente del progetto.

Valore	Descrizione
all	Tutti i progetti indipendentemente dallo stato tranne Deleted.
createPending	Il progetto è stato accodato per la creazione, ma il processo non è ancora stato avviato.
deleted	Il progetto è stato eliminato.
deleting	Il progetto è in corso di eliminazione.
new	Il progetto è in fase di creazione.
unchanged	Il progetto non è stato modificato.
wellFormed	Il progetto è completamente creato e pronto per l'uso.

ProjectVisibility

Enumerazione

Indica a chi è visibile il progetto.

Valore	Descrizione
private	Il progetto è visibile solo agli utenti con accesso esplicito.
public	Il progetto è visibile a tutti.

ReferenceLinks

Object

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome	Tipo	Descrizione
links	object	Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura.

TeamProject

Object

Rappresenta un oggetto Team Project.

Nome	Tipo	Descrizione
_links	ReferenceLinks	Collegamenti ad altri oggetti correlati a questo oggetto.
abbreviation	string	Abbreviazione del progetto.
capabilities	object	Set di funzionalità di questo progetto, ad esempio il modello di processo & controllo della versione.
defaultTeam	WebApiTeamRef	Riferimento superficiale al team predefinito.
defaultTeamImageUrl	string	URL dell'immagine di identità del team predefinita.
description	string	Descrizione del progetto (se presente).
id	string (uuid)	Identificatore del progetto.
lastUpdateTime	string (date-time)	Ora dell'ultimo aggiornamento del progetto.
name	string	Nome progetto.
revision	integer (int64)	Revisione del progetto.
state	ProjectState	Stato del progetto.
url	string	URL della versione completa dell'oggetto.
visibility	ProjectVisibility	Visibilità del progetto.

WebApiTeamRef

Object

Nome	Tipo	Descrizione
id	string (uuid)	Guid del team (identità). ID di Team Foundation.
name	string	Nome del team
url	string	URL DELL'API REST del team