推送符號套件

您可以使用 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	套件太大。