title | author | ms.author | manager | ms.date | ms.topic | ms.prod | ms.technology | description | keywords | ms.reviewer | ms.openlocfilehash | ms.sourcegitcommit | ms.translationtype | ms.contentlocale | ms.lasthandoff | ms.locfileid |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Packages Push Symbol, API NuGet | Microsoft Docs |
cristinamanum |
cmanu |
skofman |
10/30/2018 |
reference |
nuget |
Le service de publication permet aux clients de publier de nouveaux packages de symboles. |
Package de symboles push de l’API NuGet |
karann |
91bb4c9ca77fd7f1ff35831e02eb4f9d65d641c5 |
ee6c3f203648a5561c809db54ebeb1d0f0598b68 |
MT |
fr-FR |
01/26/2021 |
98773896 |
Il est possible d’envoyer des packages de symboles (snupkg) à l’aide de l’API NuGet v3.
Ces opérations sont basées sur la SymbolPackagePublish
ressource trouvée dans l' index de service.
La @type
valeur suivante est utilisée :
Valeur @type | Notes |
---|---|
SymbolPackagePublish/4.9.0 | La version initiale |
L’URL de base pour les API suivantes est la valeur de la @id
propriété de la SymbolPackagePublish/4.9.0
ressource dans l’index de servicede la source du package. Pour la documentation ci-dessous, l’URL de NuGet. org est utilisée. Considérez https://www.nuget.org/api/v2/symbolpackage
comme un espace réservé pour la @id
valeur trouvée dans l’index de service.
La PUT
méthode http est prise en charge par cette ressource.
nuget.org prend en charge l’envoi d’un nouveau format de packages de symboles (snupkg) à l’aide de l’API suivante.
PUT https://www.nuget.org/api/v2/symbolpackage
Les packages de symboles avec le même ID et la même version peuvent être envoyés plusieurs fois. Un package de symboles sera rejeté dans les cas suivants.
- Un package ayant le même ID et la même version n’existe pas.
- Un package de symboles avec le même ID et la même version a fait l’objet d’un push, mais n’est pas encore publié.
- Le package de symboles (snupkg) n’est pas valide (consultez contraintes de package de symboles).
Nom | Dans | Type | Obligatoire | Notes |
---|---|---|---|---|
X-NuGet-ApiKey | En-tête | string | Oui | Par exemple : X-NuGet-ApiKey: {USER_API_KEY} |
La clé API est une chaîne opaque obtenue à partir de la source du package par l’utilisateur et configurée dans le client. Aucun format de chaîne particulier n’est mandaté, mais la longueur de la clé API ne doit pas dépasser une taille raisonnable pour les valeurs d’en-tête HTTP.
Le corps de la demande pour la notification push de symbole est le même que le corps de la demande d’une demande push de package (voir push et suppression de packages).
Code d’état | Signification |
---|---|
201 | Le package de symboles a été correctement poussé. |
400 | Le package de symboles fourni n’est pas valide. |
401 | L’utilisateur n’est pas autorisé à effectuer cette action. |
404 | Un package correspondant avec l’ID et la version fournis n’existe pas. |
409 | Un package de symboles avec l’ID et la version fournis a été envoyé, mais il n’est pas encore disponible. |
413 | Le package est trop volumineux. |