Notă
Accesul la această pagină necesită autorizare. Puteți încerca să vă conectați sau să modificați directoarele.
Accesul la această pagină necesită autorizare. Puteți încerca să modificați directoarele.
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
- Informații despre aplicație
- Informații flux
- Utilizarea conectorului
- Informații catalog conector
- Informații despre mediu
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.