Freigeben über


Artifact Details - Get Package Versions

Rufen Sie eine Liste der Paketversionen ab, optional nach Status filtern.

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/{packageId}/versions?api-version=7.1
GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/Feeds/{feedId}/Packages/{packageId}/versions?includeUrls={includeUrls}&isListed={isListed}&isDeleted={isDeleted}&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.

packageId
path True

string

ID des Pakets (GUID-ID, nicht Name).

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.

includeUrls
query

boolean

True, um URLs für jede Version einzuschließen. Der Standardwert ist true.

isDeleted
query

boolean

Wenn festgelegt wird, ob nur gelöschte oder nicht gelöschte Versionen von Paketen in der Antwort zurückgegeben werden sollen. Der Standardwert ist nicht festgelegt (gibt alle Versionen zurück).

isListed
query

boolean

Gilt nur für NuGet-Pakete. Wenn "false" zurückgegeben wird, werden nicht aufgelistete Paketversionen zurückgegeben.

Antworten

Name Typ Beschreibung
200 OK

PackageVersion[]

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.

PackageDependency

Eine Abhängigkeit von einer anderen Paketversion.

PackageFile

Eine Paketdatei für eine bestimmte Paketversion, die nur für Pakettypen relevant ist, die mehrere Dateien pro Version enthalten.

PackageVersion

Eine bestimmte Version eines Pakets.

ProtocolMetadata

Erweiterte Metadaten für einen bestimmten Pakettyp.

ReferenceLinks

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

UpstreamSource

Vorgelagerte Quelldefinition, einschließlich Identität, Pakettyp und anderen zugehörigen Informationen.

UpstreamSourceType

Quelltyp, z. B. "Öffentlich" oder "Intern".

UpstreamStatus

Gibt den Status des Upstreams an.

UpstreamStatusDetail

FeedView

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

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

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

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.

PackageDependency

Eine Abhängigkeit von einer anderen Paketversion.

Name Typ Beschreibung
group

string

Abhängigkeitspaketgruppe (eine optionale Klassifizierung innerhalb einiger Pakettypen).

packageName

string

Name des Abhängigkeitspakets.

versionRange

string

Versionsbereich des Abhängigkeitspakets.

PackageFile

Eine Paketdatei für eine bestimmte Paketversion, die nur für Pakettypen relevant ist, die mehrere Dateien pro Version enthalten.

Name Typ Beschreibung
children

PackageFile[]

Hierarchische Darstellung von Dateien.

name

string

Dateiname.

protocolMetadata

ProtocolMetadata

Erweiterte Daten, die für einen bestimmten Pakettyp eindeutig sind.

PackageVersion

Eine bestimmte Version eines Pakets.

Name Typ Beschreibung
_links

ReferenceLinks

Verwandte Links

author

string

Paketversionsautor.

deletedDate

string (date-time)

UTC-Datum, an dem diese Paketversion gelöscht wurde.

dependencies

PackageDependency[]

Liste der Abhängigkeiten für diese Paketversion.

description

string

Paketversionsbeschreibung.

directUpstreamSourceId

string (uuid)

Die Upstreamquelle dieses Pakets wurde aufgenommen.

files

PackageFile[]

Dateien, die dieser Paketversion zugeordnet sind, sind nur für Pakettypen mit mehreren Dateien relevant.

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.

otherVersions

MinimalPackageVersion[]

Andere Versionen dieses Pakets.

packageDescription

string

Paketbeschreibung.

protocolMetadata

ProtocolMetadata

Erweiterte Daten, die für einen Pakettyp spezifisch sind.

publishDate

string (date-time)

UTC-Datum, an dem das Paket für den Dienst veröffentlicht wurde.

sourceChain

UpstreamSource[]

Liste der Upstreamquellen, über die eine Paketversion in diesen Feed verschoben wurde.

storageId

string

Interne Speicher-ID.

summary

string

Zusammenfassung der Paketversion.

tags

string[]

Paketversionstags.

url

string

Url der Paketversion.

version

string

Anzeigeversion.

views

FeedView[]

Liste der Ansichten, die diese Paketversion enthalten.

ProtocolMetadata

Erweiterte Metadaten für einen bestimmten Pakettyp.

Name Typ Beschreibung
data

object

Erweiterte Metadaten für einen bestimmten Pakettyp, formatiert in der zugehörigen Schemaversionsdefinition.

schemaVersion

integer (int32)

Schemaversion.

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.

UpstreamSource

Vorgelagerte Quelldefinition, einschließlich Identität, Pakettyp und anderen zugehörigen Informationen.

Name Typ Beschreibung
deletedDate

string (date-time)

UTC-Datum, an dem dieser Upstream gelöscht wurde.

displayLocation

string

Locator zum Herstellen einer Verbindung mit der upstream-Quelle in einem benutzerfreundlichen Format, das sich möglicherweise im Laufe der Zeit ändern kann

id

string (uuid)

Identität der upstream-Quelle.

internalUpstreamCollectionId

string (uuid)

Verfolgen Sie für einen internen Upstreamtyp die Azure DevOps-Organisation, die sie enthält.

internalUpstreamFeedId

string (uuid)

Verfolgen Sie für einen internen Upstreamtyp die Feed-ID, auf die verwiesen wird.

internalUpstreamProjectId

string (uuid)

Verfolgen Sie für einen internen Upstreamtyp das Projekt des Feeds, auf das verwiesen wird.

internalUpstreamViewId

string (uuid)

Verfolgen Sie für einen internen Upstreamtyp die Ansicht des Feeds, auf den verwiesen wird.

location

string

Konsistenter Locator für die Verbindung mit der upstream-Quelle.

name

string

Anzeigename.

protocol

string

Pakettyp, der der upstream-Quelle zugeordnet ist.

serviceEndpointId

string (uuid)

Die Identität des Dienstendpunkts, der Anmeldeinformationen enthält, die beim Zugriff auf den Upstream verwendet werden sollen.

serviceEndpointProjectId

string (uuid)

Gibt die projectId des Dienstendpunkts an.

status

UpstreamStatus

Gibt den Status des Upstreams an.

statusDetails

UpstreamStatusDetail[]

Stellt einen lesbaren Grund für den Status des Upstreams bereit.

upstreamSourceType

UpstreamSourceType

Quelltyp, z. B. "Öffentlich" oder "Intern".

UpstreamSourceType

Quelltyp, z. B. "Öffentlich" oder "Intern".

Wert Beschreibung
internal

Azure DevOps-Upstreamquelle.

public

Öffentlich verfügbare Quelle.

UpstreamStatus

Gibt den Status des Upstreams an.

Wert Beschreibung
disabled

Die Upstreamquelle ist deaktiviert.

ok

Die Upstreamquelle ist ok.

UpstreamStatusDetail

Name Typ Beschreibung
reason

string

Stellt einen lesbaren Grund für den Status des Upstreams bereit.