Condividi tramite


Projects - List

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

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

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.