合作夥伴中心 Webhook 事件

適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府Microsoft雲端合作夥伴中心

合作夥伴中心 Webhook 事件是以 HTTP POST 形式傳遞至已註冊 URL 的資源變更事件。 若要從合作夥伴中心接收事件，您需要設置一個回呼，使合作夥伴中心可以傳遞該事件。 事件經過數字簽署，因此您可以驗證它是否已從合作夥伴中心傳送。

如需如何接收事件、驗證回呼，以及使用合作夥伴中心 Webhook API 來建立、檢視及更新事件註冊的相關信息，請參閱合作夥伴中心 Webhook。

支援的事件

合作夥伴中心支援下列 Webhook 事件。

測試事件

此活動允許您自行上線並測試您的註冊，方法是請求測試活動並追蹤其進度。 您可以在嘗試傳遞事件時看到從Microsoft接收的失敗訊息。 這僅適用於「測試建立」的事件，並會刪除超過七天的數據。

屬性

範例

{
    "EventName": "test-created",
    "ResourceUri": "http://api.partnercenter.microsoft.com/webhooks/v1/registration/validationEvents/{{CorrelationId}}",
    "ResourceName": "test",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2017-11-16T16:19:06.3520276+00:00"
}

訂閱服務啟用事件

當啟用訂閱時，會觸發此事件。 此事件目前僅適用於沙箱租使用者。

屬性

範例

{
    "EventName": "subscription-active",
    "ResourceUri": "http://api.partnercenter.microsoft.com/v1/customers/{{CustomerId}}/subscriptions/{{SubscriptionId}}",
    "ResourceName": "subscription",
    "AuditUri": "https://api.partnercenter.microsoft.com/v1/auditrecords/{{AuditId}}",
    "ResourceChangeUtcDate": "2017-11-16T16:19:06.3520276+00:00"
}

訂閱待定事件

當訂用帳戶擱置時，就會引發此事件。 目前，此活動僅適用於沙箱租戶。

屬性

範例

{
    "EventName": "subscription-pending",
    "ResourceUri": "http://api.partnercenter.microsoft.com/v1/customers/{{CustomerId}}/subscriptions/{{SubscriptionId}}",
    "ResourceName": "subscription",
    "AuditUri": "https://api.partnercenter.microsoft.com/v1/auditrecords/{{AuditId}}",
    "ResourceChangeUtcDate": "2017-11-16T16:19:06.3520276+00:00"
}

訂閱續約事件

當訂閱更新時，就會引發此事件。 此事件目前僅適用於沙箱租戶。

屬性

範例

{
    "EventName": "subscription-renewed",
    "ResourceUri": "http://api.partnercenter.microsoft.com/v1/customers/{{CustomerId}}/subscriptions/{{SubscriptionId}}",
    "ResourceName": "subscription",
    "AuditUri": "https://api.partnercenter.microsoft.com/v1/auditrecords/{{AuditId}}",
    "ResourceChangeUtcDate": "2017-11-16T16:19:06.3520276+00:00"
}

訂閱更新事件

當指定的訂用帳戶變更時，就會引發此事件。 當有內部變更或透過合作夥伴中心 API 進行變更時，會產生訂閱更新事件。 只有在有商務層級變更時，才會產生此事件，例如，修改授權數目，以及訂閱狀態變更時。 它不會在訂用帳戶內建立資源時產生。

屬性

範例

{
    "EventName": "subscription-updated",
    "ResourceUri": "http://api.partnercenter.microsoft.com/webhooks/v1/customers/{{CustomerId}}/subscriptions/{{SubscriptionId}}",
    "ResourceName": "subscription",
    "AuditUri": "https://api.partnercenter.microsoft.com/v1/auditrecords/{{AuditId}}",
    "ResourceChangeUtcDate": "2017-11-16T16:19:06.3520276+00:00"
}

臨界值超過事件

當任何客戶的 Microsoft azure 使用量超過其使用量預算（其閾值）時，就會引發此事件。 如需詳細資訊，請參閱 [為您的客戶設定 Azure 消費預算/partner-center/set-an-azure-spending-budget-for-your-customers]。

屬性

範例

{
    "EventName": "usagerecords-thresholdExceeded",
    "ResourceUri": "https://api.partnercenter.microsoft.com/v1/customers/usagerecords",
    "ResourceName": "usagerecords",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

轉介建立事件

建立轉介時，就會引發此事件。

屬性

範例

{
    "EventName": "referral-created",
    "ResourceUri": "https://api.partnercenter.microsoft.com/engagements/v1/referrals/{{ReferralID}}",
    "ResourceName": "referral",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

轉介更新事件

此事件會在轉介更新時引發。

屬性

範例

{
    "EventName": "referral-updated",
    "ResourceUri": "https://api.partnercenter.microsoft.com/engagements/v1/referrals/{{ReferralID}}",
    "ResourceName": "referral",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

相關推薦更新事件

當相關的轉介更新時，就會引發此事件。

屬性

範例

{
    "EventName": "related-referral-updated",
    "ResourceUri": "https://api.partnercenter.microsoft.com/engagements/v1/referrals/{{ReferralID}}",
    "ResourceName": "referral",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

已建立的相關轉介事件

此事件會在建立相關轉介時引發。

屬性

範例

{
    "EventName": "related-referral-created",
    "ResourceUri": "https://api.partnercenter.microsoft.com/engagements/v1/referrals/{{ReferralID}}",
    "ResourceName": "referral",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

細粒度管理者關係核准事件

當客戶核准細微委派管理員許可權時，就會引發此事件。

屬性

範例

{
    "EventName": "granular-admin-relationship-approved",
    "ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}",
    "ResourceName": "GranularAdminRelationship",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

細微管理員關聯性啟動事件

建立數據粒度委派管理員許可權並讓客戶核准時，就會引發此事件。

屬性

範例

{
    "EventName": "granular-admin-relationship-activated",
    "ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}",
    "ResourceName": "GranularAdminRelationship",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

細微管理員關聯性終止事件

當合作夥伴或客戶終止細微委派系統管理員許可權時，就會引發此事件。

屬性

範例

{
    "EventName": "granular-admin-relationship-terminated",
    "ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}",
    "ResourceName": "GranularAdminRelationship",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

粒度管理關聯自動延伸事件

當系統自動擴充細微委派系統管理員許可權時，就會引發此事件。

屬性

範例

{
    "EventName": "granular-admin-relationship-auto-extended",
    "ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}",
    "ResourceName": "GranularAdminRelationship",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

細微管理員關聯性已更新事件

當客戶或合作夥伴更新細微委派系統管理員許可權時，就會引發此事件。

屬性

範例

{
    "EventName": "granular-admin-relationship-updated",
    "ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}",
    "ResourceName": "GranularAdminRelationship",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

細微管理員關聯性過期事件

當數據粒度委派管理員許可權過期時，就會引發此事件。

屬性

範例

{
    "EventName": "granular-admin-relationship-expired",
    "ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}",
    "ResourceName": "GranularAdminRelationship",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

已建立細微管理員關聯性事件

建立細微委派管理員許可權時，就會引發此事件。

屬性

範例

{
    "EventName": "granular-admin-relationship-created",
    "ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}",
    "ResourceName": "GranularAdminRelationship",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

細微的系統管理員存取指派已建立事件

當合作夥伴建立細微委派管理員許可權存取指派時，就會引發此事件。 合作夥伴可以將客戶核准Microsoft Entra 角色指派給特定安全組。

屬性

範例

{
    "EventName": "granular-admin-access-assignment-created",
    "ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}/accessAssignments/{{AssignmentID}}",
    "ResourceName": "GranularAdminAccessAssignment",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

細微的系統管理員存取指派已啟動事件

當合作夥伴將Microsoft Entra 角色指派給特定安全組並啟用細微委派系統管理員許可權存取指派時，就會引發此事件。

屬性

範例

{
    "EventName": "granular-admin-access-assignment-activated",
    "ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}/accessAssignments/{{AssignmentID}}",
    "ResourceName": "GranularAdminAccessAssignment",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

細化的管理員存取權限指派更新事件

當合作夥伴更新「細微委派管理員權限」的存取指派時，就會觸發此事件。

屬性

範例

{
    "EventName": "granular-admin-access-assignment-updated",
    "ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}/accessAssignments/{{AssignmentID}}",
    "ResourceName": "GranularAdminAccessAssignment",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

細微的系統管理員存取權指派已刪除事件

當合作夥伴刪除精細委派管理員權限的存取指派時，就會引發此事件。

屬性

範例

{
    "EventName": "granular-admin-access-assignment-deleted",
    "ResourceUri": "https://partner.microsoft.com/granularAdminRelationships/{{RelationshipID}}/accessAssignments/{{AssignmentID}}",
    "ResourceName": "GranularAdminAccessAssignment",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

CreateNewCommerceMigration 事件

建立新的商務移轉並啟動移轉程式時，就會引發此事件。

屬性

範例

{
    "EventName": "new-commerce-migration-created",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/migrations/newcommerce/{migrationId},
    "ResourceName": " NewCommerceMigration",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

完成新商務遷移事件

當新商務模式移轉成功完成時，會觸發此事件。 已取消舊版訂用帳戶，並建立新的商務訂用帳戶。

屬性

範例

{
    "EventName": "new-commerce-migration-completed",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/migrations/newcommerce/{migrationId},
    "ResourceName": " NewCommerceMigration",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

CreateNewCommerceMigration 事件

新商務移轉順利完成時，此事件將被引發。 已取消舊版訂用帳戶，並建立新的商務訂用帳戶。

屬性

範例

{
    "EventName": "create-new-commerce-migration-schedule",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/migrations/newcommerce/{migrationId},
    "ResourceName": " NewCommerceMigration",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

NewCommerceMigrationFailed 事件

當新商務移轉失敗且無法建立新的商務訂用帳戶時，就會引發此事件。

屬性

範例

{
    "EventName": "new-commerce-migration-failed",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/migrations/newcommerce/{migrationId},
    "ResourceName": " NewCommerceMigration",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

新商務遷移排程失敗事件

當新的商務移轉排程失敗時，就會引發此事件，因此不會建立移轉記錄。 失敗的移轉排程也表示不會進行移轉。

屬性

範例

{
    "EventName": "new-commerce-migration-schedule-failed",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/migrations/newcommerce/schedules/{scheduleId},
    "ResourceName": " NewCommerceMigrationSchedule",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

CreateTransfer 事件

當建立新的傳輸時，會發生此事件。

屬性

範例

{
    "EventName": "create-transfer",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/transfers/{transferId},
    "ResourceName": " Transfer",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

ExpireTransfer 事件

當新的傳輸過期時，就會引發此事件。

屬性

範例

{
    "EventName": "expire-transfer",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/transfers/{transferId},
    "ResourceName": " Transfer",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

UpdateTransfer 事件

當更新傳輸時，就會引發此事件。

屬性

範例

{
    "EventName": "update-transfer",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/transfers/{transferId},
    "ResourceName": " Transfer",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

CompleteTransfer 事件

傳輸完成時，就會引發此事件。

屬性

範例

{
    "EventName": "complete-transfer",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/transfers/{transferId},
    "ResourceName": " Transfer",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

失敗傳輸事件

當傳輸失敗時，就會引發此事件。

屬性

範例

{
    "EventName": "transfer-failed",
    "ResourceUri": https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/transfers/{transferId},
    "ResourceName": " Transfer",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

客戶接受的轉銷商關係事件

當客戶接受轉銷商關係時，就會引發此事件。

屬性

範例

{
  "EventName": "reseller-relationship-accepted-by-customer",
  "ResourceUri": "https://api.partnercenter.microsoft.com/v1/customers/4b2a6e33-8791-4386-bd2b-0d55baf25039",
  "ResourceName": "Customer",
  "AuditUri": "https://api.partnercenter.microsoft.com/auditactivity/v1/auditrecords/60d5c4bb-f78a-4200-a002-953d7cc1f5f8_4b2a6e33-8791-4386-bd2b-0d55baf25039_resellerrelationshipacceptedbycustomer_638331855840159088",
  "ResourceChangeUtcDate": "2023-10-18T00:26:24.0159088+00:00"
}

客戶接受的間接轉銷商關係事件

當客戶租戶核准間接經銷商關係時，就會引發此事件。

屬性

範例

{
  "EventName": "indirect-reseller-relationship-accepted-by-customer",
  "ResourceUri": "https://api.partnercenter.microsoft.com/v1/customers/4b2a6e33-8791-4386-bd2b-0d55baf25039",
  "ResourceName": "Customer",
  "AuditUri": "https://api.partnercenter.microsoft.com/auditactivity/v1/auditrecords/60d5c4bb-f78a-4200-a002-953d7cc1f5f8_4b2a6e33-8791-4386-bd2b-0d55baf25039_resellerrelationshipacceptedbycustomer_638331855840159088",
  "ResourceChangeUtcDate": "2023-10-18T00:26:24.0159088+00:00"
}

由 Microsoft 事件終止的 DAP 管理員關聯性

當 DAP 處於非使用中狀態超過 90 天時，Microsoft終止合作夥伴與客戶租使用者之間的 DAP 時，就會引發此事件。

屬性

範例

{
    "EventName": "dap-admin-relationship-terminated-by-microsoft",
    "ResourceName": "PartnerCustomerDap",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

DAP 管理員關聯性核准事件

當合作夥伴與客戶租使用者之間的 DAP 核准時，就會引發此事件。

屬性

範例

{
    "EventName": "dap-admin-relationship-approved",
    "ResourceName": "PartnerCustomerDap",
    "AuditUri": null,
    "ResourceUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

DAP 管理關係已終止

當合作夥伴與客戶租使用者之間的 DAP 終止時，就會引發此事件。

屬性

範例

{
    "EventName": "dap-admin-relationship-terminated",
    "ResourceName": "PartnerCustomerDap",
    "AuditUri": null,
    "ResourceUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"

}

偵測到 Azure 詐騙事件的通知

當合作夥伴租戶偵測到任何 CSP 夥伴的客戶租戶的安全警示時，就會引發此事件。 CSP 合作夥伴必須採取動作，立即解決安全性警示。

屬性

範例

{
    "EventName": "azure-fraud-event-detected",
    "ResourceUri": "https://api.partnercenter.microsoft.com/v1/customers/{{customerId}}/subscriptions/{{subscriptionId}} ",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}