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. |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour