Feed Management - Get Feed

Service:

Artifacts

API Version:

7.1-preview.1

Pobierz ustawienia dla określonego kanału informacyjnego.

Parametr projektu należy podać, jeśli źródło danych zostało utworzone w projekcie. Jeśli kanał informacyjny nie jest skojarzony z żadnym projektem, pomiń parametr projektu z żądania.

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 identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
feedId	path	True	string	Nazwa lub identyfikator kanału informacyjnego.
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
project	path		string	Identyfikator projektu lub nazwa projektu
api-version	query	True	string	Wersja interfejsu API do użycia. Ta wartość powinna być ustawiona na wartość "7.1-preview.1", aby używać tej wersji interfejsu API.
includeDeletedUpstreams	query		boolean	Uwzględnij strumienie nadrzędne, które zostały usunięte w odpowiedzi.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Feed	operacja zakończona powodzeniem

Zabezpieczenia

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

Nazwa	Opis
vso.packaging	Daje możliwość odczytywania źródeł danych i pakietów. Umożliwia również wyszukiwanie pakietów.

Definicje

Nazwa	Opis
Feed	Kontener dla artefaktów.
FeedCapabilities	Obsługiwane możliwości kanału informacyjnego.
FeedPermission	Uprawnienia do kanału informacyjnego.
FeedRole	Rola dla tej tożsamości w kanale informacyjnym.
FeedView	Widok na wierzchu kanału informacyjnego.
FeedViewType	Typ widoku.
FeedVisibility	Stan widoczności widoku.
IdentityDescriptor	Deskryptor tożsamości to otoka typu tożsamości (identyfikator SID systemu Windows, passport) wraz z unikatowym identyfikatorem, takim jak IDENTYFIKATOR SID lub PUID.
ProjectReference
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
UpstreamSource	Nadrzędna definicja źródła, w tym jego tożsamość, typ pakietu i inne skojarzone informacje.
UpstreamSourceType	Typ źródła, taki jak Publiczny lub Wewnętrzny.
UpstreamStatus	Określa stan nadrzędnego.
UpstreamStatusDetail

Feed

Kontener dla artefaktów.

Nazwa	Typ	Opis
_links	ReferenceLinks	Powiązane linki REST.
badgesEnabled	boolean	Jeśli ustawisz ten kanał informacyjny, obsługuje generowanie znaczków pakietu.
capabilities	FeedCapabilities	Obsługiwane możliwości kanału informacyjnego.
defaultViewId	string	Widok wskazany przez administratora kanału informacyjnego jest domyślnym środowiskiem dla czytelników.
deletedDate	string	Data usunięcia tego kanału informacyjnego.
description	string	Opis kanału informacyjnego. Opisy nie mogą przekraczać 255 znaków.
fullyQualifiedId	string	Będzie to identyfikator GUID kanału informacyjnego lub identyfikator GUID kanału informacyjnego i wyświetlić identyfikator GUID w zależności od sposobu uzyskiwania dostępu do kanału informacyjnego.
fullyQualifiedName	string	Pełna nazwa widoku w formacie feed@view.
hideDeletedPackageVersions	boolean	W przypadku ustawienia źródło danych spowoduje ukrycie wszystkich usuniętych/nieopublikowanych wersji
id	string	Identyfikator GUID, który jednoznacznie identyfikuje ten kanał informacyjny.
isReadOnly	boolean	W przypadku ustawienia wszystkie pakiety w kanale informacyjnym są niezmienne. Należy pamiętać, że widoki kanałów informacyjnych są niezmienne; dlatego ta flaga będzie zawsze ustawiana dla widoków.
name	string	Nazwa kanału informacyjnego. Nazwy kanałów informacyjnych muszą być zgodne z następującymi regułami: nie może przekraczać 64 znaków Nie może zawierać białychznaków nie może rozpoczynać się od znaku podkreślenia lub kropkiNie może kończyć się kropką Nie może zawierać żadnego z następujących niedozwolonych znaków: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
permanentDeletedDate	string	Data trwałego usunięcia tego kanału informacyjnego.
permissions	FeedPermission[]	Jawne uprawnienia kanału informacyjnego.
project	ProjectReference	Projekt, z którymi jest skojarzony ten kanał informacyjny.
scheduledPermanentDeleteDate	string	Data trwałego usunięcia tego kanału informacyjnego.
upstreamEnabled	boolean	To zawsze powinno być prawdziwe. Ustawienie wartości false spowoduje zastąpienie wszystkich źródeł w upstreamSources.
upstreamEnabledChangedDate	string	W przypadku ustawienia czas zmiany właściwości UpstreamEnabled. Wartość null będzie mieć wartość null, jeśli element UpstreamEnabled nigdy nie został zmieniony po utworzeniu kanału informacyjnego.
upstreamSources	UpstreamSource[]	Lista źródeł, z których ten kanał informacyjny będzie pobierać pakiety. Pusta lista wskazuje, że to źródło danych nie będzie przeszukiwać żadnych dodatkowych źródeł dla pakietów.
url	string	Adres URL podstawowego kanału informacyjnego w postaci identyfikatora GUID.
view	FeedView	Definicja widoku.
viewId	string	Identyfikator widoku.
viewName	string	Nazwa widoku.

FeedCapabilities

Obsługiwane możliwości kanału informacyjnego.

Nazwa	Typ	Opis
defaultCapabilities	string	Możliwości nowo utworzonego kanału informacyjnego
none	string	Brak flag dla tego kanału informacyjnego
underMaintenance	string	To źródło danych jest obecnie w toku konserwacji i może mieć ograniczoną funkcjonalność
upstreamV2	string	To źródło danych może obsługiwać pakiety z nadrzędnych źródeł pakiety nadrzędne muszą być ręcznie promowane do widoków

FeedPermission

Uprawnienia do kanału informacyjnego.

Nazwa	Typ	Opis
displayName	string	Nazwa wyświetlana tożsamości.
identityDescriptor	IdentityDescriptor	Tożsamość skojarzona z tą rolą.
identityId	string	Identyfikator tożsamości skojarzonej z tą rolą.
isInheritedRole	boolean	Wartość logiczna wskazująca, czy rola jest dziedziczona, czy ustawiana bezpośrednio.
role	FeedRole	Rola dla tej tożsamości w kanale informacyjnym.

FeedRole

Rola dla tej tożsamości w kanale informacyjnym.

Nazwa	Typ	Opis
administrator	string	Administratorzy mają całkowitą kontrolę nad kanałem informacyjnym.
collaborator	string	Współpracownicy mają takie same uprawnienia jak czytelnicy, ale mogą również pozyskiwać pakiety ze skonfigurowanych źródeł nadrzędnych.
contributor	string	Współautorzy mogą wykonywać wszystkie czynności w pakietach w kanale informacyjnym, w tym dodawać nowe pakiety, ale mogą nie modyfikować ustawień kanału informacyjnego.
custom	string	Nieobsługiwane.
none	string	Nieobsługiwane.
reader	string	Czytelnicy mogą odczytywać tylko pakiety i wyświetlać ustawienia.

FeedView

Widok na wierzchu kanału informacyjnego.

Nazwa	Typ	Opis
_links	ReferenceLinks	Powiązane linki REST.
id	string	Identyfikator widoku.
name	string	Nazwa widoku.
type	FeedViewType	Typ widoku.
url	string	Adres URL widoku.
visibility	FeedVisibility	Stan widoczności widoku.

FeedViewType

Typ widoku.

Nazwa	Typ	Opis
implicit	string	Typ widoku wewnętrznego, który jest automatycznie tworzony i zarządzany przez system.
none	string	Domyślny, nieokreślony typ widoku.
release	string	Widok używany jako miejsce docelowe podwyższania poziomu do klasyfikowania zwolnionych artefaktów.

FeedVisibility

Stan widoczności widoku.

Nazwa	Typ	Opis
aadTenant	string	Kanał informacyjny jest dostępny dla wszystkich prawidłowych użytkowników znajdujących się w dzierżawie usługi Azure Active Directory.
collection	string	Kanał informacyjny jest dostępny dla wszystkich prawidłowych użytkowników obecnych w organizacji, w której znajduje się kanał informacyjny (na przykład w organizacji "myorg" pod adresem "dev.azure.com/myorg")
organization	string	Kanał informacyjny jest dostępny dla wszystkich prawidłowych użytkowników obecnych w przedsiębiorstwie, w którym znajduje się kanał informacyjny. Należy pamiętać, że starsze nazewnictwo i z powrotem z powrotem pozostawiają nazwę tej wartości bez synchronizacji z jej nowym znaczeniem.
private	string	Dostępne tylko dla uprawnień jawnie ustawionych przez administratora kanału informacyjnego.

IdentityDescriptor

Deskryptor tożsamości to otoka typu tożsamości (identyfikator SID systemu Windows, passport) wraz z unikatowym identyfikatorem, takim jak IDENTYFIKATOR SID lub PUID.

Nazwa	Typ	Opis
identifier	string	Unikatowy identyfikator tej tożsamości, który nie przekracza 256 znaków, które zostaną utrwalone.
identityType	string	Typ deskryptora (na przykład Windows, Passport itp.).

ProjectReference

Nazwa	Typ	Opis
id	string	Pobiera lub ustawia identyfikator projektu.
name	string	Pobiera lub ustawia nazwę projektu.
visibility	string	Pobiera lub ustawia widoczność projektu.

ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa	Typ	Opis
links	object	Widok linków w trybie tylko do odczytu. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

UpstreamSource

Nadrzędna definicja źródła, w tym jego tożsamość, typ pakietu i inne skojarzone informacje.

Nazwa	Typ	Opis
deletedDate	string	Data UTC usunięcia tego nadrzędnego strumienia.
displayLocation	string	Lokalizator do nawiązywania połączenia ze źródłem nadrzędnym w przyjaznym dla użytkownika formacie, który może potencjalnie ulec zmianie w czasie
id	string	Tożsamość nadrzędnego źródła.
internalUpstreamCollectionId	string	W przypadku wewnętrznego typu nadrzędnego śledź organizację usługi Azure DevOps, która ją zawiera.
internalUpstreamFeedId	string	W przypadku wewnętrznego typu nadrzędnego śledź identyfikator źródła danych, do których jest przywoływany.
internalUpstreamProjectId	string	W przypadku wewnętrznego typu nadrzędnego śledź projekt przywoływanego źródła danych.
internalUpstreamViewId	string	W przypadku wewnętrznego typu nadrzędnego śledź widok przywoływanego kanału informacyjnego.
location	string	Lokalizator spójny do nawiązywania połączenia ze źródłem nadrzędnym.
name	string	Nazwa wyświetlana.
protocol	string	Typ pakietu skojarzony z nadrzędnym źródłem.
serviceEndpointId	string	Tożsamość punktu końcowego usługi, który zawiera poświadczenia do użycia podczas uzyskiwania dostępu do nadrzędnego punktu końcowego.
serviceEndpointProjectId	string	Określa identyfikator projectId punktu końcowego usługi.
status	UpstreamStatus	Określa stan nadrzędnego.
statusDetails	UpstreamStatusDetail[]	Zapewnia czytelny dla człowieka powód stanu nadrzędnego.
upstreamSourceType	UpstreamSourceType	Typ źródła, taki jak Publiczny lub Wewnętrzny.

UpstreamSourceType

Typ źródła, taki jak Publiczny lub Wewnętrzny.

Nazwa	Typ	Opis
internal	string	Nadrzędne źródło usługi Azure DevOps.
public	string	Publicznie dostępne źródło.

UpstreamStatus

Określa stan nadrzędnego.

Nazwa	Typ	Opis
disabled	string	Nadrzędne źródło jest wyłączone.
ok	string	Nadrzędne źródło jest prawidłowe.

UpstreamStatusDetail

Nazwa	Typ	Opis
reason	string	Zapewnia czytelny dla człowieka powód stanu nadrzędnego.