Feed Management - Create Feed

Service:

Artifacts

API Version:

7.1-preview.1

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.

POST https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds?api-version=7.1-preview.1

Parameter 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.

Isi Permintaan

Nama	Jenis	Deskripsi
_links	ReferenceLinks	Tautan REST terkait.
badgesEnabled	boolean	Jika diatur, umpan ini mendukung pembuatan lencana paket.
capabilities	FeedCapabilities	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: , , |, /, \\, ?, :, &, $, *, \", #, [, ] ]>
permanentDeletedDate	string	Tanggal saat umpan ini dihapus secara permanen.
permissions	FeedPermission[]	Izin eksplisit untuk umpan.
project	ProjectReference	Proyek yang dikaitkan dengan umpan ini.
scheduledPermanentDeleteDate	string	Tanggal umpan ini dijadwalkan untuk dihapus secara permanen.
upstreamEnabled	boolean	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	UpstreamSource[]	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	FeedView	Definisi tampilan.
viewId	string	Lihat Id.
viewName	string	Lihat nama.

Respons

Nama	Jenis	Deskripsi
200 OK	Feed	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.
FeedCapabilities	Kemampuan umpan yang didukung.
FeedPermission	Izin untuk umpan.
FeedRole	Peran untuk identitas ini pada umpan.
FeedView	Tampilan di atas umpan.
FeedViewType	Jenis tampilan.
FeedVisibility	Status visibilitas tampilan.
IdentityDescriptor	Deskriptor identitas adalah pembungkus untuk jenis identitas (Windows SID, Paspor) bersama dengan pengidentifikasi unik seperti SID atau PUID.
ProjectReference
ReferenceLinks	Kelas untuk mewakili kumpulan tautan referensi REST.
UpstreamSource	Definisi sumber upstream, termasuk Identitas, jenis paket, dan informasi terkait lainnya.
UpstreamSourceType	Jenis sumber, seperti Publik atau Internal.
UpstreamStatus	Menentukan status upstream.
UpstreamStatusDetail

Feed

Kontainer untuk artefak.

Nama	Jenis	Deskripsi
_links	ReferenceLinks	Tautan REST terkait.
badgesEnabled	boolean	Jika diatur, umpan ini mendukung pembuatan lencana paket.
capabilities	FeedCapabilities	Kemampuan umpan yang didukung.
defaultViewId	string	Tampilan yang ditunjukkan administrator umpan adalah pengalaman default bagi 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: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]>
permanentDeletedDate	string	Tanggal saat umpan ini dihapus secara permanen.
permissions	FeedPermission[]	Izin eksplisit untuk umpan.
project	ProjectReference	Proyek yang dikaitkan dengan umpan ini.
scheduledPermanentDeleteDate	string	Tanggal saat umpan ini dijadwalkan untuk dihapus secara permanen.
upstreamEnabled	boolean	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	UpstreamSource[]	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	FeedView	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 saat 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	IdentityDescriptor	Identitas yang terkait dengan peran ini.
identityId	string	Id identitas yang terkait dengan peran ini.
isInheritedRole	boolean	Boolean menunjukkan apakah peran tersebut diwariskan atau diatur secara langsung.
role	FeedRole	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 saja untuk paket dalam umpan termasuk menambahkan paket baru, tetapi mereka 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	ReferenceLinks	Tautan REST terkait.
id	string	Id tampilan.
name	string	Nama tampilan.
type	FeedViewType	Jenis tampilan.
url	string	Url tampilan.
visibility	FeedVisibility	Status visibilitas tampilan.

FeedViewType

Jenis tampilan.

Nama	Jenis	Deskripsi
implicit	string	Jenis tampilan internal yang secara otomatis dibuat dan dikelola oleh sistem.
none	string	Tipe 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
aadTenant	string	Umpan dapat diakses oleh semua pengguna yang valid yang ada di penyewa Azure Active Directory.
collection	string	Umpan dapat diakses oleh semua pengguna yang 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 yang 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 ditetapkan 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 mengatur 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 bersifat baca-saja, kami hanya ingin mengeksposnya sebagai baca saja.

UpstreamSource

Definisi sumber upstream, 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 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.
internalUpstreamProjectId	string	Untuk jenis upstream internal, lacak proyek umpan yang 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.
serviceEndpointId	string	Identitas titik akhir layanan yang menyimpan kredensial untuk digunakan saat mengakses upstram.
serviceEndpointProjectId	string	Menentukan projectId dari Titik Akhir Layanan.
status	UpstreamStatus	Menentukan status upstream.
statusDetails	UpstreamStatusDetail[]	Memberikan alasan yang dapat dibaca manusia untuk status hulu.
upstreamSourceType	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.

UpstreamStatus

Menentukan status upstream.

Nama	Jenis	Deskripsi
disabled	string	Sumber upstram dinonaktifkan.
ok	string	Sumber hulu baik-baik saja.

UpstreamStatusDetail

Nama	Jenis	Deskripsi
reason	string	Memberikan alasan yang dapat dibaca manusia untuk status hulu.