Projects - List
Obtenez tous les projets de l’organisation auxquels l’utilisateur authentifié a accès.
GET https://dev.azure.com/{organization}/_apis/projects?api-version=7.1-preview.4
GET https://dev.azure.com/{organization}/_apis/projects?stateFilter={stateFilter}&$top={$top}&$skip={$skip}&continuationToken={continuationToken}&getDefaultTeamImageUrl={getDefaultTeamImageUrl}&api-version=7.1-preview.4
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
organization
|
path | True |
string |
Nom de l’organisation Azure DevOps. |
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. |
$skip
|
query |
integer int32 |
||
$top
|
query |
integer int32 |
||
continuation
|
query |
integer int32 |
Pointeur qui indique le nombre de projets déjà extraits. |
|
get
|
query |
boolean |
||
state
|
query |
Filtrez les projets d’équipe dans un état de projet d’équipe spécifique (par défaut : WellFormed). |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
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.profile | Permet de lire votre profil, comptes, collections, projets, équipes et autres artefacts organisationnels de niveau supérieur. |
vso.project | Permet de lire des projets et des équipes. |
Exemples
Sample Request
GET https://dev.azure.com/fabrikam/_apis/projects?api-version=7.1-preview.4
Sample Response
{
"count": 3,
"value": [
{
"id": "eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
"name": "Fabrikam-Fiber-TFVC",
"description": "Team Foundation Version Control projects.",
"url": "https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
"state": "wellFormed"
},
{
"id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
"name": "Fabrikam-Fiber-Git",
"description": "Git projects",
"url": "https://dev.azure.com/fabrikam/_apis/projects/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
"state": "wellFormed"
},
{
"id": "281f9a5b-af0d-49b4-a1df-fe6f5e5f84d0",
"name": "TestGit",
"url": "https://dev.azure.com/fabrikam/_apis/projects/281f9a5b-af0d-49b4-a1df-fe6f5e5f84d0",
"state": "wellFormed"
}
]
}
Définitions
Nom | Description |
---|---|
Project |
État actuel du projet. |
Project |
Indique à qui le projet est visible. |
Team |
Représente une référence superficielle à un TeamProject. |
ProjectState
État actuel du projet.
Nom | Type | Description |
---|---|---|
all |
string |
Tous les projets, quel que soit leur état, à l’exception de 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 |
Le projet est en cours de suppression. |
new |
string |
Le projet 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. |
TeamProjectReference
Représente une référence superficielle à un TeamProject.
Nom | Type | Description |
---|---|---|
abbreviation |
string |
Abréviation du projet. |
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 |
État du projet. |
|
url |
string |
Url vers la version complète de l’objet. |
visibility |
Visibilité du projet. |