检索某位客户的配置策略
适用于:合作伙伴中心
如何检索指定客户的指定配置策略。
必备条件
合作伙伴中心身份验证中所述的凭据。 此方案支持使用独立应用和应用+用户凭据进行身份验证。
客户 ID (
customer-tenant-id
)。 如果不知道客户的 ID,可以通过选择“客户”工作区、客户列表中的“客户”和“帐户”,在合作伙伴中心中查找该 ID。 在客户的“帐户”页上的“客户帐户信息” 部分查找 Microsoft ID。 Microsoft ID 与客户 ID (customer-tenant-id
) 相同。策略标识符。
C#
若要检索指定客户的配置策略,请首先使用客户 ID 调用 IAggregatePartner.Customers.ById 方法,以检索针对指定客户的操作的接口。 接下来,使用策略 ID 调用 ConfigurationPolicies.ById 方法,以检索指定策略的配置策略操作的接口。 最后,调用 Get 或 GetAsync 方法来检索配置策略。
IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedConfigurationPolicyId;
ConfigurationPolicy retrievedConfigurationPolicy =
partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.ById(selectedConfigurationPolicyId).Get();
示例: 控制台测试应用。 项目:合作伙伴中心 SDK 示例 类:GetConfigurationPolicy.cs
REST 请求
请求语法
方法 | 请求 URI |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1 |
URI 参数
创建请求时,请使用以下路径和查询参数。
名称 | 类型 | 必须 | 说明 |
---|---|---|---|
customer-id | string | 是 | 一个 GUID 格式的字符串,用于标识客户。 |
policy-id | 字符串 | 是 | 标识策略的 GUID 格式字符串。 |
请求标头
有关详细信息,请参阅合作伙伴中心 REST 标头。
请求正文
无
请求示例
GET https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/policies/56edf752-ee77-4fd8-b7f5-df1f74a3a9ac HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: de894e18-f027-4ac0-8b5a-34f0c222af0c
X-Locale: en-US
Content-Length: 0
Host: api.partnercenter.microsoft.com
REST 响应
如果成功,响应将包含请求的 ConfigurationPolicy 资源。
响应的成功和错误代码
每个响应都带有一个 HTTP 状态代码,用于指示成功或失败以及其他调试信息。 请使用网络跟踪工具来读取此代码、错误类型和其他参数。 如需完整列表,请参阅合作伙伴中心 REST 错误代码。
响应示例
HTTP/1.1 200 OK
Content-Length: 443
MS-CorrelationId: abe150cf-c677-435c-b5d5-b34899a6d1ec
MS-RequestId: ab3abfe7-dce7-46c0-ab20-4fd49bc3e2f7
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:08:27 GMT
{
"id": "56edf752-ee77-4fd8-b7f5-df1f74a3a9ac",
"name": "Test policy",
"category": "o_o_b_e",
"description": "Test policy creation from API 1",
"devicesAssigned": 0,
"policySettings": ["skip_express_settings"],
"createdDate": "2017-07-25T11:03:03.8457116-07:00",
"lastModifiedDate": "2017-07-25T11:04:00.8149974-07:00",
"attributes": {
"objectType": "ConfigurationPolicy"
}
}
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈