提供通知的 Azure 托管应用程序

项目
07/31/2024

Azure 托管应用程序通知可让发布者根据托管应用程序实例的生命周期事件自动执行操作。发布者可以指定自定义通知 Webhook 终结点，以接收有关新的和现有的托管应用程序实例的事件通知。发布者可以在预配、更新和删除应用程序时设置自定义工作流。

入门

若要开始接收托管应用程序通知，请创建一个公共 HTTPS 终结点。在发布服务目录应用程序定义或 Azure 市场产品/服务时指定终结点。

下面是建议的快速入门步骤：

创建公共 HTTPS 终结点，用于记录传入的 POST 请求并返回 200 OK。
如本文稍后所述，将该终结点添加到服务目录应用程序定义或 Azure 市场套餐。
创建一个引用应用程序定义或 Azure 市场套餐的托管应用程序实例。
验证是否正在接收通知。
根据本文的“终结点身份验证”部分所述启用授权。
按照本文的“通知架构”部分中的说明分析通知请求，并根据通知实现业务逻辑。

添加服务目录应用程序定义通知

以下示例演示如何使用门户或 REST API 添加通知终结点 URI。

Azure 门户

若要开始操作，请查看快速入门：创建和发布 Azure 托管应用程序定义。

Azure 门户的屏幕截图，展示服务目录托管应用程序定义和通知终结点。

REST API

注意

只能在托管应用程序定义的 notificationEndpoints 属性中提供一个终结点。

{
  "properties": {
    "isEnabled": true,
    "lockLevel": "ReadOnly",
    "displayName": "Sample Application Definition",
    "description": "Notification-enabled application definition.",
    "notificationPolicy": {
      "notificationEndpoints": [
        {
            "uri": "https://isv.chinacloudsites.cn:1214?sig=unique_token"
        }
      ]
    },
    "authorizations": [
      {
        "principalId": "d6b7fbd3-4d99-43fe-8a7a-f13aef11dc18",
        "roleDefinitionId": "8e3af657-a8ff-443c-a75c-2fe8c4bcb635"
      },
    ...

添加 Azure 市场托管应用程序通知

屏幕截图：Azure 门户中的 Azure 市场托管应用程序通知。

事件触发器

下表描述了 eventType 和 provisioningState 的所有可能组合及其触发器：

EventType	ProvisioningState	通知的触发器
PUT	已接受	在应用程序 PUT 之后（启动受管理资源组中的部署之前）已成功创建并投影受管理资源组。
PUT	已成功	PUT 之后完全预配托管应用程序成功。
PUT	失败	在任意时间点 PUT 应用程序实例预配失败。
PATCH	已成功	在托管应用程序实例上成功执行 PATCH 以更新标记、即时 (JIT) 访问策略或托管标识之后发生。
DELETE	正在删除	在用户启动托管应用程序实例的 DELETE 后立即发生。
DELETE	Deleted	在完全成功删除托管应用程序之后发生。
DELETE	失败	在取消预配过程中出现任何阻止删除的错误之后发生。

通知架构

在创建 Webhook 终结点来处理通知时，需要分析有效负载，以获取重要属性，然后再处理通知。服务目录和 Azure 市场托管应用程序通知提供许多相同的属性，不过也存在一些差异。 applicationDefinitionId 属性仅适用于服务目录。 billingDetails 和 plan 属性仅适用于Azure 市场。

Azure 将 /resource 追加到托管应用程序定义中提供的通知终结点 URI。 Webhook 终结点必须能够处理 /resource URI 上的通知。例如，如果已提供通知终结点 URI（如 https://fabrikam.com），则 Webhook 终结点 URI 为 https://fabrikam.com/resource。

服务目录应用程序通知架构

下面的示例展示的是成功预配托管应用程序实例后的服务目录通知。

POST https://{your_endpoint_URI}/resource?{optional_parameter}={optional_parameter_value} HTTP/1.1

{
  "eventType": "PUT",
  "applicationId": "/subscriptions/<subId>/resourceGroups/<rgName>/providers/Microsoft.Solutions/applications/<applicationName>",
  "eventTime": "2019-08-14T19:20:08.1707163Z",
  "provisioningState": "Succeeded",
  "applicationDefinitionId": "/subscriptions/<subId>/resourceGroups/<rgName>/providers/Microsoft.Solutions/applicationDefinitions/<appDefName>"
}

如果预配失败，会将包含错误详细信息的通知发送到指定的终结点。

POST https://{your_endpoint_URI}/resource?{optional_parameter}={optional_parameter_value} HTTP/1.1

{
  "eventType": "PUT",
  "applicationId": "subscriptions/<subId>/resourceGroups/<rgName>/providers/Microsoft.Solutions/applications/<applicationName>",
  "eventTime": "2019-08-14T19:20:08.1707163Z",
  "provisioningState": "Failed",
  "applicationDefinitionId": "/subscriptions/<subId>/resourceGroups/<rgName>/providers/Microsoft.Solutions/applicationDefinitions/<appDefName>",
  "error": {
    "code": "ErrorCode",
    "message": "error message",
    "details": [
      {
        "code": "DetailedErrorCode",
        "message": "error message"
      }
    ]
  }
}

Azure 市场应用程序通知架构