Artifact Details - Get Packages

Referenz

Dienst:: Artifacts

API-Version:: 7.1

Rufen Sie Details zu allen Paketen im Feed ab. Verwenden Sie die verschiedenen Filter, um Informationen aus dem Resultset einzuschließen oder auszuschließen.

Der Projektparameter muss angegeben werden, wenn der Feed in einem Projekt erstellt wurde. Wenn der Feed keinem Projekt zugeordnet ist, lassen Sie den Projektparameter aus der Anforderung aus.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
feedId	path	True	string	Name oder ID des Feeds.
organization	path	True	string	Der Name der Azure DevOps-Organisation.
project	path		string	Projekt-ID oder Projektname
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.1" festgelegt werden, um diese Version der API zu verwenden.
$skip	query		integer (int32)	Überspringen Sie die ersten N-Pakete (oder Paketversionen, bei denen getTopPackageVersions=true)
$top	query		integer (int32)	Abrufen der wichtigsten N-Pakete (oder Paketversionen, bei denen getTopPackageVersions=true)
directUpstreamId	query		string (uuid)	Filtert Ergebnisse, um Pakete aus einem bestimmten Upstream zurückzugeben.
getTopPackageVersions	query		boolean	Ändert das Verhalten von $top und $skip, um alle Versionen jedes Pakets bis zu $top zurückzugeben. Muss in Verbindung mit includeAllVersions=true verwendet werden.
includeAllVersions	query		boolean	True, um alle Versionen des Pakets in der Antwort zurückzugeben. Der Standardwert ist "false" (nur neueste Version).
includeDeleted	query		boolean	Gibt gelöschte oder nicht veröffentlichte Versionen von Paketen in der Antwort zurück. Der Standardwert ist "False".
includeDescription	query		boolean	Gibt die Beschreibung für jede Version jedes Pakets in der Antwort zurück. Der Standardwert ist "False".
includeUrls	query		boolean	True, um REST-URLs mit der Antwort zurückzugeben. Der Standardwert ist True.
isCached	query		boolean	[Veraltet] Wird für Legacyszenarien verwendet und kann in zukünftigen Versionen entfernt werden.
isListed	query		boolean	Nur für NuGet-Pakete anwendbar, führt die Einstellung für andere Pakettypen zu einem 404. Wenn "false" zurückgegeben wird, werden nicht aufgelistete Paketversionen zurückgegeben. Verwenden Sie diese Option, um die Antwort zu filtern, wenn includeAllVersions auf "true" festgelegt ist. Der Standardwert ist nicht festgelegt (keine nicht aufgelisteten Pakete zurückgeben).
isRelease	query		boolean	Gilt nur für Nuget-Pakete. Verwenden Sie diese Option, um die Antwort zu filtern, wenn includeAllVersions auf "true" festgelegt ist. Der Standardwert ist True (nur Rückgabepakete ohne Vorabversionsverwaltung).
normalizedPackageName	query		string	[Veraltet] Wird für Legacyszenarien verwendet und kann in zukünftigen Versionen entfernt werden.
packageNameQuery	query		string	Filtern Sie nach Paketen, die die bereitgestellte Zeichenfolge enthalten. Zeichen in der Zeichenfolge müssen den Paketnameneinschränkungen entsprechen.
protocolType	query		string	Einer der unterstützten Artefaktpakettypen.

Antworten

Name	Typ	Beschreibung
200 OK	Package[]	Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token-URL: 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

Bereiche

Name	Beschreibung
vso.packaging	Gewährt die Möglichkeit, Feeds und Pakete zu lesen. Gewährt auch die Möglichkeit, Pakete zu durchsuchen.

Definitionen

Name	Beschreibung
FeedView	Eine Ansicht über einem Feed.
FeedViewType	Ansichtstyp.
FeedVisibility	Sichtbarkeitsstatus der Ansicht.
MinimalPackageVersion	Kerndaten zu allen Paketen, einschließlich der ID und Versionsinformationen und des Grundlegenden Zustands.
Package	Ein Paket, bei dem es sich um einen Container für eine oder mehrere Paketversionen handelt.
ReferenceLinks	Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

FeedView

Objekt

Eine Ansicht über einem Feed.

Name	Typ	Beschreibung
_links	ReferenceLinks	Verwandte REST-Links.
id	string (uuid)	ID der Ansicht.
name	string	Name der Ansicht.
type	FeedViewType	Ansichtstyp.
url	string	URL der Ansicht.
visibility	FeedVisibility	Sichtbarkeitsstatus der Ansicht.

FeedViewType

Enumeration

Ansichtstyp.

Wert	Beschreibung
implicit	Interner Ansichtstyp, der automatisch vom System erstellt und verwaltet wird.
none	Standardmäßiger, nicht angegebener Ansichtstyp.
release	Ansicht, die als Heraufstufenziel verwendet wird, um freigegebene Artefakte zu klassifizieren.

FeedVisibility

Enumeration

Sichtbarkeitsstatus der Ansicht.

Wert	Beschreibung
aadTenant	Auf den Feed kann von allen gültigen Benutzern zugegriffen werden, die im Azure Active Directory-Mandanten vorhanden sind.
collection	Auf den Feed kann von allen gültigen Benutzern in der Organisation zugegriffen werden, in der sich der Feed befindet (z. B. organisationsweit "myorg" unter "dev.azure.com/myorg")
organization	Auf den Feed kann von allen gültigen Benutzern zugegriffen werden, die im Unternehmen vorhanden sind, in dem sich der Feed befindet. Beachten Sie, dass der Name dieses Werts nicht mehr mit seiner neuen Bedeutung synchronisiert wird.
private	Nur auf die berechtigungen zugegriffen werden kann, die explizit vom Feedadministrator festgelegt wurden.

MinimalPackageVersion

Objekt

Kerndaten zu allen Paketen, einschließlich der ID und Versionsinformationen und des Grundlegenden Zustands.

Name	Typ	Beschreibung
directUpstreamSourceId	string (uuid)	Die Upstreamquelle dieses Pakets wurde aufgenommen.
id	string (uuid)	ID für das Paket.
isCachedVersion	boolean	[Veraltet] Wird für Legacyszenarien verwendet und kann in zukünftigen Versionen entfernt werden.
isDeleted	boolean	True, wenn dieses Paket gelöscht wurde.
isLatest	boolean	True, wenn dies die neueste Version des Pakets nach Pakettyp Sortierreihenfolge ist.
isListed	boolean	(Nur NuGet und Fracht) True, wenn dieses Paket aufgeführt ist.
normalizedVersion	string	Normalisierte Version mit Normalisierungsregeln, die für einen Pakettyp spezifisch sind.
packageDescription	string	Paketbeschreibung.
publishDate	string (date-time)	UTC-Datum, an dem das Paket für den Dienst veröffentlicht wurde.
storageId	string	Interne Speicher-ID.
version	string	Anzeigeversion.
views	FeedView[]	Liste der Ansichten, die diese Paketversion enthalten.

Package

Objekt

Ein Paket, bei dem es sich um einen Container für eine oder mehrere Paketversionen handelt.

Name	Typ	Beschreibung
_links	ReferenceLinks	Verwandte REST-Links.
id	string (uuid)	ID des Pakets.
isCached	boolean	Wird für Legacyszenarien verwendet und kann in zukünftigen Versionen entfernt werden.
name	string	Der Anzeigename des Pakets.
normalizedName	string	Der normalisierte Name, der die Identität dieses Pakets innerhalb des Pakettyps darstellt.
protocolType	string	Typ des Pakets.
starCount	integer (int32)	[Veraltet] – Dieses Feld wird nicht verwendet und wird in einer zukünftigen Version entfernt.
url	string	URL für dieses Paket.
versions	MinimalPackageVersion[]	Alle Versionen für dieses Paket innerhalb ihres Feeds.

ReferenceLinks

Objekt

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Referenzlinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.