すべてのプロダクト
Search

このプロダクト

    App Streaming:ListDesktopAgentRuntime

    ドキュメントセンター

    App Streaming:ListDesktopAgentRuntime

    最終更新日:Jun 24, 2026

    デスクトップエージェントランタイムのリストを照会します。

    今すぐお試しください

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

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    appstreaming:ListDesktopAgentRuntime

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    AgentProvider

    string

    必須

    エージェントプロバイダーの名前。

    OpenClaw
    ModelTemplateId

    string

    任意

    モデルグループ ID。

    mt-xxxx
    DesktopIds

    array

    任意

    エージェントランタイム ID のリスト。

    jvs-xxxxx

    string

    必須

    エージェントランタイム ID。ID のマッピングは以下のとおりです:

    JVS Computer: JVS Computer ID、フォーマットは jvs-xxxx。

    OpenClaw: クラウドコンピューター ID、フォーマットは ecd-xxxx。

    Hermes Agent: Hermes Agent ID、フォーマットは jvs-xxxx。

    ecd-xxxx
    ResourceIds

    array

    任意

    リソース ID のリスト（基盤となる実リソース ID）。

    ecd-xxxxx

    string

    任意

    リソース ID。

    ecd-xxxx
    DesktopStatuses

    array

    任意

    クラウドコンピューターステータスのリスト。

    Running

    string

    必須

    クラウドコンピューターのステータス。

    列挙値:

    • Stopped :

      Stopped

    • Starting :

      Starting

    • Rebuilding :

      Rebuilding

    • Running :

      Running

    • Stopping :

      Stopping

    • Expired :

      Expired

    • Deleted :

      Deleted

    • Pending :

      Pending

    Running
    AuthUsers

    array

    任意

    許可されるユーザーのリスト。

    user001

    string

    必須

    許可されるユーザー。

    user-001
    AgentInstanceVersions

    array

    任意

    エージェントインスタンスバージョンのリスト。

    OpenClaw 2026.4.15

    string

    必須

    エージェントインスタンスのバージョン。

    2026.3.13
    AgentInstanceStatuses

    array

    任意

    エージェントインスタンスステータスのリスト。

    Running

    string

    必須

    エージェントのインスタンスステータス。

    列挙値:

    • Undeployed :

      Undeployed

    • Deploying :

      Deploying

    • Stopped :

      Stopped

    • Starting :

      Starting

    • Running :

      Running

    • Stopping :

      Stopping

    • Deleted :

      Deleted

    • Deployed :

      Deployed

    • Unavailable :

      Unavailable

    Running
    DeploymentSource

    string

    任意

    Deployment ソース。

    列挙値:

    • User :

      ユーザー Deployment。

    • Admin :

      管理者 Deployment。

    Admin
    ModelConfigure

    boolean

    任意

    モデルが構成済みかどうかを指定します。

    列挙値:

    • true :

      はい。

    • false :

      No

    true
    ChannelConfigure

    boolean

    任意

    サードパーティチャンネルが構成済みかどうかを指定します。

    列挙値:

    • true :

      はい。

    • false :

      No

    true
    ResourceGroupId

    string

    任意

    リソースグループ ID。

    rg-xxxx
    DesktopNames

    array

    任意

    エージェントランタイム名のリスト。

    Desktop001

    string

    必須

    エージェントランタイム名。

    Agent-001
    BizType

    integer

    任意

    ビジネスタイプ。

    列挙値:

    • 1 :

      Enterprise Edition。

    1
    AgentPlatform

    string

    任意

    エージェントプラットフォーム。

    列挙値:

    • ENTERPRISE :

      Enterprise Edition。

    • ENTERPRISE_JVS :

      Enterprise Edition JVS Computer、Enterprise Edition Hermes Agent。

    ENTERPRISE
    HasAuthUser

    boolean

    任意

    許可されるユーザーが存在するかどうかを指定します。

    列挙値:

    • true :

      はい。

    • false :

      false。

    true
    IncludeRiskInfo

    boolean

    任意

    リスク情報をクエリして返すかどうかを指定します。デフォルト値: false。true にセットすると、応答に RiskInfo フィールドが含まれ、HasRisk フィルター条件が有効になります。

    列挙値:

    • true :

      はい。

    • false :

      No

    true
    HasRisk

    boolean

    任意

    リスクが存在するかどうかを指定します。リスクの有無でクラウドコンピューターをフィルターします。このパラメーターは IncludeRiskInfo が true にセットされている場合のみ有効になります。

    true にセットすると、リスクのある Record のみを返します。false にセットすると、リスクのない Record のみを返します。指定しない場合、フィルターは適用されません。

    列挙値:

    • true :

      はい。

    • false :

      No

    true
    PageSize

    integer

    任意

    1 ページあたりのエントリ数。

    20
    PageNumber

    integer

    任意

    1 ページあたりのエントリ数。

    1

    任意

    ページ番号。1 から開始します。値 0 と 1 は同じ結果を返します。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    クエリ結果。

    PageSize

    integer

    1 ページあたりのエントリ数。

    20
    PageNumber

    integer

    ページ番号。

    1
    Data

    array<object>

    返された結果オブジェクトのリスト。

    array<object>

    返された結果オブジェクト。

    DesktopId

    string

    エージェントランタイム ID。

    ecd-xxxx
    ResourceId

    string

    リソース ID。クラウドコンピューター ID です。

    ecd-xxxx
    RegionId

    string

    リージョン ID。

    cn-hangzhou
    RegionLocation

    string

    リージョンのロケーション（国内/海外）。

    列挙値:

    • Mainland :

      中国本土。

    • Overseas :

      海外（中国香港を含む）。

    Mainland
    DesktopName

    string

    エージェントランタイム名。

    Agent-001
    DesktopStatus

    string

    クラウドコンピューターのステータス。

    列挙値:

    • Stopped :

      停止済み。

    • Starting :

      起動中。

    • Rebuilding :

      再構築中。

    • Running :

      実行中。

    • Stopping :

      停止中。

    • Expired :

      期限切れ。

    • Deleted :

      削除済み。

    • Pending :

      保留中。

    Running
    OsType

    string

    オペレーティングシステムのタイプ。

    列挙値:

    • Linux :

      Linux。

    • Windows :

      Windows。

    Windows
    AuthUsers

    array

    許可されるユーザーのリスト。

    string

    許可されるユーザー。

    user-001
    HasAuthUser

    boolean

    許可されるユーザーが存在するかどうかを示します。

    列挙値:

    • true :

      はい。

    • false :

      No

    true
    AgentInstanceInfoList

    array<object>

    エージェントインスタンス情報のリスト。

    object

    エージェントインスタンス情報オブジェクト。

    AgentPlatform

    string

    AgentProvider

    string

    AgentInstanceVersion

    string

    エージェントインスタンスのバージョン。

    2026.3.13
    AgentInstanceStatus

    string

    エージェントのインスタンスステータス。

    列挙値:

    • Undeployed :

      未デプロイ。

    • Deploying :

      デプロイ中。

    • Stopped :

      停止済み。

    • Starting :

      起動中。

    • Running :

      実行中。

    • Stopping :

      停止中。

    • Deleted :

      削除済み。

    • Deployed :

      デプロイ済み。

    • Unavailable :

      利用不可。

    Running
    ModelConfigure

    boolean

    エージェントインスタンスにモデルが構成されているかどうかを示します。

    列挙値:

    • true :

      はい。

    • false :

      no.

    true
    ChannelConfigure

    boolean

    エージェントインスタンスにサードパーティチャンネルが構成されているかどうかを示します。

    列挙値:

    • true :

      はい。

    • false :

      no.

    true
    ChannelConfiguredList

    array

    エージェントインスタンスに構成されたサードパーティチャンネルのリスト。

    string

    エージェントインスタンスに構成されたサードパーティチャンネル。

    列挙値:

    • dingtalk-connector :

      DingTalk。

    • wechat :

      WeChat。

    • feishu :

      Lark。

    • qqbot :

      QQ

    • wecom :

      WeCom。

    dingtalk-connector
    DeploymentSource

    string

    Deployment ソース。

    列挙値:

    • User :

      ユーザー Deployment。

    • Admin :

      管理者 Deployment。

    Admin
    ModelTemplateId

    string

    構成されたモデルグループ ID。

    mt-xxxx
    ModelConfigure

    boolean

    エージェントランタイムにモデルが構成済みかどうかを示します。

    列挙値:

    • true :

      はい。

    • false :

      false。

    true
    ModelTemplateId

    string

    有効なモデルテンプレート ID（modelConfigure=true の場合のみ返されます）。

    mt-xxxx
    ModelTemplateName

    string

    有効なモデルテンプレート名（modelConfigure=true の場合のみ返されます）。

    model-template-001
    ChannelConfigure

    boolean

    エージェントランタイムにサードパーティチャンネルが構成済みかどうかを示します。

    列挙値:

    • true :

      はい。

    • false :

      No

    true
    ChannelConfiguredList

    array

    エージェントランタイムに構成されたサードパーティチャンネルのリスト。

    string

    エージェントランタイムに構成されたサードパーティチャンネル。

    列挙値:

    • dingtalk-connector :

      DingTalk。

    • wechat :

      WeChat。

    • feishu :

      Lark。

    • qqbot :

      QQ

    • wecom :

      WeCom。

    dingtalk-connector
    QrCodeConfiguringList

    array

    QR コード構成中のチャンネルのリスト。

    string

    QR コード構成中のチャンネル。

    wechat
    AgentImInfo

    object

    エージェント IM 情報。

    AgentImStatus

    string

    エージェント IM のステータス。

    列挙値:

    • Enabled :

      有効。

    • Disabled :

      無効。

    Enabled
    CloudSpaceStatus

    string

    CloudSpace のステータス。

    列挙値:

    • Enabled :

      有効。

    • Disabled :

      無効。

    Enabled
    RiskInfo

    object

    リスク情報（リクエストパラメーター IncludeRiskInfo が true にセットされている場合のみ返されます。それ以外の場合は null です）。

    ModelModified

    boolean

    モデル構成が変更済みかどうか（管理者が配信した構成と一致しない）を示します。

    列挙値:

    • true :

      はい。

    • false :

      no.

    true
    ChannelModified

    boolean

    サードパーティチャンネル構成が変更済みかどうか（管理者が配信した構成と一致しない）を示します。

    列挙値:

    • true :

      はい。

    • false :

      no.

    true
    AgentUninstalled

    boolean

    エージェントがアンインストールされたかどうかを示します。

    列挙値:

    • true :

      はい。

    • false :

      no.

    true
    ResourceGroup

    object

    リソースグループ情報。

    ResourceGroupId

    string

    リソースグループ ID。

    rg-xxxx
    ResourceGroupName

    string

    リソースグループ名。

    resource-group-001
    ManagementStatuses

    array

    string

    TotalCount

    integer

    エントリの総数。

    30
    RequestId

    string

    リクエスト ID。

    1CBAFFAB-B697-4049-A9B1-67E1FC5F****

    例

    成功レスポンス

    JSONJSON

    {
  "PageSize": 20,
  "PageNumber": 1,
  "Data": [
    {
      "DesktopId": "ecd-xxxx",
      "ResourceId": "ecd-xxxx",
      "RegionId": "cn-hangzhou",
      "RegionLocation": "Mainland",
      "DesktopName": "Agent-001",
      "DesktopStatus": "Running",
      "OsType": "Windows",
      "AuthUsers": [
        "user-001"
      ],
      "HasAuthUser": true,
      "AgentInstanceInfoList": [
        {
          "AgentPlatform": "",
          "AgentProvider": "",
          "AgentInstanceVersion": "2026.3.13",
          "AgentInstanceStatus": "Running",
          "ModelConfigure": true,
          "ChannelConfigure": true,
          "ChannelConfiguredList": [
            "dingtalk-connector"
          ],
          "DeploymentSource": "Admin",
          "ModelTemplateId": "mt-xxxx"
        }
      ],
      "ModelConfigure": true,
      "ModelTemplateId": "mt-xxxx",
      "ModelTemplateName": "model-template-001",
      "ChannelConfigure": true,
      "ChannelConfiguredList": [
        "dingtalk-connector"
      ],
      "QrCodeConfiguringList": [
        "wechat"
      ],
      "AgentImInfo": {
        "AgentImStatus": "Enabled",
        "CloudSpaceStatus": "Enabled"
      },
      "RiskInfo": {
        "ModelModified": true,
        "ChannelModified": true,
        "AgentUninstalled": true
      },
      "ResourceGroup": {
        "ResourceGroupId": "rg-xxxx",
        "ResourceGroupName": "resource-group-001"
      },
      "ManagementStatuses": [
        ""
      ]
    }
  ],
  "TotalCount": 30,
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****"
}

    エラーコード

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

    変更履歴

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