Repositories - Create
在团队项目中创建 git 存储库。
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=5.0POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories?sourceRef={sourceRef}&api-version=5.0URI 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Azure DevOps 组织的名称。 |
|
project
|
path |
string |
项目 ID 或项目名称 |
|
|
api-version
|
query | True |
string |
要使用的 API 版本。 应将其设置为“5.0”才能使用此版本的 API。 |
|
source
|
query |
string |
[可选]指定创建分叉存储库时要使用的源引用 |
请求正文
| 名称 | 类型 | 说明 |
|---|---|---|
| name |
string |
|
| parentRepository | ||
| project |
表示对 TeamProject 的浅表引用。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 201 Created |
创建 |
安全性
oauth2
类型:
oauth2
流向:
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.code_manage | 授予读取、更新和删除源代码、访问有关提交、更改集、分支和其他版本控制项目元数据的能力。 此外，还授予创建和管理代码存储库、创建和管理拉取请求和代码评审以及通过服务挂钩接收有关版本控制事件的通知的能力。 |
示例
示例请求
POST https://dev.azure.com/fabrikam/_apis/git/repositories?api-version=5.0
{
"name": "AnotherRepository",
"project": {
"id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c"
}
}
示例响应
{
"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"
}定义
| 名称 | 说明 |
|---|---|
|
Git |
|
|
Git |
|
|
Git |
|
|
Project |
项目状态。 |
|
Project |
项目可见性。 |
|
Reference |
表示 REST 引用链接集合的类。 |
|
Team |
TeamProjectCollection 的引用对象。 |
|
Team |
表示对 TeamProject 的浅表引用。 |
GitRepository
| 名称 | 类型 | 说明 |
|---|---|---|
| _links |
表示 REST 引用链接集合的类。 |
|
| defaultBranch |
string |
|
| id |
string |
|
| isFork |
boolean |
如此 如果存储库是作为分支创建的 |
| name |
string |
|
| parentRepository | ||
| project |
表示对 TeamProject 的浅表引用。 |
|
| remoteUrl |
string |
|
| size |
integer |
存储库的压缩大小 (字节) 。 |
| sshUrl |
string |
|
| url |
string |
|
| validRemoteUrls |
string[] |
GitRepositoryCreateOptions
| 名称 | 类型 | 说明 |
|---|---|---|
| name |
string |
|
| parentRepository | ||
| project |
表示对 TeamProject 的浅表引用。 |
GitRepositoryRef
| 名称 | 类型 | 说明 |
|---|---|---|
| collection |
此分支所在的团队项目集合 |
|
| id |
string |
|
| isFork |
boolean |
如此 如果存储库是作为分支创建的 |
| name |
string |
|
| project |
表示对 TeamProject 的浅表引用。 |
|
| remoteUrl |
string |
|
| sshUrl |
string |
|
| url |
string |
ProjectState
项目状态。
| 值 | 说明 |
|---|---|
| all |
所有项目，不考虑状态。 |
| createPending |
项目已排队等待创建，但该过程尚未启动。 |
| deleted |
已删除项目。 |
| deleting |
正在删除 Project。 |
| new |
项目正在创建过程中。 |
| unchanged |
项目尚未更改。 |
| wellFormed |
项目已完全创建并可供使用。 |
ProjectVisibility
项目可见性。
| 值 | 说明 |
|---|---|
| private |
项目仅对具有显式访问权限的用户可见。 |
| public |
项目对所有人都可见。 |
ReferenceLinks
表示 REST 引用链接集合的类。
| 名称 | 类型 | 说明 |
|---|---|---|
| links |
object |
链接的只读视图。 由于引用链接是只读的，因此我们只想将其公开为只读。 |
TeamProjectCollectionReference
TeamProjectCollection 的引用对象。
| 名称 | 类型 | 说明 |
|---|---|---|
| id |
string |
集合 ID。 |
| name |
string |
集合名称。 |
| url |
string |
集合 REST URL。 |
TeamProjectReference
表示对 TeamProject 的浅表引用。
| 名称 | 类型 | 说明 |
|---|---|---|
| abbreviation |
string |
项目缩写。 |
| defaultTeamImageUrl |
string |
默认团队标识图像的 URL。 |
| description |
string |
如果有任何) ，项目说明 (。 |
| id |
string |
项目标识符。 |
| name |
string |
项目名称。 |
| revision |
integer |
项目修订。 |
| state |
项目状态。 |
|
| url |
string |
对象完整版本的 URL。 |
| visibility |
项目可见性。 |