Projects - Update

Service:

Core

API Version:

7.1-preview.4

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

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-preview.4' 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à del 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	Identificatore del progetto.
lastUpdateTime	string	Ora dell'ultimo aggiornamento del progetto.
name	string	Nome progetto.
revision	integer	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

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

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

Riferimento per un'operazione asincrona.

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

OperationStatus

Stato corrente dell'operazione.

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

ProjectState

Stato corrente del progetto.

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

ProjectVisibility

Indica a chi è visibile il progetto.

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

ReferenceLinks

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

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à del 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	Identificatore del progetto.
lastUpdateTime	string	Ora dell'ultimo aggiornamento del progetto.
name	string	Nome progetto.
revision	integer	Revisione del progetto.
state	ProjectState	Stato del progetto.
url	string	URL della versione completa dell'oggetto.
visibility	ProjectVisibility	Visibilità del progetto.

WebApiTeamRef

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