Συγκρίνετε την απογραφή εξαγωγής δεδομένων με το API απογραφής Power Platform

Το API απογραφής Power Platform παρέχει τρέχοντα δεδομένα απογραφής μέσω του PowerPlatformResources πίνακα στο Γράφημα πόρου του Azure. Το API περιλαμβάνει πληροφορίες βασικού πόρου, κυριότητας, περιβάλλοντος και σύνδεσης, αλλά το σχήμα του διαφέρει από το σχήμα απογραφής εξαγωγής δεδομένων.

Αυτό το άρθρο περιγράφει τα εξής:

  • Δεδομένα αποθέματος διαθέσιμα μέσω του API αποθέματος Power Platform.
  • Ιδιότητες απογραφής για εξαγωγή δεδομένων που δεν είναι διαθέσιμες.
  • Ιδιότητες που έχουν μερική ή διαφορετική κάλυψη.

Για πληροφορίες σχετικά με την υποβολή ερωτημάτων στο inventory, ανατρέξτε στο Power Platform inventory API. Για το πλήρες σχήμα API, ανατρέξτε στο θέμα Αναφορά σχήματος αποθέματος Power Platform.

Σημείωμα

Microsoft αποσύρει την έκδοση προεπισκόπησης της εξαγωγής δεδομένων. Οι εξαγωγές δεδομένων αποθέματος σταματούν μετά την 1η Δεκεμβρίου 2026. Οι εξαγωγές δεδομένων χρήσης και περιβάλλοντος συνεχίζονται μέσω υπαρχουσών και νέων διαμορφώσεων και τα δεδομένα που έχετε ήδη εξαγάγει παραμένουν στη λίμνη δεδομένων σας. Αναμένετε μια άλλη ειδοποίηση από τη Microsoft όταν σταματήσουν οι εξαγωγές δεδομένων αποθέματος.

Για να προετοιμαστείτε, χρησιμοποιήστε το API απογραφής Power Platform για να εξαγάγετε δεδομένα απογραφής μέσω προγραμματισμού. Πριν από τη μετεγκατάσταση, εξετάστε τις αντιστοιχίσεις πεδίων και τα γνωστά κενά. Ορισμένα πεδία απογραφής εξαγωγής δεδομένων δεν είναι διαθέσιμα μέσω του API ή έχουν διαφορετική κάλυψη.

Το API απογραφής του Power Platform δεν εξάγει αυτόματα δεδομένα σε χώρο αποθήκευσης που ανήκει στον πελάτη. Για να δημιουργήσετε μια περιοδική εξαγωγή, χρησιμοποιήστε μια υπηρεσία Azure, όπως Azure Functions, Azure Logic Apps ή Azure Automation, για να υποβάλετε ερωτήματα στο API απογραφής Power Platform βάσει χρονοδιαγράμματος και να γράψετε τα αποτελέσματα σε Azure Blob Storage, Azure Data Lake Storage ή σε άλλον υποστηριζόμενο προορισμό.

Υποστηριζόμενοι τύποι πόρων

Το API απογραφής Power Platform περιλαμβάνει τους ακόλουθους τύπους πόρων:

Πόρος Τύπος API απογραφής Power Platform
Εφαρμογές τύπου Canvas microsoft.powerapps/canvasapps
Εφαρμογές βάσει μοντέλου microsoft.powerapps/modeldrivenapps
Εφαρμογές κώδικα microsoft.powerapps/codeapps
Διαχειριζόμενες εφαρμογές και εφαρμογές του App Builder microsoft.powerapps/apps
Ροές νέφους microsoft.powerautomate/cloudflows
Ροές παράγοντα microsoft.powerautomate/agentflows
Ροές παράγοντα ροής εργασιών microsoft.powerautomate/m365agentflows
πράκτορες του Copilot Studio microsoft.copilotstudio/agents
Connectors microsoft.powerplatformconnector/connectors
Environments microsoft.powerplatform/environments
Ομάδες περιβάλλοντος microsoft.powerplatform/environmentgroups

Διαθέσιμα δεδομένα αποθέματος

Οι παρακάτω ενότητες περιγράφουν τα διαθέσιμα πεδία κατά τύπο πόρου και κατηγορία δεδομένων.

Πληροφορίες κοινόχρηστου πόρου

Τα παρακάτω πεδία είναι διαθέσιμα για υποστηριζόμενους τύπους πόρων. Οι connectors είναι οντότητες καταλόγου και υποστηρίζουν μόνο τα κοινόχρηστα πεδία που προσδιορίζονται στην τεκμηρίωση του σχήματος inventory.

Κατηγορία δεδομένων Διαθέσιμες πληροφορίες Πεδίο API απογραφής Power Platform
Αναγνωριστικό πόρου Μοναδικό αναγνωριστικό πόρου αποθέματος name
Όνομα πόρου Εμφανιζόμενο όνομα πόρου properties.displayName
Τύπος πόρου Τυπικός τύπος πόρου Power Platform type
Ενοικιαστής Αναγνωριστικό μισθωτή tenantId
Τοποθεσία Γεωγραφική θέση του στοιχείου location
Ημερομηνία δημιουργίας Ημερομηνία και ώρα που δημιουργήθηκε ο πόρος properties.createdAt
Δημιουργήθηκε από Αναγνωριστικό αντικειμένου του χρήστη που δημιούργησε τον πόρο properties.createdBy

Πληροφορίες εφαρμογής

Οι παρακάτω πληροφορίες είναι διαθέσιμες για τους υποστηριζόμενους τύπους εφαρμογών.

Κατηγορία δεδομένων Διαθέσιμες πληροφορίες Πεδίο API απογραφής Power Platform
Ιδιοκτήτης Αναγνωριστικό αντικειμένου του κατόχου της εφαρμογής properties.ownerId
Environment Αναγνωριστικό του περιβάλλοντος που περιέχει την εφαρμογή properties.environmentId
Τελευταία τροποποίηση Ημερομηνία και ώρα τελευταίας τροποποίησης της εφαρμογής properties.lastModifiedAt
Τελευταία τροποποίηση από Αναγνωριστικό αντικειμένου του χρήστη που τροποποίησε τελευταία φορά την εφαρμογή properties.lastModifiedBy
Κατάσταση καραντίνας Εάν η εφαρμογή βρίσκεται σε καραντίνα properties.isQuarantined
Αναγνωριστικό εφαρμογής βάσει μοντέλου Αναγνωριστικό μονάδας εφαρμογής Dataverse properties.appModuleId
Λογικό όνομα εφαρμογής βάσει μοντέλου Λογικό όνομα του Dataverse properties.logicalName
Υποτύπος εφαρμογής code-app byocApp ή vibeApp. properties.subType
Υποτύπος διαχειριζόμενης εφαρμογής microsoftApp properties.subType
Υποτύπος App Builder appBuilderApp properties.subType

Πληροφορίες ροής

Οι ακόλουθες πληροφορίες είναι διαθέσιμες για ροές cloud, ροές agent και ροές agent ροής εργασιών.

Κατηγορία δεδομένων Διαθέσιμες πληροφορίες Πεδίο API απογραφής Power Platform
Ιδιοκτήτης Αναγνωριστικό αντικειμένου του κατόχου της ροής properties.ownerId
Environment Αναγνωριστικό του περιβάλλοντος που περιέχει τη ροή properties.environmentId
Τελευταία τροποποίηση Ημερομηνία και ώρα τελευταίας τροποποίησης της ροής properties.lastModifiedAt
Τελευταία τροποποίηση από Αναγνωριστικό αντικειμένου του χρήστη που τροποποίησε τελευταία φορά τη ροή properties.lastModifiedBy
Οντότητα ροής εργασιών Αναγνωριστικό οντότητας ροής εργασιών Dataverse properties.workflowEntityId
Σύνδεσμος εναύσματος Συνδετήρας που ξεκινά τη ροή properties.trigger
Λειτουργία ενεργοποίησης Λειτουργία συνδετήρα που ξεκινά τη ροή properties.triggerOperation

Τα πεδία εναύσματος είναι κενά όταν μια ροή χρησιμοποιεί ένα έναυσμα που δεν βασίζεται σε σύνδεση, όπως μια περιοδικότητα ή ένα μη αυτόματο έναυσμα.

Χρήση συνδέσμου

Η χρήση συνδέσμων είναι διαθέσιμη για υποστηριζόμενες εφαρμογές, ροές και agents.

Κατηγορία δεδομένων Διαθέσιμες πληροφορίες Πεδίο API απογραφής Power Platform
Συνδέσεις που χρησιμοποιούνται Αναγνωριστικά συνδετήρων που χρησιμοποιούνται από τον πόρο properties.powerPlatformConnectors[].connectorId
Χρησιμοποιούμενες λειτουργίες Αναγνωριστικά λειτουργιών που καλούνται σε έναν συνδετήρα properties.powerPlatformConnectors[].operations[].operationId
Ενεργοποιητής ροής Συνδετήρας που ξεκινά μια υποστηριζόμενη ροή properties.trigger
Λειτουργία ενεργοποίησης ροής Λειτουργία σύνδεσης που ξεκινά μια υποστηριζόμενη ροή properties.triggerOperation

Τα πεδία χρήσης συνδέσεων και λειτουργιών βρίσκονται αυτήν τη στιγμή σε προεπισκόπηση.

Πληροφορίες καταλόγου συνδέσμου

Μπορείτε επίσης να βρείτε συνδέσμους ως μεμονωμένους πόρους αποθέματος.

Κατηγορία δεδομένων Διαθέσιμες πληροφορίες Πεδίο API αποθέματος Power Platform
Αναγνωριστικό σύνδεσης Αναγνωριστικό συνδέσμου properties.connectorId
Περιγραφή Περιγραφή του connector properties.description
Εκδότης Εκδότης σύνδεσης properties.publisher
Επίπεδο Τυπική ή Premium ταξινόμηση properties.tier
Στάδιο κυκλοφορίας Ονομασία έκδοσης, όπως Παραγωγική έκδοση ή Προεπισκόπηση properties.releaseTag
Κατάσταση απόσυρσης Εάν ο σύνδεσμος έχει καταργηθεί properties.isDeprecated
Operations Λειτουργίες που εκτίθενται από τον σύνδεσμο properties.operations
Αναγνωριστικό ενέργειας Μοναδικό αναγνωριστικό λειτουργίας properties.operations[].operationId
Όνομα λειτουργίας Όνομα εμφάνισης λειτουργίας properties.operations[].displayName
Περιγραφή λειτουργίας Περιγραφή της λειτουργίας properties.operations[].description
Μέθοδος HTTP Μέθοδος HTTP που χρησιμοποιείται από τη λειτουργία properties.operations[].method

Πληροφορίες περιβάλλοντος

Μπορείτε να βρείτε τις ακόλουθες πληροφορίες σχετικά με τις εγγραφές απογραφής περιβάλλοντος.

Κατηγορία δεδομένων Διαθέσιμες πληροφορίες Πεδίο API απογραφής Power Platform
Αναγνωριστικό περιβάλλοντος Μοναδικό αναγνωριστικό περιβάλλοντος name
Όνομα περιβάλλοντος Εμφανιζόμενο όνομα περιβάλλοντος properties.displayName
Τοποθεσία Γεωγραφική θέση του περιβάλλοντος location
Τύπος περιβάλλοντος Παραγωγή, Προεπιλογή, Περιβάλλον προστατευμένης εκτέλεσης, Δοκιμαστική έκδοση, Προγραμματιστής, ή Dataverse για το Teams properties.environmentType
Κατάσταση διαχείρισης Εάν το περιβάλλον είναι διαχειριζόμενο περιβάλλον properties.isManaged
Ομάδα περιβαλλόντων Το όνομα της αντιστοιχισμένης ομάδας περιβάλλοντος properties.environmentGroup
Αναγνωριστικό ομάδας περιβάλλοντος Αναγνωριστικό της αντιστοιχισμένης ομάδας περιβάλλοντος properties.environmentGroupId
Τελευταία τροποποίηση Ημερομηνία και ώρα τελευταίας τροποποίησης του περιβάλλοντος properties.lastModifiedAt

Δεν υπάρχουν διαθέσιμα δεδομένα

Οι παρακάτω ιδιότητες απογραφής εξαγωγής δεδομένων δεν έχουν άμεσα ισοδύναμα στο δημοσιευμένο σχήμα API απογραφής Power Platform.

Κατηγορία δεδομένων Οι πληροφορίες inventory εξαγωγής δεδομένων δεν είναι διαθέσιμες στο API inventory του Power Platform
Περιγραφή εφαρμογής Περιγραφή μιας εφαρμογής καμβά ή εφαρμογής βάσει μοντέλου
Συνδέσεις εφαρμογής URI εφαρμογής, URI εγγράφου, URI εικονιδίου και διεύθυνση URL φόρμας SharePoint
Κοινή χρήση Αριθμός χρηστών και ομάδων με τις οποίες γίνεται κοινή χρήση μιας εφαρμογής
Κατάσταση διαγραφής ρητός δείκτης διαγραμμένου πόρου
Ιστορικό ενεργοποίησης Ημερομηνία τελευταίας ενεργοποίησης μιας εφαρμογής και ο φορέας που την ενεργοποίησε
Πληροφορίες λύσης και ALM Συσχέτιση λύσεων και λειτουργία ALM
Αξιολόγηση DLP Κατάσταση αξιολόγησης, ημερομηνία αξιολόγησης, μήνυμα παραβίασης και παραβιάσεις ανά πολιτική
Ρύθμιση παραμέτρων εφαρμογής Ρυθμίσεις, τύπος δημιουργίας, τύπος συσκευής προγράμματος-πελάτη, κεντρικός υπολογιστής ενσωμάτωσης, προσαρμοσμένες επεκτάσεις και ρύθμιση βελτιστοποίησης επιδόσεων
Παρουσίαση εφαρμογής Εικόνα φόντου, χρώμα φόντου, χαρακτηρισμός κύριας εφαρμογής, χαρακτηρισμός επιλεγμένης εφαρμογής και ταξινόμηση σχεδίου εφαρμογής
Συγκατάθεση και αδειοδότηση Ρύθμιση παράκαμψης συγκατάθεσης και επιλεξιμότητα pass εφαρμογής
Έκδοση εγγράφου Έκδοση εγγράφου που σχετίζεται με την εφαρμογή
Χρήση τοπικής πύλης δεδομένων Ρητή ένδειξη ότι μια εφαρμογή χρησιμοποιεί μια πύλη δεδομένων εσωτερικής εγκατάστασης
Χρήση πίνακα Dataverse Ρητή ένδειξη ότι μια εφαρμογή χρησιμοποιεί πίνακες Dataverse
Χρήση εξωτερικής υπηρεσίας PCF Ρητή ένδειξη ότι ένα στοιχείο ελέγχου του πλαισίου στοιχείων Power Apps χρησιμοποιεί μια εξωτερική υπηρεσία

Σημαντικό

properties.isQuarantined υποδεικνύει εάν μια εφαρμογή βρίσκεται σε καραντίνα. Δεν είναι ισοδύναμο με την ένδειξη διαγραφής εξαγωγής δεδομένων.

Διαθέσιμα δεδομένα με διαφορετική κάλυψη

Ορισμένα πεδία API απογραφής Power Platform παρέχουν σχετικές πληροφορίες, αλλά δεν είναι άμεσα ισοδύναμα των ιδιοτήτων εξαγωγής δεδομένων.

Κατηγορία δεδομένων Κατάλογος εξαγωγής δεδομένων Κάλυψη API απογραφής Power Platform
Τύπος πόρου Διαχωρισμός τιμών type και subType Ένα τυποποιημένο αναγνωριστικό πόρου στο type. Ορισμένοι τύποι πόρων παρέχουν επίσης properties.subType
Κατάσταση και κύκλος ζωής Κατάσταση πόρου και κατάσταση κύκλου ζωής Η κατάσταση καραντίνας είναι διαθέσιμη για τους υποστηριζόμενους τύπους εφαρμογών, αλλά δεν αντιπροσωπεύει όλες τις τιμές κατάστασης ή κύκλου ζωής
Ιδιοκτήτης Τιμή κατόχου και αναγνωριστικό αντικειμένου κατόχου properties.ownerId παρέχει ένα αναγνωριστικό αντικειμένου όταν είναι διαθέσιμο. Δεν περιλαμβάνεται εμφανιζόμενο όνομα κατόχου
Προσαρμοσμένη χρήση API Ρητή προσαρμοσμένη ένδειξη API Τα αναγνωριστικά σύνδεσης είναι διαθέσιμα για υποστηριζόμενους πόρους, αλλά δεν υπάρχει διαθέσιμη μια ισοδύναμη προσαρμοσμένη ένδειξη API
Χρήση συνδέσμου Premium Σαφής ένδειξη premium API Το επίπεδο συνδέτη είναι διαθέσιμο στις εγγραφές απογραφής συνδετών, αλλά δεν υπάρχει διαθέσιμη αντίστοιχη ένδειξη επιπέδου πόρων
Ενέργειες ροής εργασίας Ενέργειες ροής εργασιών και δείκτες που σχετίζονται με συνδέτες Τα δομημένα αναγνωριστικά σύνδεσης και λειτουργίας είναι διαθέσιμα για τους υποστηριζόμενους τύπους πόρων
Πληροφορίες περιβάλλοντος Αναγνωριστικό περιβάλλοντος στον πόρο και ξεχωριστά δεδομένα εξαγωγής περιβάλλοντος Ο πόρος περιλαμβάνει properties.environmentId. Οι λεπτομέρειες περιβάλλοντος είναι διαθέσιμες μέσω εγγραφών απογραφής περιβάλλοντος

Αντιστοίχιση αναγνωριστικού

Τα αναγνωριστικά πόρων δεν απεικονίζονται πανομοιότυπα στην εξαγωγή δεδομένων και στο API απογραφής του Power Platform.

Εφαρμογές βάσει μοντέλου

Χρησιμοποιήστε την ακόλουθη αντιστοίχιση για εφαρμογές βάσει μοντέλου:

Πεδίο απογραφής εξαγωγής δεδομένων Πεδίο API απογραφής Power Platform
environmentId properties.environmentId
resourceId properties.appModuleId
name properties.displayName
type και subType type

Το πεδίο API απογραφής ανώτατου επιπέδου name του Power Platform είναι το μοναδικό αναγνωριστικό πόρου απογραφής. Δεν είναι ισοδύναμο με την εξαγωγή resourceId δεδομένων για εφαρμογές βάσει μοντέλου.

Για να συσχετίσετε μια εφαρμογή βάσει μοντέλου μεταξύ των δύο σχημάτων, χρησιμοποιήστε τόσο το properties.environmentId όσο και το properties.appModuleId.

Περιορισμοί αποθέματος συνδετήρων

Η απογραφή συνδέσμων έχει τους ακόλουθους τεκμηριωμένους περιορισμούς:

  • Οι συνδέσεις σε μορφή πίνακα μπορούν να εμφανίζονται με κενό πίνακα λειτουργιών.
  • Οι ενσωματωμένες ενέργειες Power Automate, συμπεριλαμβανομένων των λειτουργιών HTTP, Control και Data, δεν αντιπροσωπεύονται ως συνδέτες.
  • Οι εφαρμογές κώδικα, οι εφαρμογές vibe, οι διαχειριζόμενες εφαρμογές και οι εφαρμογές App Builder δεν εκπέμπουν δεδομένα χρήσης σύνδεσης.
  • Οι εφαρμογές βάσει μοντέλου σπάνια αναφέρουν απευθείας συνδέσεις δεδομένων.
  • Η χρήση του συνδετήρα από μια ενσωματωμένη σελίδα καμβά σχετίζεται με την εγγραφή σελίδας καμβά αντί της εφαρμογής βάσει μοντέλου που την περιέχει.
  • Τα δεδομένα σύνδεσης ανά πόρο περιλαμβάνουν αναγνωριστικά σύνδεσης και λειτουργίας, αλλά δεν περιλαμβάνουν εμφανιζόμενα ονόματα συνδέσεων, πληροφορίες εκδότη ή επίπεδο.
  • Τα εμφανιζόμενα ονόματα συνδέσεων, οι πληροφορίες εκδότη και το επίπεδο είναι διαθέσιμα στις εγγραφές καταλόγου συνδέσεων.
  • Η παρουσία συνδέτη δεν υποδεικνύει εάν χρησιμοποιείται μια τοπική πύλη δεδομένων.