Compartir a través de


Feed Management - Get Feed

Obtiene la configuración de una fuente específica.

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}?api-version=7.1-preview.1
GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}?includeDeletedUpstreams={includeDeletedUpstreams}&api-version=7.1-preview.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

El 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-preview.1" para usar esta versión de la API.

includeDeletedUpstreams
query

boolean

Incluya los elementos ascendentes que se han eliminado en la respuesta.

Respuestas

Nombre Tipo Description
200 OK

Feed

operación correcta

Seguridad

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

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

Definiciones

Nombre Description
Feed

Un contenedor para artefactos.

FeedCapabilities

Funcionalidades admitidas de una fuente.

FeedPermission

Permisos para una fuente.

FeedRole

Rol de esta identidad en una fuente.

FeedView

Una vista sobre una fuente.

FeedViewType

Tipo de vista.

FeedVisibility

Estado de visibilidad de la vista.

IdentityDescriptor

Un descriptor de identidad es un contenedor para el tipo de identidad (SID de Windows, Passport) junto con un identificador único, como el SID o PUID.

ProjectReference
ReferenceLinks

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

UpstreamSource

Definición de origen ascendente, incluida su identidad, tipo de paquete y otra información asociada.

UpstreamSourceType

Tipo de origen, como Público o Interno.

UpstreamStatus

Especifica el estado de la cadena ascendente.

UpstreamStatusDetail

Feed

Un contenedor para artefactos.

Nombre Tipo Description
_links

ReferenceLinks

Vínculos REST relacionados.

badgesEnabled

boolean

Si se establece, esta fuente admite la generación de distintivos de paquete.

capabilities

FeedCapabilities

Funcionalidades admitidas de una fuente.

defaultViewId

string

La vista que el administrador de fuentes ha indicado es la experiencia predeterminada para los lectores.

deletedDate

string

Fecha en que se eliminó esta fuente.

description

string

Descripción de la fuente. Las descripciones no deben superar los 255 caracteres.

fullyQualifiedId

string

Será el GUID de fuente o el GUID de fuente y el GUID de vista en función de cómo se haya accedido a la fuente.

fullyQualifiedName

string

Nombre completo de la vista, en formato feed@view.

hideDeletedPackageVersions

boolean

Si se establece, la fuente ocultará todas las versiones eliminadas o no publicadas.

id

string

GUID que identifica de forma única esta fuente.

isReadOnly

boolean

Si se establece, todos los paquetes de la fuente son inmutables. Es importante tener en cuenta que las vistas de fuente son inmutables; por lo tanto, esta marca siempre se establecerá para las vistas.

name

string

Nombre de la fuente. Los nombres de fuente deben seguir estas reglas: no debe superar los 64 caracteres No debe contener espacios en blanco No debe comenzar con un carácter de subrayado o un puntoNo debe terminar con un puntoNo debe contener ninguno de los siguientes caracteres no válidos: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]>

permanentDeletedDate

string

Fecha en la que esta fuente se eliminó permanentemente.

permissions

FeedPermission[]

Permisos explícitos para la fuente.

project

ProjectReference

Proyecto al que está asociada esta fuente.

scheduledPermanentDeleteDate

string

La fecha en que esta fuente está programada para eliminarse permanentemente.

upstreamEnabled

boolean

Esto siempre debe ser cierto. Si se establece en false, se invalidarán todos los orígenes de UpstreamSources.

upstreamEnabledChangedDate

string

Si se establece, la hora en que se cambió la propiedad UpstreamEnabled. Será null si UpstreamEnabled nunca se cambió después de la creación de fuentes.

upstreamSources

UpstreamSource[]

Una lista de orígenes de los que esta fuente capturará los paquetes. Una lista vacía indica que esta fuente no buscará ningún origen adicional para los paquetes.

url

string

Dirección URL de la fuente base en formato GUID.

view

FeedView

Definición de la vista.

viewId

string

Id. de vista.

viewName

string

Nombre de la vista.

FeedCapabilities

Funcionalidades admitidas de una fuente.

Nombre Tipo Description
defaultCapabilities

string

Funcionalidades dadas a una fuente recién creada

none

string

No existen marcas para esta fuente

underMaintenance

string

Esta fuente está actualmente en mantenimiento y puede tener una funcionalidad reducida

upstreamV2

string

Esta fuente puede servir paquetes de orígenes ascendentes Los paquetes ascendentes deben promoverse manualmente a las vistas.

FeedPermission

Permisos para una fuente.

Nombre Tipo Description
displayName

string

Nombre para mostrar de la identidad.

identityDescriptor

IdentityDescriptor

Identidad asociada a este rol.

identityId

string

Identificador de la identidad asociada a este rol.

isInheritedRole

boolean

Boolean que indica si el rol se hereda o se establece directamente.

role

FeedRole

Rol de esta identidad en una fuente.

FeedRole

Rol de esta identidad en una fuente.

Nombre Tipo Description
administrator

string

Los administradores tienen control total sobre la fuente.

collaborator

string

Los colaboradores tienen los mismos permisos que los lectores, pero también pueden ingerir paquetes de orígenes ascendentes configurados.

contributor

string

Los colaboradores pueden hacer cualquier cosa en los paquetes de la fuente, incluida la adición de nuevos paquetes, pero es posible que no modifiquen la configuración de fuente.

custom

string

No compatible.

none

string

No compatible.

reader

string

Los lectores solo pueden leer paquetes y ver la configuración.

FeedView

Una vista sobre una fuente.

Nombre Tipo Description
_links

ReferenceLinks

Vínculos REST relacionados.

id

string

Id. 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

Tipo de vista.

Nombre Tipo Description
implicit

string

Tipo de vista interno que el sistema crea y administra automáticamente.

none

string

Tipo de vista predeterminado sin especificar.

release

string

Vista usada como destino de promoción para clasificar artefactos liberados.

FeedVisibility

Estado de visibilidad de la vista.

Nombre Tipo Description
aadTenant

string

Todos los usuarios válidos presentes en el inquilino de Azure Active Directory pueden acceder a la fuente.

collection

string

La fuente es accesible para 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

string

La fuente es accesible para todos los usuarios válidos presentes en la empresa donde reside la fuente. Tenga en cuenta que la nomenclatura heredada y la compatibilidad inversa dejan el nombre de este valor fuera de sincronización con su nuevo significado.

private

string

Solo puede acceder a los permisos establecidos explícitamente por el administrador de fuentes.

IdentityDescriptor

Un descriptor de identidad es un contenedor para el tipo de identidad (SID de Windows, Passport) junto con un identificador único, como el SID o PUID.

Nombre Tipo Description
identifier

string

Identificador único de esta identidad, que no supera los 256 caracteres, que se conservarán.

identityType

string

Tipo de descriptor (por ejemplo, Windows, Passport, etc.).

ProjectReference

Nombre Tipo Description
id

string

Obtiene o establece el identificador del proyecto.

name

string

Obtiene o establece el nombre del proyecto.

visibility

string

Obtiene o establece la visibilidad del proyecto.

Clase que representa una colección de vínculos de referencia de 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.

UpstreamSource

Definición de origen ascendente, incluida su identidad, tipo de paquete y otra información asociada.

Nombre Tipo Description
deletedDate

string

Fecha UTC en la que se eliminó esta cadena ascendente.

displayLocation

string

Localizador para conectarse al origen ascendente en un formato fácil de usar, que puede cambiar con el tiempo

id

string

Identidad del origen ascendente.

internalUpstreamCollectionId

string

Para un tipo ascendente interno, realice un seguimiento de la organización de Azure DevOps que lo contiene.

internalUpstreamFeedId

string

Para un tipo ascendente interno, realice un seguimiento del identificador de fuente al que se hace referencia.

internalUpstreamProjectId

string

Para un tipo ascendente interno, realice un seguimiento del proyecto de la fuente a la que se hace referencia.

internalUpstreamViewId

string

Para un tipo ascendente interno, realice un seguimiento de la vista de la fuente a la que se hace referencia.

location

string

Localizador coherente para conectarse al origen ascendente.

name

string

Nombre para mostrar.

protocol

string

Tipo de paquete asociado al origen ascendente.

serviceEndpointId

string

La identidad del punto de conexión de servicio que contiene las credenciales que se van a usar al acceder a la cadena.

serviceEndpointProjectId

string

Especifica el projectId del punto de conexión de servicio.

status

UpstreamStatus

Especifica el estado de la cadena ascendente.

statusDetails

UpstreamStatusDetail[]

Proporciona una razón legible para el estado de la cadena ascendente.

upstreamSourceType

UpstreamSourceType

Tipo de origen, como Público o Interno.

UpstreamSourceType

Tipo de origen, como Público o Interno.

Nombre Tipo Description
internal

string

Origen ascendente de Azure DevOps.

public

string

Origen disponible públicamente.

UpstreamStatus

Especifica el estado de la cadena ascendente.

Nombre Tipo Description
disabled

string

El origen ascendente está deshabilitado.

ok

string

El origen ascendente es correcto.

UpstreamStatusDetail

Nombre Tipo Description
reason

string

Proporciona una razón legible para el estado de la cadena ascendente.