Projects - List

Référence

Service:: Core

Version d'API:: 7.1

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

Avec des paramètres facultatifs:

GET https://dev.azure.com/{organization}/_apis/projects?stateFilter={stateFilter}&$top={$top}&$skip={$skip}&continuationToken={continuationToken}&getDefaultTeamImageUrl={getDefaultTeamImageUrl}&api-version=7.1

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 » 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à récupérés.
getDefaultTeamImageUrl	query		boolean
stateFilter	query		ProjectState	Filtrez sur 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
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

Nom	Description
vso.profile	Accorde la possibilité de lire votre profil, comptes, collections, projets, équipes et autres artefacts organisationnels de niveau supérieur.
vso.project	Accorde la possibilité de lire des projets et des équipes.

Exemples

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:: 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

Énumération

État actuel du projet.

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

ProjectVisibility