製品データの取得

  • [アーティクル]

Microsoft Hardware API の次のメソッドを使用して、デベロッパー センター アカウントに登録されているハードウェア製品のデータを取得します。 API を使用するための前提条件など、Microsoft ハードウェア API の概要については、API を使用したハードウェア申請の管理をご覧ください。

https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/

これらの方法を使用する前に、製品がデベロッパー センター アカウントに存在している必要があります。 製品申請を作成または管理するには、製品申請の管理をご覧ください。

Method URI 説明
GET https://manage.devcenter.microsoft.com/v2.0/hardware/products/ すべての製品のデータの取得
GET https://manage.devcenter.microsoft.com/v2.0/hardware/products/{productID} 特定の製品のデータの取得
GET https://manage.devcenter.microsoft.com/v2.0/hardware/products/{productID}/submissions 製品のすべての申請に関するデータの取得
GET https://manage.devcenter.microsoft.com/v2.0/hardware/products/{productID}/submissions/{submissionId} 製品の特定の申請に関するデータの取得

前提条件

Microsoft ハードウェア API に関するすべての 前提条件 がまだ満たされていない場合は、ここに記載されているメソッドを使用する前に前提条件を整えてください。

データ リソース

製品データを取得するための Microsoft Hardware API メソッドは、次の JSON データ リソースを使用します。

製品リソース

このリソースは、アカウントに登録されているハードウェア製品 (ドライバー) を表します。

{
  "id": 9007199267351834,
  "sharedProductId": 1152921504606971100,
  "links": [
    {
      "href": "https:// manage.devcenter.microsoft.com/api/v2.0/hardware/products/9007199267351834",
      "rel": "self",
      "method": "GET"
    },
    {
      "href": "https:// manage.devcenter.microsoft.com/api/v2.0/hardware/products/9007199267351834/submissions",
      "rel": "get_submissions",
      "method": "GET"
    }
  ],
  "isCommitted": true,
  "isExtensionInf": false, "_comment": "THis field is deprecated and moved to submission resource",
  "deviceMetadataIds": [],
  "deviceType": "notSet",
  "isTestSign": false,
  "isFlightSign": false,
  "marketingNames": [
    "marketing name 1",
    "marketing name 2"
],
  "productName": "product name",
  "selectedProductTypes": {
    "windows_v100Server": "Unclassified",
    "windows_v100": "Unclassified"
},
  "requestedSignatures": [
    "WINDOWS_v100_X64_TH1_FULL",
    "WINDOWS_v63_X64"
  ],
  "additionalAttributes": {},
  "testHarness": "hlk",
  "announcementDate": "2016-10-22T00:00:00Z",
}

このリソースには、次の値があります。

値 種類 説明
Id Long 製品のプライベート製品ID
sharedProductId Long 製品の共通プロダクトID
リンク オブジェクトの配列 詳細については、「リンク オブジェクト」を参照してください。
isCommitted Boolean 製品に少なくとも 1 つのコミット済み申請があるかどうかを示します
isExtensionInf Boolean (非推奨) 製品が拡張ドライバーかどうかを示します。 このフィールドは非推奨です。今後は使用しないでください。 isExtensionInf は申請レベルのプロパティに移動されました。
deviceMetadataIds GUID の配列 デバイス メタデータの送信をドライバーにマップする GUID
deviceType String デバイスの種類を示します。 次のいずれかの値になります。
  • "internal" - 内部コンポーネント、システムの一部として PC 内部に接続されるデバイス
  • "external" - 外部コンポーネント、PC に接続される外部デバイス (周辺機器)
  • "internalExternal" - その両方、内部的に (PC 内で) 接続できるほか、外部的にも (周辺機器として) 接続できるデバイス
  • "notSet" – データが存在しない
isTestSign Boolean 製品がテスト署名されたドライバーであるかどうかを示します。 テスト署名ドライバー パッケージの詳細については WHQL テスト署名プログラム を参照してください 。
isFlightSign Boolean 製品がフライト署名されたドライバーかどうかを示します。 フライト署名されたドライバーは、Windows Update を通じて公開できるテスト ドライバーです。 これらは、Windows Insider Program 用にサインアップしているコンピューターにのみ公開/インストールできます。 これらは、セキュア ブートを無効にすることなく、コンピューターにインストールできます。 これらは、Windows Insider Program に含まれない小売向けコンピューターにはインストールできません。
marketingNames 文字列の配列 製品のマーケティング名またはエイリアス
productName String 作成時に指定したドライバーの名前
selectedProductTypes ディクショナリ 両方が文字列であるキー値ペア。
  • Key は、オペレーティング システム ファミリ コードを表します。 オペレーティング システム ファミリ コードの一覧については OS ファミリ コード の一覧を参照してください。
  • 値は 、製品のタイプを表します。 製品の種類の一覧については 製品の種類 を参照してください。
requestedSignatures 文字列の配列 製品が認定されているオペレーティング システム署名の一覧。 すべてのオペレーティング システムの一覧については OS コード の一覧 を参照してください
additionalAttributes Object 詳細については、「その他の属性オブジェクト」を参照してください。
testHarness string 送信されたパッケージの種類。 使用できる値は　
  • hlk
  • hck
  • attestation
  • notset
announcementDate datetime 製品が Windows Server カタログに掲載される日付

申請のリソース

このリソースは、製品の申請を表します。

{
  "id": 1152921504621442000,
  "productId": 13635057453741328,
   "workflowStatus": {
      "currentStep": "finalizeIngestion",
      "state": "completed",
      "messages": []
    },
  "links": [
    {
      "href": "https:// manage.devcenter.microsoft.com/api/v2.0/hardware/products/13635057453741329/submissions/1152921504621441944",
      "rel": "self",
      "method": "GET"
    }
  ],
  "commitStatus": "CommitPending",
  "isExtensionInf": true,
  "isUniversal": true,
  "isDeclarativeInf": true,
  "name": "HARRY-Duatest2",
  "type": "derived"
}

このリソースには、次の値があります。

値 種類 説明
Id long 申請 ID。
Productid long この送信が関連付けられているプライベート プロダクト ID
workflowstatus オブジェクト これは、特定の申請の詳細を取得する場合にのみ使用できます。 このオブジェクトは、この送信のワークフローのステータスを表します。 詳細については、「ワークフローの状態オブジェクト」を参照してください。
リンク オブジェクトの配列 詳細については、「リンク オブジェクト」を参照してください。
commitStatus 詳細については、「製品申請の管理」を参照してください。
isExtensionInf Boolean 申請が拡張ドライバーかどうかを示します
isUniversal Boolean 申請がユニバーサル API テストに適合しているかどうかを示します。 ドライバーが宣言型かつユニバーサルである場合、そのドライバーは DCHU に準拠しています
isDeclarativeInf Boolean 申請が宣言型 INVerif テストに適合しているかどうかを示します。 ドライバーが宣言型かつユニバーサルである場合、そのドライバーは DCHU に準拠しています
名前 string 提出物の名前
種類 string 申請が初期提出か派生提出かを示します。 使用できる値は　
  • イニシャル
  • 派生
ダウンロード オブジェクト これは、特定の申請の詳細を取得する場合にのみ使用できます。 このオブジェクトは、申請に使用できるダウンロードを示しています。 詳細については、「ダウンロード オブジェクト」を参照してください。

Workflow Status オブジェクト

このオブジェクトは、特定のエンティティのワークフローの状態を表します。

{
      "currentStep": "finalizeIngestion",
      "state": "completed",
      "messages": []
    }

このオブジェクトの値は次のとおりです。

値 種類 説明
currentStep string このエンティティの全体的なワークフローにおける現在のステップの名前。
インジェスト/パッケージの送信の場合、使用可能な値は次のとおりです (かっこ内の説明)。
  • packageInfoValidation (パッケージのメタデータとコンテンツの検証)
  • 準備 (パッケージの処理準備)
  • スキャン (マルウェアのパッケージ内容をスキャン)
  • 検証 (テスト結果の検証)
  • catalogCreation (パッケージのセキュリティ カタログの作成)
  • manualReview (手動レビュー中)
  • 署名 (バイナリへの署名)
  • finalizeIngestion (インジェストを完了し、署名されたファイルをダウンロードまたは発行する準備をする)
状態 string 現在のステップの状態。 次のいずれかの値になります。
  • notStarted
  • 開始済み
  • 失敗
  • completed
[メッセージ] 配列 現在のステップに関するメッセージを提供する文字列の配列 (特に失敗の場合)

オブジェクトのダウンロード

このオブジェクトは、特定の申請のダウンロードを表します。

{
  "items": [
    {
      "type": "initialPackage",
      "url": "https://ingestionpackages.blob.core.windows.net/ingestion/dc55b8c6-a01c-40b6-b815-cac8bc08812a?sv=2016-05-31&sr=b&sig=ipjW3RsVC75lZrcEZRh9JmTX89L4gTIKkxwqv9F8Axs%3D&se=2018-03-12T15:32:10Z&sp=rl"
    },
    {
      "type": "derivedPackage",
      "url": "https://ingestionpackages.blob.core.windows.net/ingestion/6bd77dbf-a851-46d2-b703-29ea4efae006?sv=2016-05-31&sr=b&sig=O5XQf%2FzMbI2FFt5WwSUJWL1JbWY4JXXPRkCKAnX7IRs%3D&se=2018-03-12T15:32:10Z&sp=rl&rscd=attachment%3B filename%3DShell_1152921504621441930.hlkx"
    },
    {
      "type": "signedPackage",
      "url": "https://ingestionpackages.blob.core.windows.net/ingestion/0b83a294-c1d1-4136-82a1-dd52f51841e3?sv=2016-05-31&sr=b&sig=zTfxKJmaTwpbFol%2FpAKG0QuXJTTxm5aZ0F2wQQI8whc%3D&se=2018-03-12T15:32:10Z&sp=rl"
    },
    {
      "type": "certificationReport",
      "url": "https:// manage.devcenter.microsoft.com/dashboard/hardware/Driver/DownloadCertificationReport/29963920/13635057453741329/1152921504621441930"
    }
  ],
  "messages": []
}

このオブジェクトの値は次のとおりです。

値 種類 説明
アイテム 配列 ダウンロードの種類の配列と、それぞれの URL。 詳細は下記をご参照ください
種類 string ダウンロード可能なパッケージの種類。 次のいずれかの値になります。
  • "initialPackage" – ユーザーがアップロードしたパッケージ (新しい申請の場合、パッケージのアップロードに使用する SAS URI を指します)
  • "derivedPackage" – 派生申請のためのシェル
  • "signedPackage" – Microsoft によって署名されているパッケージ
  • "certificationReport" – 署名された製品の認定レポート
  • driverMetadata - リンクはドライバー メタデータのダウンロードを許可するファイルを指定。 詳しくは、ドライバー パッケージのメタデータに関する記事をご覧ください。
  • ExternalNotes
  • Unknown
[メッセージ] 配列 ダウンロード可能なファイルに関するメッセージを提供する文字列の配列

このオブジェクトは、含まれるエンティティに役立つリンクの一覧を表します

{
      "href": "https:// manage.devcenter.microsoft.com/api/v2.0/hardware/products/9007199267351834",
      "rel": "self",
      "method": "GET"
    }

このオブジェクトの値は次のとおりです。

値 種類 説明
Href String API 経由でリソースにアクセスする URL
Rel String リソースの種類。 次のいずれかの値になります。
  • self – リンクがそれ自体を指す
  • next_link – ページ分割に通常使用される次のリソースへのリンク ポイント
  • get_submissions – 製品のすべての申請へのリンク ポイント
  • commit_submission – 申請のコミットへのリンク ポイント
  • update_submission – 申請の更新をポイントするリンク
  • update_shippinglabel – リンクは配送先住所ラベルの更新を指定
メソッド String URL を呼び出すときに使用する http メソッドの型。 次のいずれかの値になります。
  • GET
  • POST
  • PATCH

追加の Attribute オブジェクト

このオブジェクトは、RAID コントローラー、ストレージ コントローラー、またはサーバー仮想化検証プログラム (SVVP) の種類の場合、製品に関する追加の属性を提供します。 これには、StorageController、RaidController、SVVP の 3 種類のオブジェクトのいずれかを含めることができます。

StorageController オブジェクト

値 種類 説明
biosVersion string ROM Bios バージョン
firmwareVersion string Firmware Version
driverVersion string ドライバー バージョン
driverName string ドライバー名
deviceVersion string デバイス バージョン
chipsetName string チップセット名
usedProprietary boolean 独自のドライバーを介してサポートされるマルチパス。 true の場合、proprietaryName と proprietaryVersion は madatory になります
proprietaryName string マルチパス ソフトウェア名
proprietaryVersion string マルチパス ソフトウェア バージョン
usedMicrosoft boolean Microsoft MPIO は、デバイス固有のモジュールを通じてサポートされています。 true の場合、microsoftName と microsoftVersion は madatory になります
microsoftName string マルチパス ソフトウェア名
microsoftVersion string マルチパス ソフトウェア バージョン
usedBootSupport boolean ブートサポート
usedBetterBoot boolean 2.2TB より大きいブートのサポート。 true の場合、サポートされている UEFI バージョンとサポートされている ACPI バージョンが必須です
uefiVersion string サポートされている UEFI バージョン
acpiVersion string サポートされている ACPI バージョン
supportsSector4K512E boolean 4K/512e のセクター サイズをサポート
supportsSector4K4K boolean 4K/4K のセクター サイズをサポート
supportsDifferential boolean 差動 (高電圧差動)

RaidController オブジェクト

値 種類 説明
firmwareVersion string Firmware Version
filterVersion string ドライバー バージョン
driverVersion string フィルターのバージョン
usedProprietary boolean 独自のドライバーを介してサポートされるマルチパス。 true の場合、proprietaryName と proprietaryVersion は必須です
proprietaryName string マルチパス ソフトウェア名
proprietaryVersion string マルチパス ソフトウェア バージョン
usedMicrosoft boolean Microsoft MPIO は、デバイス固有のモジュールを通じてサポートされています。 true の場合、microsoftName と microsoftVersion は mandatory になります
microsoftName string マルチパス ソフトウェア名
microsoftVersion string マルチパス ソフトウェア バージョン
isThirdPartyNeeded boolean 接続に必要なサード パーティ製の Microsoft 以外のドライバー
isSES boolean SES (SCSI エンクロージャ サービス)。 SES が含まれるかどうかを示します。 SCSI は、システム上のデバイス (もともとは Small Computer System Interface) を接続するサービス バスの標準的な用語です。 SES は SCSI Enclosure Services の略です。
isSAFTE boolean SAF-TE (ANBll 仕様)。 SAF-TE が含まれているかどうかを示します。 ANBll は業界仕様です。 SAF-TE は SCSI アクセスフォールト トレラント エンクロージャの略です。 SCSI は、システム上のデバイス (もともとは Small Computer System Interface) を接続するサービス バスの標準的な用語です。
additionalInfo string 追加情報

SVVP オブジェクト

値 種類 説明
productVersion string 製品バージョン
supportLink string サポート URL
guestOs string ゲスト OS 次のいずれかの値になります。
  • Windows サーバー 2008
  • Windows Server 2008 リリース 2
  • Windows Server 2012
  • Windows Server 2012 R2
processorArchitecture string ハードウェア プロセッサ アーキテクチャ。 次のいずれかの値になります。
  • Xeon
  • Opteron
  • Itanium 2
maxProcessors integer VM の最大プロセッサ数
maxMemory integer VM の最大メモリ (GB 単位)

製品の種類の一覧

製品には次のタイプがあります。 この情報は、適用性を識別するためにオペレーティング システムと共に使用されます。

  • オールインワン
  • 1 つのタッチですべて
  • オーディオデバイス
  • Bluetoothコントローラー
  • Bluetooth コントローラー (USB 以外)
  • コンバーチブル タブレット
  • デスクトップ
  • デジタル メディア レンダラー
  • デジタル メディア サーバー
  • デジタルスチルカメラ
  • デジタル ビデオ カメラ
  • ディストリビューション スキャン管理が有効なデバイス
  • エンタープライズ WSD 多機能プリンター
  • 指紋リーダー
  • ゲーム コントローラ
  • 汎用コントローラー
  • 汎用ポータブル デバイス
  • グラフィックス アダプター WDDM1.0
  • グラフィックス アダプター WDDM1.1
  • グラフィックス アダプター WDDM1.2
  • グラフィックアダプター WDDM1.2 DisplayOnly
  • グラフィックス アダプター WDDM1.2 RenderOnly
  • グラフィックス タブレット
  • ハード ドライブ
  • [キーボード]
  • キーボード ビデオ マウス スイッチ
  • LAN
  • LAN (Server)
  • LAN CS
  • LAN 仮想マシン (サーバー)
  • ラップトップ
  • タッチ付きノート PC
  • LCD
  • ライト センサー
  • 位置センサー
  • Media Player
  • モバイル ブロードバンド CDMA
  • モバイル ブロードバンド GSM
  • 携帯電話番号
  • モニター
  • マザーボード
  • モーションセンサーフュージョン
  • 多機能プリンター
  • 近距離近接通信
  • ネットワーク メディア デバイス
  • 光学式ドライブ
  • ペン デジタイザー
  • ポインティング図面
  • プレゼンス センサー
  • プリンター
  • Projector
  • リムーバブル ストレージ
  • ルーター
  • スキャナー
  • SDIO コントローラー
  • [サーバー]
  • サーバ仮想化検証プログラム
  • 署名タブレット
  • スマート カード
  • スマート カード リーダー
  • 記憶域配列
  • ストレージ コントローラー
  • 記憶域スペース アダプター
  • 記憶域スペース ドライブ
  • タブレット PC
  • タッチ
  • タッチ モニター
  • ウルトラモバイル PC
  • タッチ付き ウルトラモバイル PC
  • USB コントローラー
  • USB ハブ
  • WebCam
  • WLAN
  • WLAN CSB
  • WSD 多機能プリンター
  • WSD プリンター
  • WSD スキャナー

オペレーティング システム ファミリ コードの一覧

次の表に、オペレーティング システム ファミリ コードとその説明を示します。

OS ファミリ コード 説明
WindowsMe Windows Me
Windows2000 Windows 2000
Windows98 Windows 98
WindowsNT40 Windows NT 4.0
WindowsXP Windows XP
WindowsServer2003 Windows Server 2003
WindowsVista Windows Vista
Windows2008Server Windows サーバー 2008
WindowsHomeServer Windows Home Server
Windows7 Windows 7
Windows2008ServerR2 Windows Server 2008 リリース 2
WindowsServerSolutions Windows Server Solutions
Windows8 Windows 8
Windows8Server Windows Server 2012
Windows81 Windows 8.1
Windows81Server Windows Server 2012 R2
Windows_v100 Windows 10 Threshold
Windows_v100Server Windows Server Threshold
Windows_v100_RS1 Windows 10 Anniversary Update
Windows_v100Server_RS1 Windows Server 2016
Windows_v100_RS2 Windows 10 RS2 Update
Windows_v100Server_RS2 Windows Server RS2
Windows_v100_RS3 Windows 10 RS3 Update
Windows_v100Server_RS3 Windows Server RS3
Windows_v100_RS4 Windows 10 RS4 Update
Windows_v100Server_RS5 Windows Server 2019
Windows_v100_RS5 Windows 10 RS5 x86
Windows_v100_RS5 Windows 10 RS5 x64
Windows_v100_19H1 Windows 10 19H1 更新プログラム
Windows_v100_VB Windows 10 バージョン 2004
Windows_v100Server_FE Windows - Server バージョン 21H2
Windows_v100_CO Windows - Client バージョン 21H2
Windows_v100_NI Windows 11 クライアント、バージョン 22H2

オペレーティング システム コードの一覧

次の表に、オペレーティング システムコードとその説明を示します。

OS コード 説明
WINDOWS_ME Windows Me
WINDOWS_98 Windows 98
WINDOWS_2000 Windows 2000
WINDOWS_NT40 Windows NT 4.0
WINDOWS_XP Windows XP
WINDOWS_XP_IA64 Windows XP IA64
WINDOWS_XP_X64 Windows XP X64
WINDOWS_XP_MEDIA_CENTER Windows XP メディア センター
WINDOWS_2003 Windows Server 2003
WINDOWS_2003_IA64 Windows Server 2003 IA64
WINDOWS_2003_X64 Windows Server 2003 X64
WINDOWS_VISTA Windows Vista クライアント
WINDOWS_VISTA_X64 Windows Vista クライアント X64
WINDOWS_2008_SERVER Windows サーバー 2008
WINDOWS_2008_SERVER_IA64 Windows Server 2008 IA64
WINDOWS_2008_SERVER_X64 Windows Server 2008 X64
WINDOWS_HOME_SERVER Windows Home Server
WINDOWS_7 Windows 7 クライアント
WINDOWS_7_X64 Windows 7 クライアント x64
WINDOWS_2008_SERVER_R2_IA64 Windows Server 2008 リリース 2 IA64
WINDOWS_2008_SERVER_R2_X64 Windows Server 2008 リリース x64
WINDOWS_SERVER_SOLUTIONS_X64 Windows Server ソリューション x64
WINDOWS_8 Windows 8 Client
WINDOWS_8_X64 Windows 8 クライアント x64
WINDOWS_8_ARM Windows 8 クライアント RT
WINDOWS_8_SERVER_X64 Windows Server 2012
WINDOWS_v63 Windows 8.1 クライアント
WINDOWS_v63_X64 Windows 8.1 クライアント x64
WINDOWS_v63_ARM Windows 8.1 クライアント RT
WINDOWS_v63_SERVER_X64 Windows Server 2012 R2 x64
WINDOWS_v100_TH1_FULL Windows 10 クライアント バージョン 1506 および 1511 (TH1)
WINDOWS_v100_X64_TH1_FULL Windows 10 クライアント バージョン 1506 および 1511 x64 (TH1)
WINDOWS_v100_SERVER_X64_TH1_FULL Windows Server 2016 x64 (TH1)
WINDOWS_v100_TH2_FULL Windows 10 クライアント バージョン 1506 および 1511 (TH2)
WINDOWS_v100_X64_TH2_FULL Windows 10 クライアント バージョン 1506 および 1511 x64 (TH2)
WINDOWS_v100_SERVER_X64_TH2_FULL Windows Server 2016 x64 (TH2)
WINDOWS_v100_RS1_FULL Windows 10 クライアント バージョン 1607
WINDOWS_v100_X64_RS1_FULL Windows 10 クライアント バージョン 1607 x64
WINDOWS_v100_SERVER_X64_RS1_FULL Windows Server 2016 x64 (RS1)
WINDOWS_v100_RS2_FULL Windows 10 RS2 クライアント
WINDOWS_v100_X64_RS2_FULL Windows 10 RS2 クライアント x64
WINDOWS_v100_RS3_FULL Windows 10 RS3 クライアント
WINDOWS_v100_X64_RS3_FULL Windows 10 RS3 クライアント x64
WINDOWS_v100_ARM64_RS3_FULL Windows 10 RS3 クライアント Arm64
WINDOWS_v100_RS4_FULL Windows 10 RS4 クライアント
WINDOWS_v100_X64_RS4_FULL Windows 10 RS4 クライアント x64
WINDOWS_v100_ARM64_RS4_FULL Windows 10 RS4 クライアント Arm64
WINDOWS_v100_SERVER_X64_RS5_FULL Windows Server 2019
WINDOWS_v100_RS5_FULL Windows 10 RS5 x86
WINDOWS_v100_X64_RS5_FULL Windows 10 RS5 クライアント x64
WINDOWS_v100_19H1_FULL Windows 19H1 クライアント x86
WINDOWS_v100_X64_19H1_FULL Windows 19H1 クライアント x64
WINDOWS_v100_ARM64_19H1_FULL Windows 19H1 クライアント Arm64
WINDOWS_v100_VB_FULL Windows 10 バージョン 2004 クライアント x86
WINDOWS_v100_X64_VB_FULL Windows バージョン 2004 クライアント x64
WINDOWS_v100_ARM64_VB_FULL Windows バージョン 2004 クライアント Arm64
WINDOWS_v100_SERVER_X64_FE_FULL Windows - Server バージョン 21H2 x64
WINDOWS_v100_SERVER_ARM64_FE_FULL Windows - Server バージョン 21H2 Arm64
WINDOWS_v100_X64_CO_FULL Windows - Client バージョン 21H2 x64
WINDOWS_v100_ARM64_CO_FULL Windows - Client バージョン 21H2 Arm64
WINDOWS_v100_X64_NI_FULL Windows 11 クライアント、バージョン 22H2 x64
WINDOWS_v100_ARM64_NI_FULL Windows 11 クライアント、バージョン 22H2 Arm64

エラー コード

エラー コードは、API のすべての Web メソッドに適用されます。 要求を正常に完了できない場合、次の HTTP エラー コードのいずれかが応答に含まれます。

HTTP の状態 説明
400 – 不正な要求 要求の形式が正しくない (形式が正しくない要求構文、無効な要求メッセージのフレーミング、誤った要求ルーティングなど)
401 – 未承認 認証に失敗したか、指定されていません
403 – 使用不可能 リソースへのアクセスが禁止されています
404お探しのページが見つかりませんでした 要求されたエンティティが見つかりません。
415 - サポートされていないメディア タイプ ペイロードは、ターゲット リソースでこのメソッドでサポートされていない形式です。
422 - 処理できないエンティティ 検証エラー
500 - 内部サーバーエラー API サーバーで回復不可能なエラーが発生しました。

機能検証エラーが発生した場合、応答本文には次のいずれかの機能エラー コードが含まれます。

エラー コード エラー メッセージ 説明
InvalidInput 入力検証が失敗したときに返されます
RequestInvalidForCurrentState 保留中の申請のみをコミットできます 保留中の状態ではない送信にコミットが適用されたときに返されます
RequestInvalidForCurrentState 初期提出が既に存在する 最初の申請が既に存在するドライバーの初期申請が作成されたときに返されます
RequestInvalidForCurrentState 最初の申請が作成されていないため、派生申請を作成できません 最初の申請がないドライバーに対して派生申請が作成されたときに返されます
UpdateUnauthorized 製品を更新する権限がありません 共有された製品を更新できないために共有 (再販売) された製品を更新しようとしたときに返されます
UpdateUnauthorized 最初の申請なしで製品を更新できない 最初の申請がない製品を更新しようとしたときに返されます
UpdateUnauthorized ワークフローが失敗したため、製品を更新できません 失敗したワークフローを含む製品を更新しようとしたときに返されます
UpdateUnauthorized インジェスト プロセスが完了した後は、お知らせ日を更新できません インジェストが完了した後に発表日が更新されたときに返されます
UpdateUnauthorized 現在、製品名は更新できません。 やり直してください
UpdateUnauthorized 申請を更新する権限がありません 共有された製品を更新できないため、共有 (再販売) された製品の申請を更新しようとしたときに返されます
UpdateUnauthorized ワークフローが失敗しているため、申請を更新できません 失敗したワークフローがある送信を更新しようとすると返されます
EntityNotFound 提出が見つかりません 存在しない申請をコミットしようとしたときに返されます
EntityNotFound 商品が見つかりません 製品が存在しない申請を作成しようとしたときに返されます
InvalidInput 拡張機能ドライバーは、自動更新プログラムとして公開する必要があります。 IsAutoInstallDuringOSUpgrade または isAutoInstallOnApplicableSystems のいずれかを true にする必要があります。 拡張機能 INF の Windows Update 配送先住所ラベルが、isAutoInstallDuringOSUpgrade または isAutoInstallOnApplicableSystems を選択せずに作成された場合に返されます
InvalidInput CHID は、HardwareIds が Windows 10 以降のオペレーティング システムである場合にのみ許可されます。 Windows 10 以前の OS を対象とした配送先住所ラベルが、CHID を使用して作成された場合に返されます。 CHID による対象指定は、Windows 10 以降に対してのみ適用されます。
InvalidInput 別のワークフローが進行中のときには配送先住所ラベルを更新できません。 もう一度お試しください。 前のワークフローがまだ進行中のときに配送先住所ラベルを更新しようとすると返されます。
RequestInvalidForCurrentState 公開用の配送先住所ラベルをインボックス ドライバーやシステムの種類に対して作成することはできません。 できるのは、配送先住所ラベルを共有することだけです。 Windows Update の配送先住所ラベルを、インボックス ドライバーまたはシステム上で作成しようとした場合に返されます。
RequestInvalidForCurrentState 申請の配送先住所ラベルを作成する準備がまだできていません。 しばらくしてからやり直してください。 準備や事前処理が完了していない段階で配送先住所ラベルを作成しようとしたときに返されます。

関連項目