הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
ה- API של מלאי Power Platform מספק נתוני מלאי נוכחיים דרך הטבלה PowerPlatformResources ב- Azure Resource Graph. ה- API כולל פרטי משאב ליבה, בעלות, סביבה ומחבר, אך הסכימה שלו שונה מסכימת מלאי ייצוא הנתונים.
מאמר זה מתאר:
- נתוני מלאי זמינים באמצעות API של מלאי של Power Platform.
- מאפייני מלאי לייצוא נתונים שאינם זמינים.
- מאפיינים בעלי כיסוי חלקי או שונה.
לקבלת מידע אודות יצירת שאילתות על מלאי, ראה API של מלאי של Power Platform. לקבלת סכימת ה- 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 Inventory כולל את סוגי המשאבים הבאים:
| משאב | סוג API של מלאי ב- Power Platform |
|---|---|
| יישומים מבוססי קנבס | microsoft.powerapps/canvasapps |
| יישומים מבוססי מודלים | microsoft.powerapps/modeldrivenapps |
| יישומי קוד | microsoft.powerapps/codeapps |
| אפליקציות מנוהלות ואפליקציות של 'בונה אפליקציות' | microsoft.powerapps/apps |
| זרימות ענן | microsoft.powerautomate/cloudflows |
| זרימות סוכן | microsoft.powerautomate/agentflows |
| זרימות סוכן תהליכים | microsoft.powerautomate/m365agentflows |
| סוכנים של Copilot Studio | microsoft.copilotstudio/agents |
| מחברים | microsoft.powerplatformconnector/connectors |
| סביבות | microsoft.powerplatform/environments |
| קבוצות סביבתיות | microsoft.powerplatform/environmentgroups |
נתוני מלאי זמינים
הסעיפים הבאים מתארים את השדות הזמינים לפי סוג משאב וקטגוריה של נתונים.
- מידע אודות משאב משותף
- פרטי אפליקציה
- מידע על הזרימה
- שימוש במחברים
- מידע על קטלוג המחברים
- מידע על הסביבה
מידע אודות משאב משותף
השדות הבאים זמינים עבור סוגי משאבים נתמכים. מחברים הם ישויות קטלוג ותומכים רק בשדות המשותפים המזוהים בהפניה של סכימת המלאי.
| קטגוריית נתונים | מידע זמין | שדה של API המלאי של Power Platform |
|---|---|---|
| מזהה משאב | מזהה משאב מלאי ייחודי | name |
| שם משאב | שם תצוגה של משאב | properties.displayName |
| סוג משאב | סוג משאב מתוקנן של Power Platform | type |
| דייר | מזהה דייר | tenantId |
| מיקום | מיקום גיאוגרפי של המשאב | location |
| תאריך יצירה | תאריך ושעה שבהם המשאב נוצר | properties.createdAt |
| נוצר על-ידי | מזהה אובייקט של המשתמש שיצר את המשאב | properties.createdBy |
פרטי אפליקציה
המידע הבא זמין עבור סוגי אפליקציות נתמכים.
| קטגוריית נתונים | מידע זמין | שדה API של מלאי ב- Power Platform |
|---|---|---|
| בעלים | מזהה אובייקט של הבעלים של היישום | properties.ownerId |
| סביבה | מזהה הסביבה המכילה את היישום | properties.environmentId |
| שינוי אחרון | התאריך והשעה שבהם היישום שונה לאחרונה | properties.lastModifiedAt |
| שונה לאחרונה על-ידי | מזהה האובייקט של המשתמש האחרון ששינה את היישום | properties.lastModifiedBy |
| מצב הסגר | אם היישום נמצא בהסגר | properties.isQuarantined |
| מזהה אפליקציה מונחית-מודל | מזהה מודול יישום Dataverse | properties.appModuleId |
| שם לוגי של יישום מונחה מודלים | שם לוגי Dataverse | properties.logicalName |
| תת-סוג של אפליקציית Code |
byocApp או vibeApp |
properties.subType |
| סוג משנה של יישום מנוהל | microsoftApp |
properties.subType |
| תת-סוג של App Builder | appBuilderApp |
properties.subType |
מידע על הזרימה
המידע הבא זמין עבור זרימות ענן, זרימות סוכן וזרימות סוכן של תהליך עבודה.
| קטגוריית נתונים | מידע זמין | שדה API של מלאי ב- Power Platform |
|---|---|---|
| בעלים | מזהה אובייקט של הבעלים של הזרימה | properties.ownerId |
| סביבה | מזהה הסביבה המכילה את הזרימה | properties.environmentId |
| שינוי אחרון | התאריך והשעה שבהם הזרם שונה לאחרונה | properties.lastModifiedAt |
| שונה לאחרונה על-ידי | מזהה אובייקט של המשתמש האחרון ששינה את הזרימה | properties.lastModifiedBy |
| ישות זרימת עבודה | מזהה ישות זרימת עבודה של Dataverse | properties.workflowEntityId |
| מחבר טריגר | מחבר שמתחיל את הזרימה | properties.trigger |
| פעולת טריגר | פעולת מחבר שמאתחלת את הזרימה | properties.triggerOperation |
שדות המפעיל ריקים כאשר זרימה משתמשת במפעיל שאינו מבוסס על מחבר, כגון מפעיל חזרתיות או מפעיל ידני.
שימוש ב-Connector
השימוש במחברים זמין עבור אפליקציות, זרימות וסוכנים נתמכים.
| קטגוריית נתונים | מידע זמין | שדה של Inventory API ב-Power Platform |
|---|---|---|
| מחברים הנמצאים בשימוש | מזהים של מחברים המשמשים את המשאב | properties.powerPlatformConnectors[].connectorId |
| פעולות שנעשה בהן שימוש | מזהי פעולות שהופעלו במחבר | properties.powerPlatformConnectors[].operations[].operationId |
| גורם מפעיל לזרימה | מחבר שמפעיל זרימה נתמכת | properties.trigger |
| פעולת טריגר זרימה | פעולת מחבר שמאתחלת זרימה נתמכת | properties.triggerOperation |
שדות 'מחבר' ו'שימוש בפעולה' נמצאים כעת בתצוגה מקדימה.
מידע על קטלוג מחברים
באפשרותך גם למצוא מחברים כמשאבי מלאי בודדים.
| קטגוריית נתונים | מידע זמין | שדה API של Power Platform inventory |
|---|---|---|
| מזהה מחבר | מזהה מחבר | properties.connectorId |
| תיאור | תיאור מחבר | properties.description |
| מוציא לאור | מפרסם מחברים | properties.publisher |
| רובד | סיווג רגיל או Premium | properties.tier |
| שלב השחרור | ייעוד גרסה, כגון Production או תצוגה מקדימה | properties.releaseTag |
| מצב הוצאה משימוש | אם המחבר הוצא משימוש | properties.isDeprecated |
| פעולות | פעולות שנחשפו על-ידי המחבר | properties.operations |
| מזהה פעולה | מזהה פעולה ייחודי | properties.operations[].operationId |
| שם פעולה | שם תצוגה של פעולה | properties.operations[].displayName |
| תיאור הפעולה | תיאור הפעולה | properties.operations[].description |
| פעולת שירות של HTTP | שיטת HTTP שבה הפעולה משתמשת | properties.operations[].method |
מידע על הסביבה
באפשרותך למצוא את המידע הבא אודות רשומות של מלאי הסביבה.
| קטגוריית נתונים | מידע זמין | שדה API של מלאי ב- Power Platform |
|---|---|---|
| מזהה סביבה | מזהה סביבה ייחודי | name |
| שם סביבה | שם התצוגה של הסביבה | properties.displayName |
| מיקום | מיקום גיאוגרפי של הסביבה | location |
| סוג סביבה | ייצור, ברירת מחדל, ארגז חול, גירסת ניסיון, מפתחים או Dataverse for Teams | properties.environmentType |
| מצב מנוהל | האם הסביבה היא סביבה מנוהלת | properties.isManaged |
| קבוצת סביבות | שם קבוצת הסביבה שהוקצתה | properties.environmentGroup |
| מזהה קבוצת סביבה | מזהה קבוצת הסביבה שהוקצתה | properties.environmentGroupId |
| שינוי אחרון | התאריך והשעה שבהם הסביבה שונתה לאחרונה | properties.lastModifiedAt |
הנתונים אינם זמינים
לממאפיינים הבאים של מלאי ייצוא נתונים אין מקבילים ישירים בסכימת ה- API של מלאי Power Platform שפורסם.
| קטגוריית נתונים | מידע על מלאי של ייצוא נתונים אינו זמין ב-API של מלאי Power Platform |
|---|---|
| תיאור האפליקציה | תיאור של אפליקציית בד או אפליקציה מונחית מודלים |
| קישורי יישום | URI של יישום, URI של מסמך, URI של סמל, ו-URL של טופס SharePoint |
| שיתוף | מספר המשתמשים והקבוצות שאיתם האפליקציה משותפת |
| מצב מחיקה | מחוון למחיקה מפורשת של משאב |
| היסטוריית הפעלה/השבתה | התאריך שבו יישום הופעל לאחרונה והגורם שהפעיל אותו |
| מידע על פתרונות ו-ALM | שיוך Solution ומצב ALM |
| הערכת DLP | מצב הערכה, תאריך הערכה, הודעת הפרת מדיניות והפרות לפי מדיניות |
| תצורת אפליקציה | הגדרות, סוג יצירה, סוג התקן לקוח, מארח הטבעה, הרחבות מותאמות אישית והגדרת מיטוב ביצועים |
| הצגת האפליקציה | תמונת רקע, צבע רקע, הגדרת אפליקציית hero, הגדרת אפליקציה מוצגת וסיווג תוכנית אפליקציות |
| הסכמה ורישוי | הגדרת עקיפת הסכמה והזכאות ל-app-pass |
| גירסת מסמך | גירסת המסמך המשויכת לאפליקציה |
| שימוש בשער נתונים מקומי | מחוון מפורש שבו אפליקציה משתמשת בשער נתונים מקומי (on-premises) |
| שימוש בטבלת Dataverse | מחוון מפורש כי יישום משתמש בטבלאות Dataverse |
| שימוש בשירות חיצוני של PCF | מחוון מפורש שפקד מסגרת Power Apps משתמש בשירות חיצוני |
חשוב
properties.isQuarantined מציין אם אפליקציה נמצאת בהסגר. זה אינו מקביל למחוון מחיקת ייצוא הנתונים.
נתונים זמינים עם כיסוי שונה
שדות API מסוימים של מלאי Power Platform מספקים מידע קשור, אך אינם שווי ערך ישירים של מאפייני ייצוא הנתונים.
| קטגוריית נתונים | רשימת ייצוא נתונים | כיסוי API של מלאי ב- Power Platform |
|---|---|---|
| סוג משאב | הפרד בין הערכים type ו-subType |
מזהה משאב סטנדרטי בtype. סוגי משאבים מסוימים מספקים גם properties.subType |
| מצב ומחזור חיי | מצב משאב ומצב מחזור חיים | מצב בידוד זמין עבור סוגי אפליקציות נתמכים, אך הוא אינו מייצג את כל ערכי המצב או מחזור החיים |
| בעלים | ערך בעלים ומזהה אובייקט של בעלים |
properties.ownerId מספק מזהה אובייקט כאשר הוא זמין. שם תצוגה של בעלים אינו כלול |
| שימוש ב- API מותאם אישית | מחוון API מותאם אישית מפורש | מזהי קונקטורים זמינים עבור משאבים נתמכים, אך מחוון API מותאם אישית שווה ערך אינו זמין |
| שימוש במחבר פרימיום | מחוון premium מפורש ל-API | שכבת מחבר זמינה עבור רשומות מלאי של מחברים, אך מחוון שווה ערך ברמת המשאב אינו זמין |
| פעולות זרימת עבודה | פעולות זרימת עבודה ומחוונים הקשורים למחברים | מזהי מחבר ופעולה מובְנים זמינים עבור סוגי משאבים נתמכים |
| מידע על הסביבה | מזהה סביבה במשאב ונתוני ייצוא סביבה נפרדים | המשאב כולל properties.environmentId. פרטי הסביבה זמינים באמצעות רשומות מלאי של סביבה |
מיפוי מזהים
מזהי משאבים אינם מיוצגים באופן זהה בייצוא נתונים וב- API של מלאי Power Platform.
יישומים מבוססי מודלים
השתמש במיפוי הבא עבור יישומים מונחי מודלים:
| שדה מלאי של ייצוא נתונים | שדה API של מלאי ב- Power Platform |
|---|---|
environmentId |
properties.environmentId |
resourceId |
properties.appModuleId |
name |
properties.displayName |
type ו- subType |
type |
השדה ברמה העליונה של ה-API למלאי של Power Platform name הוא מזהה משאב המלאי הייחודי. אין זה מקביל לייצוא הנתונים עבור יישומים מונחי מודלים resourceId.
כדי לקשר יישום מונחה מודלים בין שתי הסכימות, השתמש גם ב-properties.environmentId וגם ב-properties.appModuleId.
מגבלות המלאי של הקונקטור
למלאי המחברים המגבלות המתועדות הבאות:
- מחברים טבלאיים יכולים להופיע עם מערך פעולות ריק.
- פעולות Power Automate המובנות, כולל פעולות HTTP, Control ופעולות נתונים, אינן מיוצגות כמחברים.
- אפליקציות קוד, אפליקציות Vibe, אפליקציות מנוהלות ואפליקציות App Builder לא פולטות נתוני שימוש במחברים.
- אפליקציות מונחות דגמים מדווחות לעתים רחוקות על קונקטורים ישירות.
- השימוש במחברים על-ידי דף בד ציור מוטבע משויך אל רשומת דף בד הציור במקום ליישום המכיל מונחה המודלים.
- נתוני מחבר לכל משאב כוללים מזהי מחבר ופעולה, אך אינם כוללים שמות תצוגה של מחברים, פרטי מפרסם או רמה.
- שמות תצוגה של קונקטורים, פרטי מפרסם ורמה זמינים עבור רשומות מלאי קונקטורים.
- נוכחות Connector אינה מציינת אם נעשה שימוש בשער נתונים מקומי.