すべてのプロダクト
Search
ドキュメントセンター

Elastic Desktop Service:DescribeDesktopSessions

最終更新日:Mar 17, 2026

WUYING Workspace インスタンスの詳細なセッション情報を照会します。

操作説明

照会可能なデータは、過去 30 日分のみです。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

必須

リージョン ID。WUYING Workspace をサポートするリージョンの一覧を取得するには、DescribeRegions を呼び出します。

cn-hangzhou

OfficeSiteId

string

任意

オフィスサイト ID。

cn-hangzhou+dir-363353****

EndUserId

string

任意

エンドユーザー ID。

alice

SessionStatus

string

任意

セッション接続ステータス。

列挙値:

  • Connected :

    接続中

  • Disconnected :

    切断済み

Connected

StartTime

string

任意

照会期間の開始時刻。

2023-01-28T02:31:43Z

EndTime

string

任意

照会期間の終了時刻。

2023-02-13T02:51:43Z

PageNumber

integer

任意

ページネーション照会におけるページ番号。

1

PageSize

integer

任意

ページネーション照会における 1 ページあたりの最大エントリ数。

10

DesktopId

array

任意

クラウドデスクトップの ID。1~100 個の ID を指定できます。

string

任意

クラウドデスクトップ ID。

ecd-gx2x1dhsmucyy****"

DesktopName

string

任意

クラウドデスクトップ名。

DemoComputer

SubPayType

string

任意

WUYING Workspace インスタンスのサブスクリプションタイプ。

列挙値:

  • duration :

    時間ベースパッケージ [ホワイトリスト]

  • postPaid :

    従量課金

  • monthPackage :

    月額パッケージ(120 時間または 250 時間)

  • prePaid :

    月額パッケージ(無制限使用)

monthPackage

CheckOsSession

boolean

任意

WUYING Workspace インスタンス内部のセッションステータスを確認するかどうか。

true

EndUserIdFilter

string

任意

エンドユーザー ID。このパラメーターは EndUserId と同一です。いずれか 1 つを指定してください。

alice

ResourceGroupId

string

任意

FillHardwareInfo

boolean

任意

応答に端末デバイス情報を含めるかどうか。

Language

string

任意

応答の言語。

zh-CN

レスポンスフィールド

フィールド

説明

object

TotalCount

integer

結果の合計件数。

1

RequestId

string

リクエスト ID。

3EC4A6DB-EC8D-55B0-9038-543DE671****

Sessions

array<object>

セッション詳細情報。

array<object>

セッション詳細情報。

SessionStatus

string

セッション接続ステータス。

列挙値:

  • Connected :

    接続中

  • Disconnected :

    切断済み

Connected

EndUserId

string

エンドユーザー ID。

alice

OfficeSiteId

string

オフィスサイト ID。

cn-hangzhou+dir-8904****

ClientIp

string

クライアント IP アドレス。

172.21.XX.XX

ClientOS

string

クライアントのオペレーティングシステム。

windows_\"Windows10Enterprise\"10.0(Build22000)

DesktopId

string

クラウドデスクトップ ID。

ecd-g6t1ukbaea****

DesktopName

string

クラウドデスクトップ名。

DemoComputer

OfficeSiteName

string

オフィスサイト名。

TestOfficeSite

ClientVersion

string

クライアントバージョン。

2.0.0-R-20221030.08****

ProtocolType

string

プロトコルタイプ。

列挙値:

  • HDX :

    HDX プロトコル

  • ASP :

    Alibaba Cloud ASP プロトコル

ASP

LatestConnectionTime

integer

WUYING Workspace インスタンスへの最新接続継続時間。単位:秒。

120

TotalConnectionTime

integer

総接続継続時間。単位:秒。

240

SessionStartTime

string

セッション開始時刻。

2023-01-28T02:31:43Z

SessionEndTime

string

セッション終了時刻。

2023-01-28T02:31:43Z

SessionIdleTime

integer

セッションアイドル継続時間。単位:秒。

120

OsType

string

オペレーティングシステムの種類。

列挙値:

  • Linux :

    Linux

  • Windows :

    Windows

Windows

EndUserApplyCoordinateTime

integer

エンドユーザーに対するリモート支援継続時間。単位:秒。

120

SubPayType

string

WUYING Workspace インスタンスのサブスクリプションタイプ。

列挙値:

  • duration :

    時間ベースパッケージ [ホワイトリスト]

  • postPaid :

    従量課金

  • monthPackage :

    月額パッケージ(120 時間または 250 時間)

  • prePaid :

    月額パッケージ(無制限使用)

monthPackage

OsSessionStatus

string

WUYING Workspace インスタンス内部のセッションステータスを確認するかどうか。

true

TerminalInfo

object

端末デバイス情報。

ProductName

string

端末デバイスの種類。

Mac

SerialNumber

string

端末デバイスのシリアル番号。

96c530bc-6095-4014-8bbc-d461b8ac****

Model

string

端末デバイスのモデル。

Mac

Uuid

string

ログインに使用したデバイスの UUID。

EBFDC7773BEBAD418A9F89429652****

DirectoryType

string

オフィスネットワークタイプ。

SIMPLE

AccountType

string

アカウントタイプ。

SIMPLE

ResourceGroups

array<object>

リソースグループ情報。

object

リソースグループ。

Id

string

リソースグループ ID。

rg-8whrmo2gtsb8bxxxx

Name

string

リソースグループ名。

RgTest

SessionIdleTime パラメーターは、WUYING Workspace が Windows を実行中の場合にのみ返されます。

成功レスポンス

JSONJSON

{
  "TotalCount": 1,
  "RequestId": "3EC4A6DB-EC8D-55B0-9038-543DE671****",
  "Sessions": [
    {
      "SessionStatus": "Connected",
      "EndUserId": "alice",
      "OfficeSiteId": "cn-hangzhou+dir-8904****",
      "ClientIp": "172.21.XX.XX",
      "ClientOS": "windows_\\\"Windows10Enterprise\\\"10.0(Build22000)",
      "DesktopId": "ecd-g6t1ukbaea****",
      "DesktopName": "DemoComputer",
      "OfficeSiteName": "TestOfficeSite",
      "ClientVersion": "2.0.0-R-20221030.08****",
      "ProtocolType": "ASP",
      "LatestConnectionTime": 120,
      "TotalConnectionTime": 240,
      "SessionStartTime": "2023-01-28T02:31:43Z\n",
      "SessionEndTime": "2023-01-28T02:31:43Z",
      "SessionIdleTime": 120,
      "OsType": "Windows",
      "EndUserApplyCoordinateTime": 120,
      "SubPayType": "monthPackage",
      "OsSessionStatus": "true",
      "TerminalInfo": {
        "ProductName": "Mac",
        "SerialNumber": "96c530bc-6095-4014-8bbc-d461b8ac****",
        "Model": "Mac",
        "Uuid": "EBFDC7773BEBAD418A9F89429652****"
      },
      "DirectoryType": "SIMPLE",
      "AccountType": "SIMPLE",
      "ResourceGroups": [
        {
          "Id": "rg-8whrmo2gtsb8bxxxx",
          "Name": "RgTest"
        }
      ]
    }
  ]
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。