为指定客户删除配置策略

适用于:合作伙伴中心

如何删除指定客户和策略标识符的配置策略。

必备条件

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

  • 客户 ID (customer-tenant-id)。 如果不知道客户的 ID,可以通过选择“客户”工作区、客户列表中的“客户”和“帐户”,在合作伙伴中心中查找该 ID。 在客户的“帐户”页上的“客户帐户信息” 部分查找 Microsoft ID。 Microsoft ID 与客户 ID (customer-tenant-id) 相同。

  • 策略标识符。

C#

删除指定客户的配置策略:

  1. 使用客户 ID 调用 IAggregatePartner.Customers.ById 方法,以检索对指定客户的操作的接口。

  2. 使用策略 ID 调用 ConfigurationPolicies.ById 方法,以检索指定策略的配置策略操作的接口。

  3. 调用 DeleteDeleteAsync 方法来删除配置策略。

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedPolicyId;

partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.ById(selectedPolicyId).Delete();

示例控制台测试应用项目:合作伙伴中心 SDK 示例 :DeleteConfigurationPolicy.cs

REST 请求

请求语法

方法 请求 URI
DELETE {baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1

URI 参数

创建请求时使用以下路径参数。

名称 类型 必须 说明
customer-id 字符串 一个 GUID 格式的字符串,用于标识客户。
policy-id string 标识要删除的策略的 GUID 格式字符串。

请求标头

有关详细信息,请参阅合作伙伴中心 REST 标头

请求正文

请求示例

DELETE https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/policies/56edf752-ee77-4fd8-b7f5-df1f74a3a9ac HTTP/1.1
Authorization: Bearer <token>
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Length: 0
Content-Type: application/json
Host: api.partnercenter.microsoft.com

REST 响应

如果成功,响应将返回 204 无内容状态代码。

响应的成功和错误代码

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

响应示例

HTTP/1.1 204 No Content
Content-Length: 0
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 76b6f317-1da1-4b61-a6fd-9952439a2c46
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:10:41 GMT