הבא מטה-נתונים של סביבה

הערה

קבוצות עניין של קהילה עברו כעת מ- Yammer Microsoft Viva Engage. כדי להצטרף לקהילת Viva Engage ולהשתתף בדיונים האחרונים, מלא את טופס הגישה לקהילת כספים ופעולות Viva Engage ובחר את הקהילה שאליה ברצונך להצטרף.

חשוב

החל מפברואר 2026, לקוחות חדשים אינם יכולים ליצור פרוייקטים ב- Microsoft Dynamics Lifecycle Services עבור Microsoft Dynamics 365 Finance, Microsoft Dynamics 365 Human Resources, Microsoft Dynamics 365 Supply Chain Management ו- Microsoft Dynamics 365 Project Operations. לקוחות חדשים צריכים להשתמש במרכז הניהול של Power Platform במקום זאת. לקבלת מידע נוסף, ראה הקפאת יצירת פרוייקטים של שירותי מחזור החיים.

באפשרותך להביא מטה-נתונים של סביבה באמצעות שירותי מחזור Dynamics (LCS) של Microsoft באמצעות ממשק ה- API של סביבת LCS. API זה מחזיר רשימה עם חלוקה לעמודים שכוללת כברירת מחדל את כל הסביבות בפרוייקט. ניתן להשתמש בפרמטרי מחרוזת השאילתה האופציונליים לסינון התגובה.

‏‏הרשאות

יישום API

אחת מההרשאות הבאות נדרשת כדי לקרוא ל- API זה. לקבלת מידע נוסף אודות הרשאות וכיצד לבחור אותן, ראה API של תנועת מסד נתונים - אימות.

סוג הרשאה	הרשאות (מההרשאות הפחותות ביותר להרשאות הרבות ביותר)
מוסמך (חשבון בעבודה או בבית ספר)	user_impersonation

LCS

ב- LCS, יש להוסיף את המשתמש המשמש באימות ה- API של OAuth לפרוייקט כבעלים של פרוייקט או כמנהל סביבה. המשתמש חייב לקבל את ההזמנה לפרוייקט.

בקשת HTTP

השתמש בנקודות הקצה הבאות של GET כדי להביא מטה-נתונים של סביבה.

הבאת מטה-נתונים עבור כל הסביבות בפרוייקט

GET /environmentinfo/v1/detail/project/{projectId}/?page=1

הבאת מטה-נתונים עבור סביבה בודדת לפי מזהה

GET /environmentinfo/v1/detail/project/{projectId}/?environmentId={environmentId}

הבאת מטה-נתונים עבור סביבה בודדת לפי שם

GET /environmentinfo/v1/detail/project/{projectId}/?environmentName={environmentName}

כותרות בקשות

השתמש ערכי הכותרת הבאים בכותרת בקשת HTTP.

כותרת	ערך:
ההרשאות	נושא {token} (נדרש)
'x-ms-version'	'2017-09-15' (נדרש)
סוג תוכן	application/json

גוף הבקשה

אל תספק גוף בקשה לשיטה זו.

תגובה

HTTP

התגובה היא תמיד תגובה "200 אישור", אלא אם כן אינך מאומת כראוי. הקפד להשתמש במאפיין IsSuccess כדי להעריך את ההצלחה או הכישלון של הפעולה.

חלוקה לעמודים

התוצאה כוללת מאפיין ResultHasMorePages בוליאני המציין אם עמוד תוצאות אחר זמין. ניתן להשתמש בפרמטר מחרוזת השאילתה ?page= כדי להביא דף ספציפי.

נתונים

עבור כל סביבה, המאפיינים הבאים זמינים. אם אין ערך זמין עבור מאפיין, מוחזר Null .

תכונה	תיאור
EnvironmentId	מזהה סביבת LCS.
שםסביבה	שם הסביבה.
מזהה פרוייקט	המזהה של פרוייקט LCS המכיל את הסביבה.
EnvironmentInfrastructure	סוג התשתית של הסביבה (לדוגמה, SelfService או MicrosoftManaged).
סוג סביבה	סוג הסביבה (לדוגמה, ייצור אוארגז חול).
קבוצת סביבה	קבוצת הסביבה (לדוגמה, Primary או DiasterRecovery).
EnvironmentProduct	המוצר הפועל בסביבה.
EnvironmentEndpointBaseUrl	כתובת ה- URL הבסיסית של הסביבה.
DeploymentState	המצב של פעולת הסביבה העדכנית ביותר.
שם טופולוגיהDisplayName	טופולוגיית המוצר שנפרסת בסביבה.
CurrentApplicationBuildVersion	מחרוזת של גירסת היישום.
CurrentApplicationReleaseName	מחרוזת של שם ההפצה של היישום.
CurrentPlatformReleaseName	מחרוזת של גירסת הפלטפורמה.
CurrentPlatformVersion	מחרוזת של שם ההפצה של הפלטפורמה.
DeployedOnUTC	ערך תאריך/שעה אוניברסלי מתואם (UTC) המציין את מועד הפריסה של הסביבה.
מיקום אחסון בענן	המיקום Azure העיקרי של הסביבה.
DisasterRecoveryLocation	המיקום Azure של הסביבה.
DeploymentStatusDisplay	המצב הנוכחי של הסביבה.
יכול להתחלה	ערך בוליאני המציין אם ניתן להפעיל את הסביבה.
משטח קנים	ערך בוליאני המציין אם ניתן לעצור את הסביבה.

תגובה לדוגמה

תגובה מוצלחת עבור בקשה ברמת הפרוייקט

{
    "ResultPageCurrent": 1,
    "ResultHasMorePages": true,
    "Data": [
        {
            "EnvironmentId": "d15ed3a8c2c14054840b946c93915da9",
            "EnvironmentName": "ProdEnvironment1",
            "ProjectId": 112233,
            "EnvironmentInfrastructure": "MicrosoftManaged",
            "EnvironmentType": "Production",
            "EnvironmentGroup": "Primary",
            "EnvironmentProduct": "finance and operations",
            "EnvironmentEndpointBaseUrl": "<example>",
            "DeploymentState": "Finished",
            "TopologyDisplayName": "finance and operations - High Availability (10.0.20 with Platform update 44)",
            "CurrentApplicationBuildVersion": "10.0.886.48",
            "CurrentApplicationReleaseName": "10.0.20",
            "CurrentPlatformReleaseName": "Update44",
            "CurrentPlatformVersion": "7.0.6060.45",
            "DeployedOnUTC": "8/5/2021 11:00 PM",
            "CloudStorageLocation": "Central India",
            "DisasterRecoveryLocation": "South India",
            "DeploymentStatusDisplay": "Deployed",
            "CanStart": false,
            "CanStop": false,
            "DatabaseDailyBackupsEnabled": true,
            "DatabaseBackupLocation": "Central India"
        },
        {
            "EnvironmentId": "60b557b2-fefb-4690-859e-f83caf98c17e",
            "EnvironmentName": "SandboxEnvironment1",
            "ProjectId": 112233,
            "EnvironmentInfrastructure": "MicrosoftManaged",
            "EnvironmentType": "Sandbox",
            "EnvironmentGroup": "Primary",
            "EnvironmentProduct": "finance and operations",
            "EnvironmentEndpointBaseUrl": "<example>",
            "DeploymentState": "Finished",
            "TopologyDisplayName": "finance and operations - Sandbox (10.0.20 with Platform update 44)",
            "CurrentApplicationBuildVersion": "10.0.960.24",
            "CurrentApplicationReleaseName": "10.0.21",
            "CurrentPlatformReleaseName": "Update45",
            "CurrentPlatformVersion": "7.0.6129.19",
            "DeployedOnUTC": "8/5/2021 12:42 PM",
            "CloudStorageLocation": "East US",
            "DisasterRecoveryLocation": "West US",
            "DeploymentStatusDisplay": "Failed",
            "CanStart": false,
            "CanStop": true,
            "DatabaseDailyBackupsEnabled": true,
            "DatabaseBackupLocation": "East US"
        }
    ],
    "IsSuccess": true,
    "OperationActivityId": "216ea45d-113d-445a-a393-f67041f7aafe",
    "ErrorMessage": null,
    "VersionEOL": "9999-12-31T23:59:59.9999999"
}

דרג מגבלות

כדי להשתמש בבקשות טובות יותר של יתרת עומס, קיימות מגבלות תעריף ב- API זה:

• 6 שיחות עבור כל פרוייקט לדקה

הערה

בקשות החורגות מהמגבלות יידחהו, ותוחזרו תגובת "בקשות רבות מדי של HTTP 429". הכותרת נסה שנית-לאחר תציין את מספר השניות שלאחר מכן ניתן לנסות שוב את הבקשה.