取消 Azure 订阅

  • 项目

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

如果遭到入侵或滥用，则 Azure 客户订阅的合作伙伴可以直接从合作伙伴中心门户或 API 取消订阅，从而关闭其 Azure 计划订阅中发现的可疑活动。

此 API 将取消 Azure 订阅。 如果合作伙伴想要取消多个订阅，则需要单独调用 API 来取消每个订阅。

如果合作伙伴想要暂停其 Azure 计划，则应使用现有的可用 API， 按 ID 更新订阅。

以下 API 不支持取消 Azure 计划。

合作伙伴必须是具有管理员代理角色的全局管理员管理员才能取消。

先决条件

  • 合作伙伴中心身份验证中所述的凭据此方案支持使用独立应用和 App+用户凭据进行身份验证。

  • Customer_id。

  • Subscription_id。

  • Entitlement_id。

C#

若要取消 Azure 订阅，需要标识该订阅的客户 ID、订阅 ID 和权利 ID。

REST 请求

请求语法

方法 请求 URI
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel HTTP/1.1

URI 参数

下表列出了取消 Azure 订阅所需的查询参数。

Name 类型 必填 描述
customer_id 字符串 Y 该值是表示客户的标识符的字符串。
subscription_id 字符串 Y 该值是表示客户的标识符的字符串。
entitlement_id 字符串 Y 该值是表示 Azure 订阅权利标识符的字符串。

请求标头

请参阅 合作伙伴中心 REST 标头。

请求正文

HTTP
{ "cancellationReason": "compromise" }

请求示例

POST
[https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel](https://api.partnercenter.microsoft.com/v1/customers/%7bcustomer_id%7d/subscriptions/%7bsubscription_id%7d/azureEntitlements/%7bentitlement_id%7d/cancel)
HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
{
 "id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
 "friendlyName": "Cancel_Azure_Subscription ",
 "status": "active",
 "subscriptionId": "065eefc4-915b-453d-c558-152e39ec25b1",
 "links": {
  "self": {
  "uri":
  "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/065eefc4-915b-453d-c558-152e39ec25b1/azureEntitlements/5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
  "method": "GET",
"headers": []
   }
  }
}

REST 响应

如果成功，此方法在响应正文中返回 订阅 资源的 Azure 权利。

响应的成功和错误代码

每个响应都有一个 HTTP 状态代码，指示成功或失败以及更多的调试信息。 使用网络跟踪工具读取此代码、错误类型和其他参数。 如需完整列表，请参阅合作伙伴中心 REST 错误代码。

HTTP 状态 HTTP 代码 错误代码 描述
BadRequest 400 900118 客户 ID 无效。
BadRequest 400 800002 客户 ID {0} 应具有 GUID 格式（xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxx）。
BadRequest 400 800002 需要订阅 ID。
BadRequest 400 800002 权利 ID 是必需的。
BadRequest 400 800002 需要 Azure 权利取消请求内容。
禁止 403 900159 帐户 ID {0} 和组织 ID 的合作伙伴与具有帐户 ID {2} 和组织 ID {1}{3}的客户没有商业关系。
BadRequest 400 900307 取消原因 “{0} 无效。
NotFound 404 800111 找不到 ID 的 {0} Azure 权利。

响应示例

取消订阅的响应包括权利状态。 预计状态将反映大约 10 分钟（即活动状态为非活动状态）。

HTTP
HTTP/1.1 200 OK
Content-Length: 1132
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 6eacec93-852d-4167-9d96-c57809bea7ed
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT
{
"id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
"friendlyName": " Cancel_Azure_Subscription",
"status": "active",
"subscriptionId": "065eefc4-915b-453d-c558-152e39ec25b1",
"links": {
"self": {
"uri":
"/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/065eefc4-915b-453d-c558-152e39ec25b1/azureEntitlements/5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
"method": "GET",
"headers": []
 }
}

后续步骤