Feed Management - Get Feed

Service:

Artifacts

API Version:

7.1-preview.1

Ottenere le impostazioni per un feed specifico.

Il parametro del progetto deve essere fornito se il feed è stato creato in un progetto. Se il feed non è associato ad alcun progetto, omettere il parametro di progetto dalla richiesta.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
feedId	path	True	string	Nome o ID del feed.
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
project	path		string	ID progetto o nome del progetto
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '7.1-preview.1' per usare questa versione dell'API.
includeDeletedUpstreams	query		boolean	Includere upstream che sono stati eliminati nella risposta.

Risposte

Nome	Tipo	Descrizione
200 OK	Feed	operazione riuscita

Sicurezza

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

Nome	Descrizione
vso.packaging	Concede la possibilità di leggere feed e pacchetti. Concede inoltre la possibilità di eseguire ricerche nei pacchetti.

Definizioni

Nome	Descrizione
Feed	Contenitore per gli artefatti.
FeedCapabilities	Funzionalità supportate di un feed.
FeedPermission	Autorizzazioni per un feed.
FeedRole	Ruolo per questa identità in un feed.
FeedView	Visualizzazione sopra un feed.
FeedViewType	Tipo di visualizzazione.
FeedVisibility	Stato di visibilità della visualizzazione.
IdentityDescriptor	Un descrittore di identità è un wrapper per il tipo di identità (SID di Windows, Passport) insieme a un identificatore univoco, ad esempio il SID o PUID.
ProjectReference
ReferenceLinks	Classe per rappresentare una raccolta di collegamenti di riferimento REST.
UpstreamSource	Definizione di origine upstream, tra cui identità, tipo di pacchetto e altre informazioni associate.
UpstreamSourceType	Tipo di origine, ad esempio Pubblico o Interno.
UpstreamStatus	Specifica lo stato dell'upstream.
UpstreamStatusDetail

Feed

Contenitore per gli artefatti.

Nome	Tipo	Descrizione
_links	ReferenceLinks	Collegamenti REST correlati.
badgesEnabled	boolean	Se impostato, questo feed supporta la generazione di notifiche di pacchetto.
capabilities	FeedCapabilities	Funzionalità supportate di un feed.
defaultViewId	string	La visualizzazione indicata dall'amministratore del feed è l'esperienza predefinita per i lettori.
deletedDate	string	Data di eliminazione del feed.
description	string	Descrizione del feed. Le descrizioni non devono superare i 255 caratteri.
fullyQualifiedId	string	Si tratta del GUID del feed o del GUID del feed e del GUID di visualizzazione a seconda del modo in cui è stato eseguito l'accesso al feed.
fullyQualifiedName	string	Nome completo della visualizzazione, nel formato feed@view.
hideDeletedPackageVersions	boolean	Se impostato, il feed nasconderà tutte le versioni eliminate/non pubblicate
id	string	GUID che identifica in modo univoco questo feed.
isReadOnly	boolean	Se impostato, tutti i pacchetti nel feed non sono modificabili. È importante notare che le visualizzazioni feed non sono modificabili; pertanto, questo flag verrà sempre impostato per le visualizzazioni.
name	string	Nome del feed. I nomi dei feed devono seguire queste regole: non deve superare i 64 caratteri Non deve contenere spazi vuoti Non deve iniziare con un carattere di sottolineatura o un punto Non deve terminare con un puntoNon deve contenere alcun carattere non valido: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
permanentDeletedDate	string	Data di eliminazione definitiva del feed.
permissions	FeedPermission[]	Autorizzazioni esplicite per il feed.
project	ProjectReference	Progetto a cui è associato questo feed.
scheduledPermanentDeleteDate	string	Data di eliminazione definitiva del feed.
upstreamEnabled	boolean	Questo dovrebbe essere sempre vero. L'impostazione su false eseguirà l'override di tutte le origini in UpstreamSources.
upstreamEnabledChangedDate	string	Se impostato, l'ora in cui la proprietà UpstreamEnabled è stata modificata. Sarà null se UpstreamEnabled non è mai stato modificato dopo la creazione del feed.
upstreamSources	UpstreamSource[]	Elenco di origini da cui il feed recupererà i pacchetti. Un elenco vuoto indica che questo feed non cercherà altre origini per i pacchetti.
url	string	URL del feed di base nel formato GUID.
view	FeedView	Definizione della vista.
viewId	string	ID visualizzazione.
viewName	string	Nome della vista.

FeedCapabilities

Funzionalità supportate di un feed.

Nome	Tipo	Descrizione
defaultCapabilities	string	Funzionalità fornite a un feed appena creato
none	string	Nessun flag esistente per questo feed
underMaintenance	string	Questo feed è attualmente in fase di manutenzione e potrebbe avere funzionalità ridotte
upstreamV2	string	Questo feed può servire i pacchetti da origini upstream i pacchetti Upstream devono essere promossi manualmente alle visualizzazioni

FeedPermission

Autorizzazioni per un feed.

Nome	Tipo	Descrizione
displayName	string	Nome visualizzato per l'identità.
identityDescriptor	IdentityDescriptor	Identità associata a questo ruolo.
identityId	string	ID dell'identità associata a questo ruolo.
isInheritedRole	boolean	Valore booleano che indica se il ruolo viene ereditato o impostato direttamente.
role	FeedRole	Ruolo per questa identità in un feed.

FeedRole

Ruolo per questa identità in un feed.

Nome	Tipo	Descrizione
administrator	string	Gli amministratori hanno il controllo totale sul feed.
collaborator	string	I collaboratori hanno le stesse autorizzazioni dei lettori, ma possono anche inserire pacchetti da origini upstream configurate.
contributor	string	I collaboratori possono eseguire qualsiasi operazione ai pacchetti nel feed, inclusa l'aggiunta di nuovi pacchetti, ma potrebbero non modificare le impostazioni del feed.
custom	string	Non supportato.
none	string	Non supportato.
reader	string	I lettori possono leggere solo i pacchetti e visualizzare le impostazioni.

FeedView

Visualizzazione sopra un feed.

Nome	Tipo	Descrizione
_links	ReferenceLinks	Collegamenti REST correlati.
id	string	ID della visualizzazione.
name	string	Nome della visualizzazione.
type	FeedViewType	Tipo di visualizzazione.
url	string	URL della visualizzazione.
visibility	FeedVisibility	Stato di visibilità della visualizzazione.

FeedViewType

Tipo di visualizzazione.

Nome	Tipo	Descrizione
implicit	string	Tipo di visualizzazione interno creato e gestito automaticamente dal sistema.
none	string	Tipo di visualizzazione predefinito non specificato.
release	string	Visualizzazione utilizzata come destinazione promozionale per classificare gli artefatti rilasciati.

FeedVisibility

Stato di visibilità della visualizzazione.

Nome	Tipo	Descrizione
aadTenant	string	Il feed è accessibile da tutti gli utenti validi presenti nel tenant di Azure Active Directory.
collection	string	Il feed è accessibile da tutti gli utenti validi presenti nell'organizzazione in cui si trova il feed (ad esempio in tutta l'organizzazione "myorg" in "dev.azure.com/myorg")
organization	string	Il feed è accessibile da tutti gli utenti validi presenti nell'organizzazione in cui risiede il feed. Si noti che la denominazione legacy e la compatibilità indietro lasciano il nome di questo valore non sincronizzato con il nuovo significato.
private	string	Accessibile solo dalle autorizzazioni impostate in modo esplicito dall'amministratore del feed.

IdentityDescriptor

Un descrittore di identità è un wrapper per il tipo di identità (SID di Windows, Passport) insieme a un identificatore univoco, ad esempio il SID o PUID.

Nome	Tipo	Descrizione
identifier	string	Identificatore univoco per questa identità, non superiore a 256 caratteri, che verranno salvati in modo permanente.
identityType	string	Tipo di descrittore (ad esempio, Windows, Passport e così via).

ProjectReference

Nome	Tipo	Descrizione
id	string	Ottiene o imposta l'ID del progetto.
name	string	Ottiene o imposta il nome del progetto.
visibility	string	Ottiene o imposta la visibilità del progetto.

ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome	Tipo	Descrizione
links	object	Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura.

UpstreamSource

Definizione di origine upstream, tra cui identità, tipo di pacchetto e altre informazioni associate.

Nome	Tipo	Descrizione
deletedDate	string	Data UTC dell'eliminazione di questo upstream.
displayLocation	string	Localizzatore per la connessione all'origine upstream in un formato intuitivo, che può cambiare potenzialmente nel tempo
id	string	Identità dell'origine upstream.
internalUpstreamCollectionId	string	Per un tipo upstream interno, tenere traccia dell'organizzazione Azure DevOps che la contiene.
internalUpstreamFeedId	string	Per un tipo upstream interno, tenere traccia dell'ID feed a cui si fa riferimento.
internalUpstreamProjectId	string	Per un tipo upstream interno, tenere traccia del progetto del feed a cui si fa riferimento.
internalUpstreamViewId	string	Per un tipo upstream interno, tenere traccia della visualizzazione del feed a cui si fa riferimento.
location	string	Localizzatore coerente per la connessione all'origine upstream.
name	string	Nome visualizzato.
protocol	string	Tipo di pacchetto associato all'origine upstream.
serviceEndpointId	string	Identità dell'endpoint del servizio che contiene le credenziali da usare per l'accesso all'upstream.
serviceEndpointProjectId	string	Specifica il projectId dell'endpoint di servizio.
status	UpstreamStatus	Specifica lo stato dell'upstream.
statusDetails	UpstreamStatusDetail[]	Fornisce un motivo leggibile per lo stato dell'upstream.
upstreamSourceType	UpstreamSourceType	Tipo di origine, ad esempio Pubblico o Interno.

UpstreamSourceType

Tipo di origine, ad esempio Pubblico o Interno.

Nome	Tipo	Descrizione
internal	string	Origine upstream di Azure DevOps.
public	string	Origine disponibile pubblicamente.

UpstreamStatus

Specifica lo stato dell'upstream.

Nome	Tipo	Descrizione
disabled	string	L'origine upstream è disabilitata.
ok	string	L'origine upstream è ok.

UpstreamStatusDetail

Nome	Tipo	Descrizione
reason	string	Fornisce un motivo leggibile per lo stato dell'upstream.