合作伙伴中心 Webhook 事件

项目
11/10/2023

适用于：合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心

合作伙伴中心 Webhook 事件是以 HTTP POST 形式传送到已注册 URL 的资源更改事件。若要从合作伙伴中心接收事件，请托管合作伙伴中心可以发布事件的回调。事件经过数字签名，以便你可以验证它是否已从合作伙伴中心发送。

有关如何接收事件、对回调进行身份验证并使用合作伙伴中心 Webhook API 创建、查看和更新事件注册的信息，请参阅合作伙伴中心 Webhook。

支持的事件

合作伙伴中心支持以下 Webhook 事件。

测试事件

此事件允许你通过请求测试事件并跟踪其进度来自行载入和测试注册。在尝试传递事件时，可以看到从 Microsoft 接收的失败消息。这仅适用于“测试创建”事件，并且清除了超过 7 天的数据。

注意

发布测试创建的事件时，将强制实施每分钟 2 个请求的限制。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，将测试创建该值。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/webhooks/v1/registration/validationEvents/{{CorrelationId}}”
资源名称	string	触发事件的资源的名称。对于此事件，该值是测试的。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

订阅更新事件

当指定的订阅发生更改时，将引发此事件。除了通过合作伙伴中心 API 进行更改外，还会生成订阅更新事件。仅当存在商业级别更改时，才会生成此事件，例如，修改许可证数和订阅状态更改时。在订阅中创建资源时，不会生成它。

注意

订阅更改的时间和触发订阅更新事件的时间之间，延迟最长为 48 小时。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值是订阅更新的。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/webhooks/v1/customers/{{CustomerId}}/subscriptions/{{SubscriptionId}}}”
资源名称	string	触发事件的资源的名称。对于此事件，该值为订阅。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

{
    "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 使用量超出其使用情况支出预算（其阈值）时，将引发此事件。有关详细信息，请参阅 [为客户/合作伙伴中心/set-an-azure-spending-budget-for-your-customers 设置 Azure 支出预算）。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，值为 usagerecords-thresholdExceeded。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/webhooks/v1/customers/usagerecords”
资源名称	string	触发事件的资源的名称。对于此事件，值为 usagerecords。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

引荐已创建事件

创建引荐时将引发此事件。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值是引荐创建的。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/engagements/v1/referrals/{{ReferralID}}”
资源名称	string	触发事件的资源的名称。对于此事件，该值为引荐。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

引荐更新事件

更新引荐时引发此事件。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值是引用更新的。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/engagements/v1/referrals/{{ReferralID}}”
资源名称	string	触发事件的资源的名称。对于此事件，该值为引荐。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

更新相关引荐时，将引发此事件。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值是相关-引荐更新的。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/engagements/v1/referrals/{{ReferralID}}”
资源名称	string	触发事件的资源的名称。对于此事件，该值为引荐。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

创建相关引荐时，将引发此事件。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值是相关引荐创建的。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/engagements/v1/referrals/{{ReferralID}}”
资源名称	string	触发事件的资源的名称。对于此事件，该值为引荐。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

精细管理员关系已批准事件

当客户租户批准粒度委派管理员特权时，将引发此事件。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值是粒度管理员-关系批准的。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/granular管理员Relationships/{{RelationshipID}}”
资源名称	string	触发事件的资源的名称。对于此事件，值为 Granular管理员Relationship。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

精细管理员关系激活事件

当创建精细委派管理员特权并激活客户批准时，将引发此事件。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值是粒度管理员-关系激活的。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/granular管理员Relationships/{{RelationshipID}}”
资源名称	string	触发事件的资源的名称。对于此事件，值为 Granular管理员Relationship。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

精细管理员关系终止事件

当合作伙伴/客户租户终止粒度委派管理员特权时，将引发此事件。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值是粒度管理员-关系终止的。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/granular管理员Relationships/{{RelationshipID}}”
资源名称	string	触发事件的资源的名称。对于此事件，值为 Granular管理员Relationship。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

精细管理员关系过期事件

当粒度委派管理员特权过期时，将引发此事件。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值是粒度管理员关系过期的。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/granular管理员Relationships/{{RelationshipID}}”
资源名称	string	触发事件的资源的名称。对于此事件，值为 Granular管理员Relationship。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

精细管理员访问分配已创建事件

当合作伙伴创建粒度委派管理员特权访问分配时，将引发此事件。合作伙伴可以将客户批准的 Microsoft Entra 角色分配给特定安全组。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值是精细的 admin-access-assignment-created。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/granular管理员Relationships/{{RelationshipID}}}/accessAssignments/{{AssignmentID}}”
资源名称	string	触发事件的资源的名称。对于此事件，值为 Granular管理员AccessAssignment。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

{
    "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 角色分配到特定安全组后，合作伙伴激活粒度委派管理员特权访问分配时，将引发此事件。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值是精细的 admin-access-assignment-activated。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/granular管理员Relationships/{{RelationshipID}}}/accessAssignments/{{AssignmentID}}”
资源名称	string	触发事件的资源的名称。对于此事件，值为 Granular管理员AccessAssignment。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

精细管理员访问分配更新事件

当合作伙伴更新粒度委派管理员特权访问分配时，将引发此事件。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值是粒度管理员访问权限-分配更新的。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/granular管理员Relationships/{{RelationshipID}}}/accessAssignments/{{AssignmentID}}”
资源名称	string	触发事件的资源的名称。对于此事件，值为 Granular管理员AccessAssignment。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

精细管理员访问分配已删除事件

当合作伙伴删除粒度委派管理员特权访问分配时，将引发此事件。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值是精细的 admin-access-assignment-deleted。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/granular管理员Relationships/{{RelationshipID}}}/accessAssignments/{{AssignmentID}}”
资源名称	string	触发事件的资源的名称。对于此事件，值为 Granular管理员AccessAssignment。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

客户事件接受的经销商关系

当客户接受经销商关系时，将引发此事件。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值为经销商关系-接受-按客户。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/v1/customers/{CustomerId}”
资源名称	string	触发事件的资源的名称。对于此事件，值为客户。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

Dap 管理员由 Microsoft 事件终止的关系

当 DAP 处于非活动状态超过 90 天时，当 Microsoft 终止合作伙伴与客户租户之间的 DAP 时，将引发此事件。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值为 dap-admin-relationship-terminated-by-microsoft。
资源名称	string	触发事件的资源的名称。对于此事件，值为 PartnerCustomerDap。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

Dap 管理员关系已批准事件

当合作伙伴租户与客户租户之间的 DAP 获得批准时，将引发此事件。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值是 dap-admin-relationship-approved。
资源名称	string	触发事件的资源的名称。对于此事件，值为 PartnerCustomerDap。
ResourceUri	string	NA 不可用
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

Dap 管理员关系终止

当合作伙伴租户与客户租户之间的 DAP 终止时，将引发此事件。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值为 dap-admin-relationship-terminated。
资源名称	string	触发事件的资源的名称。对于此事件，值为 PartnerCustomerDap。
ResourceUri	string	NA 不可用
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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

}

Azure 欺诈事件检测到事件

当 Parter 租户检测到其任何客户租户的任何 Azure 欺诈事件时，将引发此事件。合作伙伴需要采取措施来解决欺诈问题。

属性

属性	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值是检测到 azure-fraud-event。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/v1/fraudEvents？SubscriptionId={{subscriptionId}}&EventStatus={{eventStatus}}”
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

{
    "EventName": "azure-fraud-event-detected",
    "ResourceUri": "https://api.partnercenter.microsoft.com/v1/fraudEvents?SubscriptionId={{subscriptionId}}&EventStatus={{eventStatus}}",
    "AuditUri": null,
    "ResourceChangeUtcDate": "2018-02-17T00:05:39.5485487+00:00"
}

发票就绪事件

当新发票准备就绪时，将引发此事件。

properties	Type	描述
EventName	string	事件名称。在 {resource}-{action} 窗体中。对于此事件，该值已准备好发票。
ResourceUri	URI	用于获取资源的 URI。使用语法：“{baseURL}/v1/invoices/{{InvoiceId}}”
资源名称	string	触发事件的资源的名称。对于此事件，值为发票。
AuditUri	URI	（可选）要获取审核记录的 URI（如果存在）。使用语法：“{baseURL}/auditactivity/v1/auditrecords/{{AuditId}}”）
ResourceChangeUtcDate	采用 UTC 日期/时间格式的字符串	发生资源更改的日期和时间。

示例

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