Feed Management - Get Feed
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-preview.1GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}?includeDeletedUpstreams={includeDeletedUpstreams}&api-version=7.1-preview.1URI-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. |
|
project
|
path |
string |
Projekt-ID oder Projektname |
|
|
api-version
|
query | True |
string |
Version der zu verwendenden API. Dies sollte auf "7.1-preview.1" festgelegt werden, um diese Version der API zu verwenden. |
|
include
|
query |
boolean |
Schließen Sie Upstreams ein, die in der Antwort gelöscht wurden. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Erfolgreicher Vorgang |
Sicherheit
oauth2
Type:
oauth2
Flow:
accessCode
Authorization 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
Scopes
| Name | Beschreibung |
|---|---|
| vso.packaging | Ermöglicht das Lesen von Feeds und Paketen. Ermöglicht auch die Suche nach Paketen. |
Definitionen
| Name | Beschreibung |
|---|---|
| Feed |
Ein Container für Artefakte. |
|
Feed |
Unterstützte Funktionen eines Feeds. |
|
Feed |
Berechtigungen für einen Feed. |
|
Feed |
Die Rolle für diese Identität in einem Feed. |
|
Feed |
Eine Ansicht über einem Feed. |
|
Feed |
Ansichtstyp. |
|
Feed |
Sichtbarkeit status der Ansicht. |
|
Identity |
Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows SID, Passport) zusammen mit einem eindeutigen Bezeichner wie der SID oder PUID. |
|
Project |
|
|
Reference |
Die Klasse, die eine Auflistung von REST-Verweislinks darstellt. |
|
Upstream |
Upstream-Quelldefinition, einschließlich der Identität, des Pakettyps und anderer zugeordneter Informationen. |
|
Upstream |
Quelltyp, z. B. Öffentlich oder Intern. |
|
Upstream |
Gibt die status des Upstream an. |
|
Upstream |
Feed
Ein Container für Artefakte.
| Name | Typ | Beschreibung |
|---|---|---|
| _links |
Verwandte REST-Links. |
|
| badgesEnabled |
boolean |
Falls festgelegt, unterstützt dieser Feed die Generierung von Paket-Badges. |
| capabilities |
Unterstützte Funktionen eines Feeds. |
|
| defaultViewId |
string |
Die Ansicht, die der Feedadministrator angegeben hat, ist die Standardumgebung für Leser. |
| deletedDate |
string |
Das Datum, an dem dieser Feed gelöscht wurde. |
| description |
string |
Eine Beschreibung für den Feed. Beschreibungen dürfen nicht länger als 255 Zeichen sein. |
| fullyQualifiedId |
string |
Dies ist entweder die Feed-GUID oder die Feed-GUID und die Anzeige-GUID, je nachdem, wie auf den Feed zugegriffen wurde. |
| fullyQualifiedName |
string |
Vollständiger Name der Ansicht in feed@view Format. |
| hideDeletedPackageVersions |
boolean |
Wenn festgelegt, blendet der Feed alle gelöschten/unveröffentlichten Versionen aus. |
| id |
string |
Eine GUID, die diesen Feed eindeutig identifiziert. |
| isReadOnly |
boolean |
Wenn festgelegt, sind alle Pakete im Feed unveränderlich. Es ist wichtig zu beachten, dass Feedansichten unveränderlich sind. Daher wird dieses Flag immer für Ansichten festgelegt. |
| name |
string |
Ein Name für den Feed. Feednamen müssen diesen Regeln entsprechen: Dürfen nicht mehr als 64 Zeichen Dürfen keine Leerzeichen enthalten Dürfen nicht mit einem Unterstrich oder einem Punktbeginnen Darf nicht mit einem Punktenden Darf keins der folgenden unzulässigen Zeichen enthalten: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]> |
| permanentDeletedDate |
string |
Das Datum, an dem dieser Feed endgültig gelöscht wurde. |
| permissions |
Explizite Berechtigungen für den Feed. |
|
| project |
Das Projekt, dem dieser Feed zugeordnet ist. |
|
| scheduledPermanentDeleteDate |
string |
Das Datum, an dem dieser Feed endgültig gelöscht werden soll. |
| upstreamEnabled |
boolean |
Dies sollte immer wahr sein. Wenn Sie auf false festlegen, werden alle Quellen in UpstreamSources außer Kraft gesetzt. |
| upstreamEnabledChangedDate |
string |
Wenn festgelegt, Zeitpunkt, zu dem die UpstreamEnabled-Eigenschaft geändert wurde. Ist NULL, wenn UpstreamEnabled nach der Feederstellung nie geändert wurde. |
| upstreamSources |
Eine Liste der Quellen, von denen dieser Feed Pakete abruft. Eine leere Liste gibt an, dass dieser Feed keine zusätzlichen Quellen nach Paketen durchsucht. |
|
| url |
string |
Die URL des Basisfeeds in GUID-Form. |
| view |
Definition der Ansicht. |
|
| viewId |
string |
Id anzeigen. |
| viewName |
string |
Ansichtsname. |
FeedCapabilities
Unterstützte Funktionen eines Feeds.
| Name | Typ | Beschreibung |
|---|---|---|
| defaultCapabilities |
string |
Die Funktionen, die einem neu erstellten Feed zur Verfügung gestellt werden |
| none |
string |
Für diesen Feed sind keine Flags vorhanden. |
| underMaintenance |
string |
Dieser Feed wird derzeit gewartet und verfügt möglicherweise über eine eingeschränkte Funktionalität. |
| upstreamV2 |
string |
Dieser Feed kann Pakete aus Upstream Quellen bereitstellen Upstreampakete müssen manuell zu Ansichten heraufgestuft werden. |
FeedPermission
Berechtigungen für einen Feed.
| Name | Typ | Beschreibung |
|---|---|---|
| displayName |
string |
Anzeigename für die Identität. |
| identityDescriptor |
Identität, die dieser Rolle zugeordnet ist. |
|
| identityId |
string |
ID der Identität, die dieser Rolle zugeordnet ist. |
| isInheritedRole |
boolean |
Boolescher Wert, der angibt, ob die Rolle geerbt oder direkt festgelegt wird. |
| role |
Die Rolle für diese Identität in einem Feed. |
FeedRole
Die Rolle für diese Identität in einem Feed.
| Name | Typ | Beschreibung |
|---|---|---|
| administrator |
string |
Administratoren haben die vollständige Kontrolle über den Feed. |
| collaborator |
string |
Mitarbeiter verfügen über die gleichen Berechtigungen wie Leser, können aber auch Pakete aus konfigurierten Upstream Quellen erfassen. |
| contributor |
string |
Mitwirkende können für Pakete im Feed alles tun, einschließlich des Hinzufügens neuer Pakete, aber sie können die Feedeinstellungen nicht ändern. |
| custom |
string |
Nicht unterstützt. |
| none |
string |
Nicht unterstützt. |
| reader |
string |
Leser können nur Pakete lesen und Einstellungen anzeigen. |
FeedView
Eine Ansicht über einem Feed.
| Name | Typ | Beschreibung |
|---|---|---|
| _links |
Verwandte REST-Links. |
|
| id |
string |
Id der Ansicht. |
| name |
string |
Name der Ansicht. |
| type |
Ansichtstyp. |
|
| url |
string |
URL der Ansicht. |
| visibility |
Sichtbarkeit status der Ansicht. |
FeedViewType
Ansichtstyp.
| Name | Typ | Beschreibung |
|---|---|---|
| implicit |
string |
Interner Ansichtstyp, der automatisch vom System erstellt und verwaltet wird. |
| none |
string |
Standardmäßiger, nicht spezifizierter Ansichtstyp. |
| release |
string |
Ansicht, die als Heraufstufungsziel verwendet wird, um freigegebene Artefakte zu klassifizieren. |
FeedVisibility
Sichtbarkeit status der Ansicht.
| Name | Typ | Beschreibung |
|---|---|---|
| aadTenant |
string |
Auf den Feed können alle gültigen Benutzer zugreifen, die im Azure Active Directory-Mandanten vorhanden sind. |
| collection |
string |
Auf den Feed können alle gültigen Benutzer zugreifen, die in der organization vorhanden sind, in der sich der Feed befindet (z. B. über organization "myorg" bei "dev.azure.com/myorg"). |
| organization |
string |
Auf den Feed können alle gültigen Benutzer zugreifen, die in dem Unternehmen vorhanden sind, in dem sich der Feed befindet. Beachten Sie, dass legacy naming and back compat den Namen dieses Werts nicht mit seiner neuen Bedeutung synchronisieren lässt. |
| private |
string |
Nur zugriff auf die Berechtigungen, die explizit vom Feedadministrator festgelegt wurden. |
IdentityDescriptor
Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows SID, Passport) zusammen mit einem eindeutigen Bezeichner wie der SID oder PUID.
| Name | Typ | Beschreibung |
|---|---|---|
| identifier |
string |
Der eindeutige Bezeichner für diese Identität mit maximal 256 Zeichen, der beibehalten wird. |
| identityType |
string |
Deskriptortyp (z. B. Windows, Passport usw.). |
ProjectReference
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string |
Ruft die ID des Projekts ab oder legt diese fest. |
| name |
string |
Ruft den Namen des Projekts ab oder legt den Namen fest. |
| visibility |
string |
Ruft die Sichtbarkeit des Projekts ab oder legt diese fest. |
ReferenceLinks
Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
| Name | Typ | Beschreibung |
|---|---|---|
| links |
object |
Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen. |
UpstreamSource
Upstream-Quelldefinition, einschließlich der Identität, des Pakettyps und anderer zugeordneter Informationen.
| Name | Typ | Beschreibung |
|---|---|---|
| deletedDate |
string |
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 im Laufe der Zeit möglicherweise ändern kann |
| id |
string |
Identität der Upstream Quelle. |
| internalUpstreamCollectionId |
string |
Für einen internen Upstream-Typ können Sie die Azure DevOps-organization nachverfolgen, die ihn enthält. |
| internalUpstreamFeedId |
string |
Verfolgen Sie bei einem internen Upstream-Typ die Feed-ID nach, auf die verwiesen wird. |
| internalUpstreamProjectId |
string |
Verfolgen Sie für einen internen Upstream-Typ das Projekt des Feeds, auf den verwiesen wird. |
| internalUpstreamViewId |
string |
Verfolgen Sie für einen internen Upstream-Typ 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 |
Die Identität des Dienstendpunkts, der Anmeldeinformationen enthält, die beim Zugriff auf den Upstream verwendet werden sollen. |
| serviceEndpointProjectId |
string |
Gibt die projectId des Dienstendpunkts an. |
| status |
Gibt die status des Upstream an. |
|
| statusDetails |
Stellt einen für Menschen lesbaren Grund für die status der Upstream bereit. |
|
| upstreamSourceType |
Quelltyp, z. B. Öffentlich oder Intern. |
UpstreamSourceType
Quelltyp, z. B. Öffentlich oder Intern.
| Name | Typ | Beschreibung |
|---|---|---|
| internal |
string |
Azure DevOps Upstream Quelle. |
| public |
string |
Öffentlich verfügbare Quelle. |
UpstreamStatus
Gibt die status des Upstream an.
| Name | Typ | Beschreibung |
|---|---|---|
| disabled |
string |
Upstreamquelle ist deaktiviert. |
| ok |
string |
Upstreamquelle ist in Ordnung. |
UpstreamStatusDetail
| Name | Typ | Beschreibung |
|---|---|---|
| reason |
string |
Stellt einen für Menschen lesbaren Grund für die status der Upstream bereit. |