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 |
---|---|---|---|---|
feed
|
path | True |
string |
Name oder ID des Feeds. |
organization
|
path | True |
string |
Der Name der Azure DevOps-Organisation. |
package
|
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. |
include
|
query |
boolean |
True, um URLs für jede Version einzuschließen. Der Standardwert ist true. |
|
is
|
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). |
|
is
|
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 |
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 |
---|---|
Feed |
Eine Ansicht über einem Feed. |
Feed |
Ansichtstyp. |
Feed |
Sichtbarkeitsstatus der Ansicht. |
Minimal |
Kerndaten zu allen Paketen, einschließlich der ID und Versionsinformationen und des Grundlegenden Zustands. |
Package |
Eine Abhängigkeit von einer anderen Paketversion. |
Package |
Eine Paketdatei für eine bestimmte Paketversion, die nur für Pakettypen relevant ist, die mehrere Dateien pro Version enthalten. |
Package |
Eine bestimmte Version eines Pakets. |
Protocol |
Erweiterte Metadaten für einen bestimmten Pakettyp. |
Reference |
Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt. |
Upstream |
Vorgelagerte Quelldefinition, einschließlich Identität, Pakettyp und anderen zugehörigen Informationen. |
Upstream |
Quelltyp, z. B. "Öffentlich" oder "Intern". |
Upstream |
Gibt den Status des Upstreams an. |
Upstream |
FeedView
Eine Ansicht über einem Feed.
Name | Typ | Beschreibung |
---|---|---|
_links |
Verwandte REST-Links. |
|
id |
string (uuid) |
ID der Ansicht. |
name |
string |
Name der Ansicht. |
type |
Ansichtstyp. |
|
url |
string |
URL der Ansicht. |
visibility |
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 |
Feed |
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 |
Hierarchische Darstellung von Dateien. |
|
name |
string |
Dateiname. |
protocolMetadata |
Erweiterte Daten, die für einen bestimmten Pakettyp eindeutig sind. |
PackageVersion
Eine bestimmte Version eines Pakets.
Name | Typ | Beschreibung |
---|---|---|
_links |
Verwandte Links |
|
author |
string |
Paketversionsautor. |
deletedDate |
string (date-time) |
UTC-Datum, an dem diese Paketversion gelöscht wurde. |
dependencies |
Liste der Abhängigkeiten für diese Paketversion. |
|
description |
string |
Paketversionsbeschreibung. |
directUpstreamSourceId |
string (uuid) |
Die Upstreamquelle dieses Pakets wurde aufgenommen. |
files |
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 |
Andere Versionen dieses Pakets. |
|
packageDescription |
string |
Paketbeschreibung. |
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 |
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 |
Feed |
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. |
ReferenceLinks
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 |
Gibt den Status des Upstreams an. |
|
statusDetails |
Stellt einen lesbaren Grund für den Status des Upstreams bereit. |
|
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. |