Artifact Details - Get Packages

Référence

Service:: Artifacts

Version d'API:: 7.1

Obtenez des détails sur tous les packages du flux. Utilisez les différents filtres pour inclure ou exclure des informations du jeu de résultats.

Le paramètre de projet doit être fourni si le flux a été créé dans un projet. Si le flux n’est associé à aucun projet, omettez le paramètre du projet de la demande.

GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/Feeds/{feedId}/packages?api-version=7.1

Avec des paramètres facultatifs:

GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/Feeds/{feedId}/packages?protocolType={protocolType}&packageNameQuery={packageNameQuery}&normalizedPackageName={normalizedPackageName}&includeUrls={includeUrls}&includeAllVersions={includeAllVersions}&isListed={isListed}&getTopPackageVersions={getTopPackageVersions}&isRelease={isRelease}&includeDescription={includeDescription}&$top={$top}&$skip={$skip}&includeDeleted={includeDeleted}&isCached={isCached}&directUpstreamId={directUpstreamId}&api-version=7.1

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
feedId	path	True	string	Nom ou ID du flux.
organization	path	True	string	Nom de l’organisation Azure DevOps.
project	path		string	ID de projet ou nom du projet
api-version	query	True	string	Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1 » pour utiliser cette version de l’API.
$skip	query		integer (int32)	Ignorez les premiers packages N (ou les versions de package où getTopPackageVersions=true)
$top	query		integer (int32)	Obtenir les principaux packages N (ou versions de package où getTopPackageVersions=true)
directUpstreamId	query		string (uuid)	Filtrez les résultats pour retourner des packages à partir d’un amont spécifique.
getTopPackageVersions	query		boolean	Modifie le comportement de $top et de $skip pour retourner toutes les versions de chaque package jusqu’à $top. Doit être utilisé conjointement avec includeAllVersions=true
includeAllVersions	query		boolean	True pour retourner toutes les versions du package dans la réponse. La valeur par défaut est false (version la plus récente uniquement).
includeDeleted	query		boolean	Retournez les versions supprimées ou non publiées des packages dans la réponse. La valeur par défaut est False.
includeDescription	query		boolean	Retourne la description de chaque version de chaque package dans la réponse. La valeur par défaut est False.
includeUrls	query		boolean	True pour retourner des URL REST avec la réponse. La valeur par défaut est True.
isCached	query		boolean	[Obsolète] Utilisé pour les scénarios hérités et peut être supprimé dans les versions ultérieures.
isListed	query		boolean	Applicable uniquement aux packages NuGet, sa définition pour d’autres types de packages entraîne un 404. Si la valeur est false, les versions de package délistées sont retournées. Utilisez cette option pour filtrer la réponse lorsque includeAllVersions a la valeur true. La valeur par défaut n’est pas définie (ne retournez pas de packages de liste).
isRelease	query		boolean	Applicable uniquement aux packages Nuget. Utilisez cette option pour filtrer la réponse lorsque includeAllVersions a la valeur true. La valeur par défaut est True (uniquement les packages de retour sans contrôle de version préliminaire).
normalizedPackageName	query		string	[Obsolète] Utilisé pour les scénarios hérités et peut être supprimé dans les versions ultérieures.
packageNameQuery	query		string	Filtrez les packages qui contiennent la chaîne fournie. Les caractères de la chaîne doivent être conformes aux contraintes de nom de package.
protocolType	query		string	Un des types de package d’artefacts pris en charge.

Réponses

Nom	Type	Description
200 OK	Package[]	opération réussie

Sécurité

oauth2

Type: oauth2
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Étendues

Nom	Description
vso.packaging	Accorde la possibilité de lire des flux et des packages. Accorde également la possibilité de rechercher des packages.

Définitions

Nom	Description
FeedView	Vue en haut d’un flux.
FeedViewType	Type d’affichage.
FeedVisibility	État de visibilité de la vue.
MinimalPackageVersion	Données de base sur n’importe quel package, y compris ses informations d’ID et de version et l’état de base.
Package	Un package, qui est un conteneur pour une ou plusieurs versions de package.
ReferenceLinks	Classe à représenter une collection de liens de référence REST.

FeedView

Object

Vue en haut d’un flux.

Nom	Type	Description
_links	ReferenceLinks	Liens REST connexes.
id	string (uuid)	ID de la vue.
name	string	Nom de la vue.
type	FeedViewType	Type d’affichage.
url	string	URL de la vue.
visibility	FeedVisibility	État de visibilité de la vue.

FeedViewType

Énumération

Type d’affichage.

Valeur	Description
implicit	Type d’affichage interne créé et géré automatiquement par le système.
none	Type d’affichage non spécifié par défaut.
release	Affichage utilisé comme destination de promotion pour classifier les artefacts publiés.

FeedVisibility

Énumération

État de visibilité de la vue.

Valeur	Description
aadTenant	Le flux est accessible par tous les utilisateurs valides présents dans le locataire Azure Active Directory.
collection	Le flux est accessible par tous les utilisateurs valides présents dans l’organisation où réside le flux (par exemple, dans l’ensemble de l’organisation « myorg » à « dev.azure.com/myorg »)
organization	Le flux est accessible par tous les utilisateurs valides présents dans l’entreprise où réside le flux. Notez que l’attribution de noms héritée et le rétrocompte laisse le nom de cette valeur hors de synchronisation avec sa nouvelle signification.
private	Accessible uniquement par les autorisations définies explicitement par l’administrateur de flux.

MinimalPackageVersion

Object

Données de base sur n’importe quel package, y compris ses informations d’ID et de version et l’état de base.

Nom	Type	Description
directUpstreamSourceId	string (uuid)	Source en amont à partir de laquelle ce package a été ingéré.
id	string (uuid)	ID du package.
isCachedVersion	boolean	[Obsolète] Utilisé pour les scénarios hérités et peut être supprimé dans les versions ultérieures.
isDeleted	boolean	True si ce package a été supprimé.
isLatest	boolean	True s’il s’agit de la dernière version du package par ordre de tri de type de package.
isListed	boolean	(NuGet et Cargo uniquement) True si ce package est répertorié.
normalizedVersion	string	Version normalisée à l’aide de règles de normalisation spécifiques à un type de package.
packageDescription	string	Description du package.
publishDate	string (date-time)	Date UTC que le package a été publié sur le service.
storageId	string	ID de stockage interne.
version	string	Afficher la version.
views	FeedView[]	Liste des vues contenant cette version de package.

Package

Object

Un package, qui est un conteneur pour une ou plusieurs versions de package.

Nom	Type	Description
_links	ReferenceLinks	Liens REST connexes.
id	string (uuid)	ID du package.
isCached	boolean	Utilisé pour les scénarios hérités et peut être supprimé dans les versions ultérieures.
name	string	Nom complet du package.
normalizedName	string	Nom normalisé représentant l’identité de ce package dans son type de package.
protocolType	string	Type du package.
starCount	integer (int32)	[Obsolète] : ce champ n’est pas utilisé et sera supprimé dans une prochaine version.
url	string	URL de ce package.
versions	MinimalPackageVersion[]	Toutes les versions de ce package dans son flux.

ReferenceLinks

Object

Classe à représenter une collection de liens de référence REST.

Nom	Type	Description
links	object	Vue en lecture seule des liens. Étant donné que les liens de référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.