Feed Management - Get Feed

Reference

Service:: Artifacts

API Version:: 7.1-preview.1

Získejte nastavení pro konkrétní informační kanál.

Parametr projektu musí být zadán, pokud byl kanál vytvořen v projektu. Pokud informační kanál není přidružený k žádnému projektu, vyněžte parametr projektu z požadavku.

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

With optional parameters:

GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}?includeDeletedUpstreams={includeDeletedUpstreams}&api-version=7.1-preview.1

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
feedId	path	True	string	Název nebo ID informačního kanálu
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 7.1-preview.1.
includeDeletedUpstreams	query		boolean	Zahrnout upstreamy, které byly odstraněny v odpovědi.

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	Uděluje možnost číst informační kanály a balíčky. Umožňuje také vyhledávat v balíčcích.

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ě jeho identity, typu balíčku a dalších přidružených informací.
UpstreamSourceType	Typ zdroje, například Veřejný nebo Interní.
UpstreamStatus	Určuje stav upstreamu.
UpstreamStatusDetail

Feed

Kontejner pro artefakty.

Name	Typ	Description
_links	ReferenceLinks	Související odkazy REST.
badgesEnabled	boolean	Pokud je tato možnost nastavená, tento informační kanál podporuje generování odznáčku 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. Popisy nesmí být delší než 255 znaků.
fullyQualifiedId	string	V závislosti na tom, jak se k informačnímu kanálu přistupovalo, se bude jednat buď o IDENTIFIKÁTOR GUID informačního kanálu, nebo identifikátor GUID informačního kanálu a identifikátor GUID zobrazení.
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ý tento informační kanál jednoznačně identifikuje.
isReadOnly	boolean	Pokud je tato možnost 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í překročit 64 znaků Nesmí obsahovat prázdné znaky Nesmí začínat podtržítkem nebo tečkouNesmí končit tečkou Nesmí obsahovat žádné z následujících zakázaných znaků: \|, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
permanentDeletedDate	string	Datum, kdy byl tento informační kanál trvale odstraněn.
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ý.
scheduledPermanentDeleteDate	string	Datum, kdy je naplánováno trvalé odstranění tohoto informačního kanálu.
upstreamEnabled	boolean	To by mělo být vždy pravdivé. Nastavení na hodnotu false přepíše všechny zdroje v upstreamSources.
upstreamEnabledChangedDate	string	Pokud je nastaveno, čas, kdy byla vlastnost UpstreamEnabled změněna. Pokud se funkce UpstreamEnabled po vytvoření informačního kanálu nikdy nezměnila, bude mít hodnotu null.
upstreamSources	UpstreamSource[]	Seznam zdrojů, ze kterého tento informační kanál načte balíčky. Prázdný seznam označuje, že tento informační kanál nebude hledat žádné další zdroje pro balíčky.
url	string	Adresa URL základního informačního kanálu ve formuláři GUID.
view	FeedView	Definice zobrazení
viewId	string	ID zobrazení.
viewName	string	Zobrazit název.

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 v současné době v rámci údržby a může mít omezenou funkčnost.
upstreamV2	string	Tento informační kanál může obsluhovat balíčky z nadřazených zdrojů Upstreamové 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
isInheritedRole	boolean	Logická hodnota označující, jestli je role zděděná nebo nastavená přímo.
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 upstreamový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	Typ interního 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
aadTenant	string	Informační kanál je přístupný všem platným uživatelům, kteří jsou v tenantovi Azure Active Directory.
collection	string	Informační kanál je přístupný všem platným uživatelům, kteří jsou v organizaci, kde se informační kanál nachází (například v rámci organizace myorg v dev.azure.com/myorg).
organization	string	Informační kanál je přístupný všem platným uživatelům, kteří jsou v podniku, ve kterém se informační kanál nachází. Všimněte si, že starší verze pojmenování a zpětného komppatování ponechávají název této hodnoty nesynchronní s novým významem.
private	string	Přístupná pouze pomocí oprávnění explicitně nastavených správcem 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 této identity, který nepřesahuje 256 znaků, který bude zachován.
identityType	string	Typ deskriptoru (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 jen pro čtení.

UpstreamSource

Definice nadřazeného zdroje, včetně jeho 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 potenciálně 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ý odkazujete.
internalUpstreamProjectId	string	U interního upstreamového typu sledujte projekt odkazovaného informačního kanálu.
internalUpstreamViewId	string	U interního upstreamového typu sledujte zobrazení odkazovaného informační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 upstreamovém zdroji.
serviceEndpointId	string	Identita koncového bodu služby, který obsahuje přihlašovací údaje, které se mají použít při přístupu k upstreamu.
serviceEndpointProjectId	string	Určuje id projektu koncového bodu služby.
status	UpstreamStatus	Určuje stav upstreamu.
statusDetails	UpstreamStatusDetail[]	Poskytuje čitelný důvod pro stav upstreamu.
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.

UpstreamStatus

Určuje stav upstreamu.

Name	Typ	Description
disabled	string	Nadřazený zdroj je zakázaný.
ok	string	Nadřazený zdroj je v pořádku.

UpstreamStatusDetail

Name	Typ	Description
reason	string	Poskytuje čitelný důvod pro stav upstreamu.

Sdílet prostřednictvím