Feed Management - Create Feed

Service:

Artifacts

API Version:

5.1-preview.1

Vytvořte informační kanál, kontejner pro různé typy balíčků.

Informační kanály je možné vytvořit v projektu, pokud je parametr projektu zahrnutý v adrese URL požadavku. Pokud parametr projektu vynecháte, informační kanál se nepřidružuje k projektu a vytvoří se na úrovni organizace. Vytváření informačních kanálů v rámci projektu je v předběžné verzi a ve vaší organizaci ještě nemusí být k dispozici.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
organization	path	True	string	Název organizace Azure DevOps.
project	path		string	ID projektu nebo název projektu
api-version	query	True	string	Verze rozhraní API, která se má použít. Aby se tato verze rozhraní API používala, měla by být nastavená na 5.1-preview.1.

Text požadavku

Name	Typ	Description
_links	ReferenceLinks	Související odkazy REST
badgesEnabled	boolean	Pokud je toto nastavení nastavené, tento informační kanál podporuje generování odznáček balíčků.
capabilities	FeedCapabilities	Podporované možnosti informačního kanálu
defaultViewId	string	Zobrazení, které správce informačního kanálu uvedl, je výchozím prostředím pro čtenáře.
deletedDate	string	Datum odstranění tohoto informačního kanálu
description	string	Popis informačního kanálu. Popis nesmí být delší než 255 znaků.
fullyQualifiedId	string	Bude to buď IDENTIFIKÁTOR GUID informačního kanálu, nebo GUID informačního kanálu a identifikátor GUID zobrazení v závislosti na tom, jak se k informačnímu kanálu přistupovalo.
fullyQualifiedName	string	Úplný název zobrazení ve formátu feed@view
hideDeletedPackageVersions	boolean	Pokud je tato možnost nastavená, informační kanál skryje všechny odstraněné nebo nepublikované verze.
id	string	Identifikátor GUID, který jednoznačně identifikuje tento informační kanál.
isReadOnly	boolean	Pokud je nastavená, jsou všechny balíčky v informačním kanálu neměnné. Je důležité si uvědomit, že zobrazení informačního kanálu jsou neměnná; proto bude tento příznak vždy nastaven pro zobrazení.
name	string	Název informačního kanálu. Názvy informačních kanálů musí dodržovat tato pravidla: Nesmí být delší než 64 znaků. Nesmí obsahovat prázdné znaky Nesmí začínat podtržítkem nebo tečkouNesmí končit tečkou Nesmí obsahovat následující neplatné znaky: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
permissions	FeedPermission[]	Explicitní oprávnění pro informační kanál
project	ProjectReference	Projekt, ke kterému je tento informační kanál přidružený.
upstreamEnabled	boolean	ZASTARALÉ: Tato hodnota by měla být vždy pravdivá. Nastavení na false přepíše všechny zdroje v UpstreamSources.
upstreamEnabledChangedDate	string	Pokud je nastaven, čas, kdy upstreamEnabled vlastnost byla změněna. Pokud se upstreamEnabled po vytvoření informačního kanálu nikdy nezměnil, bude mít hodnotu null.
upstreamSources	UpstreamSource[]	Seznam zdrojů, ze kterého bude tento informační kanál načítat balíčky. Prázdný seznam označuje, že tento informační kanál nebude vyhledávat žádné další zdroje balíčků.
url	string	Adresa URL základního informačního kanálu ve formátu GUID.
view	FeedView	Definice zobrazení
viewId	string	ID zobrazení.
viewName	string	Název zobrazení.

Odpovědi

Name	Typ	Description
200 OK	Feed	úspěšná operace

Zabezpečení

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	Description
vso.packaging_write	Uděluje možnost vytvářet a číst informační kanály a balíčky.

Definice

Name	Description
Feed	Kontejner pro artefakty.
FeedCapabilities	Podporované možnosti informačního kanálu
FeedPermission	Oprávnění pro informační kanál.
FeedRole	Role pro tuto identitu v informačním kanálu.
FeedView	Zobrazení nad informačním kanálem
FeedViewType	Typ zobrazení
FeedVisibility	Stav viditelnosti zobrazení.
IdentityDescriptor	Popisovač identity je obálka pro typ identity (WINDOWS SID, Passport) spolu s jedinečným identifikátorem, jako je SID nebo PUID.
ProjectReference
ReferenceLinks	Třída představující kolekci odkazů REST.
UpstreamSource	Definice nadřazeného zdroje, včetně její identity, typu balíčku a dalších přidružených informací
UpstreamSourceType	Typ zdroje, například Veřejný nebo Interní.

Feed

Kontejner pro artefakty.

Name	Typ	Description
_links	ReferenceLinks	Související odkazy REST
badgesEnabled	boolean	Pokud je toto nastavení nastavené, tento informační kanál podporuje generování odznáček balíčků.
capabilities	FeedCapabilities	Podporované možnosti informačního kanálu
defaultViewId	string	Zobrazení, které správce informačního kanálu uvedl, je výchozím prostředím pro čtenáře.
deletedDate	string	Datum odstranění tohoto informačního kanálu
description	string	Popis informačního kanálu. Popis nesmí být delší než 255 znaků.
fullyQualifiedId	string	Bude to buď IDENTIFIKÁTOR GUID informačního kanálu, nebo GUID informačního kanálu a identifikátor GUID zobrazení v závislosti na tom, jak se k informačnímu kanálu přistupovalo.
fullyQualifiedName	string	Úplný název zobrazení ve formátu feed@view
hideDeletedPackageVersions	boolean	Pokud je tato možnost nastavená, informační kanál skryje všechny odstraněné nebo nepublikované verze.
id	string	Identifikátor GUID, který jednoznačně identifikuje tento informační kanál.
isReadOnly	boolean	Pokud je nastavená, jsou všechny balíčky v informačním kanálu neměnné. Je důležité si uvědomit, že zobrazení informačního kanálu jsou neměnná; proto bude tento příznak vždy nastaven pro zobrazení.
name	string	Název informačního kanálu. Názvy informačních kanálů musí dodržovat tato pravidla: Nesmí být delší než 64 znaků. Nesmí obsahovat prázdné znaky Nesmí začínat podtržítkem nebo tečkouNesmí končit tečkou Nesmí obsahovat následující neplatné znaky: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
permissions	FeedPermission[]	Explicitní oprávnění pro informační kanál
project	ProjectReference	Projekt, ke kterému je tento informační kanál přidružený.
upstreamEnabled	boolean	ZASTARALÉ: Tato hodnota by měla být vždy pravdivá. Nastavení na false přepíše všechny zdroje v UpstreamSources.
upstreamEnabledChangedDate	string	Pokud je nastaven, čas, kdy upstreamEnabled vlastnost byla změněna. Pokud se upstreamEnabled po vytvoření informačního kanálu nikdy nezměnil, bude mít hodnotu null.
upstreamSources	UpstreamSource[]	Seznam zdrojů, ze kterého bude tento informační kanál načítat balíčky. Prázdný seznam označuje, že tento informační kanál nebude vyhledávat žádné další zdroje balíčků.
url	string	Adresa URL základního informačního kanálu ve formátu GUID.
view	FeedView	Definice zobrazení
viewId	string	ID zobrazení.
viewName	string	Název zobrazení.

FeedCapabilities

Podporované možnosti informačního kanálu

Name	Typ	Description
defaultCapabilities	string	Možnosti poskytnuté nově vytvořenému informačnímu kanálu
none	string	Pro tento informační kanál neexistují žádné příznaky.
underMaintenance	string	Tento informační kanál je momentálně pod údržbou a může mít omezenou funkčnost.
upstreamV2	string	Tento informační kanál může obsluhovat balíčky z upstreamových zdrojů. Nadřazené balíčky musí být ručně povýšeny na zobrazení.

FeedPermission

Oprávnění pro informační kanál.

Name	Typ	Description
displayName	string	Zobrazovaný název identity.
identityDescriptor	IdentityDescriptor	Identita přidružená k této roli
identityId	string	ID identity přidružené k této roli
role	FeedRole	Role pro tuto identitu v informačním kanálu.

FeedRole

Role pro tuto identitu v informačním kanálu.

Name	Typ	Description
administrator	string	Správci mají nad informačním kanálem úplnou kontrolu.
collaborator	string	Spolupracovníci mají stejná oprávnění jako čtenáři, ale můžou také ingestovat balíčky z nakonfigurovaných nadřazených zdrojů.
contributor	string	Přispěvatelé můžou s balíčky v informačním kanálu dělat cokoliv, včetně přidávání nových balíčků, ale nemusí měnit nastavení informačního kanálu.
custom	string	Nepodporuje se.
none	string	Nepodporuje se.
reader	string	Čtenáři můžou jenom číst balíčky a zobrazit nastavení.

FeedView

Zobrazení nad informačním kanálem

Name	Typ	Description
_links	ReferenceLinks	Související odkazy REST
id	string	ID zobrazení.
name	string	Název zobrazení.
type	FeedViewType	Typ zobrazení
url	string	Adresa URL zobrazení
visibility	FeedVisibility	Stav viditelnosti zobrazení.

FeedViewType

Typ zobrazení

Name	Typ	Description
implicit	string	Interní typ zobrazení, který je automaticky vytvořen a spravován systémem.
none	string	Výchozí, nespecifikovaný typ zobrazení.
release	string	Zobrazení použité jako cíl povýšení ke klasifikaci vydaných artefaktů.

FeedVisibility

Stav viditelnosti zobrazení.

Name	Typ	Description
collection	string	Informační kanál je přístupný všem platným uživatelům v organizaci, ve které se informační kanál nachází (například v organizaci myorg na dev.azure.com/myorg).
organization	string	Informační kanál je přístupný všem platným uživatelům, kteří jsou přítomni v podniku, ve kterém se informační kanál nachází. Mějte na paměti, že starší verze pojmenování a zpětné kompatibility nesynchronizují název této hodnoty s novým významem.
private	string	Přístupná pouze pomocí oprávnění, která výslovně nastavil správce informačního kanálu.

IdentityDescriptor

Popisovač identity je obálka pro typ identity (WINDOWS SID, Passport) spolu s jedinečným identifikátorem, jako je SID nebo PUID.

Name	Typ	Description
identifier	string	Jedinečný identifikátor pro tuto identitu, který nepřesahuje 256 znaků, který bude zachován.
identityType	string	Typ popisovače (například Windows, Passport atd.)

ProjectReference

Name	Typ	Description
id	string	Získá nebo nastaví ID projektu.
name	string	Získá nebo nastaví název projektu.
visibility	string	Získá nebo nastaví viditelnost projektu.

ReferenceLinks

Třída představující kolekci odkazů REST.

Name	Typ	Description
links	object	Zobrazení odkazů jen pro čtení. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako odkazy jen pro čtení.

UpstreamSource

Definice nadřazeného zdroje, včetně její identity, typu balíčku a dalších přidružených informací

Name	Typ	Description
deletedDate	string	Datum UTC, kdy byl tento upstream odstraněn.
displayLocation	string	Lokátor pro připojení k nadřazeným zdrojům v uživatelsky přívětivém formátu, který se může v průběhu času měnit
id	string	Identita nadřazeného zdroje
internalUpstreamCollectionId	string	U interního upstreamového typu sledujte organizaci Azure DevOps, která ho obsahuje.
internalUpstreamFeedId	string	U interního upstreamového typu sledujte ID informačního kanálu, na který se odkazuje.
internalUpstreamViewId	string	U interního upstreamového typu sledujte zobrazení odkazovaného kanálu.
location	string	Konzistentní lokátor pro připojení k upstreamovém zdroji.
name	string	Zobrazovaný název.
protocol	string	Typ balíčku přidružený k nadřazeném zdroji.
upstreamSourceType	UpstreamSourceType	Typ zdroje, například Veřejný nebo Interní.

UpstreamSourceType

Typ zdroje, například Veřejný nebo Interní.

Name	Typ	Description
internal	string	Nadřazený zdroj Azure DevOps.
public	string	Veřejně dostupný zdroj.