Paket Simbol Dorong
Dimungkinkan untuk mendorong paket simbol (snupkg) menggunakan API NuGet V3.
Operasi ini didasarkan pada sumber daya yang SymbolPackagePublish
ditemukan dalam indeks layanan.
Penerapan versi
Nilai berikut @type
digunakan:
@type nilai | Catatan |
---|---|
SymbolPackagePublish/4.9.0 | Rilis awal |
URL Dasar
URL dasar untuk API berikut adalah nilai @id
properti SymbolPackagePublish/4.9.0
sumber daya dalam indeks layanan sumber paket. Untuk dokumentasi di bawah ini, URL nuget.org digunakan. Pertimbangkan https://www.nuget.org/api/v2/symbolpackage
sebagai tempat penampung untuk nilai yang @id
ditemukan dalam indeks layanan.
Metode HTTP
Metode PUT
HTTP didukung oleh sumber daya ini.
Mendorong paket simbol
nuget.org mendukung pendorongan format paket simbol baru (snupkg) menggunakan API berikut.
PUT https://www.nuget.org/api/v2/symbolpackage
Paket simbol dengan ID dan versi yang sama dapat dikirimkan beberapa kali. Paket simbol akan ditolak dalam kasus berikut.
- Paket dengan ID dan versi yang sama tidak ada.
- Paket simbol dengan ID dan versi yang sama didorong tetapi belum diterbitkan.
- Paket simbol (snupkg) tidak valid (lihat batasan paket simbol).
Parameter permintaan
Nama | Dalam | Jenis | Diperlukan | Catatan |
---|---|---|---|---|
X-NuGet-ApiKey | Header | string | yes | Misalnya: X-NuGet-ApiKey: {USER_API_KEY} |
Kunci API adalah string buram yang diperoleh dari sumber paket oleh pengguna dan dikonfigurasi ke klien. Tidak ada format string tertentu yang diamanatkan tetapi panjang kunci API tidak boleh melebihi ukuran yang wajar untuk nilai header HTTP.
Isi permintaan
Isi permintaan untuk dorongan simbol sama dengan isi permintaan permintaan push paket (lihat pendorongan dan penghapusan paket).
Respons
Kode status | Makna |
---|---|
201 | Paket simbol berhasil didorong. |
400 | Paket simbol yang disediakan tidak valid. |
401 | Pengguna tidak berwenang untuk melakukan tindakan ini. |
404 | Paket yang sesuai dengan ID dan versi yang disediakan tidak ada. |
409 | Paket simbol dengan ID dan versi yang disediakan didorong tetapi belum tersedia. |
413 | Paket terlalu besar. |