全部產品
Search

搜尋本產品

    ：ListDesktopAgentRuntime

    文件中心

    ：ListDesktopAgentRuntime

    更新時間：Jul 16, 2026

    查詢桌面 Agent 執行時列表。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    appstreaming:ListDesktopAgentRuntime

    get

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    AgentProvider

    string

    是

    Agent 供應商名稱。

    OpenClaw
    ModelTemplateId

    string

    否

    模型分組 ID。

    mt-xxxx
    DesktopIds

    array

    否

    Agent 執行時 ID 列表。

    jvs-xxxxx

    string

    是

    Agent 執行時 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 :

      已關機。

    • Starting :

      啟動中。

    • Rebuilding :

      重建中。

    • Running :

      執行中。

    • Stopping :

      停止中。

    • Expired :

      已過期。

    • Deleted :

      已刪除。

    • Pending :

      等待中。

    Running
    AuthUsers

    array

    否

    授權使用者列表。

    user001

    string

    是

    授權使用者。

    user-001
    AgentInstanceVersions

    array

    否

    Agent 執行個體版本列表。

    OpenClaw 2026.4.15

    string

    是

    Agent 執行個體版本。

    2026.3.13
    AgentInstanceStatuses

    array

    否

    Agent 執行個體狀態列表。

    Running

    string

    是

    Agent 執行個體狀態。

    枚舉值：

    • Undeployed :

      未部署。

    • Deploying :

      部署中。

    • Stopped :

      已停止。

    • Starting :

      啟動中。

    • Running :

      執行中。

    • Stopping :

      停止中。

    • Deleted :

      已刪除。

    • Deployed :

      已部署。

    • Unavailable :

      不可用。

    Running
    DeploymentSource

    string

    否

    部署來源。

    枚舉值：

    • User :

      使用者部署。

    • Admin :

      管理員部署。

    Admin
    ModelConfigure

    boolean

    否

    是否已設定模型。

    枚舉值：

    • true :

      是。

    • false :

      否。

    true
    ChannelConfigure

    boolean

    否

    是否已設定第三方通道。

    枚舉值：

    • true :

      是。

    • false :

      否。

    true
    ResourceGroupId

    string

    否

    資源群組 ID。

    rg-xxxx
    DesktopNames

    array

    否

    Agent 執行時名稱列表。

    Desktop001

    string

    是

    Agent 執行時名稱。

    Agent-001
    BizType

    integer

    否

    業務類型。

    枚舉值：

    • 1 :

      企業版。

    1
    AgentPlatform

    string

    否

    Agent 平台。

    枚舉值：

    • ENTERPRISE :

      企業版。

    • ENTERPRISE_JVS :

      企業版 JVS Computer、企業版 Hermes Agent。

    ENTERPRISE
    HasAuthUser

    boolean

    否

    是否已授權使用者。

    枚舉值：

    • true :

      是。

    • false :

      false

    true
    IncludeRiskInfo

    boolean

    否

    是否查詢並返回風險資訊。預設為 false。設定為 true 時，回應中將包含 RiskInfo 欄位，同時 HasRisk 篩選條件才會生效。

    枚舉值：

    • true :

      是。

    • false :

      否。

    true
    HasRisk

    boolean

    否

    是否存在風險。用於篩選有風險或無風險的雲端電腦，僅當 IncludeRiskInfo 為 true 時生效。

    設定為 true 表示僅返回存在風險的記錄，設定為 false 表示僅返回無風險的記錄，不傳則不做篩選。

    枚舉值：

    • true :

      是。

    • false :

      否。

    true
    ManagementStatus

    string

    否

    Hibernated
    PageSize

    integer

    否

    每頁大小。

    Online
    PageNumber

    integer

    否

    頁碼，從 1 開始，0 和 1 返回相同結果。

    1

    否

    每頁大小。

    20

    否

    頁碼，從 1 開始，0 和 1 返回相同結果。

    1

    否

    cn-hangzhou+dir-xxxx

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    查詢結果。

    PageSize

    integer

    每頁大小。

    20
    PageNumber

    integer

    頁碼。

    1
    Data

    array<object>

    返回的結果物件列表。

    array<object>

    返回的結果物件。

    DesktopId

    string

    Agent 執行時 ID。

    ecd-xxxx
    ResourceId

    string

    資源 ID，即雲端電腦 ID。

    ecd-xxxx
    RegionId

    string

    地域 ID。

    cn-hangzhou
    RegionLocation

    string

    地域位置（國內/海外）。

    枚舉值：

    • Mainland :

      中國大陸。

    • Overseas :

      海外（含中國香港）

    Mainland
    DesktopName

    string

    Agent 執行時名稱。

    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 :

      否。

    true
    AgentInstanceInfoList

    array<object>

    Agent 執行個體資訊列表。

    object

    Agent 執行個體資訊物件。

    AgentPlatform

    string

    AgentProvider

    string

    AgentInstanceVersion

    string

    Agent 執行個體版本。

    2026.3.13
    AgentInstanceStatus

    string

    Agent 執行個體狀態。

    枚舉值：

    • Undeployed :

      未部署。

    • Deploying :

      部署中。

    • Stopped :

      已停止。

    • Starting :

      啟動中。

    • Running :

      執行中。

    • Stopping :

      停止中。

    • Deleted :

      已刪除。

    • Deployed :

      已部署。

    • Unavailable :

      不可用。

    Running
    ModelConfigure

    boolean

    Agent 執行個體是否已配置模型。

    枚舉值：

    • true :

      是。

    • false :

      否。

    true
    ChannelConfigure

    boolean

    Agent 執行個體是否已配置三方通道。

    枚舉值：

    • true :

      是。

    • false :

      否。

    true
    ChannelConfiguredList

    array

    Agent 執行個體已配置的三方通道列表。

    string

    Agent 執行個體已配置的三方通道。

    枚舉值：

    • dingtalk-connector :

      釘釘。

    • wechat :

      微信。

    • feishu :

      飛書。

    • qqbot :

      QQ

    • wecom :

      企業微信。

    dingtalk-connector
    DeploymentSource

    string

    部署來源。

    枚舉值：

    • User :

      使用者部署。

    • Admin :

      管理員部署。

    Admin
    ModelTemplateId

    string

    已配置的模型分組 ID。

    mt-xxxx
    ModelConfigure

    boolean

    Agent 執行時是否已設定模型。

    枚舉值：

    • true :

      是。

    • false :

      false

    true
    ModelTemplateId

    string

    已生效的模型範本 ID（僅 modelConfigure=true 時返回）。

    mt-xxxx
    ModelTemplateName

    string

    已生效的模型範本名稱（僅 modelConfigure=true 時返回）。

    model-template-001
    ChannelConfigure

    boolean

    Agent 執行時是否已設定第三方通道。

    枚舉值：

    • true :

      是。

    • false :

      否。

    true
    ChannelConfiguredList

    array

    Agent 執行時已設定的第三方通道列表。

    string

    Agent 執行時已設定的第三方通道。

    枚舉值：

    • dingtalk-connector :

      釘釘。

    • wechat :

      微信。

    • feishu :

      飛書。

    • qqbot :

      QQ

    • wecom :

      企業微信。

    dingtalk-connector
    QrCodeConfiguringList

    array

    掃碼設定中的通道編碼列表。

    string

    掃碼設定中的通道編碼。

    wechat
    AgentImInfo

    object

    Agent IM 資訊。

    AgentImStatus

    string

    Agent IM 狀態。

    枚舉值：

    • Enabled :

      已啟用。

    • Disabled :

      已停用。

    Enabled
    CloudSpaceStatus

    string

    CloudSpace 狀態。

    枚舉值：

    • Enabled :

      已啟用。

    • Disabled :

      已停用。

    Enabled
    AgentImOnlineStatus

    string

    RiskInfo

    object

    風險資訊（僅當請求參數 IncludeRiskInfo 為 true 時返回，否則為 null）。

    ModelModified

    boolean

    模型配置是否被修改（與管理員下發的配置不一致）。

    枚舉值：

    • true :

      是。

    • false :

      否。

    true
    ChannelModified

    boolean

    三方通道配置是否被修改（與管理員下發的配置不一致）。

    枚舉值：

    • true :

      是。

    • false :

      否。

    true
    AgentUninstalled

    boolean

    Agent 是否被解除安裝。

    枚舉值：

    • true :

      是。

    • false :

      否。

    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****

    樣本

    正常返回樣本

    JSON格式

    {
  "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",
        "AgentImOnlineStatus": ""
      },
      "RiskInfo": {
        "ModelModified": true,
        "ChannelModified": true,
        "AgentUninstalled": true
      },
      "ResourceGroup": {
        "ResourceGroupId": "rg-xxxx",
        "ResourceGroupName": "resource-group-001"
      },
      "ManagementStatuses": [
        ""
      ]
    }
  ],
  "TotalCount": 30,
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****"
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。