Partager via


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
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

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
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.