Freigeben über

Feed Management - Get Feed

  • Referenz
Dienst:
Artifacts
API-Version:
7.1

Rufen Sie die Einstellungen für einen bestimmten Feed ab.

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}?api-version=7.1
Mit optionalen Parametern: 
GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}?includeDeletedUpstreams={includeDeletedUpstreams}&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.
includeDeletedUpstreams
 query

boolean

Schließen Sie Upstreams ein, die in der Antwort gelöscht wurden.

Antworten

Name Typ Beschreibung
200 OK

Feed

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

Ein Container für Artefakte.
FeedCapabilities

Unterstützte Funktionen eines Feeds.
FeedPermission

Berechtigungen für einen Feed.
FeedRole

Die Rolle für diese Identität in einem Feed.
FeedView

Eine Ansicht über einem Feed.
FeedViewType

Ansichtstyp.
FeedVisibility

Sichtbarkeitsstatus der Ansicht.
IdentityDescriptor

Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows SID, Passport) und einen eindeutigen Bezeichner wie die SID oder PUID.
ProjectReference
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

Feed

Objekt

Ein Container für Artefakte.

Name Typ Beschreibung
_links

ReferenceLinks

Verwandte REST-Links.
badgesEnabled

boolean

Wenn dieser Feed festgelegt ist, unterstützt dieser Feed die Generierung von Paketsignalen.
capabilities

FeedCapabilities

Unterstützte Funktionen eines Feeds.
defaultViewId

string (uuid)

Die Ansicht, die der Feedadministrator angegeben hat, ist die Standardoberfläche für Leser.
deletedDate

string (date-time)

Das Datum, an dem dieser Feed gelöscht wurde.
description

string

Eine Beschreibung für den Feed. Beschreibungen dürfen 255 Zeichen nicht überschreiten.
fullyQualifiedId

string

Dies ist entweder die Feed-GUID oder die Feed-GUID und ansichts-GUID, je nachdem, wie auf den Feed zugegriffen wurde.
fullyQualifiedName

string

Vollständiger Name der Ansicht im feed@view Format.
hideDeletedPackageVersions

boolean

Wenn festgelegt, blendet der Feed alle gelöschten/nicht veröffentlichten Versionen aus.
id

string (uuid)

Eine GUID, die diesen Feed eindeutig identifiziert.
isReadOnly

boolean

Bei Festlegung sind alle Pakete im Feed unveränderlich. Es ist wichtig zu beachten, dass Feedansichten unveränderlich sind; Daher wird dieses Kennzeichen immer für Ansichten festgelegt.
name

string

Ein Name für den Feed. Feednamen müssen diese Regeln einhalten: Darf 64 Zeichen nicht überschreiten, Darf keine Leerzeichen enthalten, Darf nicht mit einem Unterstrich oder einem Punkt beginnen Darf nicht mit einem Punkt enden Darf keine der folgenden unzulässigen Zeichen enthalten: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
permanentDeletedDate

string (date-time)

Das Datum, an dem dieser Feed endgültig gelöscht wurde.
permissions

FeedPermission[]

Explizite Berechtigungen für den Feed.
project

ProjectReference

Das Projekt, dem dieser Feed zugeordnet ist.
scheduledPermanentDeleteDate

string (date-time)

Das Datum, an dem dieser Feed endgültig gelöscht werden soll.
upstreamEnabled

boolean

Dies sollte immer wahr sein. Die Einstellung auf "false" setzt alle Quellen in UpstreamSources außer Kraft.
upstreamEnabledChangedDate

string (date-time)

Wenn dieser Wert festgelegt ist, wurde die Zeit, zu der die UpstreamEnabled-Eigenschaft geändert wurde. Ist null, wenn UpstreamEnabled nach der Feederstellung nie geändert wurde.
upstreamSources

UpstreamSource[]

Eine Liste der Quellen, aus denen dieser Feed Pakete abruft. Eine leere Liste gibt an, dass dieser Feed keine weiteren Quellen nach Paketen durchsucht.
url

string

Die URL des Basisfeeds im GUID-Formular.
view

FeedView

Definition der Ansicht.
viewId

string (uuid)

Ansichts-ID.
viewName

string

Ansichtsname.

FeedCapabilities

Enumeration

Unterstützte Funktionen eines Feeds.

Wert Beschreibung
defaultCapabilities

Die Funktionen, die einem neu erstellten Feed zugewiesen werden
none

Für diesen Feed sind keine Kennzeichnungen vorhanden.
underMaintenance

Dieser Feed wird zurzeit gewartet und kann eingeschränkte Funktionalität aufweisen.
upstreamV2

Dieser Feed kann Pakete aus Upstreamquellen bereitstellen, muss manuell in Ansichten heraufgestuft werden.

FeedPermission

Objekt

Berechtigungen für einen Feed.

Name Typ Beschreibung
displayName

string

Anzeigename für die Identität.
identityDescriptor

IdentityDescriptor

Dieser Rolle zugeordnete Identität.
identityId

string (uuid)

ID der Identität, die dieser Rolle zugeordnet ist.
isInheritedRole

boolean

Boolescher Wert, der angibt, ob die Rolle direkt geerbt oder festgelegt wird.
role

FeedRole

Die Rolle für diese Identität in einem Feed.

FeedRole

Enumeration

Die Rolle für diese Identität in einem Feed.

Wert Beschreibung
administrator

Administratoren haben die gesamte Kontrolle über den Feed.
collaborator

Mitarbeiter verfügen über die gleichen Berechtigungen wie Leser, können aber auch Pakete aus konfigurierten Upstreamquellen aufnehmen.
contributor

Mitwirkende können alle Aktionen für Pakete im Feed ausführen, einschließlich des Hinzufügens neuer Pakete, aber sie ändern möglicherweise keine Feedeinstellungen.
custom

Nicht unterstützt.
none

Nicht unterstützt.
reader

Leser können nur Pakete und Ansichtseinstellungen lesen.

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.

IdentityDescriptor

Objekt

Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows SID, Passport) und einen eindeutigen Bezeichner wie die SID oder PUID.

Name Typ Beschreibung
identifier

string

Der eindeutige Bezeichner für diese Identität, nicht mehr als 256 Zeichen, die beibehalten werden.
identityType

string

Typ des Deskriptors (z. B. Windows, Passport usw.).

ProjectReference

Objekt
Name Typ Beschreibung
id

string (uuid)

Ruft die ID des Projekts ab oder legt sie fest.
name

string

Ruft den Namen des Projekts ab oder legt den Namen fest.
visibility

string

Ruft die Sichtbarkeit des Projekts ab oder legt sie fest.
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.

UpstreamSource

Objekt

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

Enumeration

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

Wert Beschreibung
internal

Azure DevOps-Upstreamquelle.
public

Öffentlich verfügbare Quelle.

UpstreamStatus

Enumeration

Gibt den Status des Upstreams an.

Wert Beschreibung
disabled

Die Upstreamquelle ist deaktiviert.
ok

Die Upstreamquelle ist ok.

UpstreamStatusDetail

Objekt
Name Typ Beschreibung
reason

string

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