All Products
Search
Document Center

App Streaming:ListPersistentAppInstances

Last Updated:Jul 04, 2026

Mengambil daftar instans aplikasi sesi persisten dalam suatu delivery group.

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:ListPersistentAppInstances

get

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

ProductType

string

Yes

Jenis produk.

Valid values:

  • CloudApp :

    cloud application.

  • CloudBrowser :

    cloud browser.

  • AndroidCloud :

    cloud phone.

CloudApp

AppInstanceGroupId

string

Yes

ID delivery group.

aig-0bxls9m9arax6****

AppInstancePersistentIds

array

No

Daftar ID sesi persisten.

string

Yes

ID sesi persisten.

p-0cc7s3mw2fg4j****

PageSize

integer

No

Jumlah hasil kueri per halaman. Nilai maksimum: 100. Nilai default: 20.

20

PageNumber

integer

No

Nomor halaman dari hasil kueri yang akan ditampilkan. Nilai minimum: 1. Nilai default: 1.

1

Elemen respons

Element

Type

Description

Example

object

Badan respons.

RequestId

string

ID permintaan.

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

TotalCount

integer

Total jumlah hasil kueri.

15

PageSize

integer

Jumlah hasil kueri per halaman.

20

PageNumber

integer

Nomor halaman dari hasil kueri yang sedang ditampilkan.

1

PersistentAppInstanceModels

array<object>

Daftar instans aplikasi sesi persisten.

object

Informasi instans aplikasi sesi persisten.

AppInstancePersistentId

string

ID sesi persisten.

p-0cc7s3mw2fg4j****

AppInstancePersistentName

string

Nama instans aplikasi sesi persisten.

test-persistent-name

AppInstancePersistentStatus

string

Status instans dari aplikasi sesi persisten.

Valid values:

  • STARTING :

    starting.

  • RUNNING :

    running.

  • STOPPED :

    stopped.

  • UNAVAILABLE :

    unavailable.

  • DELETING :

    deleting.

  • PENDING :

    creating.

  • STOPPING :

    stopping.

  • DELETED :

    deleted.

  • REBUILDING :

    resetting.

RUNNING

AppInstanceGroupId

string

ID delivery group.

aig-0bxls9m9arax6****

AppInstanceId

string

ID instans aplikasi.

ai-azn3kmwruh1vl****

AppInstanceStatus

string

Status instans aplikasi.

Valid values:

  • INIT :

    initializing.

  • STARTING :

    application starting.

  • CLOSING :

    application stopping.

  • CLOSED :

    application closed.

  • RUNNING :

    application running.

  • IDLE :

    idle.

  • BOUND :

    bound.

  • UNAVAILABLE :

    unavailable.

  • DELETED :

    deleted.

RUNNING

GmtCreate

string

Waktu pembuatan.

2025-03-13T03:22:18.000+00:00

AuthorizedUsers

array

Daftar username yang diizinkan.

string

Username yang diizinkan.

user-001

Contoh

Respons sukses

JSONformat

{
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "TotalCount": 15,
  "PageSize": 20,
  "PageNumber": 1,
  "PersistentAppInstanceModels": [
    {
      "AppInstancePersistentId": "p-0cc7s3mw2fg4j****",
      "AppInstancePersistentName": "test-persistent-name",
      "AppInstancePersistentStatus": "RUNNING",
      "AppInstanceGroupId": "aig-0bxls9m9arax6****",
      "AppInstanceId": "ai-azn3kmwruh1vl****",
      "AppInstanceStatus": "RUNNING",
      "GmtCreate": "2025-03-13T03:22:18.000+00:00",
      "AuthorizedUsers": [
        "user-001"
      ]
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.