Feed Management - Create Feed

Servizio:

Artifacts

Versione API:

7.1

Creare un feed, un contenitore per vari tipi di pacchetto.

I feed possono essere creati in un progetto se il parametro del progetto è incluso nell'URL della richiesta. Se il parametro del progetto viene omesso, il feed non verrà associato a un progetto e verrà creato a livello di organizzazione.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
project	path		string	ID progetto o nome progetto
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '7.1' per usare questa versione dell'API.

Corpo della richiesta

Nome	Tipo	Descrizione
_links	ReferenceLinks	Collegamenti REST correlati.
badgesEnabled	boolean	Se impostato, questo feed supporta la generazione di notifiche dei pacchetti.
capabilities	FeedCapabilities	Funzionalità supportate di un feed.
defaultViewId	string (uuid)	La visualizzazione indicata dall'amministratore del feed è l'esperienza predefinita per i lettori.
deletedDate	string (date-time)	Data di eliminazione del feed.
description	string	Descrizione per il feed. Le descrizioni non devono superare i 255 caratteri.
fullyQualifiedId	string	Questo sarà il GUID del feed o il GUID del feed e il GUID di visualizzazione a seconda del modo in cui è stato eseguito l'accesso al feed.
fullyQualifiedName	string	Nome completo della visualizzazione, in formato feed@view.
hideDeletedPackageVersions	boolean	Se impostato, il feed nasconderà tutte le versioni eliminate/non pubblicate
id	string (uuid)	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 punto Non deve contenere uno dei caratteri non validi seguenti: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
permanentDeletedDate	string (date-time)	Data di eliminazione definitiva del feed.
permissions	FeedPermission[]	Autorizzazioni esplicite per il feed.
project	ProjectReference	Progetto a cui è associato questo feed.
scheduledPermanentDeleteDate	string (date-time)	Data di eliminazione definitiva di questo feed.
upstreamEnabled	boolean	Questo dovrebbe essere sempre vero. L'impostazione su false eseguirà l'override di tutte le origini in UpstreamSources.
upstreamEnabledChangedDate	string (date-time)	Se impostata, 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 recupera 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 (uuid)	ID visualizzazione.
viewName	string	Nome visualizzazione.

Risposte

Nome	Tipo	Descrizione
200 OK	Feed	operazione riuscita

Sicurezza

oauth2

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL token: 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

Ambiti

Nome	Descrizione
vso.packaging_write	Concede la possibilità di creare e leggere feed e 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	Una visualizzazione sulla parte superiore di un feed.
FeedViewType	Tipo di visualizzazione.
FeedVisibility	Stato di visibilità della visualizzazione.
IdentityDescriptor	Un descrittore di identità è un wrapper per il tipo di identità (WINDOWS SID, 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 Public o Internal.
UpstreamStatus	Specifica lo stato dell'upstream.
UpstreamStatusDetail

Feed

Object

Contenitore per gli artefatti.

Nome	Tipo	Descrizione
_links	ReferenceLinks	Collegamenti REST correlati.
badgesEnabled	boolean	Se impostato, questo feed supporta la generazione di notifiche dei pacchetti.
capabilities	FeedCapabilities	Funzionalità supportate di un feed.
defaultViewId	string (uuid)	La visualizzazione indicata dall'amministratore del feed è l'esperienza predefinita per i lettori.
deletedDate	string (date-time)	Data di eliminazione del feed.
description	string	Descrizione per il feed. Le descrizioni non devono superare i 255 caratteri.
fullyQualifiedId	string	Questo sarà il GUID del feed o il GUID del feed e il GUID di visualizzazione a seconda del modo in cui è stato eseguito l'accesso al feed.
fullyQualifiedName	string	Nome completo della visualizzazione, in formato feed@view.
hideDeletedPackageVersions	boolean	Se impostato, il feed nasconderà tutte le versioni eliminate/non pubblicate
id	string (uuid)	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 punto Non deve contenere uno dei caratteri non validi seguenti: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
permanentDeletedDate	string (date-time)	Data di eliminazione definitiva del feed.
permissions	FeedPermission[]	Autorizzazioni esplicite per il feed.
project	ProjectReference	Progetto a cui è associato questo feed.
scheduledPermanentDeleteDate	string (date-time)	Data di eliminazione definitiva di questo feed.
upstreamEnabled	boolean	Questo dovrebbe essere sempre vero. L'impostazione su false eseguirà l'override di tutte le origini in UpstreamSources.
upstreamEnabledChangedDate	string (date-time)	Se impostata, 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 recupera 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 (uuid)	ID visualizzazione.
viewName	string	Nome visualizzazione.

FeedCapabilities

Enumerazione

Funzionalità supportate di un feed.

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

FeedPermission

Object

Autorizzazioni per un feed.

Nome	Tipo	Descrizione
displayName	string	Nome visualizzato per l'identità.
identityDescriptor	IdentityDescriptor	Identità associata a questo ruolo.
identityId	string (uuid)	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

Enumerazione

Ruolo per questa identità in un feed.

Valore	Descrizione
administrator	Gli amministratori hanno il controllo totale sul feed.
collaborator	I collaboratori hanno le stesse autorizzazioni dei lettori, ma possono anche inserire pacchetti da origini upstream configurate.
contributor	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	Non confermato.
none	Non confermato.
reader	I lettori possono leggere solo i pacchetti e visualizzare le impostazioni.

FeedView

Object

Una visualizzazione sulla parte superiore di un feed.

Nome	Tipo	Descrizione
_links	ReferenceLinks	Collegamenti REST correlati.
id	string (uuid)	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

Enumerazione

Tipo di visualizzazione.

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

FeedVisibility

Enumerazione

Stato di visibilità della visualizzazione.

Valore	Descrizione
aadTenant	Il feed è accessibile da tutti gli utenti validi presenti nel tenant di Azure Active Directory.
collection	Il feed è accessibile da tutti gli utenti validi presenti nell'organizzazione in cui risiede il feed ( ad esempio nell'organizzazione 'myorg' in 'dev.azure.com/myorg')
organization	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 lascia il nome di questo valore non sincronizzato con il nuovo significato.
private	Accessibile solo dalle autorizzazioni impostate in modo esplicito dall'amministratore del feed.

IdentityDescriptor

Object

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

Nome	Tipo	Descrizione
identifier	string	Identificatore univoco per questa identità, che non supera i 256 caratteri, che verranno mantenuti.
identityType	string	Tipo di descrittore (ad esempio, Windows, Passport e così via).

ProjectReference

Object

Nome	Tipo	Descrizione
id	string (uuid)	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

Object

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

Object

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

Nome	Tipo	Descrizione
deletedDate	string (date-time)	Data UTC in cui è stato eliminato questo upstream.
displayLocation	string	Localizzatore per la connessione all'origine upstream in un formato descrittivo, che potrebbe cambiare nel tempo
id	string (uuid)	Identità dell'origine upstream.
internalUpstreamCollectionId	string (uuid)	Per un tipo upstream interno, tenere traccia dell'organizzazione Azure DevOps che la contiene.
internalUpstreamFeedId	string (uuid)	Per un tipo upstream interno, tenere traccia dell'ID del feed a cui si fa riferimento.
internalUpstreamProjectId	string (uuid)	Per un tipo upstream interno, tenere traccia del progetto del feed a cui si fa riferimento.
internalUpstreamViewId	string (uuid)	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 (uuid)	Identità dell'endpoint del servizio che contiene le credenziali da usare per l'accesso a upstream.
serviceEndpointProjectId	string (uuid)	Specifica il valore 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 Public o Internal.

UpstreamSourceType

Enumerazione

Tipo di origine, ad esempio Public o Internal.

Valore	Descrizione
internal	Origine upstream di Azure DevOps.
public	Origine disponibile pubblicamente.

UpstreamStatus

Enumerazione

Specifica lo stato dell'upstream.

Valore	Descrizione
disabled	L'origine upstream è disabilitata.
ok	L'origine upstream è ok.

UpstreamStatusDetail

Object

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