指定された顧客の新しい構成ポリシーを作成する
適用対象: パートナー センター
指定した顧客の新しい構成ポリシーを作成する方法。
前提条件
パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、スタンドアロンの App と App+User の両方の資格情報を使用した認証がサポートされています。
顧客 ID です (
customer-tenant-id
)。 顧客の ID がわからない場合は、 パートナー センター で [顧客] ワークスペースを選択し、 次に顧客 の一覧から顧客を探し、[ アカウント] を選択します。 お客様のアカウント ページで、 [顧客のアカウント情報] セクションの Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id
) と同じです。
C#
指定した顧客の新しい構成ポリシーを作成するには:
次のコード スニペットに示すように、新しい ConfigurationPolicy オブジェクトをインスタンス化します。 次に、顧客 ID を指定して IAggregatePartner.Customers.ById メソッドを呼び出して、指定した顧客の操作へのインターフェイスを取得します。
ConfigurationPolicies プロパティを取得して、構成ポリシーコレクション操作へのインターフェイスを取得します。
Create メソッドまたは CreateAsync メソッドを呼び出して、構成ポリシーを作成します。
C# の例
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
var configurationPolicyToCreate = new ConfigurationPolicy
{
Name = "Test Config Policy",
Description = "This configuration policy is created by the SDK samples",
PolicySettings = new List<PolicySettingsType>() {
PolicySettingsType.OobeUserNotLocalAdmin,
PolicySettingsType.SkipEula }
};
var createdConfigurationPolicy =
partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.Create(configurationPolicyToCreate);
サンプル: コンソール テスト アプリ。 プロジェクト: パートナー センター SDK サンプル クラス: CreateConfigurationPolicy.cs
REST 要求
要求の構文
認証方法 | 要求 URI |
---|---|
POST | {baseURL}/v1/customers/{customer-id}/policies HTTP/1.1 |
URI パラメーター
要求を作成するときは、次のパス パラメーターを使用します。
名前 | Type | 必須 | 説明 |
---|---|---|---|
customer-id | string | はい | 顧客を識別する GUID 形式の文字列。 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
[要求本文]
要求本文には、次の表に示すように、構成ポリシー情報を含む オブジェクトが含まれている必要があります。
名前 | Type | 必須 | 説明 |
---|---|---|---|
name | string | はい | ポリシーのフレンドリ名。 |
category | string | はい | ポリシー カテゴリ。 |
description | string | いいえ | ポリシーの説明。 |
policySettings | 文字列の配列 | はい | ポリシー設定。 |
要求の例
POST https://api.partnercenter.microsoft.com//v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/policies HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Length: 212
Content-Type: application/json
Host: api.partnercenter.microsoft.com
{
"name": "Windows 10 Enterprise E5",
"category": "o_o_b_e",
"description": "test policy creation from API",
"policySettings": ["oobe_user_not_local_admin", "skip_express_settings"]
}
REST 応答
成功した場合、応答本文には新しいポリシーの ConfigurationPolicy リソースが含まれます。
応答の成功とエラーのコード
各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、パートナー センターの REST エラーコードに関する記事を参照してください。
応答の例
HTTP/1.1 200 OK
Content-Length: 404
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 0dfadf74-aa66-49ed-9a67-b3b78d9297cc
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:07:36 GMT
{
"id": "40cdb858-edcc-44d7-9083-d6a36d43bd3f",
"name": "Windows 10 Enterprise E5",
"category": "o_o_b_e",
"description": "test policy creation from API",
"devicesAssigned": 0,
"policySettings": ["oobe_user_not_local_admin", "skip_express_settings"],
"createdDate": "2017-07-25T18:07:36",
"lastModifiedDate": "2017-07-25T18:07:36",
"attributes": {
"objectType": "ConfigurationPolicy"
}
}