ListImage - App Streaming - Alibaba Cloud Documentation Center

Mengembalikan informasi mengenai image.

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

list

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ImageId	string	No	ID image.	img-bp13mu****
ImageName	string	No	Nama image. Pencarian fuzzy didukung.	DemoImage
Status	string	No	Status image. Gunakan parameter ini untuk mengkueri image dengan status tertentu. Jika Anda menghilangkan parameter ini, panggilan akan mengembalikan semua image yang tidak dihapus. Valid values: AVAILABLE : tersedia INIT : menginisialisasi CREATE_FAILED : pembuatan gagal CREATING : membuat	INIT
ImageType	string	No	Tipe image. Valid values: User : custom image Shared : shared image System : system image Community : community image	User
PackageType	string	No	Tipe paket image. Valid values: Ecs_Container : image ECS + Docker Ecs : Citra ECS	Ecs
OsType	string	No	Sistem operasi image. Valid values: Linux : Linux Unknown : tidak diketahui Windows : Windows Android : Android	Windows
BizType	integer	No	Tipe bisnis. Parameter ini hanya untuk penggunaan internal. Valid values: 1 : Default	1
ProductType	string	No	Tipe produk. Valid values: CloudDesktop : Elastic Desktop Service CloudApp : Wuying App Streaming WuyingServer : Wuying Workspace	CloudApp
ProtocolType	string	No	Protokol streaming. Valid values: HDX : protokol HDX ASP : Protokol ASP proprietary dari Alibaba Cloud.	ASP
PageSize	integer	No	Jumlah entri per halaman. Nilai maksimum: 100. Nilai default: 10.	10
PageNumber	integer	No	Nomor halaman.	1
ProductTypeList	array	No	Tipe produk yang didukung oleh image.
	string	No	Tipe produk. Valid values: CloudDesktop : Elastic Desktop Service CloudApp : Wuying App Streaming WuyingServer : Wuying Workspace	CloudApp
BizTypeList	array	No	Daftar tipe bisnis. Parameter ini hanya untuk penggunaan internal.
	integer	No	Tipe bisnis. Tentukan nilai berdasarkan layanan yang Anda gunakan. Valid values: 1 : Default	1
FeatureList	array	No	Fitur yang didukung oleh image.
	string	No	Fitur yang didukung oleh image. Valid values: FotaChannel : Mendukung saluran FOTA. Builder : Mendukung Image Builder. MultiSession : Mendukung multi-sesi. GPU : Mendukung akselerasi GPU.	GPU
LanguageType	string	No	Bahasa. Valid values: en-US : Bahasa Inggris zh-HK : Bahasa Tionghoa Tradisional (Hong Kong) zh-CN : Bahasa Tionghoa Sederhana ja-JP : Bahasa Jepang	zh-CN
ResourceInstanceType	string	No	Tipe instans. Gunakan parameter ini untuk memfilter image yang kompatibel dengan tipe instans tertentu.	eds.enterprise_office.2c4g
FotaVersion	string	No	Versi image.	2.0.3-xxxx
PlatformName	string	No	Nama platform sistem operasi. Valid values: Ubuntu : Ubuntu Debian : Debian Windows Server 2022 : sistem operasi Windows Server 2022 Windows Server 2019 : sistem operasi Windows Server 2019 Windows Server 2016 : sistem operasi Windows Server 2016 Windows 11 : sistem operasi Windows 11 Windows 10 : sistem operasi Windows 10	Windows Server 2019
BizRegionIdList	array	No	ID wilayah untuk filter. Image Wuying terpusat. Gunakan parameter ini untuk menemukan image yang tersedia di wilayah tertentu.
	string	No	ID wilayah.	cn-shanghai
TagList	array<object>	No	Tag untuk memfilter hasil.
	object	No
Key	string	No	Kunci tag yang ditentukan pengguna.	env
Value	string	No	Nilai tag yang ditentukan pengguna.	test
PlatformNameList	array	No	Daftar tipe platform yang didukung. Untuk nilai yang valid, lihat parameter `PlatformName`.
	string	No	Nama platform.	Windows 11
Distro	string	No

Elemen respons

Element	Type	Description	Example
	object	Struktur data yang berisi informasi image.
PageSize	integer	Jumlah entri yang dikembalikan pada setiap halaman.	10
PageNumber	integer	Nomor halaman.	1
Data	array<object>	Daftar objek yang berisi detail image.
	array<object>	Objek yang berisi detail image.
GmtCreate	string	Waktu saat image dibuat.	2025-04-25 15:13:57
GmtModified	string	Waktu saat image terakhir dimodifikasi.	2025-04-25 15:13:57
AliUid	integer	ID penyewa.	123456789
ImageId	string	ID image. ID image sistem telah ditentukan sebelumnya. ID image kustom dibuat secara otomatis.	imgc-xxxx
ImageName	string	Nama image.	DemoImage
ImageType	string	Tipe image.	User
PackageType	string	Tipe pengemasan image.	ECS
Description	string	Deskripsi image.	描述
OsType	string	Sistem operasi image.	Windows
ProtocolType	string	Protokol streaming.	ASP
BizType	integer	Tipe bisnis.	1
ProductType	string	Tipe produk.	CloudApp
VersionId	string	Versi image.	iv-xxx
OnlineVersionId	string	ID versi image online. Satu image dapat memiliki beberapa versi.	iv-xxxx
LatestVersionId	string	ID versi image terbaru. Satu image dapat memiliki beberapa versi.	iv-xxx
Status	string	Status image.	INIT
ParentImageId	string	ID image induk, yang menunjukkan hubungan pewarisan. Bidang ini kosong untuk image sistem.	imgc-xxx
ParentImageVersion	string	Versi image induk.	iv-xxx
BaseImageId	string	ID image dasar.	imgc-xxx
BaseImageVersion	string	Versi image dasar.	iv-xxx
FotaVersion	string	Versi FOTA.	2.3.0-xxx
Language	string	Bahasa dari image tersebut. Jika image dikemas sebagai `VHD` atau `container`, nilai ini diwariskan dari image `ECS` dalam komposisi yang sama.	zh-CN
Platform	integer	Platform sistem operasi image. Catatan Jika image dikemas sebagai `VHD` atau `container`, nilai ini diwariskan dari image yang dikemas `ECS` dalam pencampuran aliran yang sama.	Windows
OnlineVersion	boolean	Menunjukkan apakah versi saat ini adalah versi aktif.	true
SystemDiskSize	integer	Ukuran disk sistem, dalam GiB. Catatan Ukuran disk sistem tidak boleh lebih kecil dari ukuran file image.	40
DataDiskSize	integer	Ukuran disk data, dalam GiB.	100
AppList	array<object>	Daftar konfigurasi aplikasi.
	object
AppId	string	ID aplikasi.	ca-xxx
AppName	string	Nama aplikasi.	应用名称
FeatureList	array	Daftar tag fitur untuk image.
	string	Tag fitur image.	Builder
ImageCreateMode	string	Metode yang digunakan untuk membuat image. Valid values: BY_SNAPSHOT_ID : Dibuat dari snapshot dan hanya berisi disk sistem. BUILDER_MANUAL : Dibuat secara manual. INSTANCE_AUTO : Dibuat secara otomatis dari instans. BY_INSTANCE_ID : Dibuat dari instans dan berisi disk sistem serta disk data.	BUILDER_MANUAL
ImageRegionList	array	Daftar wilayah.
	string	Wilayah.	地域对象。
Distro	string	Nama distribusi.	Ubuntu 22.04 64位
VersionName	string	Nama versi.	v0.1.0
ResourceInstanceCategory	string	Tipe sumber daya yang didukung oleh image.	["eds.cpu.category"]
PlatformName	string	Nama platform sistem.	Windows Server 2022
SupportedLanguageList	array	Daftar bahasa yang didukung.
	string	Bahasa yang didukung.	zh-CN
VolumeEncryptionEnabled	boolean	Menunjukkan apakah enkripsi disk diaktifkan.	true
VolumeEncryptionKey	string	ID kunci Key Management Service (KMS) yang digunakan untuk enkripsi disk. Parameter ini hanya dikembalikan ketika enkripsi disk diaktifkan.	a7b3c0c8-xxxx
SessionType	string	Tipe sesi. Valid values: SINGLE_SESSION : Image hanya mendukung satu sesi pengguna per instans. MULTIPLE_SESSION : Image mendukung beberapa sesi pengguna bersamaan pada satu instans.	SINGLE_SESSION
ImageRegionDistributeList	array<object>	Status distribusi image di berbagai wilayah.
	object
ImageId	string	ID image. ID image sistem telah ditentukan sebelumnya. ID image kustom dibuat secara otomatis.	imgc-xxx
RegionId	string	Wilayah yang didukung.	cn-shanghai
Status	string	Status distribusi di wilayah ini.	INIT
VersionId	string	Versi image.	iv-xxx
Progress	string	Progres distribusi dalam persentase.	70%
FotaChannel	string	Catatan Parameter ini tidak tersedia untuk penggunaan eksternal.	镜像支持的fota渠道，暂未启用
CompatibleMode	boolean	Menunjukkan apakah image berada dalam mode kompatibilitas.	true
DriverList	array	Daftar ID driver.
	string	ID driver.	["00be80de-xxxx-xxxx-xxxx-xxxxxxxxxxxx"]
Scene	string	Kasus penggunaan yang dimaksudkan untuk image.	AIGC
Rating	integer	Peringkat image.	95
ImageIconUrl	string	URL ikon image.
EnvironmentId	string	ID lingkungan.	env-164c321f405ca84143e4b730dbe4
TagList	array<object>	Tag yang ditambahkan ke image.
	object
Key	string	Kunci tag.	1630348213973321
Value	string	Nilai tag.	inner
SnapshotList	array<object>	Snapshot dari image tersebut.
	object
SnapshotId	string	ID snapshot.
VersionId	string	ID versi image.
DiskType	string	Tipe disk.
DiskSubType	string	Subtipe disk.
BindType	string	Tipe bind.
DiskCategory	string	Kategori disk.
Size	integer	Ukuran snapshot, dalam GiB.
Count	integer	Total jumlah entri yang dikembalikan.	22
Success	boolean	Menunjukkan apakah permintaan berhasil. Valid values: true : Permintaan berhasil. false : Permintaan gagal.	true
Code	string	Kode respons.	200
Message	string	Pesan respons.	success
RequestId	string	ID permintaan.	8737D130-BFD0-5D51-96F6-C08EB1139A25

Contoh

Respons sukses

JSONformat

{
  "PageSize": 10,
  "PageNumber": 1,
  "Data": [
    {
      "GmtCreate": "2025-04-25 15:13:57",
      "GmtModified": "2025-04-25 15:13:57",
      "AliUid": 123456789,
      "ImageId": "imgc-xxxx",
      "ImageName": "DemoImage",
      "ImageType": "User",
      "PackageType": "ECS",
      "Description": "描述",
      "OsType": "Windows",
      "ProtocolType": "ASP",
      "BizType": 1,
      "ProductType": "CloudApp",
      "VersionId": "iv-xxx",
      "OnlineVersionId": "iv-xxxx",
      "LatestVersionId": "iv-xxx",
      "Status": "INIT",
      "ParentImageId": "imgc-xxx",
      "ParentImageVersion": "iv-xxx",
      "BaseImageId": "imgc-xxx",
      "BaseImageVersion": "iv-xxx",
      "FotaVersion": "2.3.0-xxx",
      "Language": "zh-CN",
      "Platform": 0,
      "OnlineVersion": true,
      "SystemDiskSize": 40,
      "DataDiskSize": 100,
      "AppList": [
        {
          "AppId": "ca-xxx",
          "AppName": "应用名称"
        }
      ],
      "FeatureList": [
        "Builder"
      ],
      "ImageCreateMode": "BUILDER_MANUAL",
      "ImageRegionList": [
        "地域对象。"
      ],
      "Distro": "Ubuntu 22.04 64位",
      "VersionName": "v0.1.0",
      "ResourceInstanceCategory": "[\"eds.cpu.category\"]",
      "PlatformName": "Windows Server 2022",
      "SupportedLanguageList": [
        "zh-CN"
      ],
      "VolumeEncryptionEnabled": true,
      "VolumeEncryptionKey": "a7b3c0c8-xxxx",
      "SessionType": "SINGLE_SESSION",
      "ImageRegionDistributeList": [
        {
          "ImageId": "imgc-xxx",
          "RegionId": "cn-shanghai",
          "Status": "INIT",
          "VersionId": "iv-xxx",
          "Progress": "70%"
        }
      ],
      "FotaChannel": "镜像支持的fota渠道，暂未启用",
      "CompatibleMode": true,
      "DriverList": [
        "[\"00be80de-xxxx-xxxx-xxxx-xxxxxxxxxxxx\"]"
      ],
      "Scene": "AIGC",
      "Rating": 95,
      "ImageIconUrl": "",
      "EnvironmentId": "env-164c321f405ca84143e4b730dbe4",
      "TagList": [
        {
          "Key": "1630348213973321",
          "Value": "inner"
        }
      ],
      "SnapshotList": [
        {
          "SnapshotId": "",
          "VersionId": "",
          "DiskType": "",
          "DiskSubType": "",
          "BindType": "",
          "DiskCategory": "",
          "Size": 0
        }
      ]
    }
  ],
  "Count": 22,
  "Success": true,
  "Code": "200",
  "Message": "success",
  "RequestId": "8737D130-BFD0-5D51-96F6-C08EB1139A25"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InternalError	Internal error.
400	InvalidBizType	The bizType parameter is invalid.
403	Forbidden.NoPermission	You are not authorized to access this page.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.