Feed Management - Create Feed

  • Referenz
Service:
Artifacts
API Version:
5.1-preview.1

Erstellen Sie einen Feed, einen Container für verschiedene Pakettypen.

Feeds können in einem Projekt erstellt werden, wenn der Projektparameter in der Anforderungs-URL enthalten ist. Wenn der Projektparameter ausgelassen wird, wird der Feed nicht einem Projekt zugeordnet und auf organization Ebene erstellt. Das Erstellen projektbezogener Feeds befindet sich in der Vorabversion und ist möglicherweise noch nicht in Ihrem organization verfügbar.

POST https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds?api-version=5.1-preview.1

URI-Parameter

Name In Erforderlich Typ Beschreibung
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 "5.1-preview.1" festgelegt werden, um diese Version der API zu verwenden.

Anforderungstext

Name Typ Beschreibung
_links

ReferenceLinks

Verwandte REST-Links.
badgesEnabled

boolean

Falls festgelegt, unterstützt dieser Feed die Generierung von Paket-Badges.
capabilities

FeedCapabilities

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 255 Zeichen nicht überschreiten.
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/nicht verö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: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
permissions

FeedPermission[]

Explizite Berechtigungen für den Feed.
project

ProjectReference

Das Projekt, dem dieser Feed zugeordnet ist.
upstreamEnabled

boolean

VERALTET: 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

UpstreamSource[]

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 im GUID-Format.
view

FeedView

Definition der Ansicht.
viewId

string

Id anzeigen.
viewName

string

Ansichtsname.

Antworten

Name Typ Beschreibung
200 OK

Feed

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_write Ermöglicht das Erstellen und Lesen von Feeds und Paketen.

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

Sichtbarkeit status der Ansicht.
IdentityDescriptor

Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows-SID, Passport) zusammen mit einem eindeutigen Bezeichner wie sid oder PUID.
ProjectReference
ReferenceLinks

Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt.
UpstreamSource

Upstream-Quelldefinition, einschließlich ihrer Identität, des Pakettyps und anderer zugeordneter Informationen.
UpstreamSourceType

Quelltyp, z. B. Öffentlich oder Intern.

Feed

Ein Container für Artefakte.

Name Typ Beschreibung
_links

ReferenceLinks

Verwandte REST-Links.
badgesEnabled

boolean

Falls festgelegt, unterstützt dieser Feed die Generierung von Paket-Badges.
capabilities

FeedCapabilities

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 255 Zeichen nicht überschreiten.
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/nicht verö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 folgen: Darf 64 Zeichen dürfen keine Leerzeichen enthalten Dürfen nicht mit einem Unterstrich oder einem Punktbeginnen Darf nicht mit einem Punkt enden Darf keines der folgenden unzulässigen Zeichen enthalten: , ,, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
permissions

FeedPermission[]

Explizite Berechtigungen für den Feed.
project

ProjectReference

Das Projekt, dem dieser Feed zugeordnet ist.
upstreamEnabled

boolean

VERALTET: Dies sollte immer der Fall 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

UpstreamSource[]

Eine Liste der Quellen, aus 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 im GUID-Format.
view

FeedView

Definition der Ansicht.
viewId

string

Anzeigen der ID.
viewName

string

Ansichtsname.

FeedCapabilities

Unterstützte Funktionen eines Feeds.

Name Typ Beschreibung
defaultCapabilities

string

Die Funktionen, die einem neu erstellten Feed zugewiesen 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

IdentityDescriptor

Dieser Rolle zugeordnete Identität.
identityId

string

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

FeedRole

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

Projektmitarbeiter 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 dürfen 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

ReferenceLinks

Verwandte REST-Links.
id

string

ID der Ansicht.
name

string

Name der Ansicht.
type

FeedViewType

Ansichtstyp.
url

string

URL der Ansicht.
visibility

FeedVisibility

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 angegebener Ansichtstyp.
release

string

Ansicht, die als Heraufstufungsziel verwendet wird, um freigegebene Artefakte zu klassifizieren.

FeedVisibility

Sichtbarkeit status der Ansicht.

Name Typ Beschreibung
collection

string

Der Feed ist für alle gültigen Benutzer zugänglich, die in der organization vorhanden sind, in der sich der Feed befindet (z. B. organization "myorg" unter "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 der Name dieses Werts aufgrund der Legacybenennung und der Zurückkompat nicht mit seiner neuen Bedeutung synchronisiert wird.
private

string

Zugriff nur durch 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 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

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

ProjectReference

Name Typ Beschreibung
id

string

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.

Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt.

Name Typ Beschreibung
links

object

Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützter Sind, möchten wir sie nur als schreibgeschützter Link verfügbar machen.

UpstreamSource

Upstream-Quelldefinition, einschließlich ihrer Identität, des Pakettyps und anderer zugeordneter Informationen.

Name Typ Beschreibung
deletedDate

string

UTC-Datum, an dem diese 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

Verfolgen Sie für einen internen Upstream typ die Azure DevOps-organization, die ihn enthält.
internalUpstreamFeedId

string

Verfolgen Sie bei einem internen Upstream Typ die Feed-ID, auf die verwiesen wird.
internalUpstreamViewId

string

Verfolgen Sie bei einem internen Upstream Typ die Ansicht des Feeds, auf den verwiesen wird.
location

string

Konsistenter Locator zum Herstellen einer Verbindung mit der Upstream Quelle.
name

string

Anzeigename.
protocol

string

Pakettyp, der der Upstream Quelle zugeordnet ist.
upstreamSourceType

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.