提取环境历史记录

注释

社区兴趣组现已从 Yammer 迁移到Microsoft Viva Engage。 若要加入 Viva Engage 社区并参与最新讨论，请填写 “请求访问财务和运营 Viva Engage 社区 ”表单，然后选择要加入的社区。

重要

从 2026 年 2 月开始，新客户将无法在 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 管理中心 。 有关详细信息，请参阅 生命周期服务项目创建冻结。

可以通过生命周期服务环境 API 通过 Microsoft Dynamics 生命周期服务提取环境历史记录元数据。 此 API 返回包含持续和过去作的分页列表。

权限

API 应用程序

要调用此 API，需要以下权限之一。 有关权限以及如何选择它们的详细信息，请参阅 数据库移动 API - 身份验证。

权限类型 权限（从最低权限到最高权限）
委派（工作或学校帐户） user_impersonation

生命周期服务

在生命周期服务中，API OAuth 身份验证中使用的用户必须作为项目所有者或环境管理员添加到项目中。 用户必须接受对项目的邀请。

HTTP 请求

使用以下 GET 终结点提取给定环境的环境历史记录。

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

请求标头

在 HTTP 请求标头中使用以下标头值。

Header 值
Authorization 持有者 {token} （必需）
“x-ms-version” “2017-09-15” （必需）
内容类型 application/json

请求主体

请勿提供此方法的请求正文。

响应

HTTP

除非未正确进行身份验证，否则响应始终为“200 正常”响应。 请务必使用 IsSuccess 属性来评估作的成功或失败。

Pagination

结果包括一个布尔 ResultHasMorePages 属性，该属性指示是否有另一页的结果可用。 ？page= 查询字符串参数可用于提取特定页面。

Data

对于每个历史记录作，可以使用以下属性。 如果没有可用于属性的值，则返回 null 。

财产 Description
名称 提供的作历史记录名称。
类型 操作类型。
TypeDisplay 作类型的显示字符串。
StartDateTimeUtc 作的开始日期和时间（UTC）。
EndDateTimeUtc 作的结束日期和时间（UTC）。
地位 操作状态。
活动编号 作活动的全局唯一标识符（GUID）。
EnvironmentId 对其执行作的环境 ID。
ProjectId 对其执行作的项目的 ID。

示例响应

成功的响应

{
    "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"
}

速率限制

为了更好地对请求进行负载均衡，此 API 存在速率限制：

  • 每个环境每 30 秒 6 次调用
  • 每分钟每个项目的 6 次调用

注释

超过限制的请求将被拒绝，并返回“HTTP 429 请求过多”响应。 重试标头将指示请求可以重试后的秒数。

  • Last updated on