deviceManagementCollectionSettingDefinition を更新する

名前空間: microsoft.graph

重要:Microsoft は Intune /beta API をサポートしていますが、より頻繁に変更される可能性があります。 可能な場合は、バージョン v1.0 を使用することをお勧めします。 バージョン セレクターを使用して、バージョン v1.0 で API が使用できるかどうかを確認します。

注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。

deviceManagementCollectionSettingDefinition オブジェクトのプロパティを更新します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ✅ ✅ ✅

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) DeviceManagementConfiguration.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション DeviceManagementConfiguration.ReadWrite.All

HTTP 要求

PATCH /deviceManagement/settingDefinitions/{deviceManagementSettingDefinitionId}
PATCH /deviceManagement/categories/{deviceManagementSettingCategoryId}/settingDefinitions/{deviceManagementSettingDefinitionId}
PATCH /deviceManagement/intents/{deviceManagementIntentId}/categories/{deviceManagementIntentSettingCategoryId}/settingDefinitions/{deviceManagementSettingDefinitionId}
PATCH /deviceManagement/templates/{deviceManagementTemplateId}/categories/{deviceManagementTemplateSettingCategoryId}/settingDefinitions/{deviceManagementSettingDefinitionId}

要求ヘッダー

ヘッダー 値
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
承諾 application/json

要求本文

要求の本文で、 deviceManagementCollectionSettingDefinition オブジェクトの JSON 表現を指定します。

次の表に、 deviceManagementCollectionSettingDefinition を作成するときに必要なプロパティを示します。

プロパティ 型 説明
id 文字列 deviceManagementSettingDefinition から継承される設定定義の ID
valueType deviceManangementIntentValueType deviceManagementSettingDefinition から継承された値のデータ型。 使用可能な値: integer、boolean、string、complex、collection、abstractComplex。
displayName 文字列 設定の表示名: deviceManagementSettingDefinition から継承されます。
isTopLevel ブール型 設定が最上位レベルの場合は、コレクションや複雑な設定でラップする必要はありません deviceManagementSettingDefinition から継承されます
説明 String 設定の説明: deviceManagementSettingDefinition から継承
placeholderText 文字列 有効な入力の例としてのプレースホルダー テキスト deviceManagementSettingDefinition から継承
documentationUrl 文字列 設定ドキュメントへの URL deviceManagementSettingDefinition から継承
headerTitle 文字列 設定ヘッダーのタイトルは、設定/設定のカテゴリ/セクションを表します deviceManagementSettingDefinition から継承されます
headerSubtitle 文字列 カテゴリ/セクションの詳細については、設定ヘッダーのサブタイトルを参照してください deviceManagementSettingDefinition から継承
keywords String collection 設定に関連付けられているキーワード 継承元 deviceManagementSettingDefinition
制約 deviceManagementConstraint コレクション 設定値の制約のコレクション deviceManagementSettingDefinition から継承されます
依存関係 deviceManagementSettingDependency コレクション 他の設定に対する依存関係のコレクション deviceManagementSettingDefinition から継承
elementDefinitionId 文字列 コレクションの各要素の外観を記述する設定定義 ID

応答

成功した場合、このメソッドは応答本文で 200 OK 応答コードと更新された deviceManagementCollectionSettingDefinition オブジェクトを返します。

例

要求

以下は、要求の例です。

PATCH https://graph.microsoft.com/beta/deviceManagement/settingDefinitions/{deviceManagementSettingDefinitionId}
Content-type: application/json
Content-length: 1081

{
  "@odata.type": "#microsoft.graph.deviceManagementCollectionSettingDefinition",
  "valueType": "boolean",
  "displayName": "Display Name value",
  "isTopLevel": true,
  "description": "Description value",
  "placeholderText": "Placeholder Text value",
  "documentationUrl": "https://example.com/documentationUrl/",
  "headerTitle": "Header Title value",
  "headerSubtitle": "Header Subtitle value",
  "keywords": [
    "Keywords value"
  ],
  "constraints": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
      "supportedTypes": [
        "Supported Types value"
      ]
    }
  ],
  "dependencies": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingDependency",
      "definitionId": "Definition Id value",
      "constraints": [
        {
          "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
          "supportedTypes": [
            "Supported Types value"
          ]
        }
      ]
    }
  ],
  "elementDefinitionId": "Element Definition Id value"
}

応答

以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1130

{
  "@odata.type": "#microsoft.graph.deviceManagementCollectionSettingDefinition",
  "id": "0419c4a7-c4a7-0419-a7c4-1904a7c41904",
  "valueType": "boolean",
  "displayName": "Display Name value",
  "isTopLevel": true,
  "description": "Description value",
  "placeholderText": "Placeholder Text value",
  "documentationUrl": "https://example.com/documentationUrl/",
  "headerTitle": "Header Title value",
  "headerSubtitle": "Header Subtitle value",
  "keywords": [
    "Keywords value"
  ],
  "constraints": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
      "supportedTypes": [
        "Supported Types value"
      ]
    }
  ],
  "dependencies": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingDependency",
      "definitionId": "Definition Id value",
      "constraints": [
        {
          "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
          "supportedTypes": [
            "Supported Types value"
          ]
        }
      ]
    }
  ],
  "elementDefinitionId": "Element Definition Id value"
}
  • Last updated on