Artifact Details - Get Packages

Riferimento

Servizio:: Artifacts

Versione API:: 7.1

Ottenere informazioni dettagliate su tutti i pacchetti nel feed. Usare i vari filtri per includere o escludere informazioni dal set di risultati.

Il parametro di 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}/packages?api-version=7.1

Con parametri facoltativi:

GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/Feeds/{feedId}/packages?protocolType={protocolType}&packageNameQuery={packageNameQuery}&normalizedPackageName={normalizedPackageName}&includeUrls={includeUrls}&includeAllVersions={includeAllVersions}&isListed={isListed}&getTopPackageVersions={getTopPackageVersions}&isRelease={isRelease}&includeDescription={includeDescription}&$top={$top}&$skip={$skip}&includeDeleted={includeDeleted}&isCached={isCached}&directUpstreamId={directUpstreamId}&api-version=7.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 progetto
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '7.1' per usare questa versione dell'API.
$skip	query		integer (int32)	Ignorare i primi N pacchetti (o versioni del pacchetto in cui getTopPackageVersions=true)
$top	query		integer (int32)	Ottenere i primi N pacchetti (o versioni dei pacchetti in cui getTopPackageVersions=true)
directUpstreamId	query		string (uuid)	Filtra i risultati per restituire i pacchetti da un upstream specifico.
getTopPackageVersions	query		boolean	Modifica il comportamento di $top e $skip per restituire tutte le versioni di ogni pacchetto fino a $top. Deve essere usato insieme a includeAllVersions=true
includeAllVersions	query		boolean	True per restituire tutte le versioni del pacchetto nella risposta. Il valore predefinito è false (solo versione più recente).
includeDeleted	query		boolean	Restituisce versioni eliminate o non pubblicate dei pacchetti nella risposta. Il valore predefinito è False.
includeDescription	query		boolean	Restituisce la descrizione per ogni versione di ogni pacchetto nella risposta. Il valore predefinito è False.
includeUrls	query		boolean	True per restituire gli URL REST con la risposta. Il valore predefinito è True.
isCached	query		boolean	[Obsoleto] Usato per scenari legacy e può essere rimosso nelle versioni future.
isListed	query		boolean	Applicabile solo per i pacchetti NuGet, impostandolo per altri tipi di pacchetto verrà generato un valore 404. Se false, verranno restituite le versioni del pacchetto non elencate. Usare questa opzione per filtrare la risposta quando includeAllVersions è impostato su true. Il valore predefinito è unset (non restituire pacchetti non elencati).
isRelease	query		boolean	Applicabile solo per i pacchetti NuGet. Usare questa opzione per filtrare la risposta quando includeAllVersions è impostato su true. Il valore predefinito è True (restituisce solo pacchetti senza controllo delle versioni non definitive).
normalizedPackageName	query		string	[Obsoleto] Usato per scenari legacy e può essere rimosso nelle versioni future.
packageNameQuery	query		string	Filtrare in base ai pacchetti che contengono la stringa specificata. I caratteri nella stringa devono essere conformi ai vincoli del nome del pacchetto.
protocolType	query		string	Uno dei tipi di pacchetto di artefatti supportati.

Risposte

Nome	Tipo	Descrizione
200 OK	Package[]	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	Concede la possibilità di leggere feed e pacchetti. Concede inoltre la possibilità di eseguire ricerche nei pacchetti.

Definizioni

Nome	Descrizione
FeedView	Una visualizzazione sulla parte superiore di un feed.
FeedViewType	Tipo di visualizzazione.
FeedVisibility	Stato di visibilità della visualizzazione.
MinimalPackageVersion	Dati di base su qualsiasi pacchetto, incluse le informazioni sull'ID e sulla versione e lo stato di base.
Package	Pacchetto, che è un contenitore per una o più versioni del pacchetto.
ReferenceLinks	Classe per rappresentare una raccolta di collegamenti di riferimento REST.

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.

MinimalPackageVersion

Object

Dati di base su qualsiasi pacchetto, incluse le informazioni sull'ID e sulla versione e lo stato di base.

Nome	Tipo	Descrizione
directUpstreamSourceId	string (uuid)	Origine upstream da cui è stato inserito il pacchetto.
id	string (uuid)	ID per il pacchetto.
isCachedVersion	boolean	[Obsoleto] Usato per scenari legacy e può essere rimosso nelle versioni future.
isDeleted	boolean	True se il pacchetto è stato eliminato.
isLatest	boolean	True se si tratta della versione più recente del pacchetto in base al tipo di pacchetto ordinamento.
isListed	boolean	(Solo NuGet e Cargo) True se il pacchetto è elencato.
normalizedVersion	string	Versione normalizzata usando regole di normalizzazione specifiche di un tipo di pacchetto.
packageDescription	string	Descrizione del pacchetto.
publishDate	string (date-time)	Utc Data di pubblicazione del pacchetto nel servizio.
storageId	string	ID di archiviazione interno.
version	string	Versione di visualizzazione.
views	FeedView[]	Elenco di visualizzazioni contenenti questa versione del pacchetto.

Package

Object

Pacchetto, che è un contenitore per una o più versioni del pacchetto.

Nome	Tipo	Descrizione
_links	ReferenceLinks	Collegamenti REST correlati.
id	string (uuid)	ID del pacchetto.
isCached	boolean	Usato per scenari legacy e può essere rimosso nelle versioni future.
name	string	Nome visualizzato del pacchetto.
normalizedName	string	Nome normalizzato che rappresenta l'identità del pacchetto all'interno del tipo di pacchetto.
protocolType	string	Tipo del pacchetto.
starCount	integer (int32)	[Obsoleto] - Questo campo non è usato e verrà rimosso in una versione futura.
url	string	URL per questo pacchetto.
versions	MinimalPackageVersion[]	Tutte le versioni per questo pacchetto all'interno del relativo feed.

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.