Hämta miljöhistorik

Note

Intressegrupper för communityn har nu flyttat från Yammer till Microsoft Viva Engage. Om du vill gå med i en Viva Engage-community och delta i de senaste diskussionerna fyller du i formuläret Begär åtkomst till Finance and Operations Viva Engage Community och väljer den community som du vill ansluta till.

Important

Från och med februari 2026 kan nya kunder inte skapa projekt i Microsoft Dynamics Lifecycle Services för Microsoft Dynamics 365 Finance, Microsoft Dynamics 365 Human Resources, Microsoft Dynamics 365 Supply Chain Management och Microsoft Dynamics 365 Project Operations. Nya kunder bör använda administrationscentret för Power Platform i stället. För mer information, se projektfrysning för Lifecycle Services.

Du kan hämta metadata för miljöhistorik via Microsoft Dynamics Livscykeltjänster via API:et för livscykeltjänsters miljö. Det här API:et returnerar en sidnumrerad lista som innehåller pågående och tidigare åtgärder.

Behörigheter

API-program

En av följande behörigheter krävs för att anropa denna API. Mer information om behörigheter och hur du väljer dem finns i API för databasflytt – autentisering.

Behörighetstyp	Behörigheter (från minst privilegierad till de mest privilegierade)
Delegerad (arbets- eller skolkonto)	user_impersonation

Livscykeltjänster

I Livscykeltjänster måste användaren som används i API OAuth-autentiseringen läggas till i projektet som antingen projektägare eller miljöadministratör. Användaren måste godkänna inbjudan till projektet.

HTTP-begäran

Använd följande GET-slutpunkt för att hämta miljöhistorik för en viss miljö.

GET /environmentinfo/v1/history/project/{projectId}/environment/{environmentId}/?page=1

Rubrik för begäran

Använd följande rubrikvärden i HTTP-begärandehuvudet.

Sidhuvud	Värde
Auktorisering	Bearer {token} (krävs)
"x-ms-version"	"2017-09-15" (krävs)
Innehållstyp	application/json

Begär brödtext

Ange ingen brödtext för den här metoden.

Svar

HTTP

Svaret är alltid ett "200 OK"-svar, såvida du inte är korrekt autentiserad. Se till att använda egenskapen IsSuccess för att utvärdera åtgärdens framgång eller misslyckande.

Paginering

Resultatet innehåller en boolesk ResultHasMorePages-egenskap som anger om en annan sida med resultat är tillgänglig. Frågesträngsparametern ?page= kan användas för att hämta en viss sida.

Data

Följande egenskaper är tillgängliga för varje historikåtgärd. Om inget värde är tillgängligt för en egenskap returneras null .

Fastighet	Description
Namn	Det angivna namnet på åtgärdshistoriken.
Typ	Åtgärdstypen.
TypeDisplay	Visningssträngen för åtgärdstypen.
StartDateTimeUtc	Startdatum och tid för åtgärden i Coordinated Universal Time (UTC).
EndDateTimeUtc	Slutdatum och tid för åtgärden i UTC.
Status	Status för åtgärden.
AktivitetsId	Den globalt unika identifieraren (GUID) för åtgärdens aktivitet.
MiljöId	ID:t för miljön som åtgärden utfördes mot.
ProjectId	ID:t för projektet som åtgärden utfördes mot.

Exempelsvar

Lyckat svar

{
    "ResultPageCurrent": 1,
    "ResultHasMorePages": false,
    "Data": [
        {
            "Name": "Finance insights",
            "Type": "InstallAddin",
            "TypeDisplay": "Install addin",
            "StartDateTimeUTC": "2021-06-03T15:10:00.0",
            "EndDateTimeUTC": "2021-06-03T15:11:00.0",
            "Status": "Completed",
            "ActivityId": "0924ecdd-1b80-40cc-8158-172785841c15",
            "EnvironmentId": "9ba7fcc3e3b941e09eccd40abde85429",
            "ProjectId": 112233
        },
        {
            "Name": "Contoso Package deployment",
            "Type": "ApplicationHotfix",
            "TypeDisplay": "Application deployable package",
            "StartDateTimeUTC": "2021-06-03T10:10:00.0",
            "EndDateTimeUTC": "2021-06-03T10:11:00.0",
            "Status": "Completed",
            "ActivityId": "34703e5c3d224d1685dbaa7f8677d237",
            "EnvironmentId": "9ba7fcc3e3b941e09eccd40abde85429",
            "ProjectId": 112233
        }
    ],
    "IsSuccess": true,
    "OperationActivityId": "47bb9956-6fae-49c1-8669-6ec0431e7ee9",
    "ErrorMessage": null,
    "VersionEOL": "9999-12-31T23:59:59.9999999"
}

Hastighetsbegränsningar

För att bättre belastningsutjämning av begäranden finns det hastighetsbegränsningar för det här API:et:

6 anrop för varje miljö var 30:e sekund
6 samtal för varje projekt per minut