Projects - List

Ссылка

Служба:: Core

Версия API:: 7.1

Получите все проекты в организации, к которым имеет доступ прошедший проверку подлинности пользователь.

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

С использованием необязательных параметров:

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
organization	path	True	string	Имя организации Azure DevOps.
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение "7.1".
$skip	query		integer (int32)
$top	query		integer (int32)
continuationToken	query		integer (int32)	Указатель, показывающий, сколько проектов уже было выполнено.
getDefaultTeamImageUrl	query		boolean
stateFilter	query		ProjectState	Фильтрация по командным проектам в определенном состоянии командного проекта (по умолчанию: WellFormed).

Ответы

Имя	Тип	Описание
200 OK	TeamProjectReference[]	успешная операция

Безопасность

oauth2

Тип: oauth2
Flow: accessCode
URL-адрес авторизации: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
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

Области

Имя	Описание
vso.profile	Предоставляет возможность читать профиль, учетные записи, коллекции, проекты, команды и другие артефакты организации верхнего уровня.
vso.project	Предоставляет возможность читать проекты и команды.

Примеры

Образец запроса

HTTP

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

Пример ответа

Код состояния:: 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"
    }
  ]
}

Определения

Имя	Описание
ProjectState	Текущее состояние проекта.
ProjectVisibility	Указывает, кому отображается проект.
TeamProjectReference	Представляет неглубокую ссылку на TeamProject.

ProjectState

Перечисление

Текущее состояние проекта.

Значение	Описание
all	Все проекты независимо от состояния, кроме deleted.
createPending	Проект был поставлен в очередь для создания, но процесс еще не запущен.
deleted	Проект удален.
deleting	Проект находится в процессе удаления.
new	Проект находится в процессе создания.
unchanged	Проект не был изменен.
wellFormed	Проект полностью создан и готов к использованию.

ProjectVisibility