WindowsQualityUpdateCatalogItem を更新する

名前空間: microsoft.graph

大事な： /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。

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

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

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

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

アクセス許可

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

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

HTTP 要求

PATCH /deviceManagement/windowsUpdateCatalogItems/{windowsUpdateCatalogItemId}

要求ヘッダー

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

要求本文

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

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

プロパティ	型	説明
id	String	カタログ項目 ID。windowsUpdateCatalogItem から継承
displayName	String	カタログ アイテムの表示名。 windowsUpdateCatalogItem から継承
releaseDateTime	DateTimeOffset	カタログ アイテムがリリースされた日付 WindowsUpdateCatalogItem から継承された日付
endOfSupportDate	DateTimeOffset	windowsUpdateCatalogItem から継承されたカタログ 項目の最後にサポートされた日付
kbArticleId	String	Windows 品質更新プログラム カタログ項目に関連付けられているサポート情報記事を識別します。 読み取り専用
classification	windowsQualityUpdateCategory	Windows 品質更新プログラムのカテゴリ。 使用可能な値は、すべて、セキュリティ、セキュリティ以外です。 読み取り専用です。 可能な値は all、security、nonSecurity です。
qualityUpdateCadence	windowsQualityUpdateCadence	品質更新プログラムの発行間隔。 使用できる値は、月単位、outOfBand です。 このプロパティは変更できず、カタログの作成時に自動的に設定されます。 読み取り専用です。 可能な値は monthly、outOfBand、unknownFutureValue です。
isExpeditable	ブール型	TRUE の場合は、品質更新プログラムが探索対象であることを示します。 FALSE の場合は、品質更新プログラムが探索の品質ではないことを示します。 既定値は FALSE です。 読み取り専用
productRevisions	windowsQualityUpdateCatalogProductRevision コレクション	この品質更新プログラムの一部としてリリースされるオペレーティング システム製品のリビジョン。 読み取り専用です。

応答

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

例

要求

以下は、要求の例です。

PATCH https://graph.microsoft.com/beta/deviceManagement/windowsUpdateCatalogItems/{windowsUpdateCatalogItemId}
Content-type: application/json
Content-length: 1177

{
  "@odata.type": "#microsoft.graph.windowsQualityUpdateCatalogItem",
  "displayName": "Display Name value",
  "releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
  "endOfSupportDate": "2017-01-01T00:02:08.3437725-08:00",
  "kbArticleId": "Kb Article Id value",
  "classification": "security",
  "qualityUpdateCadence": "outOfBand",
  "isExpeditable": true,
  "productRevisions": [
    {
      "@odata.type": "microsoft.graph.windowsQualityUpdateCatalogProductRevision",
      "displayName": "Display Name value",
      "releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
      "versionName": "Version Name value",
      "productName": "Product Name value",
      "osBuild": {
        "@odata.type": "microsoft.graph.windowsQualityUpdateProductBuildVersionDetail",
        "majorVersionNumber": 2,
        "minorVersionNumber": 2,
        "buildNumber": 11,
        "updateBuildRevision": 3
      },
      "knowledgeBaseArticle": {
        "@odata.type": "microsoft.graph.windowsQualityUpdateProductKnowledgeBaseArticle",
        "articleId": "Article Id value",
        "articleUrl": "https://example.com/articleUrl/"
      }
    }
  ]
}

応答

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

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

{
  "@odata.type": "#microsoft.graph.windowsQualityUpdateCatalogItem",
  "id": "8eb831ba-31ba-8eb8-ba31-b88eba31b88e",
  "displayName": "Display Name value",
  "releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
  "endOfSupportDate": "2017-01-01T00:02:08.3437725-08:00",
  "kbArticleId": "Kb Article Id value",
  "classification": "security",
  "qualityUpdateCadence": "outOfBand",
  "isExpeditable": true,
  "productRevisions": [
    {
      "@odata.type": "microsoft.graph.windowsQualityUpdateCatalogProductRevision",
      "displayName": "Display Name value",
      "releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
      "versionName": "Version Name value",
      "productName": "Product Name value",
      "osBuild": {
        "@odata.type": "microsoft.graph.windowsQualityUpdateProductBuildVersionDetail",
        "majorVersionNumber": 2,
        "minorVersionNumber": 2,
        "buildNumber": 11,
        "updateBuildRevision": 3
      },
      "knowledgeBaseArticle": {
        "@odata.type": "microsoft.graph.windowsQualityUpdateProductKnowledgeBaseArticle",
        "articleId": "Article Id value",
        "articleUrl": "https://example.com/articleUrl/"
      }
    }
  ]
}