Feed Management - Create Feed

  • Référence
Service:
Artifacts
API Version:
5.1-preview.1

Créez un flux, un conteneur pour différents types de package.

Des flux peuvent être créés dans un projet si le paramètre de projet est inclus dans l’URL de la requête. Si le paramètre de projet est omis, le flux n’est pas associé à un projet et est créé au niveau organization. La création de flux dans l’étendue du projet est en préversion et n’est peut-être pas encore disponible dans votre organization.

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

Paramètres URI

Nom Dans Obligatoire Type Description
organization
 path True

string

Nom de l’organisation Azure DevOps.
project
 path

string

ID de projet ou nom du projet
api-version
 query True

string

Version de l’API à utiliser. Cette valeur doit être définie sur « 5.1-preview.1 » pour utiliser cette version de l’API.

Corps de la demande

Nom Type Description
_links

ReferenceLinks

Liens REST associés.
badgesEnabled

boolean

S’il est défini, ce flux prend en charge la génération de badges de package.
capabilities

FeedCapabilities

Fonctionnalités prises en charge d’un flux.
defaultViewId

string

L’affichage que l’administrateur de flux a indiqué est l’expérience par défaut pour les lecteurs.
deletedDate

string

Date à laquelle ce flux a été supprimé.
description

string

Description du flux. Les descriptions ne doivent pas dépasser 255 caractères.
fullyQualifiedId

string

Il s’agit du GUID de flux ou du GUID de flux et du GUID d’affichage en fonction de la façon dont le flux a été accédé.
fullyQualifiedName

string

Nom complet de la vue, au format feed@view.
hideDeletedPackageVersions

boolean

S’il est défini, le flux masque toutes les versions supprimées/non publiées
id

string

GUID qui identifie ce flux de manière unique.
isReadOnly

boolean

Si la valeur est définie, tous les packages du flux sont immuables. Il est important de noter que les vues de flux sont immuables ; par conséquent, cet indicateur sera toujours défini pour les vues.
name

string

Nom du flux. les noms de flux doivent respecter ces règles : ne doivent pas dépasser 64 caractères Ne doivent pas contenir d’espaces blancs Ne doit pas commencer par un trait de soulignement ou un pointNe doit pas se terminer par un pointNe doit pas contenir les caractères non autorisés suivants : , |, /, \, \\ , ?, :, &, $, *, \ », #, [, ] ]]>
permissions

FeedPermission[]

Autorisations explicites pour le flux.
project

ProjectReference

Projet auquel ce flux est associé.
upstreamEnabled

boolean

OBSOLÈTE : cela doit toujours être vrai. La définition de la valeur false remplace toutes les sources dans UpstreamSources.
upstreamEnabledChangedDate

string

Si la valeur est définie, heure à laquelle la propriété UpstreamEnabled a été modifiée. A la valeur Null si UpstreamEnabled n’a jamais été modifié après la création du flux.
upstreamSources

UpstreamSource[]

Liste des sources à partir de laquelle ce flux extrait les packages. Une liste vide indique que ce flux ne recherche pas de packages dans d’autres sources.
url

string

URL du flux de base au format GUID.
view

FeedView

Définition de la vue.
viewId

string

ID d’affichage.
viewName

string

Nom de la vue.

Réponses

Nom Type Description
200 OK

Feed

opération réussie

Sécurité

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

Nom Description
vso.packaging_write Octroie la possibilité de créer et de lire des flux et des packages.

Définitions

Nom Description
Feed

Conteneur pour les artefacts.
FeedCapabilities

Fonctionnalités prises en charge d’un flux.
FeedPermission

Autorisations pour un flux.
FeedRole

Rôle de cette identité sur un flux.
FeedView

Vue au-dessus d’un flux.
FeedViewType

Type d’affichage.
FeedVisibility

Visibilité status de la vue.
IdentityDescriptor

Un descripteur d’identité est un wrapper pour le type d’identité (Windows SID, Passport) ainsi qu’un identificateur unique tel que le SID ou le PUID.
ProjectReference
ReferenceLinks

Classe pour représenter une collection de liens de référence REST.
UpstreamSource

Définition de source en amont, y compris son identité, son type de package et d’autres informations associées.
UpstreamSourceType

Type de source, tel que Public ou Interne.

Feed

Conteneur pour les artefacts.

Nom Type Description
_links

ReferenceLinks

Liens REST associés.
badgesEnabled

boolean

S’il est défini, ce flux prend en charge la génération de badges de package.
capabilities

FeedCapabilities

Fonctionnalités prises en charge d’un flux.
defaultViewId

string

L’affichage que l’administrateur de flux a indiqué est l’expérience par défaut pour les lecteurs.
deletedDate

string

Date à laquelle ce flux a été supprimé.
description

string

Description du flux. Les descriptions ne doivent pas dépasser 255 caractères.
fullyQualifiedId

string

Il s’agit du GUID de flux ou du GUID de flux et du GUID d’affichage en fonction de la façon dont le flux a été accédé.
fullyQualifiedName

string

Nom complet de la vue, au format feed@view.
hideDeletedPackageVersions

boolean

S’il est défini, le flux masque toutes les versions supprimées/non publiées
id

string

GUID qui identifie ce flux de manière unique.
isReadOnly

boolean

Si la valeur est définie, tous les packages du flux sont immuables. Il est important de noter que les vues de flux sont immuables ; par conséquent, cet indicateur sera toujours défini pour les vues.
name

string

Nom du flux. les noms de flux doivent respecter ces règles : ne doivent pas dépasser 64 caractères Ne doivent pas contenir d’espaces blancs Ne doit pas commencer par un trait de soulignement ou un pointNe doit pas se terminer par un pointNe doit pas contenir les caractères non autorisés suivants : , |, /, \, \\ , ?, :, &, $, *, \ », #, [, ] ]]>
permissions

FeedPermission[]

Autorisations explicites pour le flux.
project

ProjectReference

Projet auquel ce flux est associé.
upstreamEnabled

boolean

OBSOLÈTE : cela doit toujours être vrai. La définition de la valeur false remplace toutes les sources dans UpstreamSources.
upstreamEnabledChangedDate

string

Si la valeur est définie, heure à laquelle la propriété UpstreamEnabled a été modifiée. A la valeur Null si UpstreamEnabled n’a jamais été modifié après la création du flux.
upstreamSources

UpstreamSource[]

Liste des sources à partir de laquelle ce flux extrait les packages. Une liste vide indique que ce flux ne recherche pas de packages dans d’autres sources.
url

string

URL du flux de base au format GUID.
view

FeedView

Définition de la vue.
viewId

string

ID d’affichage.
viewName

string

Nom de la vue.

FeedCapabilities

Fonctionnalités prises en charge d’un flux.

Nom Type Description
defaultCapabilities

string

Fonctionnalités données à un flux nouvellement créé
none

string

Il n’existe aucun indicateur pour ce flux
underMaintenance

string

Ce flux est actuellement en cours de maintenance et peut avoir des fonctionnalités réduites
upstreamV2

string

Ce flux peut servir des packages provenant de sources amont les packages en amont doivent être promus manuellement en affichages

FeedPermission

Autorisations pour un flux.

Nom Type Description
displayName

string

Nom d’affichage de l’identité.
identityDescriptor

IdentityDescriptor

Identité associée à ce rôle.
identityId

string

ID de l’identité associée à ce rôle.
role

FeedRole

Rôle de cette identité sur un flux.

FeedRole

Rôle de cette identité sur un flux.

Nom Type Description
administrator

string

Les administrateurs ont un contrôle total sur le flux.
collaborator

string

Les collaborateurs disposent des mêmes autorisations que les lecteurs, mais peuvent également ingérer des packages à partir de sources amont configurées.
contributor

string

Les contributeurs peuvent tout faire pour les packages du flux, y compris l’ajout de nouveaux packages, mais ils ne peuvent pas modifier les paramètres de flux.
custom

string

Non prise en charge.
none

string

Non prise en charge.
reader

string

Les lecteurs peuvent uniquement lire les packages et afficher les paramètres.

FeedView

Vue au-dessus d’un flux.

Nom Type Description
_links

ReferenceLinks

Liens REST associés.
id

string

ID de la vue.
name

string

Nom de la vue.
type

FeedViewType

Type d’affichage.
url

string

URL de la vue.
visibility

FeedVisibility

Visibilité status de la vue.

FeedViewType

Type d’affichage.

Nom Type Description
implicit

string

Type de vue interne créé et géré automatiquement par le système.
none

string

Type d’affichage non spécifié par défaut.
release

string

Vue utilisée comme destination de promotion pour classifier les artefacts libérés.

FeedVisibility

Visibilité status de la vue.

Nom Type Description
collection

string

Le flux est accessible à tous les utilisateurs valides présents dans le organization où réside le flux (par exemple, sur organization « myorg » à « dev.azure.com/myorg »)
organization

string

Le flux est accessible à tous les utilisateurs valides présents dans l’entreprise où réside le flux. Notez que le nommage hérité et l’arrière-plan laissent le nom de cette valeur non synchronisé avec sa nouvelle signification.
private

string

Accessible uniquement par les autorisations explicitement définies par l’administrateur de flux.

IdentityDescriptor

Un descripteur d’identité est un wrapper pour le type d’identité (Windows SID, Passport) ainsi qu’un identificateur unique tel que le SID ou le PUID.

Nom Type Description
identifier

string

Identificateur unique de cette identité, ne dépassant pas 256 caractères, qui sera conservé.
identityType

string

Type de descripteur (par exemple, Windows, Passport, etc.).

ProjectReference

Nom Type Description
id

string

Obtient ou définit l’ID du projet.
name

string

Obtient ou définit le nom du projet.
visibility

string

Obtient ou définit la visibilité du projet.

Classe pour représenter une collection de liens de référence REST.

Nom Type Description
links

object

Vue en lecture seule des liens. Étant donné que les liens de référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

UpstreamSource

Définition de source en amont, y compris son identité, son type de package et d’autres informations associées.

Nom Type Description
deletedDate

string

Date UTC à laquelle cette amont a été supprimée.
displayLocation

string

Localisateur pour la connexion à la source amont dans un format convivial, qui peut potentiellement changer au fil du temps
id

string

Identité de la source amont.
internalUpstreamCollectionId

string

Pour un type de amont interne, suivez le organization Azure DevOps qui le contient.
internalUpstreamFeedId

string

Pour un type de amont interne, suivez l’ID de flux référencé.
internalUpstreamViewId

string

Pour un type de amont interne, suivez l’affichage du flux référencé.
location

string

Localisateur cohérent pour la connexion à la source amont.
name

string

Nom d’affichage.
protocol

string

Type de package associé à la source amont.
upstreamSourceType

UpstreamSourceType

Type de source, tel que Public ou Interne.

UpstreamSourceType

Type de source, tel que Public ou Interne.

Nom Type Description
internal

string

Azure DevOps amont source.
public

string

Source accessible au public.