Bandingkan inventaris ekspor data dengan API inventaris Power Platform

API inventori Power Platform menyediakan data inventaris saat ini melalui PowerPlatformResources tabel di Azure Resource Graph. API mencakup sumber daya inti, kepemilikan, lingkungan, dan informasi konektor, tetapi skemanya berbeda dari skema inventori ekspor data.

Artikel ini menjelaskan:

  • Data inventori tersedia melalui API inventaris Power Platform.
  • Properti inventaris ekspor data yang tidak tersedia.
  • Properti yang memiliki cakupan parsial atau berbeda.

Untuk informasi tentang mengkueri inventaris, lihat API inventori Power Platform. Untuk skema API lengkap, lihat Referensi skema inventori Power Platform.

Note

Microsoft menghentikan versi pratinjau ekspor data. Ekspor data inventori berhenti setelah 1 Desember 2026. Ekspor data penggunaan dan lingkungan berlanjut melalui konfigurasi yang ada maupun yang baru, dan data yang sudah Anda ekspor tetap berada di data lake Anda. Anda akan menerima pemberitahuan lain dari Microsoft saat ekspor data inventori berhenti.

Untuk mempersiapkannya, gunakan API inventaris Power Platform untuk mengekspor data inventori secara terprogram. Sebelum Anda bermigrasi, tinjau pemetaan kolom dan celah yang diketahui. Beberapa bidang inventori ekspor data tidak tersedia melalui API atau memiliki cakupan yang berbeda.

API inventori Power Platform tidak secara otomatis mengekspor data ke penyimpanan milik pelanggan. Untuk membuat ekspor berulang, gunakan layanan Azure, seperti Azure Functions, Azure Logic Apps, atau Azure Automation, untuk mengkueri API inventori Power Platform sesuai jadwal dan menulis hasilnya ke Azure Blob Storage, Azure Data Lake Storage, atau tujuan lain yang didukung.

Jenis sumber daya yang didukung

API inventori Power Platform mencakup jenis sumber daya berikut:

Resource Jenis API inventori Power Platform
Aplikasi kanvas microsoft.powerapps/canvasapps
Aplikasi berbasis model microsoft.powerapps/modeldrivenapps
Aplikasi kode microsoft.powerapps/codeapps
Aplikasi Terkelola dan aplikasi App Builder microsoft.powerapps/apps
Aliran cloud microsoft.powerautomate/cloudflows
Alur agen microsoft.powerautomate/agentflows
Alur agen alur kerja microsoft.powerautomate/m365agentflows
Agen Copilot Studio microsoft.copilotstudio/agents
Connectors microsoft.powerplatformconnector/connectors
Environments microsoft.powerplatform/environments
Kelompok lingkungan microsoft.powerplatform/environmentgroups

Data inventori yang tersedia

Bagian berikut ini menjelaskan bidang yang tersedia berdasarkan jenis sumber daya dan kategori data.

Informasi sumber daya bersama

Bidang berikut ini tersedia untuk jenis sumber daya yang didukung. Konektor adalah entitas katalog dan hanya mendukung bidang bersama yang diidentifikasi dalam referensi skema inventori.

Kategori data Informasi yang tersedia Kolom API inventori Power Platform
ID Sumber Daya Pengidentifikasi sumber daya inventori unik name
Nama sumber daya Nama tampilan sumber daya properties.displayName
Jenis sumber daya Jenis sumber daya Power Platform terstandarisasi type
Tenant ID penyewa tenantId
Location Lokasi geografis resource location
Tanggal pembuatan Tanggal dan waktu saat sumber daya dibuat properties.createdAt
Dibuat oleh ID objek milik pengguna yang membuat sumber daya properties.createdBy

Informasi aplikasi

Informasi berikut tersedia untuk jenis aplikasi yang didukung.

Kategori data Informasi yang tersedia Kolom API inventori Power Platform
Pemilik ID objek pemilik aplikasi properties.ownerId
Environment ID lingkungan yang berisi aplikasi properties.environmentId
Terakhir diubah Tanggal dan waktu aplikasi terakhir diubah properties.lastModifiedAt
Terakhir diubah oleh ID objek dari pengguna yang terakhir mengubah aplikasi properties.lastModifiedBy
Status karantina Apakah aplikasi sedang dikarantina properties.isQuarantined
ID aplikasi berbasis model Pengidentifikasi modul aplikasi Dataverse properties.appModuleId
Nama logika aplikasi berbasis model Nama logis Dataverse properties.logicalName
Subtipe code-app byocApp atau vibeApp properties.subType
Subjenis aplikasi terkelola microsoftApp properties.subType
Subjenis App Builder appBuilderApp properties.subType

Informasi alur

Informasi berikut tersedia untuk alur cloud, alur agen, dan alur agen workflow.

Kategori data Informasi yang tersedia Kolom API inventori Power Platform
Pemilik ID objek pemilik alur properties.ownerId
Environment Pengidentifikasi lingkungan yang berisi flow properties.environmentId
Terakhir diubah Tanggal dan waktu saat alur terakhir diubah properties.lastModifiedAt
Terakhir diubah oleh ID objek dari pengguna yang terakhir mengubah alur properties.lastModifiedBy
Entitas alur kerja Pengidentifikasi entitas alur kerja Dataverse properties.workflowEntityId
Konektor pemicu Konektor yang memulai alur properties.trigger
Jalankan operasi Operasi konektor yang memulai alur properties.triggerOperation

Bidang pemicu kosong saat alur menggunakan pemicu yang tidak berbasis konektor, seperti pengulangan atau pemicu manual.

Penggunaan konektor

Penggunaan konektor tersedia untuk aplikasi, alur, dan agen yang didukung.

Kategori data Informasi yang tersedia Kolom API inventori Power Platform
Konektor yang digunakan Pengidentifikasi konektor yang digunakan oleh sumber daya properties.powerPlatformConnectors[].connectorId
Operasi yang digunakan Pengidentifikasi operasi yang dipanggil pada konektor properties.powerPlatformConnectors[].operations[].operationId
Pemicu alur Konektor yang memulai alur yang didukung properties.trigger
Operasi pemicu alur Operasi konektor yang memulai alur yang didukung properties.triggerOperation

Bidang penggunaan konektor dan operasi saat ini berada dalam pratinjau.

Informasi katalog konektor

Anda juga dapat menemukan konektor sebagai sumber daya inventori individual.

Kategori data Informasi yang tersedia Kolom API inventori Power Platform
ID Konektor Pengidentifikasi konektor properties.connectorId
Deskripsi Deskripsi konektor properties.description
Penerbit Publisher konektor properties.publisher
Tier Klasifikasi Standar atau Premium properties.tier
Tahap rilis Penetapan rilis, seperti Produksi atau Pratinjau properties.releaseTag
Status deprekasi Apakah konektor usang properties.isDeprecated
Operations Operasi yang diekspos oleh konektor properties.operations
ID Operasi Pengidentifikasi operasi unik properties.operations[].operationId
Nama operasi Nama tampilan operasi properties.operations[].displayName
Deskripsi operasi Deskripsi operasi properties.operations[].description
metode HTTP Metode HTTP yang digunakan oleh operasi properties.operations[].method

Informasi lingkungan

Anda dapat menemukan informasi berikut tentang catatan inventaris lingkungan.

Kategori data Informasi yang tersedia Kolom API inventori Power Platform
ID Lingkungan Pengenal lingkungan unik name
Nama lingkungan Nama tampilan lingkungan properties.displayName
Location Lokasi geografis lingkungan location
Jenis lingkungan Produksi, Default, Sandbox, Uji Coba, Pengembang, atau Dataverse untuk Teams properties.environmentType
Status terkelola Apakah lingkungan tersebut merupakan lingkungan terkelola properties.isManaged
Kelompok lingkungan Nama grup lingkungan yang ditetapkan properties.environmentGroup
ID grup lingkungan Pengidentifikasi grup lingkungan yang ditetapkan properties.environmentGroupId
Terakhir diubah Tanggal dan waktu saat lingkungan terakhir diubah properties.lastModifiedAt

Data tidak tersedia

Properti inventori ekspor data berikut ini tidak memiliki padanan langsung dalam skema API inventori Power Platform yang diterbitkan.

Kategori data Informasi inventaris untuk ekspor data tidak tersedia di API inventori Power Platform
Deskripsi aplikasi Deskripsi aplikasi kanvas atau aplikasi berbasis model
Tautan aplikasi URI aplikasi, URI dokumen, URI ikon, dan URL formulir SharePoint
Berbagi Jumlah pengguna dan grup dengan siapa aplikasi dibagikan
Status penghapusan Indikator sumber daya terhapus eksplisit
Riwayat pengaktifan Tanggal saat aplikasi terakhir diaktifkan dan akun yang mengaktifkannya
Solusi dan informasi ALM Asosiasi Solution dan mode ALM
Evaluasi DLP Status evaluasi, tanggal evaluasi, pesan pelanggaran, dan pelanggaran berdasarkan kebijakan
Konfigurasi aplikasi Pengaturan, jenis pembuatan, jenis perangkat klien, host penyematan, ekstensi kustom, dan pengaturan pengoptimalan performa
Presentasi aplikasi Gambar latar belakang, warna latar belakang, penentuan hero-app, penentuan aplikasi unggulan, dan klasifikasi plan aplikasi
Persetujuan dan lisensi Pengaturan melewati persetujuan dan kelayakan izin aplikasi
Versi dokumen Versi dokumen yang terkait dengan aplikasi
Penggunaan gateway on-premises Indikator eksplisit bahwa aplikasi menggunakan gateway data on-premises
Penggunaan tabel Dataverse Indikator eksplisit bahwa aplikasi menggunakan tabel Dataverse
Penggunaan layanan eksternal PCF Indikator eksplisit bahwa kontrol kerangka kerja komponen Power Apps menggunakan layanan eksternal

Important

properties.isQuarantined menunjukkan apakah aplikasi dikarantina. Itu tidak setara dengan indikator penghapusan ekspor data.

Data tersedia dengan cakupan yang berbeda

Beberapa bidang API inventori Power Platform menyediakan informasi terkait tetapi tidak setara langsung dengan properti ekspor data.

Kategori data Inventaris ekspor data Cakupan API inventori Power Platform
Jenis sumber daya Pisahkan nilai type dan subType Pengenal sumber daya standar di type. Beberapa jenis sumber daya juga menyediakan properties.subType
Status dan siklus hidup Status sumber daya dan status daur hidup status karantina tersedia untuk jenis aplikasi yang didukung, tetapi tidak mewakili semua status atau nilai siklus hidup
Pemilik Nilai pemilik dan ID objek pemilik properties.ownerId menyediakan ID objek jika tersedia. Nama tampilan pemilik tidak disertakan
Penggunaan API kustom Indikator API kustom eksplisit Pengidentifikasi konektor tersedia untuk sumber daya yang didukung, tetapi indikator API kustom yang setara tidak tersedia
Penggunaan konektor premium Indikator API premium eksplisit tier konektor tersedia pada rekaman inventori konektor, tetapi indikator tingkat sumber daya yang setara tidak tersedia
Aksi alur kerja Tindakan alur kerja dan indikator terkait konektor Konektor terstruktur dan pengidentifikasi operasi tersedia untuk jenis sumber daya yang didukung
Informasi lingkungan Pengidentifikasi lingkungan pada sumber daya dan data ekspor lingkungan terpisah Sumber daya mencakup properties.environmentId. Detail lingkungan tersedia melalui catatan inventaris lingkungan

Pemetaan pengidentifikasi

Pengidentifikasi sumber daya tidak diwakili secara identik dalam ekspor data dan API inventori Power Platform.

Aplikasi berbasis model

Gunakan pemetaan berikut untuk aplikasi berbasis model:

Bidang inventaris ekspor data Kolom API inventori Power Platform
environmentId properties.environmentId
resourceId properties.appModuleId
name properties.displayName
type dan subType type

Bidang tingkat teratas name API inventaris Power Platform adalah pengidentifikasi sumber daya inventori unik. Ini tidak setara dengan ekspor data resourceId untuk aplikasi berbasis model.

Untuk mengorelasikan aplikasi berbasis model antara dua skema, gunakan keduanya, properties.environmentId dan properties.appModuleId.

Batasan inventaris konektor

Inventori konektor memiliki batasan yang didokumenkan berikut:

  • Konektor tabular dapat muncul dengan array operasi kosong.
  • Tindakan Power Automate bawaan, termasuk operasi HTTP, Kontrol, dan Data, tidak diwakili sebagai konektor.
  • Aplikasi kode, aplikasi vibe, aplikasi terkelola, dan aplikasi App Builder tidak mengeluarkan data penggunaan konektor.
  • Aplikasi berbasis model jarang melaporkan konektor secara langsung.
  • Penggunaan konektor oleh halaman kanvas yang disematkan dikaitkan dengan catatan halaman kanvas, bukan dengan aplikasi berbasis model yang memuatnya.
  • Data konektor per sumber daya mencakup pengidentifikasi konektor dan operasi tetapi tidak menyertakan nama tampilan konektor, informasi penerbit, atau tingkatan.
  • Nama tampilan konektor, informasi penerbit, dan tingkatan tersedia pada rekaman inventori konektor.
  • Kehadiran konektor tidak menunjukkan apakah gateway lokal digunakan.

Konten terkait

  • Terakhir diperbarui pada