Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
L’API d’inventaire Power Platform fournit des données d’inventaire actuelles via la PowerPlatformResources table dans Azure Resource Graph. L’API inclut les informations de base sur la ressource, le propriétaire, l’environnement et le connecteur, mais son schéma diffère du schéma d’inventaire d’exportation de données.
Cet article aborde les points suivants :
- Données d’inventaire disponibles via l’API d’inventaire Power Platform.
- Propriétés d’inventaire de l’exportation de données non disponibles.
- Propriétés qui ont une couverture partielle ou différente.
Pour plus d’informations sur l’interrogation de l’inventaire, consultez l’API d’inventaire Power Platform. Pour obtenir le schéma d’API complet, consultez la référence du schéma d’inventaire Power Platform.
Note
Microsoft met fin à la préversion de l’exportation de données. Les exportations de données d’inventaire s’arrêtent après le 1er décembre 2026. Les exportations de données d’utilisation et d’environnement se poursuivent avec les configurations existantes et nouvelles, et les données que vous avez déjà exportées restent dans votre lac de données. Attendez-vous à une autre notification de Microsoft lorsque les exportations de données d’inventaire s’arrêtent.
Pour vous préparer, utilisez l’API d’inventaire Power Platform pour exporter les données d’inventaire par programmation. Avant de migrer, passez en revue les mappages de champs et les lacunes connues. Certains champs d’inventaire d’exportation de données ne sont pas disponibles via l’API ou ont une couverture différente.
L’API d’inventaire Power Platform n’exporte pas automatiquement les données vers le stockage appartenant au client. Pour créer une exportation périodique, utilisez un service Azure, tel que Azure Functions, Azure Logic Apps ou Azure Automation, pour interroger l’API d’inventaire Power Platform selon une planification et écrire les résultats dans Stockage Blob Azure, Azure Data Lake Storage ou une autre destination prise en charge.
Types de ressources pris en charge
L’API d’inventaire Power Platform inclut les types de ressources suivants :
| Resource | Type d’API d’inventaire Power Platform |
|---|---|
| Applications canevas | microsoft.powerapps/canvasapps |
| Applications basées sur des modèles | microsoft.powerapps/modeldrivenapps |
| Applications de code | microsoft.powerapps/codeapps |
| Applications managées et applications App Builder | microsoft.powerapps/apps |
| Flux de cloud | microsoft.powerautomate/cloudflows |
| Flux d’agents | microsoft.powerautomate/agentflows |
| Flux des agents de workflow | microsoft.powerautomate/m365agentflows |
| Agents de Copilot Studio | microsoft.copilotstudio/agents |
| Connectors | microsoft.powerplatformconnector/connectors |
| Environments | microsoft.powerplatform/environments |
| Groupes environnementaux | microsoft.powerplatform/environmentgroups |
Données d’inventaire disponibles
Les sections suivantes décrivent les champs disponibles par type de ressource et catégorie de données.
- Informations sur les ressources partagées
- Informations sur l’application
- Informations de flux
- Utilisation du connecteur
- Informations sur le catalogue des connecteurs
- Informations système
Informations sur les ressources partagées
Les champs suivants sont disponibles pour les types de ressources pris en charge. Les connecteurs sont des entités de catalogue et prennent uniquement en charge les champs partagés identifiés dans la référence de schéma d’inventaire.
| Catégorie de données | Informations disponibles | Champ API d’inventaire Power Platform |
|---|---|---|
| ID de ressource | Identificateur de ressource d’inventaire unique | name |
| Nom de la ressource | Nom d’affichage de la ressource | properties.displayName |
| Type de ressource | Type de ressource Power Platform standardisé | type |
| Tenant | Identificateur de locataire | tenantId |
| Location | Emplacement géographique de la ressource | location |
| Date de création | Date et heure de création de la ressource | properties.createdAt |
| Créé par | ID d’objet de l’utilisateur qui a créé la ressource | properties.createdBy |
Informations sur l’application
Les informations suivantes sont disponibles pour les types d’applications pris en charge.
| Catégorie de données | Informations disponibles | Champ API d’inventaire Power Platform |
|---|---|---|
| Owner | ID d’objet du propriétaire de l’application | properties.ownerId |
| Environment | Identificateur de l’environnement contenant l’application | properties.environmentId |
| Dernière modification | Date et heure de la dernière modification de l’application | properties.lastModifiedAt |
| Dernière modification effectuée par | ID d’objet de l’utilisateur qui a modifié l’application pour la dernière fois | properties.lastModifiedBy |
| État de quarantaine | Indique si l’application est mise en quarantaine | properties.isQuarantined |
| ID d’application basée sur un modèle | Identificateur de module d’application Dataverse | properties.appModuleId |
| Nom logique de l’application pilotée par modèle | Nom logique Dataverse | properties.logicalName |
| Sous-type de Code-app |
byocApp ou vibeApp |
properties.subType |
| Sous-type d’application gérée | microsoftApp |
properties.subType |
| Sous-type d’App Builder | appBuilderApp |
properties.subType |
Informations de flux
Les informations suivantes sont disponibles pour les flux cloud, les flux d’agents et les flux d’agents de workflow.
| Catégorie de données | Informations disponibles | Champ API d’inventaire Power Platform |
|---|---|---|
| Owner | ID d’objet du propriétaire du flux | properties.ownerId |
| Environment | Identificateur de l’environnement contenant le flux | properties.environmentId |
| Dernière modification | Date et heure de la dernière modification du flux | properties.lastModifiedAt |
| Dernière modification effectuée par | ID d’objet de l’utilisateur qui a modifié le flux pour la dernière fois | properties.lastModifiedBy |
| Entité de workflow | Identificateur d’entité de flux de travail Dataverse | properties.workflowEntityId |
| Connecteur de déclenchement | Connecteur qui lance le flux | properties.trigger |
| Déclencher l’opération | Opération de connecteur qui lance le flux | properties.triggerOperation |
Les champs de déclencheur sont vides lorsqu’un flux utilise un déclencheur qui n’est pas basé sur le connecteur, par exemple une périodicité ou un déclencheur manuel.
Utilisation de connecteur
L’utilisation des connecteurs est disponible pour les applications, les flux et les agents pris en charge.
| Catégorie de données | Informations disponibles | Champ API d’inventaire Power Platform |
|---|---|---|
| Connecteurs utilisés | Identificateurs des connecteurs utilisés par la ressource | properties.powerPlatformConnectors[].connectorId |
| Opérations utilisées | Identificateurs des opérations invoquées sur un connecteur | properties.powerPlatformConnectors[].operations[].operationId |
| Déclencheur de flux | Connecteur qui lance un flux pris en charge | properties.trigger |
| Opération de déclenchement du flux | Opération de connecteur qui lance un flux pris en charge | properties.triggerOperation |
Les champs d’utilisation du connecteur et des opérations sont actuellement en préversion.
Informations sur le catalogue de connecteurs
Vous pouvez également trouver des connecteurs en tant qu’éléments de stock individuels.
| Catégorie de données | Informations disponibles | Champ API d’inventaire Power Platform |
|---|---|---|
| ID de connecteur | Identificateur du connecteur | properties.connectorId |
| Description | Description du connecteur | properties.description |
| Éditeur | Éditeur de connecteurs | properties.publisher |
| Tier | Classification standard ou premium | properties.tier |
| Phase de mise en production | Désignation de version, telle que Production ou Préversion | properties.releaseTag |
| État d’obsolescence | Indique si le connecteur est déprécié | properties.isDeprecated |
| Operations | Opérations exposées par le connecteur | properties.operations |
| ID d’opération | Identificateur d’opération unique | properties.operations[].operationId |
| Nom de l’opération | Nom d’affichage de l’opération | properties.operations[].displayName |
| Description de l’opération | Description de l’opération | properties.operations[].description |
| Méthode HTTP | Méthode HTTP utilisée par l’opération | properties.operations[].method |
Informations d’environnement
Vous trouverez les informations suivantes sur les fiches d’inventaire des environnements.
| Catégorie de données | Informations disponibles | Champ API d’inventaire Power Platform |
|---|---|---|
| ID d’environnement | Identificateur d’environnement unique | name |
| Nom de l’environnement | Nom d’affichage de l’environnement | properties.displayName |
| Location | Localisation géographique de l’environnement | location |
| Type d’environnement | Production, Par défaut, Sandbox, Version d’évaluation, Développeur ou Dataverse pour Teams | properties.environmentType |
| Statut géré | Si l’environnement est un environnement managé | properties.isManaged |
| Groupe d’environnement | Nom du groupe d’environnement affecté | properties.environmentGroup |
| ID de groupe d’environnement | Identificateur du groupe d’environnement affecté | properties.environmentGroupId |
| Dernière modification | Date et heure de la dernière modification de l’environnement | properties.lastModifiedAt |
Données non disponibles
Les propriétés d’inventaire d’exportation de données suivantes n’ont pas d’équivalent direct dans le schéma d’API d’inventaire Power Platform publié.
| Catégorie de données | Les informations d’inventaire d’exportation de données ne sont pas disponibles dans l’API d’inventaire Power Platform |
|---|---|
| Description de l’application | Description d’une application canevas ou pilotée par modèle |
| Liens d’application | URI d’application, URI de document, URI d’icône et URL de formulaire SharePoint |
| Partage | Nombre d’utilisateurs et de groupes avec lesquels une application est partagée |
| État de suppression | Indicateur de ressource supprimée explicite |
| Historique des mises en service | Date à laquelle une application a été activée pour la dernière fois et le principal qui l’a activé |
| Informations sur la solution et ALM | Association de solutions et mode ALM |
| Évaluation DLP | État d’évaluation, date d’évaluation, message de violation et violations par règle |
| la configuration d’une application ; | Paramètres, type de création, type d’appareil client, hôte d’intégration, extensions personnalisées et paramètre d’optimisation des performances |
| Présentation de l’application | Image d’arrière-plan, couleur d’arrière-plan, désignation de l’app héroïque, désignation de l’app à la une et classification de plan d’application |
| Consentement et gestion des licences | Paramètre de contournement du consentement et éligibilité de l’app-pass |
| Version du document | Version de document associée à l’application |
| Utilisation de la passerelle de données locale | Indicateur explicite qu’une application utilise une passerelle de données locale |
| Utilisation de la table Dataverse | Indicateur explicite qu’une application utilise des tables Dataverse |
| Utilisation du service external-service de PCF | Indicateur explicite indiquant qu’un contrôle du Power Apps Component Framework utilise un service externe |
Important
properties.isQuarantined indique si une application est mise en quarantaine. Il ne s’agit pas d’un équivalent de l’indicateur de suppression d’exportation de données.
Données disponibles avec une couverture différente
Certains champs de l’API d’inventaire Power Platform fournissent des informations connexes, mais ne sont pas des équivalents directs des propriétés d’exportation de données.
| Catégorie de données | Inventaire des exportations de données | Couverture de l’API d’inventaire Power Platform |
|---|---|---|
| Type de ressource | Séparer les valeurs type et subType |
Identifiant de ressource standardisé dans type. Certains types de ressources proposent également properties.subType |
| État et cycle de vie | État des ressources et état du cycle de vie | L’état de quarantaine est disponible pour les types d’applications pris en charge, mais il ne représente pas toutes les valeurs d’état ou de cycle de vie |
| Owner | Valeur du propriétaire et ID de l’objet du propriétaire |
properties.ownerId fournit un ID d’objet lorsqu’il est disponible. Un nom d’affichage du propriétaire n’est pas inclus |
| Utilisation personnalisée de l’API | Indicateur d’API personnalisée explicite | Les identificateurs de connecteur sont disponibles pour les ressources prises en charge, mais un indicateur d’API personnalisé équivalent n’est pas disponible |
| Utilisation du connecteur premium | Indicateur d’API Premium explicite | Le niveau du connecteur est disponible sur les enregistrements d’inventaire du connecteur, mais un indicateur de niveau ressource équivalent n’est pas disponible |
| Actions de flux de travail | Actions de flux de travail et indicateurs liés au connecteur | Les identificateurs de connecteur et d’opération structurés sont disponibles pour les types de ressources pris en charge |
| Informations sur l’environnement | Identificateur d’environnement sur la ressource et données d’exportation d’environnement distinctes | La ressource inclut properties.environmentId. Les détails de l’environnement sont disponibles via les enregistrements d’inventaire de l’environnement |
Correspondance des identifiants
Les identificateurs de ressource ne sont pas représentés de manière identique dans l’exportation de données et l’API d’inventaire Power Platform.
Applications basées sur des modèles
Utilisez le mappage suivant pour les applications basées sur des modèles :
| Champ d’inventaire d’exportation de données | Champ API d’inventaire Power Platform |
|---|---|
environmentId |
properties.environmentId |
resourceId |
properties.appModuleId |
name |
properties.displayName |
type et subType |
type |
Le champ de niveau name supérieur de l’API d’inventaire Power Platform est l’identificateur de ressource d’inventaire unique. Elle n’est pas équivalente à l’exportation resourceId de données pour les applications pilotées par modèle.
Pour mettre en corrélation une application pilotée par modèle entre les deux schémas, utilisez les deux properties.environmentId et properties.appModuleId.
Limitations de l’inventaire des connecteurs
L’inventaire des connecteurs comporte les limitations documentées suivantes :
- Les connecteurs tabulaires peuvent apparaître avec un tableau d’opérations vide.
- Les actions intégrées Power Automate, y compris les opérations HTTP, Contrôle et Données, ne sont pas représentées en tant que connecteurs.
- Les applications Code, les applications Vibe, les applications gérées et les applications App Builder n’émettent pas de données d’utilisation du connecteur.
- Les applications basées sur des modèles affichent rarement directement les connecteurs.
- L’utilisation du connecteur par une page de canevas incorporée est associée à l’enregistrement de page de canevas au lieu de l’application basée sur des modèles contenant.
- Les données du connecteur par ressource incluent des identificateurs de connecteur et d’opération, mais n’incluent pas les noms d’affichage du connecteur, les informations d’éditeur ou le niveau.
- Les noms d’affichage du connecteur, les informations sur le fournisseur et le niveau sont disponibles sur les enregistrements d’inventaire du connecteur.
- La présence du connecteur n’indique pas si une passerelle locale est utilisée.