Feed Management - Get Feed
Obtenga 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.1GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}?includeDeletedUpstreams={includeDeletedUpstreams}&api-version=7.1Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
feed
|
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. |
|
include
|
query |
boolean |
Incluya los elementos ascendentes que se han eliminado en la respuesta. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
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 |
|---|---|
| Feed |
Contenedor para artefactos. |
|
Feed |
Funcionalidades admitidas de una fuente. |
|
Feed |
Permisos para una fuente. |
|
Feed |
Rol para esta identidad en una fuente. |
|
Feed |
Vista sobre una fuente. |
|
Feed |
Tipo de vista. |
|
Feed |
Estado de visibilidad de la vista. |
|
Identity |
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. |
|
Project |
|
|
Reference |
Clase que representa una colección de vínculos de referencia rest. |
|
Upstream |
Definición de origen ascendente, incluida su identidad, tipo de paquete y otra información asociada. |
|
Upstream |
Tipo de origen, como Público o Interno. |
|
Upstream |
Especifica el estado de la cadena ascendente. |
|
Upstream |
Feed
Contenedor para artefactos.
| Nombre | Tipo | Description |
|---|---|---|
| _links |
Vínculos REST relacionados. |
|
| badgesEnabled |
boolean |
Si se establece, esta fuente admite la generación de distintivos de paquete. |
| capabilities |
Funcionalidades admitidas de una fuente. |
|
| defaultViewId |
string (uuid) |
La vista que el administrador de fuentes ha indicado es la experiencia predeterminada para los lectores. |
| deletedDate |
string (date-time) |
Fecha en que se eliminó esta fuente. |
| description |
string |
Descripción de la fuente. Las descripciones no deben superar los 255 caracteres. |
| fullyQualifiedId |
string |
Este será el GUID de fuente o el GUID de fuente y el GUID de vista en función de cómo se obtuvo acceso 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 (uuid) |
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: <list type="bullet"><item><description> No debe superar los 64 caracteres </description></item><><description> No debe contener espacios <en blanco /description></item><><description> No debe comenzar con un carácter de subrayado o un punto </description></item><><description> No debe terminar con un punto </><description/item description>><>< No debe contener ninguno de los siguientes caracteres no válidos: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]></description></item></list> |
| permanentDeletedDate |
string (date-time) |
Fecha en que se eliminó permanentemente esta fuente. |
| permissions |
Permisos explícitos para la fuente. |
|
| project |
Proyecto al que está asociada esta fuente. |
|
| scheduledPermanentDeleteDate |
string (date-time) |
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 (date-time) |
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 la fuente. |
| upstreamSources |
Una lista de orígenes de los que esta fuente capturará 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 |
Definición de la vista. |
|
| viewId |
string (uuid) |
Id. de vista. |
| viewName |
string |
Nombre de la vista. |
FeedCapabilities
Funcionalidades admitidas de una fuente.
| Valor | Description |
|---|---|
| none |
No existen marcas para esta fuente |
| upstreamV2 |
Esta fuente puede servir paquetes de orígenes ascendentes: los paquetes ascendentes deben promoverse manualmente a las vistas. |
| underMaintenance |
Esta fuente está actualmente en mantenimiento y puede tener una funcionalidad reducida |
| defaultCapabilities |
Las funcionalidades dadas a una fuente recién creada |
FeedPermission
Permisos para una fuente.
| Nombre | Tipo | Description |
|---|---|---|
| displayName |
string |
Nombre para mostrar de la identidad. |
| identityDescriptor |
Identidad asociada a este rol. |
|
| identityId |
string (uuid) |
Identificador de la identidad asociada a este rol. |
| isInheritedRole |
boolean |
Boolean que indica si el rol se hereda o se establece directamente. |
| role |
Rol para esta identidad en una fuente. |
FeedRole
Rol para esta identidad en una fuente.
| Valor | Description |
|---|---|
| custom |
Sin fundamento. |
| none |
Sin fundamento. |
| reader |
Los lectores solo pueden leer paquetes y ver la configuración. |
| contributor |
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. |
| administrator |
Los administradores tienen control total sobre la fuente. |
| collaborator |
Los colaboradores tienen los mismos permisos que los lectores, pero también pueden ingerir paquetes de orígenes ascendentes configurados. |
FeedView
Vista sobre una fuente.
| Nombre | Tipo | Description |
|---|---|---|
| _links |
Vínculos REST relacionados. |
|
| id |
string (uuid) |
Identificador de la vista. |
| name |
string |
Nombre de la vista. |
| type |
Tipo de vista. |
|
| url |
string |
Dirección URL de la vista. |
| visibility |
Estado de visibilidad de la vista. |
FeedViewType
Tipo de vista.
| Valor | Description |
|---|---|
| none |
Tipo de vista no especificado predeterminado. |
| release |
Vista usada como destino de promoción para clasificar artefactos liberados. |
| implicit |
Tipo de vista interno que el sistema crea y administra automáticamente. |
FeedVisibility
Estado de visibilidad de la vista.
| Valor | Description |
|---|---|
| private |
Solo puede acceder a los permisos establecidos explícitamente por el administrador de fuentes. |
| 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. |
| aadTenant |
Todos los usuarios válidos presentes en el inquilino de Azure Active Directory pueden acceder a la fuente. |
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 (uuid) |
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. |
ReferenceLinks
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. |
UpstreamSource
Definición de origen ascendente, incluida su identidad, tipo de paquete y otra información asociada.
| Nombre | Tipo | Description |
|---|---|---|
| deletedDate |
string (date-time) |
Fecha UTC en la que se eliminó esta cadena ascendente. |
| displayLocation |
string |
Localizador para conectarse al origen ascendente en un formato descriptivo, que puede cambiar con el tiempo |
| id |
string (uuid) |
Identidad del origen ascendente. |
| internalUpstreamCollectionId |
string (uuid) |
Para un tipo ascendente interno, realice un seguimiento de la organización de Azure DevOps que lo contiene. |
| internalUpstreamFeedId |
string (uuid) |
Para un tipo ascendente interno, realice un seguimiento del identificador de fuente al que se hace referencia. |
| internalUpstreamProjectId |
string (uuid) |
Para un tipo ascendente interno, realice un seguimiento del proyecto de la fuente a la que se hace referencia. |
| internalUpstreamViewId |
string (uuid) |
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 (uuid) |
Identidad del punto de conexión de servicio que contiene las credenciales que se van a usar al acceder a la cadena ascendente. |
| serviceEndpointProjectId |
string (uuid) |
Especifica el projectId del punto de conexión de servicio. |
| status |
Especifica el estado de la cadena ascendente. |
|
| statusDetails |
Proporciona una razón legible para el estado de la cadena ascendente. |
|
| upstreamSourceType |
Tipo de origen, como Público o Interno. |
UpstreamSourceType
Tipo de origen, como Público o Interno.
| Valor | Description |
|---|---|
| public |
Origen disponible públicamente. |
| internal |
Origen ascendente de Azure DevOps. |
UpstreamStatus
Especifica el estado de la cadena ascendente.
| Valor | Description |
|---|---|
| ok |
El origen ascendente es correcto. |
| disabled |
El origen ascendente está deshabilitado. |
UpstreamStatusDetail
| Nombre | Tipo | Description |
|---|---|---|
| reason |
string |
Proporciona una razón legible para el estado de la cadena ascendente. |