Partager via

Feed Management - Get Feed

Service:
Artifacts
Version d'API:
7.1

Obtenez les paramètres d’un flux spécifique.

Le paramètre de projet doit être fourni si le flux a été créé dans un projet. Si le flux n’est associé à aucun projet, omettez le paramètre du projet de la demande.

GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}?api-version=7.1
Avec des paramètres facultatifs: 
GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}?includeDeletedUpstreams={includeDeletedUpstreams}&api-version=7.1

Paramètres URI

Nom Dans Obligatoire Type Description
feedId
 path True

string

Nom ou ID du flux.
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 « 7.1 » pour utiliser cette version de l’API.
includeDeletedUpstreams
 query

boolean

Incluez les amonts qui ont été supprimés dans la réponse.

Réponses

Nom Type Description
200 OK

Feed

opération réussie

Sécurité

oauth2

Type: oauth2
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

Nom Description
vso.packaging Accorde la possibilité de lire des flux et des packages. Accorde également la possibilité de rechercher 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 en haut d’un flux.
FeedViewType

Type d’affichage.
FeedVisibility

État de visibilité de la vue.
IdentityDescriptor

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

Classe à 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.
UpstreamStatus

Spécifie l’état de l’amont.
UpstreamStatusDetail

Feed

Object

Conteneur pour les artefacts.

Nom Type Description
_links

ReferenceLinks

Liens REST connexes.
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 (uuid)

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

string (date-time)

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

Si cette option est définie, le flux masque toutes les versions supprimées/non publiées
id

string (uuid)

GUID qui identifie de façon unique ce flux.
isReadOnly

boolean

S’il est défini, tous les packages du flux sont immuables. Il est important de noter que les vues de flux sont immuables ; par conséquent, cet indicateur est toujours défini pour les vues.
name

string

Nom du flux. Les noms de flux doivent suivre ces règles : <liste type="bullet"><description> de l’élément><Ne doit pas dépasser 64 caractères </description d’élément/description>< d’élément d’élément><>>< ne doit pas contenir d’espaces blancs </description d’élément/><><description>< de l’élément/description> de l’élément ne doit pas commencer par un trait de soulignement ou une description> d’élément></description></description d’élément><de période <ne doit pas se terminer par une description d’élément /description /description>></élément><><de période < Ne doit contenir aucun des caractères non valides suivants : , |, /, \\ , ?, :, &, $, *, \", #, [, ]]></description></item></list>
permanentDeletedDate

string (date-time)

Date à laquelle ce flux a été définitivement supprimé.
permissions

FeedPermission[]

Autorisations explicites pour le flux.
project

ProjectReference

Projet auquel ce flux est associé.
scheduledPermanentDeleteDate

string (date-time)

Date à laquelle ce flux est planifié pour être supprimé définitivement.
upstreamEnabled

boolean

Cela devrait toujours être vrai. La valeur false remplace toutes les sources dans UpstreamSources.
upstreamEnabledChangedDate

string (date-time)

Si elle est définie, heure à laquelle la propriété UpstreamEnabled a été modifiée. Est 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 sources supplémentaires pour les packages.
url

string

URL du flux de base sous forme GUID.
view

FeedView

Définition de la vue.
viewId

string (uuid)

Id d’affichage.
viewName

string

Nom de l’affichage.

FeedCapabilities

Énumération

Fonctionnalités prises en charge d’un flux.

Valeur Description
none

Aucun indicateur n’existe pour ce flux
upstreamV2

Ce flux peut servir des packages à partir de sources en amont les packages en amont doivent être promus manuellement vers des vues
underMaintenance

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

Fonctionnalités fournies à un flux nouvellement créé

FeedPermission

Object

Autorisations pour un flux.

Nom Type Description
displayName

string

Nom complet de l’identité.
identityDescriptor

IdentityDescriptor

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

string (uuid)

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

boolean

Boolean indiquant si le rôle est hérité ou défini directement.
role

FeedRole

Rôle de cette identité sur un flux.

FeedRole

Énumération

Rôle de cette identité sur un flux.

Valeur Description
custom

Unsupported.
none

Unsupported.
reader

Les lecteurs ne peuvent lire que les packages et afficher les paramètres.
contributor

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

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

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

FeedView

Object

Vue en haut d’un flux.

Nom Type Description
_links

ReferenceLinks

Liens REST connexes.
id

string (uuid)

ID de la vue.
name

string

Nom de la vue.
type

FeedViewType

Type d’affichage.
url

string

URL de la vue.
visibility

FeedVisibility

État de visibilité de la vue.

FeedViewType

Énumération

Type d’affichage.

Valeur Description
none

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

Affichage utilisé comme destination de promotion pour classifier les artefacts publiés.
implicit

Type d’affichage interne créé et géré automatiquement par le système.

FeedVisibility

Énumération

État de visibilité de la vue.

Valeur Description
private

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

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

Le flux est accessible par tous les utilisateurs valides présents dans l’entreprise où réside le flux. Notez que l’attribution de noms héritée et le rétrocompte laisse le nom de cette valeur hors de synchronisation avec sa nouvelle signification.
aadTenant

Le flux est accessible par tous les utilisateurs valides présents dans le locataire Azure Active Directory.

IdentityDescriptor

Object

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

Nom Type Description
identifier

string

Identificateur unique de cette identité, qui ne dépasse pas 256 caractères, qui seront conservés.
identityType

string

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

ProjectReference

Object
Nom Type Description
id

string (uuid)

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

Classe à 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

Object

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-time)

Date UTC à laquelle cet amont a été supprimé.
displayLocation

string

Localisateur de connexion à la source en amont dans un format convivial qui peut changer au fil du temps
id

string (uuid)

Identité de la source en amont.
internalUpstreamCollectionId

string (uuid)

Pour un type en amont interne, suivez l’organisation Azure DevOps qui la contient.
internalUpstreamFeedId

string (uuid)

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

string (uuid)

Pour un type en amont interne, suivez le projet du flux référencé.
internalUpstreamViewId

string (uuid)

Pour un type en amont interne, suivez la vue du flux référencé.
location

string

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

string

Nom complet.
protocol

string

Type de package associé à la source en amont.
serviceEndpointId

string (uuid)

Identité du point de terminaison de service qui contient les informations d’identification à utiliser lors de l’accès en amont.
serviceEndpointProjectId

string (uuid)

Spécifie le projectId du point de terminaison de service.
status

UpstreamStatus

Spécifie l’état de l’amont.
statusDetails

UpstreamStatusDetail[]

Fournit une raison lisible par l’homme pour l’état de l’amont.
upstreamSourceType

UpstreamSourceType

Type de source, tel que Public ou Interne.

UpstreamSourceType

Énumération

Type de source, tel que Public ou Interne.

Valeur Description
public

Source disponible publiquement.
internal

Source en amont d’Azure DevOps.

UpstreamStatus

Énumération

Spécifie l’état de l’amont.

Valeur Description
ok

La source en amont est ok.
disabled

La source en amont est désactivée.

UpstreamStatusDetail

Object
Nom Type Description
reason

string

Fournit une raison lisible par l’homme pour l’état de l’amont.