製品データの取得
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/my/hardware/products/ |
すべての製品のデータの取得 |
GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} |
特定の製品のデータの取得 |
GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions |
製品のすべての申請に関するデータの取得 |
GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId} |
製品の特定の申請に関するデータの取得 |
前提条件
Microsoft ハードウェア API に関する前提条件をすべて満たしてから、ここに記載されているメソッドを使用してください。
データ リソース
製品データを取得するための Microsoft Hardware API メソッドは、次の JSON データ リソースを使用します。
製品リソース
このリソースは、アカウントに登録されているハードウェア製品 (ドライバー) を表します。
{
"id": 9007199267351834,
"sharedProductId": 1152921504606971100,
"links": [
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/9007199267351834",
"rel": "self",
"method": "GET"
},
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/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 | デバイスの種類を示します。 次のいずれかの値になります。
|
isTestSign | Boolean | 製品がテスト署名されたドライバーであるかどうかを示します。 テスト署名ドライバー パッケージの詳細については WHQL テスト署名プログラム を参照してください 。 |
isFlightSign | Boolean | 製品がフライト署名されたドライバーかどうかを示します。 フライト署名されたドライバーは、Windows Update を通じて公開できるテスト ドライバーです。 これらは、Windows Insider Program にサインアップしたマシンにのみ発行/インストールできます。 セキュア ブートを無効にしなくてもマシンにインストールできます。 Windows Insider Program に含まれていないリテール マシンにはインストールできません。 |
marketingNames | 文字列の配列 | 製品のマーケティング名またはエイリアス |
productName | String | 作成時に指定したドライバーの名前 |
selectedProductTypes | ディクショナリ | 両方が文字列であるキー値ペア。
|
requestedSignatures | 文字列の配列 | 製品が認定されているオペレーティング システム署名の一覧。 すべてのオペレーティング システムの一覧については、「OS コードの一覧」を参照してください。 |
additionalAttributes | Object | 詳細については、「追加属性オブジェクト」を参照してください。 |
testHarness | string | 提出されたパッケージの種類。 使用できる値:
|
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 に準拠しています。 |
Name | string | 申請の名前。 |
種類 | string | 申請が初期提出か派生提出かを示します。 使用できる値:
|
ダウンロード | オブジェクト | これは、特定の申請の詳細を取得する場合にのみ使用できます。 このオブジェクトは、申請に使用できるダウンロードを示しています。 詳細については、「オブジェクトのダウンロード」を参照してください。 |
Workflow Status オブジェクト
このオブジェクトは、特定のエンティティのワークフローの状態を表します。
{
"currentStep": "finalizeIngestion",
"state": "completed",
"messages": []
}
このオブジェクトの値は次のとおりです。
値 | 種類 | 説明 |
---|---|---|
currentStep | string | このエンティティの全体的なワークフローにおける現在のステップの名前。 インジェスト/パッケージの送信の場合、使用可能な値は次のとおりです (かっこ内の説明)。
|
状態 | string | 現在のステップの状態。 次のいずれかの値になります。
|
Messages (メッセージ) | 配列 | 現在の手順に関するメッセージを提供する文字列の配列 (特に失敗がある場合) |
オブジェクトのダウンロード
このオブジェクトは、特定の申請のダウンロードを表します。
{
"items": [
{
"type": "initialPackage",
"url": "<SAS URL from Hardware API>"
},
{
"type": "derivedPackage",
"url": "<SAS URL from Hardware API>"
},
{
"type": "signedPackage",
"url": "<SAS URL from Hardware API>"
},
{
"type": "certificationReport",
"url": "https:// manage.devcenter.microsoft.com/dashboard/hardware/Driver/DownloadCertificationReport/29963920/13635057453741329/1152921504621441930"
}
],
"messages": []
}
このオブジェクトの値は次のとおりです。
値 | 種類 | 説明 |
---|---|---|
項目 | 配列 | ダウンロードの種類の配列と、それぞれの URL。 |
種類 | string | ダウンロード可能なパッケージの種類。 次のいずれかの値になります。
|
Messages (メッセージ) | 配列 | ダウンロード可能なファイルに関するメッセージを提供する文字列の配列 |
リンクオブジェクト
このオブジェクトは、含まれるエンティティに役立つリンクの一覧を表します
{
"href": "https:// manage.devcenter.microsoft.com/api/v2.0/hardware/products/9007199267351834",
"rel": "self",
"method": "GET"
}
このオブジェクトの値は次のとおりです。
値 | 種類 | 説明 |
---|---|---|
Href | String | API 経由でリソースにアクセスする URL |
Rel | String | リソースの種類。 次のいずれかの値になります。
|
メソッド | String | URL を呼び出すときに使用する http メソッドの型。 使用できる値:
|
追加の 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 は必須です。 |
proprietaryName | string | マルチパス ソフトウェア名 |
proprietaryVersion | string | マルチパス ソフトウェア バージョン |
usedMicrosoft | boolean | Microsoft MPIO は、デバイス固有のモジュールを通じてサポートされています。 true の場合、microsoftName と microsoftVersion は必須です。 |
microsoftName | string | マルチパス ソフトウェア名 |
microsoftVersion | string | マルチパス ソフトウェア バージョン |
usedBootSupport | boolean | ブートサポート |
usedBetterBoot | boolean | Boot > 2.2 TB のサポート。 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 次のいずれかの値になります。
|
processorArchitecture | string | ハードウェア プロセッサ アーキテクチャ。 次のいずれかの値になります。
|
maxProcessors | integer | VM の最大プロセッサ数 |
maxMemory | integer | VM の最大メモリ (GB 単位) |
製品の種類の一覧
製品には次のタイプがあります。 オペレーティング システムと共に、この情報は適用性を識別するために使用されます。
- 3D プリンター
- 加速度計センサー
- オールインワン
- 1 つのタッチですべて
- オーディオデバイス
- オーディオ処理オブジェクト
- Bluetoothコントローラー
- Bluetooth コントローラー (USB 以外)
- Camera
- カメラ センサー
- クラスター
- コンピューティング アクセラレータ MCDM 2.7
- コンピューティング アクセラレータ MCDM 3.1
- コンピューティング アクセラレータ MCDM 3.2
- コンバーチブル タブレット
- デスクトップ
- デジタル メディア レンダラー
- デジタル メディア サーバー
- デジタルスチルカメラ
- デジタル ビデオ カメラ
- ディストリビューション スキャン管理が有効なデバイス
- エンタープライズ WSD 多機能プリンター
- 指紋リーダー
- ゲーム コントローラ
- 汎用コントローラー
- 汎用ポータブル デバイス
- グラフィックス アダプター MCDM2.7
- グラフィックス アダプター MCDM2.8
- グラフィックス アダプター MCDM2.9
- グラフィックス アダプター MCDM3.0
- グラフィックス アダプター WDDM1.0
- グラフィックス アダプター WDDM1.1
- グラフィックス アダプター WDDM1.2
- グラフィックアダプター WDDM1.2 DisplayOnly
- グラフィックス アダプター WDDM1.2 RenderOnly
- グラフィックス アダプター WDDM1.3
- グラフィックス アダプターWDDM1.3 DisplayOnly
- グラフィックス アダプター WDDM1.3 RenderOnly
- グラフィックス アダプター WDDM2.0
- グラフィック アダプター WDDM2.0 ディスプレイのみ
- グラフィックス アダプター WDDM2.0 レンダリングのみ
- グラフィックス アダプター WDDM2.1
- グラフィック アダプター WDDM2.1 ディスプレイのみ
- グラフィックス アダプター WDDM2.1 レンダリングのみ
- グラフィックス アダプター WDDM2.2
- グラフィック アダプター WDDM2.2 ディスプレイのみ
- グラフィックス アダプター WDDM2.2 レンダリングのみ
- グラフィックス アダプター WDDM2.3
- グラフィック アダプター WDDM2.3 ディスプレイのみ
- グラフィックス アダプター WDDM2.3 レンダリングのみ
- グラフィックス アダプター WDDM2.4
- グラフィック アダプター WDDM2.4 ディスプレイのみ
- グラフィックス アダプター WDDM2.4 レンダリングのみ
- グラフィックス アダプター WDDM2.4 VM
- グラフィックス アダプター WDDM2.5
- グラフィック アダプター WDDM2.5 ディスプレイのみ
- グラフィックス アダプター WDDM2.5 レンダリングのみ
- グラフィックス アダプター WDDM2.5 VM
- グラフィックス アダプター WDDM2.6
- グラフィック アダプター WDDM2.6 ディスプレイのみ
- グラフィックス アダプター WDDM2.6 レンダリングのみ
- グラフィックス アダプター WDDM2.6 VM
- グラフィックス アダプター WDDM2.7
- グラフィック アダプター WDDM2.7 ディスプレイのみ
- グラフィックス アダプター WDDM2.7 レンダリングのみ
- グラフィックス アダプター WDDM2.7 VM
- グラフィックス アダプター WDDM2.8
- グラフィック アダプター WDDM2.8 ディスプレイのみ
- グラフィックス アダプター WDDM2.8 レンダリングのみ
- グラフィックス アダプター WDDM2.8 VM
- グラフィックス アダプター WDDM2.9
- グラフィック アダプター WDDM2.9 ディスプレイのみ
- グラフィックス アダプター WDDM2.9 レンダリングのみ
- グラフィックス アダプター WDDM2.9 VM
- グラフィックス アダプター WDDM3.0
- グラフィック アダプター WDDM3.0 ディスプレイのみ
- グラフィックス アダプター WDDM3.0 レンダリングのみ
- グラフィックス アダプター WDDM3.0 VM
- グラフィックス アダプター WDDM3.1
- グラフィック アダプター WDDM3.1 ディスプレイのみ
- グラフィックス アダプター WDDM3.1 レンダリングのみ
- グラフィックス アダプター WDDM3.1 VM
- グラフィックス アダプター WDDM3.2
- グラフィック アダプター WDDM3.2 ディスプレイのみ
- グラフィックス アダプター WDDM3.2 レンダリングのみ
- グラフィックス アダプター WDDM3.2 VM
- グラフィックス タブレット
- ジャイロスコープ センサー
- ハード ドライブ
- ハードウェア多機能変換
- [キーボード]
- キーボード ビデオ マウス スイッチ
- LAN
- LAN (Server)
- LAN CS
- LAN 仮想マシン (サーバー)
- ノート PC
- タッチ付きノート PC
- LCD
- ライト センサー
- 位置センサー
- Media Player
- モバイル ブロードバンド CDMA
- モバイル ブロードバンド GSM
- 携帯電話番号
- モニター
- マザーボード
- モーションセンサーフュージョン
- 多機能プリンター
- 近距離近接通信
- ネットワーク メディア デバイス
- NFC
- NFC スマート カード リーダー
- 光学式ドライブ
- ペン デジタイザー
- ポインティング図面
- 精度の高い タッチパッド
- プレゼンス センサー
- プリンター
- Projector
- リムーバブル ストレージ
- ルーター
- スキャナー
- SDIO コントローラー
- [サーバー]
- サーバ仮想化検証プログラム
- 署名タブレット
- スマート カード
- スマート カード リーダー
- 記憶域配列
- ストレージ コントローラー
- 記憶域スペース アダプター
- 記憶域スペース ドライブ
- タブレット PC
- タッチ
- タッチ モニター
- TPM20
- ウルトラモバイル 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 |
Windows_v100_GE | Windows 11 クライアント、バージョン 24H2 |
Windows_v100Server_GE | Windows Server 2025 |
オペレーティング システム コードの一覧
次の表に、オペレーティング システムコードとその説明を示します。
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 |
WINDOWS_v100_X64_GE_FULL | Windows 11 クライアント、バージョン 24H2 x64 |
WINDOWS_v100_ARM64_GE_FULL | Windows 11 クライアント バージョン 24H2 ARM64 |
WINDOWS_v100_SERVER_X64_GE_FULL | Windows Server 2025 x64 |
WINDOWS_v100_SERVER_ARM64_GE_FULL | Windows Server 2025 ARM64 |
エラー コード
エラー コードは、API のすべての Web メソッドに適用されます。 要求を正常に完了できない場合、応答には次のいずれかの HTTP エラー コードが含まれます。
HTTP の状態 | 説明 |
---|---|
400 – 不正な要求 | 要求の形式が正しくない (形式が正しくない要求構文、無効な要求メッセージのフレーミング、誤った要求ルーティングなど) |
401 – 未承認 | 認証に失敗したか、指定されていません |
403 – 使用不可能 | リソースへのアクセスが禁止されています。 |
404お探しのページが見つかりませんでした | 要求されたエンティティが見つかりません。 |
415 - サポートされていないメディア タイプ | ペイロードは、ターゲット リソースでこのメソッドでサポートされていない形式です。 |
422 - 処理できないエンティティ | 検証エラー |
429 - 要求が多すぎます | 送信されている要求が多すぎます。 呼び出しが調整され、応答でバックオフ時間が提供されます。 |
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 | 申請で配送先住所ラベルを作成する準備がまだ整っていません。 しばらくしてからやり直してください。 | 準備や前処理が完了するのを待たずに配送先住所ラベルが作成されたときに返されます。 |