Windows デバイス ポータル コア REST API リファレンス

Windows デバイス ポータル (WDP) のすべての機能は、REST API を基にして構築されています。開発者は REST API を直接呼び出して、プログラムからリソースにアクセスし、デバイスを制御することができます。

アプリの展開

アプリをインストールする

要求

次の要求形式を使用して、アプリをインストールできます。

認証方法 要求 URI
POST /api/app/packagemanager/package

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
パッケージ (必須) インストールするパッケージのファイル名。

要求ヘッダー

  • None

要求本文

  • .appx または .appxbundle ファイル、およびアプリが必要とする依存関係。
  • デバイスが IoT または Windows デスクトップの場合、アプリの署名に使う証明書。 その他のプラットフォームでは、証明書は必要ありません。

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 展開要求は受け入れられ、処理されています。
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

Note

Windows Mixed Reality は通常のデスクトップで実行されるため、Desktop と同じポータルです。

要求

次の要求形式を使用して、関連セットをインストールできます。

認証方法 要求 URI
POST /api/app/packagemanager/package

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
パッケージ (必須) インストールするパッケージのファイル名。

要求ヘッダー

  • None

要求本文

  • オプション パッケージをパラメーターとして指定するときは、"foo.appx.opt"、"bar.appxbundle.opt" などのようにパッケージのファイル名に ".opt" を追加します。
  • .appx または .appxbundle ファイル、およびアプリが必要とする依存関係。
  • デバイスが IoT または Windows デスクトップの場合、アプリの署名に使う証明書。 その他のプラットフォームでは、証明書は必要ありません。

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 展開要求は受け入れられ、処理されています。
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

アプリをルース フォルダーに登録する

要求

次の要求形式を使用して、アプリをルース フォルダーに登録できます。

認証方法 要求 URI
POST /api/app/packagemanager/networkapp

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

{
    "mainpackage" :
    {
        "networkshare" : "\\some\share\path",
        "username" : "optional_username",
        "password" : "optional_password"
    }
}

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 展開要求は受け入れられ、処理されています。
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

要求

次の要求形式を使用して、関連セットをルース フォルダーに登録できます。

認証方法 要求 URI
POST /api/app/packagemanager/networkapp

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

{
    "mainpackage" :
    {
        "networkshare" : "\\some\share\path",
        "username" : "optional_username",
        "password" : "optional_password"
    },
    "optionalpackages" :
    [
        {
            "networkshare" : "\\some\share\path2",
            "username" : "optional_username2",
            "password" : "optional_password2"
        },
        ...
    ]
}

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 展開要求は受け入れられ、処理されています。
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

アプリのインストール状態を取得する

要求

次の要求形式を使用して、現在進行中のアプリのインストールの状態を取得できます。

認証方法 要求 URI
GET /api/app/packagemanager/state

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 最後の展開の結果
204 インストールは実行中です
404 インストール操作は見つかりませんでした

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

アプリをアンインストールする

要求

次の要求形式を使用して、アプリをアンインストールできます。

認証方法 要求 URI
DELETE /api/app/packagemanager/package

URI パラメーター

URI パラメーター 説明
パッケージ (必須) ターゲット アプリの PackageFullName (GET /api/app/packagemanager/packages から)

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

インストールされたアプリを取得する

要求

次の要求形式を使用して、システムにインストールされているアプリの一覧を取得できます。

認証方法 要求 URI
GET /api/app/packagemanager/packages

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、インストールされているパッケージの一覧と関連する詳細情報が含まれます。 この応答のテンプレートは次のとおりです。

{"InstalledPackages": [
    {
        "Name": string,
        "PackageFamilyName": string,
        "PackageFullName": string,
        "PackageOrigin": int, (https://msdn.microsoft.com/library/windows/desktop/dn313167(v=vs.85).aspx)
        "PackageRelativeId": string,
        "Publisher": string,
        "Version": {
            "Build": int,
            "Major": int,
            "Minor": int,
            "Revision": int
     },
     "RegisteredUsers": [
     {
        "UserDisplayName": string,
        "UserSID": string
     },...
     ]
    },...
]}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

Bluetooth


コンピューターの Bluetooth 無線を取得する

要求

次の要求形式を使用して、コンピューターにインストールされている Bluetooth 無線の一覧を取得できます。 これは、同じ JSON データを使用して、WebSocket 接続にアップグレードすることもできます。

認証方法 要求 URI
GET /api/bt/getradios
GET/WebSocket /api/bt/getradios

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、デバイスにアタッチされている Bluetooth 無線の JSON 配列が含まれます。

{"BluetoothRadios" : [
    {
        "BluetoothAddress" : int64,
        "DisplayName" : string,
        "HasUnknownUsbDevice" : boolean,
        "HasProblem" : boolean,
        "ID" : string,
        "ProblemCode" : int,
        "State" : string
    },...
]}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • HoloLens
  • IoT

Bluetooth 無線をオンまたはオフにします。

要求

特定の Bluetooth 無線をオンまたはオフに設定します。

認証方法 要求 URI
POST /api/bt/setradio

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
ID (必須) Bluetooth 無線のデバイス ID であり、base 64 でエンコードされている必要があります。
State (必須) これは、"On" または "Off" にすることができます。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • HoloLens
  • IoT

ペアリングした Bluetooth デバイスの一覧を取得する

要求

現在ペアリングされている Bluetooth デバイスの一覧を取得するには、次の要求形式を使用します。 これは、同じ JSON データを使用して、WebSocket 接続にアップグレードすることもできます。 WebSocket 接続の有効期間中、デバイスの一覧が変更される可能性があります。 更新が行われるたびに、WebSocket 接続を介してデバイスの完全な一覧が送信されます。

認証方法 要求 URI
GET /api/bt/getpaired
GET/WebSocket /api/bt/getpaired

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、現在ペアリングされている Bluetooth デバイスの JSON 配列が含まれます。

{"PairedDevices": [
    {
        "Name" : string,
        "ID" : string,
        "AudioConnectionStatus" : string
    },...
]}

デバイスをこのシステムのオーディオに使用できる場合は、AudioConnectionStatus フィールドが表示されます (ポリシーとオプションのコンポーネントがこの影響を受ける可能性があります)。AudioConnectionStatus は、"Connected" または "Disconnected" のいずれかです。


利用可能な Bluetooth デバイスの一覧を取得する

要求

ペアリングに使用できる Bluetooth デバイスの一覧を取得するには、次の要求形式を使用します。 これは、同じ JSON データを使用して、WebSocket 接続にアップグレードすることもできます。 WebSocket 接続の有効期間中、デバイスの一覧が変更される可能性があります。 更新が行われるたびに、WebSocket 接続を介してデバイスの完全な一覧が送信されます。

認証方法 要求 URI
GET /api/bt/getavailable
GET/WebSocket /api/bt/getavailable

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、現在ペアリングに利用可能な Bluetooth デバイスの JSON 配列が含まれます。

{"AvailableDevices": [
    {
        "Name" : string,
        "ID" : string
    },...
]}

Bluetooth デバイスを接続する

要求

デバイスをこのシステムのオーディオに使用できる場合、デバイスに接続します (ポリシーとオプションのコンポーネントがこの影響を受ける可能性があります)。

認証方法 要求 URI
POST /api/bt/connectdevice

URI パラメーター

URI パラメーター 説明
ID (必須) Bluetooth デバイスのアソシエーション エンドポイント ID。Base64 でエンコードされている必要があります。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • HoloLens
  • IoT

Bluetooth デバイスを切断する

要求

デバイスをこのシステムのオーディオに使用できる場合は、デバイスを切断します (ポリシーとオプションのコンポーネントがこの影響を受ける可能性があります)。

認証方法 要求 URI
POST /api/bt/disconnectdevice

URI パラメーター

URI パラメーター 説明
ID (必須) Bluetooth デバイスのアソシエーション エンドポイント ID。Base64 でエンコードされている必要があります。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • HoloLens
  • IoT

デバイス マネージャー


コンピューターにインストールされているデバイスを取得する

要求

次の要求形式を使用して、コンピューターにインストールされているデバイスの一覧を取得できます。

認証方法 要求 URI
GET /api/devicemanager/devices

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、デバイスにアタッチされているデバイスの JSON 配列が含まれます。

{"DeviceList": [
    {
        "Class": string,
        "Description": string,
        "ID": string,
        "Manufacturer": string,
        "ParentID": string,
        "ProblemCode": int,
        "StatusCode": int
    },...
]}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • IoT

接続された USB デバイス/ハブのデータを取得する

要求

次の要求形式を使用して、接続された USB デバイスおよびハブの USB 記述子の一覧を取得できます。

認証方法 要求 URI
GET /ext/devices/usbdevices

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答は、ハブの USB 記述子およびポート情報と共に、USB デバイスのデバイス ID が含まれる JSON です。

{
    "DeviceList": [
        {
        "ID": string,
        "ParentID": string, // Will equal an "ID" within the list, or be blank
        "Description": string, // optional
        "Manufacturer": string, // optional
        "ProblemCode": int, // optional
        "StatusCode": int // optional
        },
        ...
    ]
}

返されるデータのサンプル

{
    "DeviceList": [{
        "ID": "System",
        "ParentID": ""
    }, {
        "Class": "USB",
        "Description": "Texas Instruments USB 3.0 xHCI Host Controller",
        "ID": "PCI\\VEN_104C&DEV_8241&SUBSYS_1589103C&REV_02\\4&37085792&0&00E7",
        "Manufacturer": "Texas Instruments",
        "ParentID": "System",
        "ProblemCode": 0,
        "StatusCode": 25174026
    }, {
        "Class": "USB",
        "Description": "USB Composite Device",
        "DeviceDriverKey": "{36fc9e60-c465-11cf-8056-444553540000}\\0016",
        "ID": "USB\\VID_045E&PID_00DB\\8&2994096B&0&1",
        "Manufacturer": "(Standard USB Host Controller)",
        "ParentID": "USB\\VID_0557&PID_8021\\7&2E9A8711&0&4",
        "ProblemCode": 0,
        "StatusCode": 25182218
    }]
}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • IoT

ダンプの収集


アプリのすべてのクラッシュ ダンプの一覧を取得する

要求

次の要求形式を使用して、サイドローディングされたすべてのアプリについて、利用可能なすべてのクラッシュ ダンプの一覧を取得できます。

認証方法 要求 URI
GET /api/debug/dump/usermode/dumps

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、サイドローディングされたアプリケーションごとにクラッシュ ダンプの一覧が含まれます。

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Window Mobile (Windows Insider Program のみ)
  • Windows デスクトップ
  • HoloLens
  • IoT

アプリのクラッシュ ダンプ収集設定を取得する

要求

次の要求形式を使用して、サイドローディングされたアプリのクラッシュ ダンプ収集設定を取得できます。

認証方法 要求 URI
GET /api/debug/dump/usermode/crashcontrol

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
packageFullName (必須) サイドローディングされたアプリのパッケージの完全な名前。

要求ヘッダー

  • None

要求本文

  • None

応答

応答は、次の形式になります。

{"CrashDumpEnabled": bool}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Window Mobile (Windows Insider Program のみ)
  • Windows デスクトップ
  • HoloLens
  • IoT

サイドローディングされたアプリのクラッシュ ダンプを削除する

要求

次の要求形式を使用して、サイドローディングされたアプリのクラッシュ ダンプを削除できます。

認証方法 要求 URI
DELETE /api/debug/dump/usermode/crashdump

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
packageFullName (必須) サイドローディングされたアプリのパッケージの完全な名前。
fileName (必須) 削除する必要があるダンプ ファイルの名前。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Window Mobile (Windows Insider Program のみ)
  • Windows デスクトップ
  • HoloLens
  • IoT

サイドローディングされたアプリのクラッシュ ダンプを無効にする

要求

次の要求形式を使用して、サイドローディングされたアプリのクラッシュ ダンプを無効にすることができます。

認証方法 要求 URI
DELETE /api/debug/dump/usermode/crashcontrol

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
packageFullName (必須) サイドローディングされたアプリのパッケージの完全な名前。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Window Mobile (Windows Insider Program のみ)
  • Windows デスクトップ
  • HoloLens
  • IoT

サイドローディングされたアプリのクラッシュ ダンプをダウンロードする

要求

次の要求形式を使用して、サイドローディングされたアプリのクラッシュ ダンプをダウンロードできます。

認証方法 要求 URI
GET /api/debug/dump/usermode/crashdump

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
packageFullName (必須) サイドローディングされたアプリのパッケージの完全な名前。
fileName (必須) ダウンロードするダンプ ファイルの名前。

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、ダンプ ファイルが含まれます。 WinDbg または Visual Studio を使用して、ダンプ ファイルを検証できます。

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Window Mobile (Windows Insider Program のみ)
  • Windows デスクトップ
  • HoloLens
  • IoT

サイドローディングされたアプリのクラッシュ ダンプを有効にする

要求

次の要求形式を使用して、サイドローディングされたアプリのクラッシュ ダンプを有効にすることができます。

認証方法 要求 URI
POST /api/debug/dump/usermode/crashcontrol

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
packageFullName (必須) サイドローディングされたアプリのパッケージの完全な名前。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK

利用可能なデバイス ファミリ

  • Window Mobile (Windows Insider Program のみ)
  • Windows デスクトップ
  • HoloLens
  • IoT

バグチェック ファイルの一覧を取得する

要求

次の要求形式を使用して、バグチェックのミニダンプ ファイルの一覧を取得できます。

認証方法 要求 URI
GET /api/debug/dump/kernel/dumplist

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、ダンプ ファイル名とこれらのファイルのサイズの一覧が含まれます。 一覧は、次の形式になります。

{"DumpFiles": [
    {
        "FileName": string,
        "FileSize": int
    },...
]}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • IoT

バグチェックのダンプ ファイルをダウンロードする

要求

次の要求形式を使用して、バグチェックのダンプ ファイルをダウンロードできます。

認証方法 要求 URI
GET /api/debug/dump/kernel/dump

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
<ファイル名> (必須) ダンプ ファイルのファイル名。 API を使ってダンプの一覧を取得することによって確認できます。

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、ダンプ ファイルが含まれます。 WinDbg を使用してこのファイルを調べることができます。

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • IoT

バグチェックのクラッシュ制御の設定を取得する

要求

次の要求形式を使用して、バグチェックのクラッシュ制御の設定を取得できます。

認証方法 要求 URI
GET /api/debug/dump/kernel/crashcontrol

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、クラッシュの制御の設定が含まれます。 CrashControl について詳しくは、「CrashControl」をご覧ください。 応答のテンプレートは次のとおりです。

{
    "autoreboot": bool (0 or 1),
    "dumptype": int (0 to 4),
    "maxdumpcount": int,
    "overwrite": bool (0 or 1)
}

ダンプの種類

0: 無効

1:完全なメモリ ダンプ (使用中のすべてのメモリを収集)

2:カーネル メモリ ダンプ (ユーザー モード メモリは無視)

3:制限付きカーネル ミニダンプ

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • IoT

ライブ カーネル ダンプを取得する

要求

次の要求形式を使用して、ライブ カーネル ダンプを取得できます。

認証方法 要求 URI
GET /api/debug/dump/livekernel

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、カーネル モードの完全なダンプが含まれます。 WinDbg を使用してこのファイルを調べることができます。

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • IoT

ライブ ユーザー プロセスからダンプを取得する

要求

次の要求形式を使用して、ライブ ユーザー プロセスのダンプを取得できます。

認証方法 要求 URI
GET /api/debug/dump/usermode/live

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
pid (必須) 目的のプロセスの一意のプロセス ID。

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、プロセス ダンプが含まれます。 WinDbg または Visual Studio を使用してこのファイルを調べることができます。

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • IoT

バグチェックのクラッシュ制御の設定を行う

要求

次の要求形式を使用して、バグチェック データの収集に関する設定を行うことができます。

認証方法 要求 URI
POST /api/debug/dump/kernel/crashcontrol

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
autoreboot (オプション) true または false。 これは、エラーやロックの発生後に、システムが自動的に再起動するかどうかを示します。
dumptype (オプション) dump タイプ。 サポートされる値については、「CrashDumpType 列挙体」をご覧ください。
maxdumpcount (オプション) 保存するダンプの最大数。
overwrite (オプション) true または false。 これは、maxdumpcountで指定されているダンプ カウンターの制限に達した場合に古いダンプを上書きするかどうかを示します。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • IoT

ETW


websocket 経由でリアルタイムの ETW セッションを作成する

要求

次の要求形式を使用して、リアルタイムの ETW セッションを作成できます。 これは、websocket 経由で管理されます。 ETW イベントは、サーバーで一括処理され、1 秒に 1 回クライアントに送信されます。

認証方法 要求 URI
GET/WebSocket /api/etw/session/realtime

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、有効なプロバイダーの ETW イベントが含まれます。 以下の「ETW WebSocket コマンド」をご覧ください。

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • IoT

ETW WebSocket コマンド

次のコマンドは、クライアントからサーバーに送信されます。

コマンド 説明
provider {guid} enable {level} {guid} で指定されたプロバイダー (括弧は不要) を指定されたレベルで有効にします。 {level} は、1 (最小限の詳細) ~ 5 (詳細) の int です。
provider {guid} disable {guid} で指定されたプロバイダー (括弧は不要) を無効にします。

この応答は、サーバーからクライアントに送信されます。 これは、テキストとして送信され、JSON で解析すると次の形式になります。

{
    "Events":[
        {
            "Timestamp": int,
            "ProviderName": string,
            "ID": int, 
            "TaskName": string,
            "Keyword": int,
            "Level": int,
            payload objects...
        },...
    ],
    "Frequency": int
}

payload objects は、追加のキーと値のペア (文字列: 文字列) で、元の ETW イベントから提供されます。

例:

{
    "ID" : 42, 
    "Keyword" : 9223372036854775824, 
    "Level" : 4, 
    "Message" : "UDPv4: 412 bytes transmitted from 10.81.128.148:510 to 132.215.243.34:510. ",
    "PID" : "1218", 
    "ProviderName" : "Microsoft-Windows-Kernel-Network", 
    "TaskName" : "KERNEL_NETWORK_TASK_UDPIP", 
    "Timestamp" : 131039401761757686, 
    "connid" : "0", 
    "daddr" : "132.245.243.34", 
    "dport" : "500", 
    "saddr" : "10.82.128.118", 
    "seqnum" : "0", 
    "size" : "412", 
    "sport" : "500"
}

登録済みの ETW プロバイダーを列挙する

要求

次の要求形式を使用して、登録済みプロバイダーを列挙できます。

認証方法 要求 URI
GET /api/etw/providers

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、ETW プロバイダーの一覧が含まれます。 一覧には、各プロバイダーのフレンドリ名と GUID が次の形式で含まれます。

{"Providers": [
    {
        "GUID": string, (GUID)
        "Name": string
    },...
]}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • IoT

プラットフォームによって公開されているカスタム ETW プロバイダーを列挙します。

要求

次の要求形式を使用して、登録済みプロバイダーを列挙できます。

認証方法 要求 URI
GET /api/etw/customproviders

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

200 OK。 応答には、ETW プロバイダーの一覧が含まれます。 一覧には、各プロバイダーのフレンドリ名と GUID が含まれます。

{"Providers": [
    {
        "GUID": string, (GUID)
        "Name": string
    },...
]}

状態コード

  • 標準の状態コード。

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • IoT

インストール先


場所の上書きモードを取得する

要求

次の要求型式を使用して、デバイスの場所スタック上書き状態を取得できます。 この呼び出しを成功させるには、開発者モードを有効にしておく必要があります。

認証方法 要求 URI
GET /ext/location/override

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、デバイスの上書き状態が次の形式で含まれます。

{"Override" : bool}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

場所の上書きモードを設定する

要求

次の要求型式を使用して、デバイスの場所スタック上書き状態を設定できます。 有効になっている場合は、場所スタックによって位置挿入が許可されます。 この呼び出しを成功させるには、開発者モードを有効にしておく必要があります。

認証方法 要求 URI
PUT /ext/location/override

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

{"Override" : bool}

応答

応答には、デバイスに設定されている上書き状態が次の形式で含まれます。

{"Override" : bool}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

挿入された位置を取得する

要求

次の要求型式を使用して、デバイスの挿入 (スプーフィング) された場所を取得できます。 挿入された場所を設定する必要があります。設定されなかった場合は、エラーがスローされます。

認証方法 要求 URI
GET /ext/location/position

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、現在の挿入された緯度と経度の値が次の形式で含まれます。

{
    "Latitude" : double,
    "Longitude" : double
}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

挿入された位置を設定する

要求

次の要求型式を使用して、デバイスの挿入 (スプーフィング) された場所を設定できます。 あらかじめデバイス上で場所の上書きモードが有効になっており、設定される場所も有効である必要があります。それ以外の場合はエラーがスローされます。

認証方法 要求 URI
PUT /ext/location/override

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

{
    "Latitude" : double,
    "Longitude" : double
}

応答

応答には、設定された場所の情報が次の形式で含まれます。

{
    "Latitude" : double,
    "Longitude" : double
}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

OS 情報


コンピューター名を取得する

要求

次の要求形式を使用して、コンピューターの名前を取得できます。

認証方法 要求 URI
GET /api/os/machinename

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、コンピューター名が次の形式で含まれます。

{"ComputerName": string}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

オペレーティング システムの情報を取得する

要求

次の要求形式を使用して、コンピューターの OS 情報を取得できます。

認証方法 要求 URI
GET /api/os/info

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、OS 情報が次の形式で含まれます。

{
    "ComputerName": string,
    "OsEdition": string,
    "OsEditionId": int,
    "OsVersion": string,
    "Platform": string
}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

デバイス ファミリを取得する

要求

次の要求形式を使用して、デバイス ファミリ (Xbox、携帯電話、デスクトップなど) を取得できます。

認証方法 要求 URI
GET /api/os/devicefamily

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、デバイス ファミリ (SKU - デスクトップ、Xbox など) が含まれます。

{
   "DeviceType" : string
}

DeviceType は、"Windows.Xbox"、"Windows.Desktop" などのようになります。

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

コンピューター名を設定する

要求

次の要求形式を使用して、コンピューターの名前を設定できます。

認証方法 要求 URI
POST /api/os/machinename

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
name (必須) コンピューターの新しい名前。 base64 でエンコードされている必要があります。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

ユーザー情報


アクティブ ユーザーを取得する

要求

次の要求形式を使用して、デバイスのアクティブ ユーザーの名前を取得できます。

認証方法 要求 URI
GET /api/users/activeuser

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、ユーザー情報が次の形式で含まれます。

成功した場合:

{
    "UserDisplayName" : string, 
    "UserSID" : string
}

失敗した場合:

{
    "Code" : int, 
    "CodeText" : string, 
    "Reason" : string, 
    "Success" : bool
}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • HoloLens
  • IoT

パフォーマンス データ


実行中のプロセスの一覧を取得する

要求

次の要求形式を使用して、現在実行中のプロセスの一覧を取得できます。 これは、WebSocket 接続にアップグレードすることもでき、1 秒に 1 度クライアントにプッシュされる同じ JSON データを取得できます。

認証方法 要求 URI
GET /api/resourcemanager/processes
GET/WebSocket /api/resourcemanager/processes

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、プロセスの一覧と各プロセスの詳細情報が含まれます。 情報は JSON 形式で、テンプレートは次のとおりです。

{"Processes": [
    {
        "CPUUsage": float,
        "ImageName": string,
        "PageFileUsage": long,
        "PrivateWorkingSet": long,
        "ProcessId": int,
        "SessionId": int,
        "UserName": string,
        "VirtualSize": long,
        "WorkingSetSize": long
    },...
]}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • IoT

システム パフォーマンスの統計情報を取得する

要求

次の要求形式を使用して、システム パフォーマンスの統計情報を取得できます。 これには、読み取りと書き込みのサイクルや、使用されているメモリの量などの情報が含まれます。

認証方法 要求 URI
GET /api/resourcemanager/systemperf
GET/WebSocket /api/resourcemanager/systemperf

これは、WebSocket 接続にアップグレードできます。 1 秒に 1 度以下と同じ JSON データが提供されます。

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、CPU と GPU の使用量、メモリ アクセス、ネットワーク アクセスなど、パフォーマンスの統計情報が含まれます。 この情報は JSON 形式で、テンプレートは次のとおりです。

{
    "AvailablePages": int,
    "CommitLimit": int,
    "CommittedPages": int,
    "CpuLoad": int,
    "IOOtherSpeed": int,
    "IOReadSpeed": int,
    "IOWriteSpeed": int,
    "NonPagedPoolPages": int,
    "PageSize": int,
    "PagedPoolPages": int,
    "TotalInstalledInKb": int,
    "TotalPages": int,
    "GPUData": 
    {
        "AvailableAdapters": [{ (One per detected adapter)
            "DedicatedMemory": int,
            "DedicatedMemoryUsed": int,
            "Description": string,
            "SystemMemory": int,
            "SystemMemoryUsed": int,
            "EnginesUtilization": [ float,... (One per detected engine)]
        },...
    ]},
    "NetworkingData": {
        "NetworkInBytes": int,
        "NetworkOutBytes": int
    }
}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

Power


現在のバッテリ状態を取得する

要求

次の要求形式を使用して、バッテリの現在の状態を取得できます。

認証方法 要求 URI
GET /api/power/battery

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

現在のバッテリ状態に関する情報が次の形式で返されます。

{
    "AcOnline": int (0 | 1),
    "BatteryPresent": int (0 | 1),
    "Charging": int (0 | 1),
    "DefaultAlert1": int,
    "DefaultAlert2": int,
    "EstimatedTime": int,
    "MaximumCapacity": int,
    "RemainingCapacity": int
}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • IoT

アクティブな電源設定を取得する

要求

次の要求形式を使用して、アクティブな電源設定を取得できます。

認証方法 要求 URI
GET /api/power/activecfg

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

アクティブな電源設定の形式は、次のとおりです。

{"ActivePowerScheme": string (guid of scheme)}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • IoT

電源設定のサブ値を取得する

要求

次の要求形式を使用して、電源設定のサブ値を取得できます。

認証方法 要求 URI
GET /api/power/cfg/<電源設定のパス>

オプション:

  • SCHEME_CURRENT

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

利用可能な電源状態の完全な一覧は、アプリケーションごとが基本で、バッテリ低下、重要なバッテリといったさまざまな電源状態がフラグ設定されています。

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • IoT

システムの電源状態を取得する

要求

次の要求形式を使用して、システムの電源状態を確認できます。 これによって、低電力状態になっているかどうかを確認できます。

認証方法 要求 URI
GET /api/power/state

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

電源状態の情報のテンプレートは次のとおりです。

{"LowPowerState" : false, "LowPowerStateAvailable" : true }

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • HoloLens
  • IoT

アクティブな電源設定を行う

要求

次の要求形式を使用して、アクティブな電源設定を設定できます。

認証方法 要求 URI
POST /api/power/activecfg

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
scheme (必須) システムのアクティブな電源設定として設定するスキームの GUID。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • IoT

電源設定のサブ値を設定する

要求

次の要求形式を使用して、電源設定のサブ値を設定できます。

認証方法 要求 URI
POST /api/power/cfg/<電源設定のパス>

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
valueAC (必須) AC 電源に使用する値。
valueDC (必須) バッテリ電源に使用する値。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • IoT

SleepStudy レポートを取得する

要求

認証方法 要求 URI
GET /api/power/sleepstudy/report

次の要求形式を使用して、SleepStudy レポートを取得できます。

URI パラメーター | URI パラメーター | 説明 | | :------ | :------ | | FileName | (必須) ダウンロードするファイルのファイル名。 この値は、hex64 エンコードされている必要があります。 |

要求ヘッダー

  • None

要求本文

  • None

応答

応答は、スリープ検査の結果が含まれているファイルです。

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • IoT

利用可能な SleepStudy レポートを列挙する

要求

次の要求形式を使用して、利用可能な SleepStudy レポートを列挙できます。

認証方法 要求 URI
GET /api/power/sleepstudy/reports

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

利用可能なレポートの一覧のテンプレートは次のとおりです。

{"Reports": [
    {
        "FileName": string
    },...
]}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • IoT

スリープ スタディ変換を取得する

要求

次の要求形式を使用して、スリープ スタディ変換を取得できます。 この変換は、SleepStudy レポートを、ユーザーが読み取ることができる XML 形式に変換する XSLT です。

認証方法 要求 URI
GET /api/power/sleepstudy/transform

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、スリープ スタディ変換が含まれます。

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • IoT

リモート コントロール


ターゲット コンピューターを再起動する

要求

次の要求形式を使用して、ターゲット コンピューターを再起動できます。

認証方法 要求 URI
POST /api/control/restart

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

ターゲット コンピューターをシャットダウンする

要求

次の要求形式を使用して、ターゲット コンピューターをシャット ダウンできます。

認証方法 要求 URI
POST /api/control/shutdown

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

タスク マネージャー


最新のアプリを起動する

要求

次の要求形式を使用して、最新のアプリを起動できます。

認証方法 要求 URI
POST /api/taskmanager/app

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
appid (必須) 起動するアプリの PRAID。 この値は、hex64 エンコードされている必要があります。
パッケージ (必須) 起動するアプリ パッケージの完全な名前。 この値は、hex64 エンコードされている必要があります。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

最新のアプリを停止する

要求

次の要求形式を使用して、最新のアプリを停止できます。

認証方法 要求 URI
DELETE /api/taskmanager/app

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
パッケージ (必須) 停止するアプリ パッケージの完全な名前。 この値は、hex64 エンコードされている必要があります。
forcestop (オプション) 値が yes の場合は、システムがすべてのプロセスを強制的に停止することを示します。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

PID でプロセスを強制終了する

要求

次の要求形式を使用して、プロセスを強制終了できます。

認証方法 要求 URI
DELETE /api/taskmanager/process

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
pid (必須) 終了するプロセスの一意のプロセス ID。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • HoloLens
  • IoT

ネットワーク


現在の IP 構成を取得する

要求

次の要求形式を使用して、現在の IP 構成を取得できます。

認証方法 要求 URI
GET /api/networking/ipconfig

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

応答には、次のテンプレートの IP 構成が含まれます。

{"Adapters": [
    {
        "Description": string,
        "HardwareAddress": string,
        "Index": int,
        "Name": string,
        "Type": string,
        "DHCP": {
            "LeaseExpires": int, (timestamp)
            "LeaseObtained": int, (timestamp)
            "Address": {
                "IpAddress": string,
                "Mask": string
            }
        },
        "WINS": {(WINS is optional)
            "Primary": {
                "IpAddress": string,
                "Mask": string
            },
            "Secondary": {
                "IpAddress": string,
                "Mask": string
            }
        },
        "Gateways": [{ (always 1+)
            "IpAddress": "10.82.128.1",
            "Mask": "255.255.255.255"
            },...
        ],
        "IpAddresses": [{ (always 1+)
            "IpAddress": "10.82.128.148",
            "Mask": "255.255.255.0"
            },...
        ]
    },...
]}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

静的 IP アドレスを設定する (IPV4 構成)

要求

静的 IP と DNS を使用して IPV4 構成を設定します。 静的 IP を指定しない場合、DHCP が有効になります。 静的 IP を指定する場合、DNS も指定する必要があります。

認証方法 要求 URI
PUT /api/networking/ipv4config

URI パラメーター

URI パラメーター 説明
AdapterName (必須) ネットワーク インターフェイスの GUID。
IPAddress 設定する静的 IP アドレス。
SubnetMask (IPAddress が null でない場合は必須) 静的サブネット マスク。
DefaultGateway (IPAddress が null でない場合は必須) 既定の静的ゲートウェイ。
PrimaryDNS (IPAddress が null でない場合は必須) 設定する静的プライマリ DNS。
SecondayDNS (PrimaryDNS が null でない場合は必須) 設定する静的セカンダリ DNS。

わかりやすくするために、インターフェイスを DHCP に設定するには、ネットワーク上の AdapterName のみをシリアル化します。

{
    "AdapterName":"{82F86C1B-2BAE-41E3-B08D-786CA44FEED7}"
}

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

ワイヤレス ネットワーク インターフェイスを列挙する

要求

次の要求形式を使用して、利用可能なワイヤレス ネットワーク インターフェイスを列挙できます。

認証方法 要求 URI
GET /api/wifi/interfaces

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

次の形式の利用可能なワイヤレス インターフェイスと詳細の一覧。

{"Interfaces": [{
    "Description": string,
    "GUID": string (guid with curly brackets),
    "Index": int,
    "ProfilesList": [
        {
            "GroupPolicyProfile": bool,
            "Name": string, (Network currently connected to)
            "PerUserProfile": bool
        },...
    ]
    }
]}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

ワイヤレス ネットワークを列挙する

要求

次の要求形式を使用して、指定されたインターフェイスのワイヤレス ネットワークの一覧を列挙できます。

認証方法 要求 URI
GET /api/wifi/networks

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
インターフェイス (必須) ワイヤレス ネットワークの検索に使用するネットワーク インターフェイスの GUID (括弧は不要)。

要求ヘッダー

  • None

要求本文

  • None

応答

指定されたインターフェイスで見つかったワイヤレス ネットワークの一覧。 これには、ネットワークの詳細が次の形式で含まれます。

{"AvailableNetworks": [
    {
        "AlreadyConnected": bool,
        "AuthenticationAlgorithm": string, (WPA2, etc)
        "Channel": int,
        "CipherAlgorithm": string, (for example, AES)
        "Connectable": int, (0 | 1)
        "InfrastructureType": string,
        "ProfileAvailable": bool,
        "ProfileName": string,
        "SSID": string,
        "SecurityEnabled": int, (0 | 1)
        "SignalQuality": int,
        "BSSID": [int,...],
        "PhysicalTypes": [string,...]
    },...
]}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

Wi-Fi ネットワークを接続および切断する

要求

次の要求形式を使用して、Wi-Fi ネットワークを接続および切断できます。

認証方法 要求 URI
POST /api/wifi/network

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
インターフェイス (必須) ネットワークへの接続に使用するネットワーク インターフェイスの GUID。
op (必須) 実行するアクションを示します。 設定可能な値は、connect または disconnect です。
ssid ( op == connect の場合は必須) 接続先 SSID。
key ( op == connect で、ネットワークで認証が必要な場合は必須) 共有キー。
createprofile (必要) デバイスでネットワークのプロファイルを作成します。 これにより、今後、デバイスはネットワークに自動接続されます。 yes または no を指定できます。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

Wi-Fi のプロファイルを削除する

要求

次の要求形式を使用して、特定のインターフェイス上のネットワークに関連付けられたプロファイルを削除できます。

認証方法 要求 URI
DELETE /api/wifi/profile

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
インターフェイス (必須) 削除するプロファイルに関連付けられたネットワーク インターフェイスの GUID。
プロファイル (必須) 削除するプロファイルの名前。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

Windows エラー報告 (WER)


Windows エラー報告 (WER) ファイルをダウンロードする

要求

次の要求形式を使用して、WER 関連のファイルをダウンロードできます。

認証方法 要求 URI
GET /api/wer/report/file

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
ユーザー (必須) レポートに関連付けられたユーザー名。
(必須) レポートの種類。 これは queried または archived のいずれかになります。
name (必須) レポートの名前。 base64 でエンコードされている必要があります。
ファイル (必須) レポートからダウンロードするファイルの名前。 base64 でエンコードされている必要があります。

要求ヘッダー

  • None

要求本文

  • None

応答

  • 応答には、要求したファイルが含まれています。

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • HoloLens
  • IoT

Windows エラー報告 (WER) レポート内のファイルを列挙する

要求

次の要求形式を使用して、WER レポート内のファイルを列挙できます。

認証方法 要求 URI
GET /api/wer/report/files

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
ユーザー (必須) レポートに関連付けられたユーザー。
(必須) レポートの種類。 これは queried または archived のいずれかになります。
name (必須) レポートの名前。 base64 でエンコードされている必要があります。

要求ヘッダー

  • None

要求本文

{"Files": [
    {
        "Name": string, (Filename, not base64 encoded)
        "Size": int (bytes)
    },...
]}

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • HoloLens
  • IoT

Windows エラー報告 (WER) レポートを一覧表示する

要求

次の要求形式を使用して、WER レポートを取得できます。

認証方法 要求 URI
GET /api/wer/reports

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

WER 報告の形式は次のとおりです。

{"WerReports": [
    {
        "User": string,
        "Reports": [
            {
                "CreationTime": int,
                "Name": string, (not base64 encoded)
                "Type": string ("Queue" or "Archive")
            },
    ]},...
]}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows デスクトップ
  • HoloLens
  • IoT

Windows Performance Recorder (WPR)


カスタム プロファイルを使用してトレースを開始する

要求

次の要求形式を使用して、WPR プロファイルをアップロードし、そのプロファイルを使用してトレースを開始できます。 一度に実行できるトレースは 1 つのみです。 プロファイルはデバイス上に残りません。

認証方法 要求 URI
POST /api/wpr/customtrace

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • カスタム WPR プロファイルが含まれる、原則に従ったマルチパートの http 本文。

応答

WPR セッション状態の形式は次のとおりです。

{
    "SessionType": string, (Running or Idle) 
    "State": string (normal or boot)
}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • IoT

起動パフォーマンス トレース セッションを開始する

要求

次の要求形式を使用して、WPR の起動トレース セッションを開始できます。 これは、パフォーマンス トレース セッションとも呼びます。

認証方法 要求 URI
POST /api/wpr/boottrace

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
プロファイル (必須) このパラメーターは起動時に必要です。 パフォーマンス トレース セッションを開始する必要があるプロファイルの名前。 指定可能なプロファイルは、perfprofiles/profiles.json に格納されています。

要求ヘッダー

  • None

要求本文

  • None

応答

この API は、開始時に次の形式で WPR セッション状態を返します。

{
    "SessionType": string, (Running or Idle) 
    "State": string (boot)
}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • IoT

起動パフォーマンス トレース セッションを停止する

要求

次の要求形式を使用して、WPR の起動トレース セッションを停止できます。 これは、パフォーマンス トレース セッションとも呼びます。

認証方法 要求 URI
GET /api/wpr/boottrace

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

  • なし。 注: これは時間のかかる操作です。 ETL のディスクへの書き込みが終了すると、制御が戻ります。

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • IoT

パフォーマンス トレース セッションを開始する

要求

次の要求形式を使用して、WPR のトレース セッションを開始できます。 これは、パフォーマンス トレース セッションとも呼びます。 一度に実行できるトレースは 1 つのみです。

認証方法 要求 URI
POST /api/wpr/trace

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
プロファイル (必須) パフォーマンス トレース セッションを開始する必要があるプロファイルの名前。 指定可能なプロファイルは、perfprofiles/profiles.json に格納されています。

要求ヘッダー

  • None

要求本文

  • None

応答

この API は、開始時に次の形式で WPR セッション状態を返します。

{
    "SessionType": string, (Running or Idle) 
    "State": string (normal)
}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • IoT

パフォーマンスのトレース セッションを停止する

要求

次の要求形式を使用して、WPR のトレース セッションを停止できます。 これは、パフォーマンス トレース セッションとも呼びます。

認証方法 要求 URI
GET /api/wpr/trace

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

  • なし。 注: これは時間のかかる操作です。 ETL のディスクへの書き込みが終了すると、制御が戻ります。

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • IoT

トレース セッションの状態を取得する

要求

次の要求形式を使用して、現在の WPR セッションの状態を取得できます。

認証方法 要求 URI
GET /api/wpr/status

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

WPR トレース セッションの状態の形式は次のとおりです。

{
    "SessionType": string, (Running or Idle) 
    "State": string (normal or boot)
}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • IoT

完了したトレース セッション (ETL) を一覧表示する

要求

次の要求形式を使用して、デバイス上の ETL トレースの一覧を取得できます。

認証方法 要求 URI
GET /api/wpr/tracefiles

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

完了したトレース セッションの一覧は次の形式で提供されます。

{"Items": [{
    "CurrentDir": string (filepath),
    "DateCreated": int (File CreationTime),
    "FileSize": int (bytes),
    "Id": string (filename),
    "Name": string (filename),
    "SubPath": string (filepath),
    "Type": int
}]}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • IoT

トレース セッション (ETL) をダウンロードする

要求

次の要求形式を使用して、トレースファイル (ブート トレースまたはユーザー モード トレース) をダウンロードできます。

認証方法 要求 URI
GET /api/wpr/tracefile

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
<ファイル名> (必須) ダウンロードする ETL トレースの名前。 これらは /api/wpr/tracefiles にあります。

要求ヘッダー

  • None

要求本文

  • None

応答

  • トレース ETL ファイルを返します。

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • IoT

トレース セッション (ETL) を削除する

要求

次の要求形式を使用して、トレースファイル (ブート トレースまたはユーザー モード トレース) を削除できます。

認証方法 要求 URI
DELETE /api/wpr/tracefile

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

URI パラメーター 説明
<ファイル名> (必須) 削除する ETL トレースの名前。 これらは /api/wpr/tracefiles にあります。

要求ヘッダー

  • None

要求本文

  • None

応答

  • トレース ETL ファイルを返します。

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • IoT

DNS SD タグ


タグを表示する

要求

デバイスに現在適用されているタグを表示します。 これらのタグは、T キー内の DNS-SD TXT レコードを使用してアドバタイズされます。

認証方法 要求 URI
GET /api/dns-sd/tags

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答 現在適用されているタグの形式は次のとおりです。

 {
    "tags": [
        "tag1", 
        "tag2", 
        ...
     ]
}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
5XX サーバー エラー

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

タグを削除する

要求

DNS-SD によって現在アドバタイズされているすべてのタグを削除します。

認証方法 要求 URI
DELETE /api/dns-sd/tags

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答

  • None

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
5XX サーバー エラー

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

タグを削除する

要求

DNS-SD によって現在アドバタイズされている 1 つのタグを削除します。

認証方法 要求 URI
DELETE /api/dns-sd/tag

URI パラメーター

URI パラメーター 説明
tagValue (必須) 削除するタグ。

要求ヘッダー

  • None

要求本文

  • None

応答

  • None

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

タグを追加する

要求

DNS-SD アドバタイズにタグを追加します。

認証方法 要求 URI
POST /api/dns-sd/tag

URI パラメーター

URI パラメーター 説明
tagValue (必要) 追加するタグ。

要求ヘッダー

  • None

要求本文

  • None

応答

  • None

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
401 タグ領域のオーバーフロー。 提供されたタグが、結果として生成される DNS-SD サービス レコードに対して長すぎます。

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • Xbox
  • HoloLens
  • IoT

アプリのエクスプローラー


既知のフォルダーを取得する

要求

アクセス可能なトップ レベル フォルダーの一覧を取得します。

認証方法 要求 URI
GET /api/filesystem/apps/knownfolders

URI パラメーター

  • None

要求ヘッダー

  • None

要求本文

  • None

応答 利用可能なフォルダーの形式は次のとおりです。

 {"KnownFolders": [
    "folder0",
    "folder1",...
]}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 展開要求は受け入れられ、処理されています。
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • Xbox
  • IoT

ファイルを取得する

要求

フォルダー内のファイルの一覧を取得します。

認証方法 要求 URI
GET /api/filesystem/apps/files

URI パラメーター

URI パラメーター 説明
knownfolderid (必須) 必要なファイルの一覧の対象となるトップレベル ディレクトリ。 サイドロードされたアプリにアクセスするには、LocalAppData を使用します。
packagefullname ( knownfolderid == LocalAppData の場合は必須) 対象となるアプリのパッケージのフルネーム。
パス (オプション) 上で指定したフォルダーまたはパッケージ内のサブディレクトリ。

要求ヘッダー

  • None

要求本文

  • None

応答 利用可能なフォルダーの形式は次のとおりです。

{"Items": [
    {
        "CurrentDir": string (folder under the requested known folder),
        "DateCreated": int,
        "FileSize": int (bytes),
        "Id": string,
        "Name": string,
        "SubPath": string (present if this item is a folder, this is the name of the folder),
        "Type": int
    },...
]}

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • Xbox
  • IoT

ファイルをダウンロードする

要求

既知のフォルダーまたは appLocalData からファイルを取得します。

認証方法 要求 URI
GET /api/filesystem/apps/file

URI パラメーター

URI パラメーター 説明
knownfolderid (必須) ファイルをダウンロードするトップレベル ディレクトリ。 サイドロードされたアプリにアクセスするには、LocalAppData を使用します。
<ファイル名> (必須) ダウンロードするファイルの名前。
packagefullname ( knownfolderid == LocalAppData の場合は必須) 対象となるパッケージのフルネーム。
パス (オプション) 上で指定したフォルダーまたはパッケージ内のサブディレクトリ。

要求ヘッダー

  • None

要求本文

  • 要求するファイル (存在する場合)

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 要求したファイル
404 ファイルが見つからない
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • Xbox
  • IoT

ファイルの名前の変更

要求

フォルダー内のファイルの名前を変更します。

認証方法 要求 URI
POST /api/filesystem/apps/rename

URI パラメーター

URI パラメーター 説明
knownfolderid (必須) ファイルが存在するトップレベル ディレクトリ。 サイドロードされたアプリにアクセスするには、LocalAppData を使用します。
<ファイル名> (必須) 名前を変更するファイルの元の名前。
newfilename (必須) ファイルの新しい名前。
packagefullname ( knownfolderid == LocalAppData の場合は必須) 対象となるアプリのパッケージのフルネーム。
パス (オプション) 上で指定したフォルダーまたはパッケージ内のサブディレクトリ。

要求ヘッダー

  • None

要求本文

  • None

応答

  • None

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK です。 ファイルの名前が変更されました
404 ファイルが見つからない
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • Xbox
  • IoT

ファイルを削除する

要求

フォルダー内のファイルを削除します。

認証方法 要求 URI
DELETE /api/filesystem/apps/file

URI パラメーター

URI パラメーター 説明
knownfolderid (必須) ファイルを削除するトップレベル ディレクトリ。 サイドロードされたアプリにアクセスするには、LocalAppData を使用します。
<ファイル名> (必須) 削除するファイルの名前。
packagefullname ( knownfolderid == LocalAppData の場合は必須) 対象となるアプリのパッケージのフルネーム。
パス (オプション) 上で指定したフォルダーまたはパッケージ内のサブディレクトリ。

要求ヘッダー

  • None

要求本文

  • None

応答

  • None

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK です。 ファイルが削除されます。
404 ファイルが見つからない
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • Xbox
  • IoT

ファイルをアップロードする

要求

フォルダーにファイルをアップロードします。 この場合、同じ名前を持つ既存のファイルは上書きされますが、新しいフォルダーは作成されません。

認証方法 要求 URI
POST /api/filesystem/apps/file

URI パラメーター

URI パラメーター 説明
knownfolderid (必須) ファイルをアップロードするトップレベル ディレクトリ。 サイドロードされたアプリにアクセスするには、LocalAppData を使用します。
packagefullname ( knownfolderid == LocalAppData の場合は必須) 対象となるアプリのパッケージのフルネーム。
extract (必須) true または false これは、アップロード後にファイルを抽出するかどうかを示します。
パス (オプション) 上で指定したフォルダーまたはパッケージ内のサブディレクトリ。

要求ヘッダー

  • None

要求本文

  • None

応答

状態コード

この API では次の状態コードが返される可能性があります。

HTTP 状態コード 説明
200 OK です。 ファイルがアップロードされます。
4XX エラー コード
5XX エラー コード

利用可能なデバイス ファミリ

  • Windows Mobile
  • Windows デスクトップ
  • HoloLens
  • Xbox
  • IoT