Repositories - Create
Buat repositori git dalam proyek tim.
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1-preview.1POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories?sourceRef={sourceRef}&api-version=7.1-preview.1Parameter URI
| Nama | Dalam | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Nama organisasi Azure DevOps. |
|
project
|
path |
string |
ID proyek atau nama proyek |
|
|
api-version
|
query | True |
string |
Versi API yang akan digunakan. Ini harus diatur ke '7.1-preview.1' untuk menggunakan versi api ini. |
|
source
|
query |
string |
[opsional] Tentukan refs sumber yang akan digunakan saat membuat repositori fork |
Isi Permintaan
| Nama | Jenis | Deskripsi |
|---|---|---|
| name |
string |
|
| parentRepository | ||
| project |
Mewakili referensi dangkal ke TeamProject. |
Respons
| Nama | Jenis | Deskripsi |
|---|---|---|
| 201 Created |
Dibuat |
Keamanan
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
| Nama | Deskripsi |
|---|---|
| vso.code_manage | Memberikan kemampuan untuk membaca, memperbarui, dan menghapus kode sumber, mengakses metadata tentang penerapan, set perubahan, cabang, dan artefak kontrol versi lainnya. Juga memberikan kemampuan untuk membuat dan mengelola repositori kode, membuat dan mengelola permintaan pull dan ulasan kode, dan untuk menerima pemberitahuan tentang peristiwa kontrol versi melalui hook layanan. |
Contoh
| 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"
}Definisi
| Nama | Deskripsi |
|---|---|
|
Git |
|
|
Git |
|
|
Git |
|
|
Project |
Status proyek. |
|
Project |
Visibilitas proyek. |
|
Reference |
Kelas untuk mewakili kumpulan tautan referensi REST. |
|
Team |
Objek referensi untuk TeamProjectCollection. |
|
Team |
Mewakili referensi dangkal ke TeamProject. |
GitRepository
| Nama | Jenis | Deskripsi |
|---|---|---|
| _links |
Kelas untuk mewakili kumpulan tautan referensi REST. |
|
| defaultBranch |
string |
|
| id |
string |
|
| isDisabled |
boolean |
True jika repositori dinonaktifkan. Salah jika tidak. |
| isFork |
boolean |
True jika repositori dibuat sebagai fork. |
| isInMaintenance |
boolean |
True jika repositori sedang dalam pemeliharaan. Salah jika tidak. |
| name |
string |
|
| parentRepository | ||
| project |
Mewakili referensi dangkal ke TeamProject. |
|
| remoteUrl |
string |
|
| size |
integer |
Ukuran terkompresi (byte) repositori. |
| sshUrl |
string |
|
| url |
string |
|
| validRemoteUrls |
string[] |
|
| webUrl |
string |
GitRepositoryCreateOptions
| Nama | Jenis | Deskripsi |
|---|---|---|
| name |
string |
|
| parentRepository | ||
| project |
Mewakili referensi dangkal ke TeamProject. |
GitRepositoryRef
| Nama | Jenis | Deskripsi |
|---|---|---|
| collection |
Kumpulan Proyek Tim tempat Fork ini berada |
|
| id |
string |
|
| isFork |
boolean |
True jika repositori dibuat sebagai fork |
| name |
string |
|
| project |
Mewakili referensi dangkal ke TeamProject. |
|
| remoteUrl |
string |
|
| sshUrl |
string |
|
| url |
string |
ProjectState
Status proyek.
| Nama | Jenis | Deskripsi |
|---|---|---|
| all |
string |
Semua proyek terlepas dari status kecuali Dihapus. |
| createPending |
string |
Proyek telah diantrekan untuk pembuatan, tetapi prosesnya belum dimulai. |
| deleted |
string |
Proyek telah dihapus. |
| deleting |
string |
Proyek sedang dalam proses dihapus. |
| new |
string |
Proyek sedang dalam proses dibuat. |
| unchanged |
string |
Proyek belum diubah. |
| wellFormed |
string |
Proyek benar-benar dibuat dan siap digunakan. |
ProjectVisibility
Visibilitas proyek.
| Nama | Jenis | Deskripsi |
|---|---|---|
| private |
string |
Proyek ini hanya terlihat oleh pengguna dengan akses eksplisit. |
| public |
string |
Proyek ini terlihat oleh semua. |
ReferenceLinks
Kelas untuk mewakili kumpulan tautan referensi REST.
| Nama | Jenis | Deskripsi |
|---|---|---|
| links |
object |
Tampilan baca-saja dari tautan. Karena tautan Referensi bersifat baca-saja, kami hanya ingin mengeksposnya sebagai baca-saja. |
TeamProjectCollectionReference
Objek referensi untuk TeamProjectCollection.
| Nama | Jenis | Deskripsi |
|---|---|---|
| avatarUrl |
string |
Url avatar koleksi. |
| id |
string |
Id Koleksi. |
| name |
string |
Nama Koleksi. |
| url |
string |
Url REST Koleksi. |
TeamProjectReference
Mewakili referensi dangkal ke TeamProject.
| Nama | Jenis | Deskripsi |
|---|---|---|
| abbreviation |
string |
Singkatan proyek. |
| defaultTeamImageUrl |
string |
Url ke gambar identitas tim default. |
| description |
string |
Deskripsi proyek (jika ada). |
| id |
string |
Pengidentifikasi proyek. |
| lastUpdateTime |
string |
Waktu pembaruan terakhir proyek. |
| name |
string |
Nama proyek. |
| revision |
integer |
Revisi proyek. |
| state |
Status proyek. |
|
| url |
string |
Url ke versi lengkap objek. |
| visibility |
Visibilitas proyek. |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk