Comparați inventarul de export de date cu API-ul de inventar Power Platform

API-ul pentru inventarul Power Platform oferă date de inventar curente prin intermediul tabelului PowerPlatformResources din Azure Resource Graph. API-ul include informații de bază despre resurse, proprietate, mediu și conector, dar schema sa diferă de schema de inventar a exportului de date.

Acest articol descrie:

  • Datele de inventar disponibile prin API-ul de inventar Power Platform.
  • Proprietățile de inventar ale exportului de date care nu sunt disponibile.
  • Proprietăți care au o acoperire parțială sau diferită.

Pentru informații despre interogarea inventarului, consultați API-uri pentru inventarul Power Platform. Pentru schema API completă, consultați Referință schemă de inventar a platformei Power Platform.

Notă

Microsoft retrage versiunea preliminară a exportului de date. Exporturile de date de inventar se opresc după 1 decembrie 2026. Exporturile de date despre utilizare și mediu continuă prin configurațiile existente și noi și datele pe care le-ați exportat deja rămâne în lacul de date. Așteptați o altă notificare de la Microsoft atunci când exporturile de date de inventar se opresc.

Pentru a vă pregăti, utilizați API-ul de inventar Power Platform pentru a exporta prin programare datele de inventar. Înainte de a migra, revizuiți mapările de câmp și spațiile cunoscute. Unele câmpuri de inventar de export de date nu sunt disponibile prin API sau au o acoperire diferită.

API-ul de inventar Power Platform nu exportă automat datele în spațiul de stocare deținut de client. Pentru a crea un export recurent, utilizați un serviciu de Azure, cum ar fi Azure Functions, Azure Logic Apps sau Azure Automation, pentru a interoga API-ul de inventar Power Platform după un program și scrieți rezultatele în Azure Blob Storage, Azure Data Lake Storage sau o altă destinație acceptată.

Tipuri de resurse acceptate

API-ul de inventar Power Platform include următoarele tipuri de resurse:

Resursă Tip API inventar Power Platform
Aplicații pânză microsoft.powerapps/canvasapps
Aplicații bazate pe modele microsoft.powerapps/modeldrivenapps
Aplicații de cod microsoft.powerapps/codeapps
Aplicații Gestionate și Generator de aplicații microsoft.powerapps/apps
Fluxurile pentru cloud microsoft.powerautomate/cloudflows
Curgeri de agenți microsoft.powerautomate/agentflows
Fluxuri de agenți de workflow microsoft.powerautomate/m365agentflows
Agenți Copilot Studio microsoft.copilotstudio/agents
Connectors microsoft.powerplatformconnector/connectors
Mediile microsoft.powerplatform/environments
Grupurile de medii microsoft.powerplatform/environmentgroups

Date de inventar disponibile

Următoarele secțiuni descriu câmpurile disponibile după tipul de resurse și categoria de date.

Informații despre resurse partajate

Următoarele câmpuri sunt disponibile pentru tipurile de resurse acceptate. Conectorii sunt entități de catalog și acceptă numai câmpurile partajate identificate în referința schemei de inventar.

Categorie de date Informații disponibile Câmpul API al inventarului Power Platform
ID resursă Identificator unic de resurse de inventar name
Nume resursă Nume afișat resurse properties.displayName
Tip de resursă Tip de resursă Power Platform standardizat type
Entitate găzduită Identificator entitate găzduită tenantId
Locație Locația geografică a resursei location
Data creării Data și ora la care a fost creată resursa properties.createdAt
Creat de ID-ul de obiect al utilizatorului care a creat resursa properties.createdBy

Informații despre aplicație

Următoarele informații sunt disponibile pentru tipurile de aplicații acceptate.

Categorie de date Informații disponibile Câmpul API al inventarului Power Platform
Proprietar ID-ul de obiect al proprietarului aplicației properties.ownerId
Mediu Identificatorul mediului care conține aplicația properties.environmentId
Ultima modificare Data și ora ultimei modificări a aplicației properties.lastModifiedAt
Ultima modificare de ID-ul de obiect al utilizatorului care a modificat ultima dată aplicația properties.lastModifiedBy
Stare carantină Dacă aplicația este în carantină properties.isQuarantined
ID aplicație bazat pe model Identificator modul aplicațieverse properties.appModuleId
Nume logic de aplicație bazat pe modele Dataverse nume logic properties.logicalName
Subtipul aplicației cod byocApp sau vibeApp properties.subType
Subtip aplicație gestionată microsoftApp properties.subType
SubtipUl Generatorului de aplicații appBuilderApp properties.subType

Informații flux

Următoarele informații sunt disponibile pentru fluxurile în cloud, fluxurile agent și fluxurile agentului de flux de lucru.

Categorie de date Informații disponibile Câmpul API al inventarului Power Platform
Proprietar ID-ul obiectului proprietarului fluxului properties.ownerId
Mediu Identificatorul mediului care conține fluxul properties.environmentId
Ultima modificare Data și ora ultimei modificări a fluxului properties.lastModifiedAt
Ultima modificare de ID-ul de obiect al utilizatorului care a modificat ultima dată fluxul properties.lastModifiedBy
Entitate flux de lucru Dataverse workflow entity identifier properties.workflowEntityId
Declanșator conector Conector care inițiază fluxul properties.trigger
Operațiune de declanșare Operațiune de conector care inițiază fluxul properties.triggerOperation

Câmpurile trigger sunt goale atunci când un flux utilizează un trigger care nu este bazat pe conector, cum ar fi o repetare sau un declanșator manual.

Utilizarea conectorului

Utilizarea conectorului este disponibilă pentru aplicațiile, fluxurile și agenții acceptați.

Categorie de date Informații disponibile Câmpul API al inventarului Power Platform
Conectori utilizați Identificatori de conectori utilizați de resursă properties.powerPlatformConnectors[].connectorId
Operațiuni utilizate Identificatorii operațiunilor invocate pe un conector properties.powerPlatformConnectors[].operations[].operationId
Declanșator flux Conector care inițiază un flux acceptat properties.trigger
Operațiune declanșator flux Operațiune de conector care inițiază un flux acceptat properties.triggerOperation

Informații catalog conector

De asemenea, puteți găsi conectori ca resurse individuale de inventar.

Categorie de date Informații disponibile Câmpul API al inventarului Power Platform
ID conector Identificator conector properties.connectorId
Descriere Descriere conector properties.description
Publisher Editor conector properties.publisher
Nivelul Clasificare standard sau Premium properties.tier
Etapa de lansare Denumirea versiunii, cum ar fi Producție sau Previzualizare properties.releaseTag
Stare perimare Dacă conectorul este perimat properties.isDeprecated
Operațiuni Operațiuni expuse de conector properties.operations
ID operațiune Identificator unic al operațiunii properties.operations[].operationId
Numele operațiunii Nume afișat operațiune properties.operations[].displayName
Descriere operațiune Descrierea operațiunii properties.operations[].description
Metodă HTTP Metoda HTTP utilizată de operațiune properties.operations[].method

Informații despre mediu

Puteți găsi următoarele informații despre înregistrările inventarului mediului.

Categorie de date Informații disponibile Câmpul API al inventarului Power Platform
ID mediu Identificator unic de mediu name
Nume mediu Nume afișat mediu properties.displayName
Locație Locația geografică a mediului location
Tip de mediu Producție, implicit, Sandbox, versiune de încercare, dezvoltator sauverse de date pentru Teams properties.environmentType
Stare gestionată Dacă mediul este un mediu gestionat properties.isManaged
Grup de mediu Numele grupului de mediu atribuit properties.environmentGroup
ID grup mediu Identificator al grupului de mediu atribuit properties.environmentGroupId
Ultima modificare Data și ora ultimei modificări a mediului properties.lastModifiedAt

Datele nu sunt disponibile

Următoarele proprietăți de inventar de export de date nu au echivalente directe în schema API de inventar Power Platform publicată.

Categorie de date Informațiile despre inventarul de export de date nu sunt disponibile în API-ul de inventar Power Platform
Descriere aplicație Descrierea unei pânze sau a unei aplicații bazate pe modele
Linkuri aplicație URI-ul aplicației, URI-ul documentului, URI-ul pictogramei și URL-ul SharePoint formular
Partajare Numărul de utilizatori și grupuri cu care este partajată o aplicație
Stare ștergere Indicator explicit de resurse șterse
Istoric de activare Data la care o aplicație a fost activată ultima dată și entitatea principală care a activat-o
Informații despre soluții și ALM Asocierea soluțiilor și modul ALM
Evaluare DLP Starea evaluării, data evaluării, mesajul de încălcare și încălcările după politică
Configurarea aplicațiilor Setări, tip de creare, tip de dispozitiv client, gazdă încorporată, extensii particularizate și setări de optimizare a performanței
Prezentare aplicație Imagine de fundal, culoarea de fundal, denumirea erou-aplicație, denumirea recomandate a aplicațiilor și clasificarea planului de aplicații
Consimțământul și licențierea Ocolirea setării de consimțământ și eligibilitatea pentru app-pass
Versiune document Versiunea documentului asociată aplicației
Utilizarea gateway-ului local Indicator explicit că o aplicație utilizează un gateway de date local
Utilizarea tabelului Dataverse Indicator explicit că o aplicație utilizează tabele Dataverse
Utilizare serviciu extern PCF Indicator explicit că un control cadru de componente Power Apps utilizează un serviciu extern

Important

properties.isQuarantined indică dacă o aplicație este în carantină. Acesta nu este un echivalent al indicatorului de ștergere a exportului de date.

Datele disponibile cu acoperire diferită

Unele câmpuri API de inventar Power Platform oferă informații asociate, dar nu sunt echivalente directe ale proprietăților de export de date.

Categorie de date Inventar export date Acoperire API pentru inventarul Power Platform
Tip de resursă Separare type și subType valori Un identificator de resursă standardizat în type. Unele tipuri de resurse oferă, de asemenea, properties.subType
Stare și ciclu de viață Starea resursei și starea ciclului de viață Starea de carantină este disponibilă pentru tipurile de aplicații acceptate, dar nu reprezintă toate valorile privind starea sau ciclul de viață
Proprietar Valoarea proprietarului și ID-ul obiectului proprietarului properties.ownerId furnizează un ID de obiect atunci când este disponibil. Numele afișat al proprietarului nu este inclus
Utilizare API particularizată Indicator API particularizat explicit Identificatorii de conectori sunt disponibili pentru resurse acceptate, dar un indicator API particularizat echivalent nu este disponibil
Utilizarea conectorului Premium Indicator API premium explicit Nivelul conectorului este disponibil în înregistrările inventarului conectorului, dar un indicator echivalent la nivel de resurse nu este disponibil
Acțiuni de flux de lucru Acțiuni flux de lucru și indicatori asociați conectorilor Identificatorii de conectori și operațiuni structurate sunt disponibili pentru tipurile de resurse acceptate
Informații despre mediu Identificatorul de mediu pentru resursă și date separate de export mediu Resursa include properties.environmentId. Detaliile despre mediu sunt disponibile prin înregistrările inventarului de mediu

Mapare identificator

Identificatorii de resurse nu sunt reprezentați identic în exportul de date și API-ul de inventar Power Platform.

Aplicații bazate pe modele

Utilizați următoarea mapare pentru aplicațiile bazate pe modele:

Câmpul de inventar export date Câmpul API al inventarului Power Platform
environmentId properties.environmentId
resourceId properties.appModuleId
name properties.displayName
type şi subType type

Câmpul API de inventar Power Platform de nivel name superior este identificatorul unic de resurse de inventar. Nu este echivalent cu exportul resourceId de date pentru aplicațiile bazate pe modele.

Pentru a corela o aplicație bazată pe model între cele două scheme, utilizați ambele properties.environmentId și properties.appModuleId.

Limitările inventarului conectorului

Inventarul conectorului are următoarele limitări documentate:

  • Conectorii tabelare pot apărea cu o matrice de operațiuni goală.
  • Acțiunile de Power Automate predefinite, inclusiv operațiunile HTTP, Control și Date, nu sunt reprezentate ca conectori.
  • Aplicațiile de cod, aplicațiile vibe, aplicațiile gestionate și aplicațiile App Builder nu emit date de utilizare a conectorilor.
  • Aplicațiile bazate pe modele rareori raportează conectorii direct.
  • Utilizarea conectorului de către o pagină de pânză încorporată este asociată cu înregistrarea paginii pânzei în locul aplicației care conține modelul.
  • Datele conectorilor per resursă includ identificatori conectori și operațiuni, dar nu includ nume afișate de conectori, informații despre editor sau nivel.
  • Numele afișate ale conectorilor, informațiile despre editor și nivelul sunt disponibile în înregistrările de inventar ale conectorului.
  • Prezența conectorului nu indică dacă este utilizat un gateway local.