Artifact Details - Get Packages

Referencia

Servicio:: Artifacts

Versión de la API:: 7.1

Obtenga detalles sobre todos los paquetes de la fuente. Use los distintos filtros para incluir o excluir información del conjunto de resultados.

El parámetro del proyecto debe proporcionarse si la fuente se creó en un proyecto. Si la fuente no está asociada a ningún proyecto, omita el parámetro del proyecto de la solicitud.

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

Con parámetros opcionales:

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

Nombre	En	Requerido	Tipo	Description
feedId	path	True	string	Nombre o identificador de la fuente.
organization	path	True	string	Nombre de la organización de Azure DevOps.
project	path		string	Id. de proyecto o nombre del proyecto
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "7.1" para usar esta versión de la API.
$skip	query		integer (int32)	Omita los primeros paquetes N (o versiones de paquete donde getTopPackageVersions=true)
$top	query		integer (int32)	Obtenga los principales paquetes N (o versiones de paquete donde getTopPackageVersions=true)
directUpstreamId	query		string (uuid)	Filtre los resultados para devolver paquetes de una cadena ascendente específica.
getTopPackageVersions	query		boolean	Cambia el comportamiento de $top y $skip para devolver todas las versiones de cada paquete hasta $top. Debe usarse junto con includeAllVersions=true
includeAllVersions	query		boolean	True para devolver todas las versiones del paquete en la respuesta. El valor predeterminado es false (solo la versión más reciente).
includeDeleted	query		boolean	Devuelve versiones eliminadas o no publicadas de paquetes en la respuesta. El valor predeterminado es False.
includeDescription	query		boolean	Devuelve la descripción de cada versión de cada paquete de la respuesta. El valor predeterminado es False.
includeUrls	query		boolean	True para devolver direcciones URL de REST con la respuesta. El valor predeterminado es True.
isCached	query		boolean	[Obsoleto] Se usa para escenarios heredados y se puede quitar en versiones futuras.
isListed	query		boolean	Solo se aplica a los paquetes NuGet, si se establece para otros tipos de paquete, se producirá un error 404. Si es false, se devolverán las versiones del paquete deslistadas. Úselo para filtrar la respuesta cuando includeAllVersions está establecido en true. El valor predeterminado es unset (no devolver paquetes deslistados).
isRelease	query		boolean	Solo se aplica a los paquetes Nuget. Úselo para filtrar la respuesta cuando includeAllVersions está establecido en true. El valor predeterminado es True (solo devuelve paquetes sin control de versiones preliminares).
normalizedPackageName	query		string	[Obsoleto] Se usa para escenarios heredados y se puede quitar en versiones futuras.
packageNameQuery	query		string	Filtre por los paquetes que contienen la cadena proporcionada. Los caracteres de la cadena deben cumplir las restricciones de nombre del paquete.
protocolType	query		string	Uno de los tipos de paquete de artefacto admitidos.

Respuestas

Nombre	Tipo	Description
200 OK	Package[]	operación correcta

Seguridad

oauth2

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del 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

Ámbitos

Nombre	Description
vso.packaging	Concede la capacidad de leer fuentes y paquetes. También concede la capacidad de buscar paquetes.

Definiciones

Nombre	Description
FeedView	Vista sobre una fuente.
FeedViewType	Tipo de vista.
FeedVisibility	Estado de visibilidad de la vista.
MinimalPackageVersion	Datos básicos sobre cualquier paquete, incluida su información de identificador y versión y el estado básico.
Package	Un paquete, que es un contenedor para una o varias versiones de paquete.
ReferenceLinks	Clase que representa una colección de vínculos de referencia rest.

FeedView

Object

Vista sobre una fuente.

Nombre	Tipo	Description
_links	ReferenceLinks	Vínculos REST relacionados.
id	string (uuid)	Identificador de la vista.
name	string	Nombre de la vista.
type	FeedViewType	Tipo de vista.
url	string	Dirección URL de la vista.
visibility	FeedVisibility	Estado de visibilidad de la vista.

FeedViewType

Enumeración

Tipo de vista.

Valor	Description
implicit	Tipo de vista interno que el sistema crea y administra automáticamente.
none	Tipo de vista no especificado predeterminado.
release	Vista usada como destino de promoción para clasificar artefactos liberados.

FeedVisibility

Enumeración

Estado de visibilidad de la vista.

Valor	Description
aadTenant	Todos los usuarios válidos presentes en el inquilino de Azure Active Directory pueden acceder a la fuente.
collection	La fuente es accesible por todos los usuarios válidos presentes en la organización donde reside la fuente (por ejemplo, en la organización "myorg" en "dev.azure.com/myorg")
organization	La fuente es accesible por todos los usuarios válidos presentes en la empresa donde reside la fuente. Tenga en cuenta que la nomenclatura heredada y la compatibilidad posterior dejan el nombre de este valor fuera de sincronización con su nuevo significado.
private	Solo puede acceder a los permisos establecidos explícitamente por el administrador de fuentes.

MinimalPackageVersion

Object

Datos básicos sobre cualquier paquete, incluida su información de identificador y versión y el estado básico.

Nombre	Tipo	Description
directUpstreamSourceId	string (uuid)	Origen ascendente del que se ingerió este paquete.
id	string (uuid)	Identificador del paquete.
isCachedVersion	boolean	[Obsoleto] Se usa para escenarios heredados y se puede quitar en versiones futuras.
isDeleted	boolean	True si se ha eliminado este paquete.
isLatest	boolean	True si se trata de la versión más reciente del paquete por criterio de ordenación de tipo de paquete.
isListed	boolean	(Solo NuGet y Carga) True si se muestra este paquete.
normalizedVersion	string	Versión normalizada mediante reglas de normalización específicas de un tipo de paquete.
packageDescription	string	Descripción del paquete.
publishDate	string (date-time)	Fecha UTC en la que se publicó el paquete en el servicio.
storageId	string	Identificador de almacenamiento interno.
version	string	Mostrar versión.
views	FeedView[]	Lista de vistas que contienen esta versión del paquete.

Package

Object

Un paquete, que es un contenedor para una o varias versiones de paquete.

Nombre	Tipo	Description
_links	ReferenceLinks	Vínculos REST relacionados.
id	string (uuid)	Identificador del paquete.
isCached	boolean	Se usa para escenarios heredados y se puede quitar en versiones futuras.
name	string	Nombre para mostrar del paquete.
normalizedName	string	Nombre normalizado que representa la identidad de este paquete dentro de su tipo de paquete.
protocolType	string	Tipo del paquete.
starCount	integer (int32)	[Obsoleto] : este campo no se usa y se quitará en una versión futura.
url	string	Dirección URL de este paquete.
versions	MinimalPackageVersion[]	Todas las versiones de este paquete dentro de su fuente.

ReferenceLinks

Object

Clase que representa una colección de vínculos de referencia rest.

Nombre	Tipo	Description
links	object	Vista de solo lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.