Repositories - Create
チーム プロジェクトに Git リポジトリを作成します。
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1-preview.1
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories?sourceRef={sourceRef}&api-version=7.1-preview.1
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
organization
|
path | True |
string |
Azure DevOps 組織の名前です。 |
project
|
path |
string |
プロジェクト ID またはプロジェクト名 |
|
api-version
|
query | True |
string |
使用する API のバージョン。 このバージョンの API を使用するには、これを '7.1-preview.1' に設定する必要があります。 |
source
|
query |
string |
[省略可能]フォーク リポジトリの作成時に使用するソース参照を指定する |
要求本文
名前 | 型 | 説明 |
---|---|---|
name |
string |
|
parentRepository | ||
project |
TeamProject への浅い参照を表します。 |
応答
名前 | 型 | 説明 |
---|---|---|
201 Created |
作成済み |
セキュリティ
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 | ソース コードの読み取り、更新、削除、コミット、変更セット、ブランチ、およびその他のバージョン管理成果物に関するメタデータへのアクセスを許可します。 また、コード リポジトリの作成と管理、pull request とコード レビューの作成と管理、およびサービス フックを使用してバージョン管理イベントに関する通知を受信する機能も付与されます。 |
例
Create a fork of a parent repository |
Create a fork of a parent repository syncing only the provided refs |
Create a repository |
Create a fork of a parent repository
Sample Request
POST https://dev.azure.com/{organization}/_apis/git/repositories?api-version=7.1-preview.1
{
"name": "forkRepository",
"project": {
"id": "3b046b6a-d070-4cd5-ad59-2eace5d05b90"
},
"parentRepository": {
"id": "57a09b16-c635-4ec9-bd6b-d501fec4eb7b",
"project": {
"id": "3b046b6a-d070-4cd5-ad59-2eace5d05b90"
}
}
}
Sample Response
{
"id": "76b510af-7910-4a96-9902-b978d6226bee",
"name": "forkRepository",
"url": "https://dev.azure.com/fabrikam/MyFirstProject/_apis/git/repositories/76b510af-7910-4a96-9902-b978d6226bee",
"project": {
"id": "3b046b6a-d070-4cd5-ad59-2eace5d05b90",
"name": "MyFirstProject",
"url": "https://dev.azure.com/fabrikam/_apis/projects/3b046b6a-d070-4cd5-ad59-2eace5d05b90",
"state": "wellFormed",
"revision": 11,
"visibility": "private",
"defaultTeamImageUrl": null
},
"size": 0,
"remoteUrl": "https://dev.azure.com/fabrikam/MyFirstProject/_git/forkRepository",
"sshUrl": "git@ssh.dev.azure.com:v3/fabrikam/MyFirstProject/forkRepository",
"isFork": true,
"_links": {
"forkSyncOperation": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/76b510af-7910-4a96-9902-b978d6226bee/forkSyncRequests/8"
}
}
}
Create a fork of a parent repository syncing only the provided refs
Sample Request
POST https://dev.azure.com/{organization}/_apis/git/repositories?sourceRef=users/heads/master&api-version=7.1-preview.1
{
"name": "forkRepositoryWithOnlySourceRef",
"project": {
"id": "3b046b6a-d070-4cd5-ad59-2eace5d05b90"
},
"parentRepository": {
"id": "76b510af-7910-4a96-9902-b978d6226bee",
"project": {
"id": "3b046b6a-d070-4cd5-ad59-2eace5d05b90"
}
}
}
Sample Response
{
"id": "29230c30-9125-459b-a3f6-ffab329053bd",
"name": "forkRepositoryWithOnlySourceRef",
"url": "https://dev.azure.com/fabrikam/MyFirstProject/_apis/git/repositories/29230c30-9125-459b-a3f6-ffab329053bd",
"project": {
"id": "3b046b6a-d070-4cd5-ad59-2eace5d05b90",
"name": "MyFirstProject",
"url": "https://dev.azure.com/fabrikam/_apis/projects/3b046b6a-d070-4cd5-ad59-2eace5d05b90",
"state": "wellFormed",
"revision": 12,
"visibility": "private",
"defaultTeamImageUrl": null
},
"size": 0,
"remoteUrl": "https://dev.azure.com/fabrikam/MyFirstProject/_git/forkRepositoryWithOnlySourceRef",
"sshUrl": "git@ssh.dev.azure.com:v3/fabrikam/MyFirstProject/forkRepositoryWithOnlySourceRef",
"isFork": true,
"_links": {
"forkSyncOperation": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/29230c30-9125-459b-a3f6-ffab329053bd/forkSyncRequests/7"
}
}
}
Create a repository
Sample Request
POST https://dev.azure.com/fabrikam/_apis/git/repositories?api-version=7.1-preview.1
{
"name": "AnotherRepository",
"project": {
"id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c"
}
}
Sample Response
{
"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 |
|
isDisabled |
boolean |
True を指定すると、リポジトリが無効になります。 それ以外の場合は false です。 |
isFork |
boolean |
True を指定すると、リポジトリがフォークとして作成されます。 |
isInMaintenance |
boolean |
True を指定すると、リポジトリはメンテナンス中です。 それ以外の場合は false です。 |
name |
string |
|
parentRepository | ||
project |
TeamProject への浅い参照を表します。 |
|
remoteUrl |
string |
|
size |
integer |
リポジトリの圧縮サイズ (バイト)。 |
sshUrl |
string |
|
url |
string |
|
validRemoteUrls |
string[] |
|
webUrl |
string |
GitRepositoryCreateOptions
名前 | 型 | 説明 |
---|---|---|
name |
string |
|
parentRepository | ||
project |
TeamProject への浅い参照を表します。 |
GitRepositoryRef
名前 | 型 | 説明 |
---|---|---|
collection |
このフォークが存在するチーム プロジェクト コレクション |
|
id |
string |
|
isFork |
boolean |
リポジトリがフォークとして作成された場合は True |
name |
string |
|
project |
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
TeamProjectCollection の参照オブジェクト。
名前 | 型 | 説明 |
---|---|---|
avatarUrl |
string |
コレクションアバターの URL。 |
id |
string |
コレクション ID。 |
name |
string |
コレクション名。 |
url |
string |
コレクション REST URL。 |
TeamProjectReference
TeamProject への浅い参照を表します。
名前 | 型 | 説明 |
---|---|---|
abbreviation |
string |
プロジェクトの省略形。 |
defaultTeamImageUrl |
string |
既定のチーム ID イメージへの URL。 |
description |
string |
プロジェクトの説明 (存在する場合)。 |
id |
string |
プロジェクト識別子。 |
lastUpdateTime |
string |
プロジェクトの最終更新時刻。 |
name |
string |
プロジェクト名。 |
revision |
integer |
プロジェクトリビジョン。 |
state |
プロジェクトの状態。 |
|
url |
string |
オブジェクトの完全なバージョンへの URL。 |
visibility |
プロジェクトの可視性。 |