Projects - List

Service:

Core

API Version:

7.1-preview.4

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

With optional parameters:

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
continuationToken	query		integer int32	Pointeur qui indique le nombre de projets déjà extraits.
getDefaultTeamImageUrl	query		boolean
stateFilter	query		ProjectState	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	TeamProjectReference[]	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

HTTP

GET https://dev.azure.com/fabrikam/_apis/projects?api-version=7.1-preview.4

Sample Response

Status code:

200

{
  "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
ProjectState	État actuel du projet.
ProjectVisibility	Indique à qui le projet est visible.
TeamProjectReference	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	ProjectState	État du projet.
url	string	Url vers la version complète de l’objet.
visibility	ProjectVisibility	Visibilité du projet.