Feed Management - Get Feed
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
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 |
---|---|---|---|---|
feed
|
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. |
include
|
query |
boolean |
Zahrnout upstreamy, které byly odstraněny v odpovědi. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
ú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. |
Feed |
Podporované možnosti informačního kanálu. |
Feed |
Oprávnění pro informační kanál. |
Feed |
Role pro tuto identitu v informačním kanálu. |
Feed |
Zobrazení nad informačním kanálem |
Feed |
Typ zobrazení. |
Feed |
Stav viditelnosti zobrazení. |
Identity |
Popisovač identity je obálka pro typ identity (Windows SID, Passport) spolu s jedinečným identifikátorem, jako je SID nebo PUID. |
Project |
|
Reference |
Třída představující kolekci odkazů REST. |
Upstream |
Definice nadřazeného zdroje, včetně jeho identity, typu balíčku a dalších přidružených informací. |
Upstream |
Typ zdroje, například Veřejný nebo Interní. |
Upstream |
Určuje stav upstreamu. |
Upstream |
Feed
Kontejner pro artefakty.
Name | Typ | Description |
---|---|---|
_links |
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 |
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 |
Explicitní oprávnění pro informační kanál. |
|
project |
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 |
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 |
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 |
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 |
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 |
Související odkazy REST. |
|
id |
string |
ID zobrazení. |
name |
string |
Název zobrazení. |
type |
Typ zobrazení. |
|
url |
string |
Adresa URL zobrazení |
visibility |
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 |
Určuje stav upstreamu. |
|
statusDetails |
Poskytuje čitelný důvod pro stav upstreamu. |
|
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. |