Vertaa vietävien tietojen inventaariota Power Platformin inventaario-ohjelmointirajapintaan

Power Platform inventory -ohjelmointirajapinta tarjoaa nykyiset varastotiedot Azure Resource Graphin PowerPlatformResources -taulukon kautta. Ohjelmointirajapinta sisältää ydinresurssin, omistajuuden, ympäristön ja yhdistimen tiedot, mutta sen skeema eroaa dataviennin inventaarion skeemasta.

Tässä artikkelissa kuvataan:

  • Varastotiedot, jotka ovat käytettävissä Power Platformin inventaario-API:n kautta.
  • Tietojen viennin inventaario-ominaisuudet, jotka eivät ole käytettävissä.
  • Kohteet, joiden kattavuus on osittainen tai poikkeava.

Lisätietoja varaston kyselystä on kohdassa Power Platform inventory API. Täydellinen ohjelmointirajapintarakenne on kohdassa Power Platformin inventaarion skeemaviite.

Note

Microsoft poistaa käytöstä tietojen viennin esikatseluversion. Varastotietojen vienti loppuu 1.12.2026 jälkeen. Käyttö- ja ympäristödatan vienti jatkuu olemassa olevien ja uusien kokoonpanojen kautta, ja jo viemäsi tiedot pysyvät Data Lake -tallennustilassa. Odota toista ilmoitusta Microsoftilta, kun varastotietojen vienti pysähtyy.

Valmistaudu käyttämällä Power Platform inventory APIa inventaariotietojen ohjelmalliseen viemiseen. Ennen siirtymistä tarkista kenttäkartoitukset ja tunnetut aukot. Jotkin tietojen viennin inventaariokentät eivät ole käytettävissä ohjelmointirajapinnan kautta tai niillä on eri kattavuus.

Power Platform inventory -ohjelmointirajapinta ei automaattisesti vie tietoja asiakkaan omistamaan tallennustilaan. Voit luoda toistuvan viennin käyttämällä Azure-palvelua, kuten Azure-funktiot, Azure Logic Apps tai Azure Automation, kyselyjen tekemiseen Power Platformin inventaario-APIin aikataulun mukaisesti ja tulosten kirjoittamiseen kohteeseen Azure Blob Storage, Azure Data Lake Storage tai muuhun tuettuun kohteeseen.

Tuetut resurssityypit

Power Platform inventory -ohjelmointirajapinta sisältää seuraavat resurssityypit:

Resource Power Platform inventory API:n tyyppi
Canvas-sovellukset microsoft.powerapps/canvasapps
mallipohjaiset sovellukset microsoft.powerapps/modeldrivenapps
Koodisovellukset microsoft.powerapps/codeapps
Managed- ja App Builder -sovellukset microsoft.powerapps/apps
Pilvivirtaukset microsoft.powerautomate/cloudflows
Agentin työnkulut microsoft.powerautomate/agentflows
Agentin työnkulut microsoft.powerautomate/m365agentflows
Copilot Studion agenttien kanssa microsoft.copilotstudio/agents
Liittimet microsoft.powerplatformconnector/connectors
Environments microsoft.powerplatform/environments
Ympäristöryhmät microsoft.powerplatform/environmentgroups

Käytettävissä olevat varastotiedot

Seuraavissa osissa kuvataan käytettävissä olevat kentät resurssityypin ja tietoluokan mukaan.

Jaetun resurssin tiedot

Seuraavat kentät ovat käytettävissä tuetuissa resurssityypeissä. Yhdistimet ovat luetteloentiteettejä, ja ne tukevat vain jaettuja kenttiä, jotka on tunnistettu inventaarion skeemaviitteessä.

Tietoluokka Käytettävissä olevat tiedot Power Platform inventory API -kenttä
Resurssin tunnus Yksilöllinen varastoresurssitunniste name
Resurssin nimi Resurssin näyttönimi properties.displayName
Resurssin tyyppi standardoitu Power Platform -resurssityyppi type
Vuokraaja Vuokralaisen tunniste tenantId
Sijainti Resurssin maantieteellinen sijainti location
Luontipäivämäärä Päivämäärä ja aika, jolloin resurssi luotiin properties.createdAt
Luonut Resurssin luoneen käyttäjän objektitunnus properties.createdBy

Sovelluksen tiedot

Tuetuille sovellustyypeille on saatavilla seuraavat tiedot.

Tietoluokka Käytettävissä olevat tiedot Power Platform inventory API -kenttä
Omistaja Sovelluksen omistajan objektitunnus properties.ownerId
Environment Sovelluksen sisältävän ympäristön tunnus properties.environmentId
Viimeisin muokkaus Päivämäärä ja aika, jolloin sovellusta viimeksi muokattiin properties.lastModifiedAt
Viimeksi muokannut Sovellusta viimeksi muokanneen käyttäjän objektitunnus properties.lastModifiedBy
Karanteenin tila Onko sovellus karanteenissa properties.isQuarantined
Mallipohjaisen sovelluksen tunnus Dataverse-sovellusmoduulin tunniste properties.appModuleId
mallipohjaisen sovelluksen looginen nimi Dataversen looginen nimi properties.logicalName
koodisovelluksen alatyyppi byocApp tai vibeApp properties.subType
Hallitun sovelluksen alatyyppi microsoftApp properties.subType
App Builder -alatyyppi appBuilderApp properties.subType

Flow’n tiedot

Seuraavat tiedot ovat käytettävissä pilvityönkuluille, agenttityönkuluille ja työnkulkuagenteille.

Tietoluokka Käytettävissä olevat tiedot Power Platform inventory API -kenttä
Omistaja Työnkulun omistajan objektitunnus properties.ownerId
Environment Työnkulun sisältävän ympäristön tunnus properties.environmentId
Viimeisin muokkaus Päivämäärä ja aika, jolloin työnkulkua viimeksi muokattiin properties.lastModifiedAt
Viimeksi muokannut Työnkulkua viimeksi muokanneen käyttäjän objektitunnus properties.lastModifiedBy
Työnkulkuentiteetti Dataverse workflow -entiteetin tunnus properties.workflowEntityId
Liipaisinliitin Virtauksen käynnistävä liitin properties.trigger
Käynnistystoiminto Liitintoiminto, joka käynnistää virran properties.triggerOperation

Käynnistinkentät ovat tyhjiä, kun työnkulku käyttää käynnistintä, joka ei ole liitinpohjainen, kuten toistuvaa käynnistintä tai manuaalista käynnistintä.

Liittimen käyttö

Liittimen käyttö on käytettävissä tuetuissa sovelluksissa, työnkuluissa ja agenteissa.

Tietoluokka Käytettävissä olevat tiedot Power Platform inventory API -kenttä
Käytössä olevat yhdistimet Resurssin käyttämien liittimien tunnisteet properties.powerPlatformConnectors[].connectorId
Käytetyt toiminnot Liittimessä kutsuttujen toimintojen tunnisteet properties.powerPlatformConnectors[].operations[].operationId
Vuon käynnistin Liitin, joka käynnistää tuetun työnkulun properties.trigger
Vuon käynnistystoiminto Liitin-toiminto, joka käynnistää tuetun työnkulun properties.triggerOperation

Liittimen ja toiminnon käyttökentät ovat tällä hetkellä esiversiona.

Liitinluettelon tiedot

Liittimet löytyvät myös yksittäisinä varastonimikkeinä.

Tietoluokka Käytettävissä olevat tiedot Power Platform inventory API-kenttä
Liittimen tunnus Liittimen tunnus properties.connectorId
Description Liittimen kuvaus properties.description
Julkaisija Liittimen julkaisijaosapuoli properties.publisher
Tier Vakio- tai Premium-luokitus properties.tier
Julkaisuvaihe Julkaisun määritys, kuten tuotantoversio tai esikatselu properties.releaseTag
Vanhentumistila Onko liitin poistettu käytöstä properties.isDeprecated
Operations Liittimen tarjoamat toiminnot properties.operations
Toiminnon tunnus Toiminnon yksilöllinen tunniste properties.operations[].operationId
Työvaiheen nimi Toiminnon näyttönimi properties.operations[].displayName
Toiminnon kuvaus Toiminnon kuvaus properties.operations[].description
HTTP-menetelmä Toiminnon käyttämä HTTP-menetelmä properties.operations[].method

Ympäristötiedot

Voit löytää seuraavat tiedot ympäristöluettelotietueista.

Tietoluokka Käytettävissä olevat tiedot Power Platform Inventory API -kenttä
Ympäristön tunnus Yksilöllinen ympäristön tunniste name
Ympäristön nimi Ympäristön näyttönimi properties.displayName
Sijainti Ympäristön maantieteellinen sijainti location
Ympäristön tyyppi Tuotanto, oletus, hiekkalaatikko, kokeilu, kehittäjä tai Dataverse for Teams properties.environmentType
Hallinnoitu tila onko kyseessä hallittu ympäristö properties.isManaged
Ympäristöryhmä Määritetyn ympäristöryhmän nimi properties.environmentGroup
Ympäristöryhmän tunnus Määritetyn ympäristöryhmän tunnus properties.environmentGroupId
Viimeisin muokkaus Päivämäärä ja aika, jolloin ympäristöä viimeksi muokattiin properties.lastModifiedAt

Tiedot eivät ole käytettävissä

Seuraavien dataviennin inventaarion ominaisuuksilla ei ole suoria vastaavia julkaistussa Power Platform -inventaarion API-rakenteessa.

Tietoluokka Tietojen viennin inventaariotiedot eivät ole käytettävissä Power Platform -inventaario API:ssa
Sovelluksen kuvaus Pohjaan perustuvan tai mallipohjaisen sovelluksen kuvaus
Sovelluslinkit Sovelluksen URI-osoite, asiakirjan URI-osoite, kuvake URI ja SharePoint-lomakkeen URL
Sharing Niiden käyttäjien ja ryhmien määrä, joiden kanssa sovellus on jaettu
Poistamistila Eksplisiittinen poistetun resurssin ilmaisin
Käyttöönottohistoria Päivämäärä, jolloin sovellus otettiin viimeksi käyttöön, sekä sen käyttöön ottanut käyttäjä
Ratkaisun ja ALM:n tiedot Ratkaisun liittäminen ja ALM-tila
DLP-arviointi Arvioinnin tila, arviointipäivämäärä, virhesanoma ja käytäntökohtaiset rikkomukset
Sovellusmääritykset Asetukset, luontityyppi, asiakaslaitteen tyyppi, upotusisäntä, mukautetut laajennukset ja suorituskyvyn optimointiasetukset
Sovellusesitys Taustakuva, taustaväri, hero-app-nimeke, featured-app-nimeke ja sovellussuunnitelman luokitus
Suostumus ja lisensointi Ohitussuostumusasetus ja app-pass-kelpoisuus
Asiakirjan versio Sovellukseen liittyvä asiakirjaversio
Paikallinen yhdyskäytävän käyttö Eksplisiittinen ilmaisin siitä, että sovellus käyttää paikallista tietoyhdyskäytävää
Dataverse-taulukon käyttö Eksplisiittinen ilmaisin siitä, että sovellus käyttää Dataverse-taulukoita
PCF:n ulkoisen palvelun käyttö Eksplisiittinen ilmaisin siitä, että Power Apps komponenttikehyksen ohjausobjekti käyttää ulkoista palvelua

Important

properties.isQuarantined ilmaisee, onko sovellus karanteenissa. Se ei ole tietojen viennin poistoilmaisimen vastine.

Saatavilla olevat tiedot, joiden kattavuus on erilainen

Jotkin Power Platform -varaston API-kentät tarjoavat aiheeseen liittyviä tietoja, mutta ne eivät vastaa suoraan tietojen viennin ominaisuuksia.

Tietoluokka Tietojen viennin luettelo Power Platform -varaston API-kattavuus
Resurssin tyyppi Erota type- ja subType-arvot Standardoitu resurssitunniste kohteessa type. Osa resurssityypeistä tarjoaa myös properties.subType
Tila ja elinkaari Resurssin tila ja elinkaaritila Karanteenitila on käytettävissä tuetuille sovellustyypeille, mutta se ei kata kaikkia tila- tai elinkaariarvoja
Omistaja Omistajan arvo ja omistajaobjektin tunnus properties.ownerId antaa objektitunnuksen, jos sellainen on saatavilla. Omistajan näyttönimeä ei ole sisällytetty
Mukautetun API:n käyttö Eksplisiittinen mukautettu API-ilmaisin Liitintunnukset ovat käytettävissä tuetuille resursseille, mutta vastaava mukautetun ohjelmointirajapinnan ilmaisin ei ole käytettävissä
Premium-liittimen käyttö Nimenomainen premium-API-ilmaisin Liitintaso on käytettävissä liitinvaraston tietueissa, mutta vastaava resurssitason ilmaisin ei ole käytettävissä
Työnkulkutehtävät Työnkulun toiminnot ja yhdistinkohtaiset ilmaisimet Jäsennetyt liitin- ja toimintotunnisteet ovat käytettävissä tuetuille resurssityypeille
Ympäristön tiedot Ympäristön tunnus resurssissa ja erilliset ympäristön vientitiedot Resurssi sisältää properties.environmentId. Ympäristön tiedot ovat käytettävissä ympäristöinventaariotietueiden kautta

Tunnisteiden kartoitus

Resurssitunnukset eivät ole identtisiä tietojen viennissä ja Power Platformin inventaario-API:ssa.

mallipohjaiset sovellukset

Käytä seuraavaa määritystä mallipohjaisissa sovelluksissa:

Tietojen viennin inventaariokenttä Power Platform inventaario-API-kenttä
environmentId properties.environmentId
resourceId properties.appModuleId
name properties.displayName
type Ja subType type

Power Platform -inventaario-ohjelmointirajapinnan ylimmän tason name kenttä on yksilöivä inventaarioresurssin tunnus. Se ei ole sama kuin mallipohjaisten sovellusten tietojen vienti resourceId.

Jos haluat korreloida mallipohjaisen sovelluksen kahden skeeman välille, käytä molempia properties.environmentId ja properties.appModuleId.

Liitinvaraston rajoitukset

Liitinvarastolla on seuraavat dokumentoidut rajoitukset:

  • Taulukkomuotoiset liittimet voivat näkyä, joissa on tyhjä toimintotaulukko.
  • Sisäänrakennettuja Power Automate -toimintoja, kuten HTTP-, Control- ja Data-toimintoja, ei esitetä liittiminä.
  • Koodisovellukset, vibe-sovellukset, hallitut sovellukset ja App Builder -sovellukset eivät lähetä liittimen käyttötietoja.
  • Mallipohjaisissa sovelluksissa liittimiä raportoidaan harvoin suoraan.
  • Upotetun pohjasovellussivun liittimen käyttö liittyy pohjasovellussivun tietueeseen mallipohjaisen sovelluksen sijaan.
  • Resurssikohtaisen liittimen tiedot sisältävät liittimen ja toimintotunnisteet, mutta eivät sisällä liittimen näyttönimiä, julkaisijan tietoja tai tasoa.
  • Liittimen näyttönimet, julkaisijan tiedot ja taso ovat käytettävissä liitinluettelotietueissa.
  • Liittimen läsnäolo ei ilmaise, käytetäänkö paikallista yhdyskäytävää.

Liittyvä sisältö

  • Viimeksi päivitetty