Condividi tramite

Pacchetti di simboli push

  • Articolo

È possibile eseguire il push dei pacchetti di simboli (snupkg) usando l'API NuGet V3. Queste operazioni sono basate sulla SymbolPackagePublish risorsa presente nell'indice del servizio.

Controllo delle versioni

Viene usato il valore seguente @type :

Valore @type Note
SymbolPackagePublish/4.9.0 Versione iniziale

URL di base

L'URL di base per le API seguenti è il valore della @id proprietà della SymbolPackagePublish/4.9.0 risorsa nell'indice del servizio dell'origine del pacchetto. Per la documentazione seguente, viene usato l'URL di nuget.org. Si consideri https://www.nuget.org/api/v2/symbolpackage un segnaposto per il @id valore trovato nell'indice del servizio.

Metodi HTTP

Il PUT metodo HTTP è supportato da questa risorsa.

Eseguire il push di un pacchetto di simboli

nuget.org supporta il push del nuovo formato di pacchetti di simboli (snupkg) usando l'API seguente.

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

I pacchetti di simboli con lo stesso ID e la stessa versione possono essere inviati più volte. Un pacchetto di simboli verrà rifiutato nei casi seguenti.

  • Un pacchetto con lo stesso ID e la stessa versione non esiste.
  • È stato eseguito il push di un pacchetto di simboli con lo stesso ID e la stessa versione, ma non è ancora stato pubblicato.
  • Il pacchetto di simboli (snupkg) non è valido (vedere vincoli del pacchetto di simboli).

Parametri della richiesta

Nome Tra Type Obbligatorio Note
X-NuGet-ApiKey Intestazione string yes Ad esempio, X-NuGet-ApiKey: {USER_API_KEY}

La chiave API è una stringa opaca ottenuta dall'origine del pacchetto dall'utente e configurata nel client. Non viene richiesto alcun formato stringa specifico, ma la lunghezza della chiave API non deve superare una dimensione ragionevole per i valori di intestazione HTTP.

Corpo della richiesta

Il corpo della richiesta per il push dei simboli è uguale al corpo della richiesta di una richiesta push del pacchetto (vedere push ed eliminazione del pacchetto).

Response

Codice di stato Significato
201 Il push del pacchetto di simboli è stato eseguito correttamente.
400 Il pacchetto di simboli specificato non è valido.
401 L'utente non è autorizzato a eseguire questa azione.
404 Un pacchetto corrispondente con l'ID e la versione specificati non esiste.
409 È stato eseguito il push di un pacchetto di simboli con l'ID e la versione specificati, ma non è ancora disponibile.
413 Il pacchetto è troppo grande.