All Products
Search

This Product

    App Streaming:ListDesktopAgentRuntime

    Document Center

    App Streaming:ListDesktopAgentRuntime

    Last Updated:Jun 24, 2026

    Mengkueri daftar waktu proses agen desktop.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    appstreaming:ListDesktopAgentRuntime

    get

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    AgentProvider

    string

    Yes

    Nama penyedia agen.

    OpenClaw
    ModelTemplateId

    string

    No

    ID kelompok model.

    mt-xxxx
    DesktopIds

    array

    No

    Daftar ID waktu proses agen.

    jvs-xxxxx

    string

    Yes

    ID waktu proses agen. Pemetaan ID adalah sebagai berikut:

    JVS Computer: ID JVS Computer, format jvs-xxxx.

    OpenClaw: ID cloud computer, format ecd-xxxx.

    Hermes Agent: ID Hermes Agent, format jvs-xxxx.

    ecd-xxxx
    ResourceIds

    array

    No

    Daftar ID Sumber daya (ID Sumber daya dasar yang sebenarnya).

    ecd-xxxxx

    string

    No

    ID Sumber daya.

    ecd-xxxx
    DesktopStatuses

    array

    No

    Daftar status cloud computer.

    Running

    string

    Yes

    Status cloud computer.

    Valid values:

    • Stopped :

      Stopped

    • Starting :

      Starting

    • Rebuilding :

      Rebuilding

    • Running :

      Running

    • Stopping :

      Stopping

    • Expired :

      Expired

    • Deleted :

      Deleted

    • Pending :

      Pending

    Running
    AuthUsers

    array

    No

    Daftar pengguna terotorisasi.

    user001

    string

    Yes

    Pengguna terotorisasi.

    user-001
    AgentInstanceVersions

    array

    No

    Daftar versi instans agen.

    OpenClaw 2026.4.15

    string

    Yes

    Versi instans agen.

    2026.3.13
    AgentInstanceStatuses

    array

    No

    Daftar status instans agen.

    Running

    string

    Yes

    Status instans agen.

    Valid values:

    • Undeployed :

      Undeployed

    • Deploying :

      Deploying

    • Stopped :

      Stopped

    • Starting :

      Starting

    • Running :

      Running

    • Stopping :

      Stopping

    • Deleted :

      Deleted

    • Deployed :

      Deployed

    • Unavailable :

      Unavailable

    Running
    DeploymentSource

    string

    No

    Sumber penerapan.

    Valid values:

    • User :

      Penerapan pengguna.

    • Admin :

      Penerapan admin.

    Admin
    ModelConfigure

    boolean

    No

    Apakah model dikonfigurasi.

    Valid values:

    • true :

      Ya.

    • false :

      No

    true
    ChannelConfigure

    boolean

    No

    Apakah saluran pihak ketiga dikonfigurasi.

    Valid values:

    • true :

      Ya.

    • false :

      No

    true
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

    rg-xxxx
    DesktopNames

    array

    No

    Daftar nama waktu proses agen.

    Desktop001

    string

    Yes

    Nama waktu proses agen.

    Agent-001
    BizType

    integer

    No

    Tipe bisnis.

    Valid values:

    • 1 :

      Edisi Enterprise.

    1
    AgentPlatform

    string

    No

    Platform agen.

    Valid values:

    • ENTERPRISE :

      Edisi Enterprise.

    • ENTERPRISE_JVS :

      Edisi Enterprise JVS Computer, Edisi Enterprise Hermes Agent.

    ENTERPRISE
    HasAuthUser

    boolean

    No

    Apakah pengguna terotorisasi ada.

    Valid values:

    • true :

      Ya.

    • false :

      false.

    true
    IncludeRiskInfo

    boolean

    No

    Apakah akan mengkueri dan mengembalikan informasi risiko. Nilai default: false. Jika disetel ke true, tanggapan menyertakan bidang RiskInfo, dan kondisi filter HasRisk berlaku.

    Valid values:

    • true :

      Ya.

    • false :

      No

    true
    HasRisk

    boolean

    No

    Apakah risiko ada. Memfilter cloud computer dengan atau tanpa risiko. Parameter ini hanya berlaku ketika IncludeRiskInfo disetel ke true.

    Setel ke true untuk hanya mengembalikan catatan dengan risiko. Setel ke false untuk hanya mengembalikan catatan tanpa risiko. Jika tidak ditentukan, tidak ada filter yang diterapkan.

    Valid values:

    • true :

      Ya.

    • false :

      No

    true
    PageSize

    integer

    No

    Jumlah entri per halaman.

    20
    PageNumber

    integer

    No

    Jumlah entri per halaman.

    1

    No

    Nomor halaman, dimulai dari 1. Nilai 0 dan 1 mengembalikan hasil yang sama.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Hasil kueri.

    PageSize

    integer

    Jumlah entri per halaman.

    20
    PageNumber

    integer

    Nomor halaman.

    1
    Data

    array<object>

    Daftar objek hasil yang dikembalikan.

    array<object>

    Objek hasil yang dikembalikan.

    DesktopId

    string

    ID waktu proses agen.

    ecd-xxxx
    ResourceId

    string

    ID Sumber daya, yaitu ID cloud computer.

    ecd-xxxx
    RegionId

    string

    ID wilayah.

    cn-hangzhou
    RegionLocation

    string

    Lokasi wilayah (domestik/luar negeri).

    Valid values:

    • Mainland :

      Daratan Tiongkok.

    • Overseas :

      Luar negeri (termasuk Hong Kong, Tiongkok).

    Mainland
    DesktopName

    string

    Nama waktu proses agen.

    Agent-001
    DesktopStatus

    string

    Status cloud computer.

    Valid values:

    • Stopped :

      Stopped.

    • Starting :

      Starting.

    • Rebuilding :

      Rebuilding.

    • Running :

      Running.

    • Stopping :

      Stopping.

    • Expired :

      Expired.

    • Deleted :

      Deleted.

    • Pending :

      Pending.

    Running
    OsType

    string

    Tipe sistem operasi.

    Valid values:

    • Linux :

      Linux.

    • Windows :

      Windows.

    Windows
    AuthUsers

    array

    Daftar pengguna terotorisasi.

    string

    Pengguna terotorisasi.

    user-001
    HasAuthUser

    boolean

    Apakah pengguna terotorisasi ada.

    Valid values:

    • true :

      Ya.

    • false :

      No

    true
    AgentInstanceInfoList

    array<object>

    Daftar informasi instans agen.

    object

    Objek informasi instans agen.

    AgentPlatform

    string

    AgentProvider

    string

    AgentInstanceVersion

    string

    Versi instans agen.

    2026.3.13
    AgentInstanceStatus

    string

    Status instans agen.

    Valid values:

    • Undeployed :

      Belum di-deploy.

    • Deploying :

      Men-deploy.

    • Stopped :

      Dihentikan.

    • Starting :

      Memulai.

    • Running :

      Berjalan.

    • Stopping :

      Menghentikan.

    • Deleted :

      Dihapus.

    • Deployed :

      Sudah di-deploy.

    • Unavailable :

      Tidak tersedia.

    Running
    ModelConfigure

    boolean

    Menunjukkan apakah model dikonfigurasi untuk instans agen.

    Valid values:

    • true :

      ya.

    • false :

      tidak.

    true
    ChannelConfigure

    boolean

    Menunjukkan apakah kanal pihak ketiga dikonfigurasi untuk instans agen.

    Valid values:

    • true :

      ya.

    • false :

      tidak.

    true
    ChannelConfiguredList

    array

    Daftar kanal pihak ketiga yang dikonfigurasi untuk instans agen.

    string

    Kanal pihak ketiga yang dikonfigurasi untuk instans agen.

    Valid values:

    • dingtalk-connector :

      DingTalk.

    • wechat :

      WeChat.

    • feishu :

      Lark.

    • qqbot :

      QQ

    • wecom :

      WeCom.

    dingtalk-connector
    DeploymentSource

    string

    Sumber deployment.

    Valid values:

    • User :

      Deployment pengguna.

    • Admin :

      Deployment administrator.

    Admin
    ModelTemplateId

    string

    ID grup model yang dikonfigurasi.

    mt-xxxx
    ModelConfigure

    boolean

    Apakah waktu proses agen memiliki model yang dikonfigurasi.

    Valid values:

    • true :

      Ya.

    • false :

      false.

    true
    ModelTemplateId

    string

    ID templat model yang efektif (hanya dikembalikan ketika modelConfigure=true).

    mt-xxxx
    ModelTemplateName

    string

    Nama templat model yang efektif (hanya dikembalikan ketika modelConfigure=true).

    model-template-001
    ChannelConfigure

    boolean

    Apakah waktu proses agen memiliki saluran pihak ketiga yang dikonfigurasi.

    Valid values:

    • true :

      Ya.

    • false :

      No

    true
    ChannelConfiguredList

    array

    Daftar saluran pihak ketiga yang dikonfigurasi untuk waktu proses agen.

    string

    Saluran pihak ketiga yang dikonfigurasi untuk waktu proses agen.

    Valid values:

    • dingtalk-connector :

      DingTalk.

    • wechat :

      WeChat.

    • feishu :

      Lark.

    • qqbot :

      QQ

    • wecom :

      WeCom.

    dingtalk-connector
    QrCodeConfiguringList

    array

    Daftar saluran dalam konfigurasi kode QR.

    string

    Saluran dalam konfigurasi kode QR.

    wechat
    AgentImInfo

    object

    Informasi IM agen.

    AgentImStatus

    string

    Status IM agen.

    Valid values:

    • Enabled :

      Diaktifkan.

    • Disabled :

      Dinonaktifkan.

    Enabled
    CloudSpaceStatus

    string

    Status CloudSpace.

    Valid values:

    • Enabled :

      Diaktifkan.

    • Disabled :

      Dinonaktifkan.

    Enabled
    RiskInfo

    object

    Informasi risiko (hanya dikembalikan ketika parameter permintaan IncludeRiskInfo disetel ke true, jika tidak null).

    ModelModified

    boolean

    Menunjukkan apakah konfigurasi model telah dimodifikasi (tidak konsisten dengan konfigurasi yang dikirimkan oleh administrator).

    Valid values:

    • true :

      ya.

    • false :

      tidak.

    true
    ChannelModified

    boolean

    Menunjukkan apakah konfigurasi kanal pihak ketiga telah dimodifikasi (tidak konsisten dengan konfigurasi yang dikirimkan oleh administrator).

    Valid values:

    • true :

      ya.

    • false :

      tidak.

    true
    AgentUninstalled

    boolean

    Menunjukkan apakah agen telah di-uninstall.

    Valid values:

    • true :

      ya.

    • false :

      tidak.

    true
    ResourceGroup

    object

    Informasi kelompok sumber daya.

    ResourceGroupId

    string

    ID grup sumber daya.

    rg-xxxx
    ResourceGroupName

    string

    Nama grup sumber daya.

    resource-group-001
    ManagementStatuses

    array

    string

    TotalCount

    integer

    Jumlah total entri.

    30
    RequestId

    string

    ID permintaan.

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

    Contoh

    Respons sukses

    JSONformat

    {
  "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****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.