Feed Management - Create Feed
Buat umpan, kontainer untuk berbagai jenis paket.
Umpan dapat dibuat dalam proyek jika parameter proyek disertakan dalam url permintaan. Jika parameter proyek dihilangkan, umpan tidak akan dikaitkan dengan proyek dan akan dibuat di tingkat organisasi. Membuat umpan cakupan proyek sedang dalam prarilis, dan mungkin belum tersedia di organisasi Anda.
POST https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds?api-version=5.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 '5.1-preview.1' untuk menggunakan versi api ini. |
Isi Permintaan
| Nama | Jenis | Deskripsi |
|---|---|---|
| _links |
Tautan REST terkait. |
|
| badgesEnabled |
boolean |
Jika diatur, umpan ini mendukung pembuatan lencana paket. |
| capabilities |
Kemampuan umpan yang didukung. |
|
| defaultViewId |
string |
Tampilan yang ditunjukkan administrator umpan adalah pengalaman default untuk pembaca. |
| deletedDate |
string |
Tanggal saat umpan ini dihapus. |
| description |
string |
Deskripsi untuk umpan. Deskripsi tidak boleh melebihi 255 karakter. |
| fullyQualifiedId |
string |
Ini akan menjadi GUID umpan atau GUID umpan dan melihat GUID tergantung pada bagaimana umpan diakses. |
| fullyQualifiedName |
string |
Nama lengkap tampilan, dalam format feed@view. |
| hideDeletedPackageVersions |
boolean |
Jika diatur, umpan akan menyembunyikan semua versi yang dihapus/tidak diterbitkan |
| id |
string |
GUID yang secara unik mengidentifikasi umpan ini. |
| isReadOnly |
boolean |
Jika diatur, semua paket dalam umpan tidak dapat diubah. Penting untuk dicatat bahwa tampilan umpan tidak dapat diubah; oleh karena itu, bendera ini akan selalu diatur untuk tampilan. |
| name |
string |
Nama untuk umpan. nama umpan harus mengikuti aturan ini: Tidak boleh melebihi 64 karakter Tidak boleh berisi spasi kosong Tidak boleh dimulai dengan garis bawah atau titikTidak boleh diakhapi dengan titik Tidak boleh berisi salah satu karakter ilegal berikut: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]> |
| permissions |
Izin eksplisit untuk umpan. |
|
| project |
Proyek yang dikaitkan dengan umpan ini. |
|
| upstreamEnabled |
boolean |
KEDALUARSA: Ini harus selalu benar. Pengaturan ke false akan mengambil alih semua sumber di UpstreamSources. |
| upstreamEnabledChangedDate |
string |
Jika diatur, waktu properti UpstreamEnabled diubah. Akan null jika UpstreamEnabled tidak pernah diubah setelah pembuatan Umpan. |
| upstreamSources |
Daftar sumber asal umpan ini akan mengambil paket. Daftar kosong menunjukkan bahwa umpan ini tidak akan mencari sumber tambahan untuk paket. |
|
| url |
string |
URL umpan dasar dalam bentuk GUID. |
| view |
Definisi tampilan. |
|
| viewId |
string |
Lihat Id. |
| viewName |
string |
Lihat nama. |
Respons
| Nama | Jenis | Deskripsi |
|---|---|---|
| 200 OK |
operasi berhasil |
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.packaging_write | Memberikan kemampuan untuk membuat dan membaca umpan dan paket. |
Definisi
| Nama | Deskripsi |
|---|---|
| Feed |
Kontainer untuk artefak. |
|
Feed |
Kemampuan umpan yang didukung. |
|
Feed |
Izin untuk umpan. |
|
Feed |
Peran untuk identitas ini pada umpan. |
|
Feed |
Tampilan di atas umpan. |
|
Feed |
Jenis tampilan. |
|
Feed |
Status visibilitas tampilan. |
|
Identity |
Deskriptor identitas adalah pembungkus untuk jenis identitas (Windows SID, Paspor) bersama dengan pengidentifikasi unik seperti SID atau PUID. |
|
Project |
|
|
Reference |
Kelas untuk mewakili kumpulan tautan referensi REST. |
|
Upstream |
Definisi sumber hulu, termasuk Identitas, jenis paket, dan informasi terkait lainnya. |
|
Upstream |
Jenis sumber, seperti Publik atau Internal. |
Feed
Kontainer untuk artefak.
| Nama | Jenis | Deskripsi |
|---|---|---|
| _links |
Tautan REST terkait. |
|
| badgesEnabled |
boolean |
Jika diatur, umpan ini mendukung pembuatan lencana paket. |
| capabilities |
Kemampuan umpan yang didukung. |
|
| defaultViewId |
string |
Tampilan yang ditunjukkan administrator umpan adalah pengalaman default untuk pembaca. |
| deletedDate |
string |
Tanggal saat umpan ini dihapus. |
| description |
string |
Deskripsi untuk umpan. Deskripsi tidak boleh melebihi 255 karakter. |
| fullyQualifiedId |
string |
Ini akan menjadi GUID umpan atau GUID umpan dan melihat GUID tergantung pada bagaimana umpan diakses. |
| fullyQualifiedName |
string |
Nama lengkap tampilan, dalam format feed@view. |
| hideDeletedPackageVersions |
boolean |
Jika diatur, umpan akan menyembunyikan semua versi yang dihapus/tidak diterbitkan |
| id |
string |
GUID yang secara unik mengidentifikasi umpan ini. |
| isReadOnly |
boolean |
Jika diatur, semua paket dalam umpan tidak dapat diubah. Penting untuk dicatat bahwa tampilan umpan tidak dapat diubah; oleh karena itu, bendera ini akan selalu diatur untuk tampilan. |
| name |
string |
Nama untuk umpan. nama umpan harus mengikuti aturan ini: Tidak boleh melebihi 64 karakter Tidak boleh berisi spasi kosong Tidak boleh dimulai dengan garis bawah atau titikTidak Boleh diakhapi dengan titik Tidak boleh berisi salah satu karakter ilegal berikut: , , |, /, \\, ?, :, &, $, *, \", #, [, ] ]> |
| permissions |
Izin eksplisit untuk umpan. |
|
| project |
Proyek yang dikaitkan dengan umpan ini. |
|
| upstreamEnabled |
boolean |
USANG: Ini harus selalu benar. Pengaturan ke false akan menimpa semua sumber di UpstreamSources. |
| upstreamEnabledChangedDate |
string |
Jika diatur, waktu properti UpstreamEnabled diubah. Akan null jika UpstreamEnabled tidak pernah diubah setelah pembuatan Umpan. |
| upstreamSources |
Daftar sumber asal umpan ini akan mengambil paket. Daftar kosong menunjukkan bahwa umpan ini tidak akan mencari sumber tambahan untuk paket. |
|
| url |
string |
URL umpan dasar dalam bentuk GUID. |
| view |
Definisi tampilan. |
|
| viewId |
string |
Lihat Id. |
| viewName |
string |
Lihat nama. |
FeedCapabilities
Kemampuan umpan yang didukung.
| Nama | Jenis | Deskripsi |
|---|---|---|
| defaultCapabilities |
string |
Kemampuan yang diberikan ke umpan yang baru dibuat |
| none |
string |
Tidak ada bendera untuk umpan ini |
| underMaintenance |
string |
Umpan ini sedang dalam pemeliharaan dan mungkin memiliki fungsionalitas yang berkurang |
| upstreamV2 |
string |
Umpan ini dapat melayani paket dari sumber hulu paket Upstream harus dipromosikan secara manual ke tampilan |
FeedPermission
Izin untuk umpan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| displayName |
string |
Nama tampilan untuk identitas. |
| identityDescriptor |
Identitas yang terkait dengan peran ini. |
|
| identityId |
string |
Id identitas yang terkait dengan peran ini. |
| role |
Peran untuk identitas ini pada umpan. |
FeedRole
Peran untuk identitas ini pada umpan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| administrator |
string |
Administrator memiliki kontrol penuh atas umpan. |
| collaborator |
string |
Kolaborator memiliki izin yang sama dengan pembaca, tetapi juga dapat menyerap paket dari sumber hulu yang dikonfigurasi. |
| contributor |
string |
Kontributor dapat melakukan apa pun untuk paket dalam umpan termasuk menambahkan paket baru, tetapi mungkin tidak mengubah pengaturan umpan. |
| custom |
string |
Tidak didukung. |
| none |
string |
Tidak didukung. |
| reader |
string |
Pembaca hanya dapat membaca paket dan melihat pengaturan. |
FeedView
Tampilan di atas umpan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| _links |
Tautan REST terkait. |
|
| id |
string |
Id tampilan. |
| name |
string |
Nama tampilan. |
| type |
Jenis tampilan. |
|
| url |
string |
Url tampilan. |
| visibility |
Status visibilitas tampilan. |
FeedViewType
Jenis tampilan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| implicit |
string |
Jenis tampilan internal yang secara otomatis dibuat dan dikelola oleh sistem. |
| none |
string |
Jenis tampilan default yang tidak ditentukan. |
| release |
string |
Lihat yang digunakan sebagai tujuan promosi untuk mengklasifikasikan artefak yang dirilis. |
FeedVisibility
Status visibilitas tampilan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| collection |
string |
Umpan dapat diakses oleh semua pengguna valid yang ada di organisasi tempat umpan berada (misalnya di seluruh organisasi 'myorg' di 'dev.azure.com/myorg') |
| organization |
string |
Umpan dapat diakses oleh semua pengguna valid yang ada di perusahaan tempat umpan berada. Perhatikan bahwa penamaan warisan dan back compat meninggalkan nama nilai ini tidak sinkron dengan arti barunya. |
| private |
string |
Hanya dapat diakses oleh izin yang secara eksplisit diatur oleh administrator umpan. |
IdentityDescriptor
Deskriptor identitas adalah pembungkus untuk jenis identitas (Windows SID, Paspor) bersama dengan pengidentifikasi unik seperti SID atau PUID.
| Nama | Jenis | Deskripsi |
|---|---|---|
| identifier |
string |
Pengidentifikasi unik untuk identitas ini, tidak melebihi 256 karakter, yang akan dipertahankan. |
| identityType |
string |
Jenis deskriptor (misalnya, Windows, Paspor, dll.). |
ProjectReference
| Nama | Jenis | Deskripsi |
|---|---|---|
| id |
string |
Mendapatkan atau menetapkan id proyek. |
| name |
string |
Mendapatkan atau menetapkan nama proyek. |
| visibility |
string |
Mendapatkan atau mengatur visibilitas proyek. |
ReferenceLinks
Kelas untuk mewakili kumpulan tautan referensi REST.
| Nama | Jenis | Deskripsi |
|---|---|---|
| links |
object |
Tampilan baca-saja dari tautan. Karena tautan Referensi dibaca saja, kami hanya ingin mengeksposnya sebagai baca-saja. |
UpstreamSource
Definisi sumber hulu, termasuk Identitas, jenis paket, dan informasi terkait lainnya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| deletedDate |
string |
Tanggal UTC bahwa upstream ini dihapus. |
| displayLocation |
string |
Pencari lokasi untuk menyambungkan ke sumber hulu dalam format yang mudah digunakan, yang mungkin berpotensi berubah dari waktu ke waktu |
| id |
string |
Identitas sumber hulu. |
| internalUpstreamCollectionId |
string |
Untuk jenis upstream internal, lacak organisasi Azure DevOps yang berisinya. |
| internalUpstreamFeedId |
string |
Untuk jenis upstream internal, lacak id umpan yang sedang dirujuk. |
| internalUpstreamViewId |
string |
Untuk jenis upstream internal, lacak tampilan umpan yang dirujuk. |
| location |
string |
Pencari lokasi yang konsisten untuk menyambungkan ke sumber hulu. |
| name |
string |
Nama tampilan. |
| protocol |
string |
Jenis paket yang terkait dengan sumber upstream. |
| upstreamSourceType |
Jenis sumber, seperti Publik atau Internal. |
UpstreamSourceType
Jenis sumber, seperti Publik atau Internal.
| Nama | Jenis | Deskripsi |
|---|---|---|
| internal |
string |
Sumber upstream Azure DevOps. |
| public |
string |
Sumber yang tersedia untuk umum. |
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