Feed Management - Create Feed

Service:

Artifacts

API Version:

5.1-preview.1

Cree una fuente, un contenedor para varios tipos de paquete.

Las fuentes se pueden crear en un proyecto si el parámetro del proyecto se incluye en la dirección URL de la solicitud. Si se omite el parámetro del proyecto, la fuente no se asociará a un proyecto y se creará en el nivel de organización. La creación de fuentes con ámbito de proyecto está en versión preliminar y es posible que aún no esté disponible en su organización.

POST https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds?api-version=5.1-preview.1

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
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 "5.1-preview.1" para usar esta versión de la API.

Cuerpo de la solicitud

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: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
permissions	FeedPermission[]	Permisos explícitos para la fuente.
project	ProjectReference	Proyecto al que está asociada esta fuente.
upstreamEnabled	boolean	OBSOLETO: Esto siempre debe ser true. 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.

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_write	Concede la capacidad de crear y leer fuentes y 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.

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: , |, /, \\, ?, :, &, $, *, \", #, [, ] ]]>
permissions	FeedPermission[]	Permisos explícitos para la fuente.
project	ProjectReference	Proyecto al que está asociada esta fuente.
upstreamEnabled	boolean	OBSOLETO: Esto siempre debe ser true. 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.
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
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.

ReferenceLinks

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