Azure 防欺诈通知 - 更新防欺诈事件状态
适用于:合作伙伴中心 API
调查每个报告的 Azure 资源的欺诈活动并确定欺诈行为或合法行为后,可以使用此 API 更新欺诈事件状态,并出于适当的原因。
注意
此 API 只会更新事件状态,它不会代表云解决方案提供商合作伙伴解决欺诈活动。
必备条件
- 合作伙伴中心身份验证中所述的凭据。 此方案支持使用应用凭据和用户凭据进行身份验证。
REST 请求
请求语法
| 方法 | 请求 URI |
|---|---|
| POST | {baseURL}/v1/fraudEvents/subscription/{subscriptionId}/status |
请求标头
- 有关详细信息,请参阅合作伙伴中心 REST 标头。
请求正文
无。
请求示例
POST https://api.partnercenter.microsoft.com/v1/fraudEvents/subscription/{subscriptionId}/status} HTTP/1.1
Authorization: Bearer <token>
Host: api.partnercenter.microsoft.com
Content-Type: application/json
{
"EventIds": ["2a7064fb-1e33-4007-974e-352cb3f2c805_2edeb5b1-766f-4209-9271-3ddf27755afa"],
"EventStatus" : "Resolved",
"ResolvedReason": "Fraud"
}
URI 参数
创建请求时使用以下可选查询参数。
| 名称 | 类型 | 必需 | 说明 |
|---|---|---|---|
| SubscriptionId | 字符串 | 是 | 具有 Crypro 挖掘活动的 Azure 订阅 ID |
请求正文
| 属性 | 类型 | 必需 | 说明 |
|---|---|---|---|
| eventIds | string[] | 否 | 如果要更新给定订阅 ID 下所有欺诈事件的状态,请将 eventId 保留为空 |
| eventStatus | 字符串 | 是 | 将其设置为 “解决 ”以解决欺诈事件,或将其设置为 “主动” 以响应欺诈事件。 |
| resolvedReason | 字符串 | 是 | 解决欺诈事件后,设置适当的原因代码,接受的原因代码是 欺诈 或 忽略 |
REST 响应
如果成功,此方法在响应正文中返回欺诈事件的集合。
响应的成功和错误代码
每个响应附带一个 HTTP 状态代码,指示成功或失败以及更多调试信息。 使用网络跟踪工具读取此代码、错误类型和更多参数。 有关完整列表,请参阅错误代码。
响应示例
HTTP/1.1 200 OK
Content-Length: 313
Content-Type: application/json
MS-CorrelationId: 4cb80cbe-566b-4d8b-8b8f-af1454b73089
MS-RequestId: 566330a7-1e4b-4848-9c23-f135c70fd810
Date: Thu, 21 May 2020 22:29:17 GMT
[
{
"eventTime": "2021-12-08T00:25:45.69",
"eventId": "2a7064fb-1e33-4007-974e-352cb3f2c805_2edeb5b1-766f-4209-9271-3ddf27755afa",
"partnerTenantId": "348e932d-ef58-4347-8351-be51e4ec148c",
"partnerFriendlyName": "test partner",
"customerTenantId": "a248da34-6840-4c67-82d7-7f55ccd50d03",
"customerFriendlyName": "test customer",
"subscriptionId": "2a7064fb-1e33-4007-974e-352cb3f2c805",
"subscriptionType": "modern",
"entityId": "2edeb5b1-766f-4209-9271-3ddf27755afa",
"entityName": "sampleentity",
"entityUrl": "\\sample\\entity\\url",
"hitCount": "10",
"catalogOfferId": "ms-azr-17g",
"eventStatus": "Resolved",
"serviceName": "sampleservice",
"resourceName": "sampleresource",
"resourceGroupName": "sampleresourcegroup",
"firstOccurrence": "2021-12-08T00:25:45.69",
"lastOccurrence": "2021-12-08T00:25:45.69",
"resolvedReason": "Fraud",
"resolvedOn": "2021-12-08T11:25:45.69",
"resolvedBy": "adminagent@test.com"
}
]