Feed Management - Create Feed
Créez un flux, un conteneur pour différents types de packages.
Des flux peuvent être créés dans un projet si le paramètre de projet est inclus dans l’URL de la demande. Si le paramètre de projet est omis, le flux n’est pas associé à un projet et est créé au niveau organization.
POST https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/feeds?api-version=7.1-preview.1Paramè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 « 7.1-preview.1 » pour utiliser cette version de l’API. |
Corps de la demande
| Nom | Type | Description |
|---|---|---|
| _links |
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 |
Fonctionnalités prises en charge d’un flux. |
|
| defaultViewId |
string |
La vue que l’administrateur de flux a indiquée 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 cette option 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 est toujours défini pour les vues. |
| name |
string |
Nom du flux. Les noms de flux doivent suivre ces règles : Ne doit pas dépasser 64 caractères Ne doit 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 : , |, /, \\, ?, :, &, $, *, \ », #, [, ] ]]> |
| permanentDeletedDate |
string |
Date à laquelle ce flux a été supprimé définitivement. |
| permissions |
Autorisations explicites pour le flux. |
|
| project |
Projet auquel ce flux est associé. |
|
| scheduledPermanentDeleteDate |
string |
Date à laquelle ce flux est planifié pour être définitivement supprimé. |
| upstreamEnabled |
boolean |
Cela doit toujours être vrai. La définition de la valeur false remplace toutes les sources dans UpstreamSources. |
| upstreamEnabledChangedDate |
string |
Si elle 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 |
Liste des sources à partir des laquelle ce flux extraitra 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 |
Définition de la vue. |
|
| viewId |
string |
ID de l’affichage. |
| viewName |
string |
Nom de la vue. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
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 | Permet de créer et de lire des flux et des packages. |
Définitions
| Nom | Description |
|---|---|
| Feed |
Conteneur pour les artefacts. |
|
Feed |
Fonctionnalités prises en charge d’un flux. |
|
Feed |
Autorisations pour un flux. |
|
Feed |
Rôle de cette identité sur un flux. |
|
Feed |
Vue au-dessus d’un flux. |
|
Feed |
Type de vue. |
|
Feed |
Visibilité status de la vue. |
|
Identity |
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 PUID. |
|
Project |
|
|
Reference |
Classe pour représenter une collection de liens de référence REST. |
|
Upstream |
Définition de source en amont, y compris son identité, son type de package et d’autres informations associées. |
|
Upstream |
Type de source, par exemple Public ou Interne. |
|
Upstream |
Spécifie le status du amont. |
|
Upstream |
Feed
Conteneur pour les artefacts.
| Nom | Type | Description |
|---|---|---|
| _links |
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 |
Fonctionnalités prises en charge d’un flux. |
|
| defaultViewId |
string |
La vue que l’administrateur de flux a indiquée 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 cette option 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 est toujours défini pour les vues. |
| name |
string |
Nom du flux. Les noms de flux doivent suivre ces règles : Ne doit pas dépasser 64 caractères Ne doit 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 : , |, /, \\, ?, :, &, $, *, \ », #, [, ] ]]> |
| permanentDeletedDate |
string |
Date à laquelle ce flux a été supprimé définitivement. |
| permissions |
Autorisations explicites pour le flux. |
|
| project |
Projet auquel ce flux est associé. |
|
| scheduledPermanentDeleteDate |
string |
Date à laquelle ce flux est planifié pour être définitivement supprimé. |
| upstreamEnabled |
boolean |
Cela doit toujours être vrai. La définition de la valeur false remplace toutes les sources dans UpstreamSources. |
| upstreamEnabledChangedDate |
string |
Si elle 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 |
Liste des sources à partir des laquelle ce flux extraitra 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 |
Définition de la vue. |
|
| viewId |
string |
ID de l’affichage. |
| viewName |
string |
Nom de la vue. |
FeedCapabilities
Fonctionnalités prises en charge d’un flux.
| Nom | Type | Description |
|---|---|---|
| defaultCapabilities |
string |
Fonctionnalités accordées à un flux nouvellement créé |
| none |
string |
Aucun indicateur n’existe 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 amont sources Les packages en amont doivent être promus manuellement en vues |
FeedPermission
Autorisations pour un flux.
| Nom | Type | Description |
|---|---|---|
| displayName |
string |
Nom d’affichage de l’identité. |
| identityDescriptor |
Identité associée à ce rôle. |
|
| identityId |
string |
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 |
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 |
Liens REST associés. |
|
| id |
string |
ID de la vue. |
| name |
string |
Nom de la vue. |
| type |
Type de vue. |
|
| url |
string |
URL de la vue. |
| visibility |
Visibilité status de la vue. |
FeedViewType
Type de vue.
| 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 |
|---|---|---|
| aadTenant |
string |
Le flux est accessible à tous les utilisateurs valides présents dans le locataire Azure Active Directory. |
| collection |
string |
Le flux est accessible à tous les utilisateurs valides présents dans le organization où réside le flux (par exemple, dans 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 la compatibilité arrière-plan ne permettent pas de synchroniser le nom de cette valeur 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 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. |
ReferenceLinks
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 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 ce amont a été supprimé. |
| displayLocation |
string |
Localisateur pour la connexion à la source amont dans un format convivial, qui peut changer au fil du temps |
| id |
string |
Identité de la source amont. |
| internalUpstreamCollectionId |
string |
Pour un type de amont interne, suivez les organization Azure DevOps qui le contiennent. |
| internalUpstreamFeedId |
string |
Pour un type de amont interne, suivez l’ID de flux référencé. |
| internalUpstreamProjectId |
string |
Pour un type de amont interne, suivez le projet du flux référencé. |
| internalUpstreamViewId |
string |
Pour un type de amont interne, suivez la vue 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. |
| serviceEndpointId |
string |
Identité du point de terminaison de service qui contient les informations d’identification à utiliser lors de l’accès au amont. |
| serviceEndpointProjectId |
string |
Spécifie le projectId du point de terminaison de service. |
| status |
Spécifie le status du amont. |
|
| statusDetails |
Fournit une raison lisible pour la status du amont. |
|
| upstreamSourceType |
Type de source, par exemple Public ou Interne. |
UpstreamSourceType
Type de source, par exemple Public ou Interne.
| Nom | Type | Description |
|---|---|---|
| internal |
string |
Azure DevOps amont source. |
| public |
string |
Source disponible publiquement. |
UpstreamStatus
Spécifie le status du amont.
| Nom | Type | Description |
|---|---|---|
| disabled |
string |
La source en amont est désactivée. |
| ok |
string |
La source en amont est correcte. |
UpstreamStatusDetail
| Nom | Type | Description |
|---|---|---|
| reason |
string |
Fournit une raison lisible pour la status du amont. |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour