Projects - Update

Référence

Service:: Core

API Version:: 7.1-preview.4

Mettez à jour le nom, l’abréviation, la description ou restaurez un projet existant.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
organization	path	True	string	Nom de l’organisation Azure DevOps.
projectId	path	True	string uuid	ID de projet du projet à mettre à jour.
api-version	query	True	string	Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1-preview.4 » pour utiliser cette version de l’API.

Corps de la demande

Nom	Type	Description
_links	ReferenceLinks	Liens vers d’autres objets liés à cet objet.
abbreviation	string	Abréviation de projet.
capabilities	object	Ensemble de fonctionnalités de ce projet (telles que le modèle de processus & le contrôle de version).
defaultTeam	WebApiTeamRef	Ref superficiel de l’équipe par défaut.
defaultTeamImageUrl	string	URL de l’image d’identité d’équipe par défaut.
description	string	Description du projet (le cas échéant).
id	string	Identificateur de projet.
lastUpdateTime	string	Heure de la dernière mise à jour du projet.
name	string	Nom du projet.
revision	integer	Révision du projet.
state	ProjectState	État du projet.
url	string	Url de la version complète de l’objet.
visibility	ProjectVisibility	Visibilité du projet.

Réponses

Nom	Type	Description
200 OK	OperationReference	opération réussie

Sécurité

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

Nom	Description
vso.project_write	Permet de lire et de mettre à jour des projets et des équipes.

Définitions

Nom	Description
OperationReference	Référence pour une opération asynchrone.
OperationStatus	Status actuelle de l’opération.
ProjectState	État actuel du projet.
ProjectVisibility	Indique à qui le projet est visible.
ReferenceLinks	Classe pour représenter une collection de liens de référence REST.
TeamProject	Représente un objet Project d’équipe.
WebApiTeamRef

OperationReference

Référence pour une opération asynchrone.

Nom	Type	Description
id	string	Identificateur unique de l’opération.
pluginId	string	Identificateur unique du plug-in.
status	OperationStatus	Status actuelle de l’opération.
url	string	URL permettant d’obtenir l’objet d’opération complet.

OperationStatus

Status actuelle de l’opération.

Nom	Type	Description
cancelled	string	L’opération a été annulée par l’utilisateur.
failed	string	L’opération s’est terminée avec un échec.
inProgress	string	L’opération est en cours.
notSet	string	L’opération n’a pas de status définie.
queued	string	L’opération a été mise en file d’attente.
succeeded	string	L’opération s’est terminée avec succès.

ProjectState

État actuel du projet.

Nom	Type	Description
all	string	Tous les projets, quel que soit leur état, sauf Supprimé.
createPending	string	Project a été mis en file d’attente pour la création, mais le processus n’a pas encore démarré.
deleted	string	Le projet a été supprimé.
deleting	string	Project est en cours de suppression.
new	string	Project est en cours de création.
unchanged	string	Le projet n’a pas été modifié.
wellFormed	string	Le projet est entièrement créé et prêt à être utilisé.

ProjectVisibility

Indique à qui le projet est visible.

Nom	Type	Description
private	string	Le projet n’est visible que par les utilisateurs disposant d’un accès explicite.
public	string	Le projet est visible par tous.

ReferenceLinks

Classe pour représenter une collection de liens de référence REST.

Nom	Type	Description
links	object	Vue en lecture seule des liens. Étant donné que les liens référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

TeamProject

Représente un objet Project d’équipe.

Nom	Type	Description
_links	ReferenceLinks	Liens vers d’autres objets liés à cet objet.
abbreviation	string	Abréviation de projet.
capabilities	object	Ensemble de fonctionnalités de ce projet (telles que le modèle de processus & le contrôle de version).
defaultTeam	WebApiTeamRef	Ref superficiel de l’équipe par défaut.
defaultTeamImageUrl	string	URL de l’image d’identité d’équipe par défaut.
description	string	Description du projet (le cas échéant).
id	string	Identificateur de projet.
lastUpdateTime	string	Heure de la dernière mise à jour du projet.
name	string	Nom du projet.
revision	integer	Révision du projet.
state	ProjectState	État du projet.
url	string	Url de la version complète de l’objet.
visibility	ProjectVisibility	Visibilité du projet.

WebApiTeamRef

Nom	Type	Description
id	string	Guid de l’équipe (identité). UN ID Team Foundation.
name	string	Nom de l’équipe
url	string	URL de l’API REST d’équipe

Partager via