共用方式為


推送符號套件

您可以使用 NuGet V3 API 推送符號套件(snupkg)。 這些作業是以SymbolPackagePublish服務索引中找到的資源為基礎。

版本控制

使用下列 @type 值:

@type 值 備註
SymbolPackagePublish/4.9.0 初始版本

基礎 URL

下列 API 的基底 URL 是@id套件來源服務索引中資源的 屬性值SymbolPackagePublish/4.9.0。 針對下列檔,會使用 nuget.org 的URL。 請考慮 https://www.nuget.org/api/v2/symbolpackage 作為服務索引中找到值的佔位元 @id

HTTP 方法

PUT此資源支援 HTTP 方法。

推送符號套件

nuget.org 支援使用下列 API 推送新的符號套件格式(snupkg)。

PUT https://www.nuget.org/api/v2/symbolpackage

具有相同標識碼和版本的符號套件可以多次提交。 在下列情況下,符號套件將會遭到拒絕。

  • 具有相同標識碼和版本的套件不存在。
  • 已推送具有相同標識碼和版本的符號套件,但尚未發佈。
  • 符號套件 (snupkg) 無效(請參閱 符號套件條件約束)。

要求參數

名稱 位於 類型 必要 備註
X-NuGet-ApiKey 標頭 string 例如,X-NuGet-ApiKey: {USER_API_KEY}

API 金鑰是使用者從套件來源取得的不透明字串,並設定至用戶端。 未強制使用特定的字串格式,但 API 金鑰的長度不應超過 HTTP 標頭值的合理大小。

要求本文

符號推送的要求本文與套件推送要求的要求本文相同(請參閱 套件推送和刪除)。

回應

狀態碼 意義
201 符號套件已成功推送。
400 提供的符號套件無效。
401 用戶無權執行此動作。
404 具有所提供標識碼和版本的對應套件不存在。
409 已推送具有所提供標識碼和版本的符號套件,但尚無法使用。
413 套件太大。