Repositories - Create

Service:

Git

API Version:

5.0

Создайте репозиторий Git в командном проекте.

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=5.0

With optional parameters:

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories?sourceRef={sourceRef}&api-version=5.0

Параметры URI

Имя	В	Обязательно	Тип	Описание
organization	path	True	string	Название организации Azure DevOps.
project	path		string	Идентификатор проекта или имя проекта
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение 5.0.
sourceRef	query		string	[необязательно] Указание исходных ссылок для использования при создании репозитория вилки

Текст запроса

Имя	Тип	Описание
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Представляет неглубокую ссылку на TeamProject.

Ответы

Имя	Тип	Описание
201 Created	GitRepository	Создание

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

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

Имя

Описание

vso.code_manage

Предоставляет возможность чтения, обновления и удаления исходного кода, доступа к метаданным о фиксациях, наборах изменений, ветвях и других артефактах управления версиями. Кроме того, предоставляет возможность создавать репозитории кода и управлять ими, создавать запросы на вытягивание и проверки кода и управлять ими, а также получать уведомления о событиях управления версиями с помощью перехватчиков служб.

Примеры

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/_apis/git/repositories?api-version=5.0

{
  "name": "AnotherRepository",
  "project": {
    "id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c"
  }
}

Sample Response

Status code:

201

{
  "id": "5febef5a-833d-4e14-b9c0-14cb638f91e6",
  "name": "AnotherRepository",
  "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/5febef5a-833d-4e14-b9c0-14cb638f91e6",
  "project": {
    "id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
    "name": "Fabrikam-Fiber-Git",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
    "state": "wellFormed"
  },
  "remoteUrl": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_git/AnotherRepository"
}

Определения

Имя	Описание
GitRepository
GitRepositoryCreateOptions
GitRepositoryRef
ProjectState	Состояние проекта.
ProjectVisibility	Видимость проекта.
ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
TeamProjectCollectionReference	Объект reference для TeamProjectCollection.
TeamProjectReference	Представляет неглубокую ссылку на TeamProject.

GitRepository

Имя	Тип	Описание
_links	ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
defaultBranch	string
id	string
isFork	boolean	Значение true, если репозиторий был создан как вилка
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Представляет неглубокую ссылку на TeamProject.
remoteUrl	string
size	integer	Сжатый размер (байты) репозитория.
sshUrl	string
url	string
validRemoteUrls	string[]

GitRepositoryCreateOptions

Имя	Тип	Описание
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Представляет неглубокую ссылку на TeamProject.

GitRepositoryRef

Имя	Тип	Описание
collection	TeamProjectCollectionReference	Коллекция командных проектов, в которой находится эта вилка
id	string
isFork	boolean	Значение true, если репозиторий был создан как вилка
name	string
project	TeamProjectReference	Представляет неглубокую ссылку на TeamProject.
remoteUrl	string
sshUrl	string
url	string

ProjectState

Состояние проекта.

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

ProjectVisibility

Видимость проекта.

Имя	Тип	Описание
private	string	Проект виден только пользователям с явным доступом.
public	string	Проект виден всем.

ReferenceLinks

Класс, представляющий коллекцию ссылок REST.

Имя	Тип	Описание
links	object	Представление ссылок только для чтения. Так как ссылочные ссылки доступны только для чтения, мы хотим предоставить их только для чтения.

TeamProjectCollectionReference

Объект reference для TeamProjectCollection.

Имя	Тип	Описание
id	string	Идентификатор коллекции.
name	string	Имя коллекции.
url	string	URL-адрес REST коллекции.

TeamProjectReference

Представляет неглубокую ссылку на TeamProject.

Имя	Тип	Описание
abbreviation	string	Сокращение проекта.
defaultTeamImageUrl	string	URL-адрес образа удостоверения команды по умолчанию.
description	string	Описание проекта (при наличии).
id	string	Идентификатор проекта.
name	string	Имя проекта.
revision	integer	Редакция проекта.
state	ProjectState	Состояние проекта.
url	string	URL-адрес полной версии объекта.
visibility	ProjectVisibility	Видимость проекта.