Bagikan melalui


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.