Artifact Details - Get Packages

Referência

Serviço:: Artifacts

Versão da API:: 7.1

Obtenha detalhes sobre todos os pacotes no feed. Use os vários filtros para incluir ou excluir informações do conjunto de resultados.

O parâmetro do projeto deve ser fornecido se o feed foi criado em um projeto. Se o feed não estiver associado a nenhum projeto, omita o parâmetro do projeto da solicitação.

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

Com parâmetros opcionais:

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
feedId	path	True	string	Nome ou ID do feed.
organization	path	True	string	O nome da organização do Azure DevOps.
project	path		string	ID do projeto ou nome do projeto
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '7.1' para usar essa versão da api.
$skip	query		integer (int32)	Ignorar os primeiros pacotes N (ou versões de pacote em que getTopPackageVersions=true)
$top	query		integer (int32)	Obter os principais pacotes N (ou versões de pacote em que getTopPackageVersions=true)
directUpstreamId	query		string (uuid)	Filtre os resultados para retornar pacotes de um upstream específico.
getTopPackageVersions	query		boolean	Altera o comportamento de $top e $skip para retornar todas as versões de cada pacote até $top. Deve ser usado em conjunto com includeAllVersions=true
includeAllVersions	query		boolean	True para retornar todas as versões do pacote na resposta. O padrão é false (somente a versão mais recente).
includeDeleted	query		boolean	Retornar versões excluídas ou não publicadas de pacotes na resposta. O padrão é False.
includeDescription	query		boolean	Retorne a descrição de cada versão de cada pacote na resposta. O padrão é False.
includeUrls	query		boolean	True para retornar URLs REST com a resposta. O padrão é True.
isCached	query		boolean	[Obsoleto] Usado para cenários herdados e pode ser removido em versões futuras.
isListed	query		boolean	Aplicável somente a pacotes NuGet, defini-lo para outros tipos de pacote resultará em um 404. Se false, as versões de pacote deslistadas serão retornadas. Use isso para filtrar a resposta quando includeAllVersions for definido como true. O padrão não está definido (não retorne pacotes deslistados).
isRelease	query		boolean	Aplicável somente para pacotes Nuget. Use isso para filtrar a resposta quando includeAllVersions for definido como true. O padrão é True (retornar apenas pacotes sem o controle de versão de pré-lançamento).
normalizedPackageName	query		string	[Obsoleto] Usado para cenários herdados e pode ser removido em versões futuras.
packageNameQuery	query		string	Filtrar para pacotes que contêm a cadeia de caracteres fornecida. Os caracteres na cadeia de caracteres devem estar em conformidade com as restrições de nome do pacote.
protocolType	query		string	Um dos tipos de pacote de artefatos com suporte.

Respostas

Nome	Tipo	Description
200 OK	Package[]	operação bem-sucedida

Segurança

oauth2

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do 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

Escopos

Nome	Description
vso.packaging	Concede a capacidade de ler feeds e pacotes. Também concede a capacidade de pesquisar pacotes.

Definições

Nome	Description
FeedView	Uma exibição na parte superior de um feed.
FeedViewType	Tipo de exibição.
FeedVisibility	Status de visibilidade do modo de exibição.
MinimalPackageVersion	Dados básicos sobre qualquer pacote, incluindo suas informações de ID e versão e estado básico.
Package	Um pacote, que é um contêiner para uma ou mais versões de pacote.
ReferenceLinks	A classe para representar uma coleção de links de referência REST.

FeedView

Objeto

Uma exibição na parte superior de um feed.

Nome	Tipo	Description
_links	ReferenceLinks	Links REST relacionados.
id	string (uuid)	ID da exibição.
name	string	Nome da exibição.
type	FeedViewType	Tipo de exibição.
url	string	Url do modo de exibição.
visibility	FeedVisibility	Status de visibilidade do modo de exibição.

FeedViewType

Enumeração

Tipo de exibição.

Valor	Description
implicit	Tipo de exibição interna que é criado e gerenciado automaticamente pelo sistema.
none	Tipo de exibição padrão não especificado.
release	Exibição usada como destino de promoção para classificar artefatos liberados.

FeedVisibility

Enumeração

Status de visibilidade do modo de exibição.

Valor	Description
aadTenant	O feed é acessível por todos os usuários válidos presentes no locatário do Azure Active Directory.
collection	O feed é acessível por todos os usuários válidos presentes na organização em que o feed reside (por exemplo, na organização 'myorg' em 'dev.azure.com/myorg')
organization	O feed é acessível por todos os usuários válidos presentes na empresa em que o feed reside. Observe que a nomenclatura herdada e o compatibilidade de voltar deixam o nome desse valor fora de sincronia com seu novo significado.
private	Acessível somente pelas permissões definidas explicitamente pelo administrador do feed.

MinimalPackageVersion

Objeto

Dados básicos sobre qualquer pacote, incluindo suas informações de ID e versão e estado básico.

Nome	Tipo	Description
directUpstreamSourceId	string (uuid)	Fonte upstream da qual esse pacote foi ingerido.
id	string (uuid)	ID do pacote.
isCachedVersion	boolean	[Obsoleto] Usado para cenários herdados e pode ser removido em versões futuras.
isDeleted	boolean	True se este pacote tiver sido excluído.
isLatest	boolean	True se esta for a versão mais recente do pacote por ordem de classificação de tipo de pacote.
isListed	boolean	(Somente NuGet e Cargo) True se este pacote estiver listado.
normalizedVersion	string	Versão normalizada usando regras de normalização específicas para um tipo de pacote.
packageDescription	string	Descrição do pacote.
publishDate	string (date-time)	Data UTC em que o pacote foi publicado no serviço.
storageId	string	ID de armazenamento interno.
version	string	Versão de exibição.
views	FeedView[]	Lista de exibições que contêm esta versão do pacote.

Package

Objeto

Um pacote, que é um contêiner para uma ou mais versões de pacote.

Nome	Tipo	Description
_links	ReferenceLinks	Links REST relacionados.
id	string (uuid)	ID do pacote.
isCached	boolean	Usado para cenários herdados e pode ser removido em versões futuras.
name	string	O nome de exibição do pacote.
normalizedName	string	O nome normalizado que representa a identidade desse pacote dentro de seu tipo de pacote.
protocolType	string	Tipo do pacote.
starCount	integer (int32)	[Obsoleto] – esse campo não é utilizado e será removido em uma versão futura.
url	string	Url para este pacote.
versions	MinimalPackageVersion[]	Todas as versões desse pacote no feed.

ReferenceLinks

Objeto

A classe para representar uma coleção de links de referência REST.

Nome	Tipo	Description
links	object	A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.