Projects - List

Service:

Core

API Version:

7.1-preview.4

Ottenere tutti i progetti nell'organizzazione a cui l'utente autenticato ha accesso.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '7.1-preview.4' per usare questa versione dell'API.
$skip	query		integer int32
$top	query		integer int32
continuationToken	query		integer int32	Puntatore che mostra il numero di progetti già recuperati.
getDefaultTeamImageUrl	query		boolean
stateFilter	query		ProjectState	Filtrare i progetti team in uno stato specifico del progetto team (impostazione predefinita: WellFormed).

Risposte

Nome	Tipo	Descrizione
200 OK	TeamProjectReference[]	operazione riuscita

Sicurezza

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

Nome	Descrizione
vso.profile	Concede la possibilità di leggere il profilo, gli account, le raccolte, i progetti, i team e altri artefatti dell'organizzazione di primo livello.
vso.project	Concede la possibilità di leggere progetti e team.

Esempio

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"
    }
  ]
}

Definizioni

Nome	Descrizione
ProjectState	Stato corrente del progetto.
ProjectVisibility	Indica a chi è visibile il progetto.
TeamProjectReference	Rappresenta un riferimento superficiale a un oggetto TeamProject.

ProjectState

Stato corrente del progetto.

Nome	Tipo	Descrizione
all	string	Tutti i progetti indipendentemente dallo stato ad eccezione di Deleted.
createPending	string	Il progetto è stato accodato per la creazione, ma il processo non è ancora stato avviato.
deleted	string	Il progetto è stato eliminato.
deleting	string	Il progetto è in fase di eliminazione.
new	string	Il progetto è in fase di creazione.
unchanged	string	Il progetto non è stato modificato.
wellFormed	string	Il progetto è completamente creato e pronto per l'uso.

ProjectVisibility

Indica a chi è visibile il progetto.

Nome	Tipo	Descrizione
private	string	Il progetto è visibile solo agli utenti con accesso esplicito.
public	string	Il progetto è visibile a tutti.

TeamProjectReference

Rappresenta un riferimento superficiale a un oggetto TeamProject.

Nome	Tipo	Descrizione
abbreviation	string	Abbreviazione del progetto.
defaultTeamImageUrl	string	URL dell'immagine di identità del team predefinita.
description	string	Descrizione del progetto (se presente).
id	string	Identificatore del progetto.
lastUpdateTime	string	Ora dell'ultimo aggiornamento del progetto.
name	string	Nome progetto.
revision	integer	Revisione del progetto.
state	ProjectState	Stato del progetto.
url	string	URL della versione completa dell'oggetto.
visibility	ProjectVisibility	Visibilità del progetto.