Mengkueri daftar resource gambar yang tersedia untuk Anda dengan menentukan parameter seperti ImageId, skenario penggunaan gambar, dan kondisi filter.
Deskripsi operasi
Sumber daya gambar yang dapat Anda kueri meliputi gambar kustom Anda, gambar publik yang disediakan oleh Alibaba Cloud, gambar Alibaba Cloud Marketplace, dan gambar bersama yang dibagikan oleh pengguna Alibaba Cloud lain kepada Anda.
Paging didukung. Hasil kueri mencakup jumlah total Sumber daya gambar yang tersedia dan Sumber daya gambar pada halaman saat ini. Jumlah entri default per halaman adalah 10.
Saat Anda memanggil operasi API menggunakan CLI Asisten Cloud, parameter permintaan dengan tipe data berbeda harus mematuhi persyaratan format. Untuk informasi selengkapnya, lihat Format parameter CLI.
Saat Anda mengkueri gambar yang disediakan oleh Alibaba Cloud atau gambar bersama (ImageOwnerAlias diatur ke system atau others), aturan otentikasi RAM dapat diabaikan untuk permintaan ini. Untuk informasi selengkapnya, lihat Aturan otentikasi.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ecs:DescribeImages |
get |
Image.
Image.
|
None | None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
ID wilayah gambar. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru. |
cn-hangzhou |
| Status |
string |
No |
Status gambar. Nilai valid:
Nilai default: Available. Saat Usable digunakan, Status wajib diisi dan tidak memiliki nilai default. Catatan
Parameter ini mendukung beberapa nilai secara bersamaan, dipisahkan oleh koma (,). Saat nilai diatur ke ALL, gambar dalam semua status akan dikueri. ALL tidak dapat digunakan bersama dengan nilai status lainnya. |
Available |
| ImageId |
string |
No |
ID gambar. |
m-bp1g7004ksh0oeuc**** |
| ShowExpired |
boolean |
No |
Apakah gambar langganan telah melebihi periode penggunaannya. |
false |
| SnapshotId |
string |
No |
ID snapshot yang digunakan untuk membuat gambar kustom. |
s-bp17ot2q7x72ggtw**** |
| ImageName |
string |
No |
Nama gambar. Pencarian fuzzy didukung. |
testImageName |
| ImageFamily |
string |
No |
Nama keluarga gambar. Anda dapat mengatur parameter ini untuk memfilter gambar yang termasuk dalam keluarga gambar tertentu. Nilai default: kosong. Catatan
Untuk informasi tentang keluarga gambar yang terkait dengan gambar publik Alibaba Cloud, lihat Ikhtisar gambar publik. |
hangzhou-daily-update |
| ImageOwnerAlias |
string |
No |
Sumber gambar. Nilai valid:
Nilai default: kosong. Catatan
Nilai kosong menunjukkan bahwa gambar dengan nilai system, self, dan others akan dikembalikan. |
self |
| InstanceType |
string |
No |
Tipe instans yang ingin Anda kueri untuk gambar yang tersedia. |
ecs.g5.large |
| Usable |
boolean |
No |
Apakah gambar tersedia. Catatan
Gambar yang tersedia menunjukkan bahwa gambar dapat langsung digunakan untuk membuat instans. Untuk skenario ketersediaan lainnya, lihat Ketersediaan instan gambar. |
true |
| IsSupportIoOptimized |
boolean |
No |
Apakah gambar dapat berjalan pada instans yang dioptimalkan I/O. |
true |
| IsSupportCloudinit |
boolean |
No |
Apakah gambar mendukung cloud-init. |
true |
| OSType |
string |
No |
Tipe sistem operasi gambar. Nilai valid:
|
linux |
| Architecture |
string |
No |
Arsitektur gambar. Nilai valid:
|
i386 |
| PageNumber |
integer |
No |
Nomor halaman resource. Nilai minimum: 1. Nilai default: 1. |
1 |
| PageSize |
integer |
No |
Jumlah entri per halaman untuk kueri paging. Pengaturan parameter ini untuk menentukan jumlah entri yang dikembalikan pada setiap halaman. Nilai maksimum: 100. Nilai default: 10. |
10 |
| Usage |
string |
No |
Apakah gambar sedang berjalan pada instans ECS. Nilai valid:
|
Instans |
| DryRun |
boolean |
No |
Apakah akan menjalankan dry run saja, tanpa menjalankan permintaan aktual.
Nilai default: false. |
false |
| ActionType |
string |
No |
Skenario penggunaan gambar. Nilai valid:
|
CreateEcs |
| ResourceGroupId |
string |
No |
ID kelompok Sumber daya tempat gambar kustom berada. Saat Anda menggunakan parameter ini untuk memfilter Sumber daya, jumlah Sumber daya tidak boleh melebihi 1000. Catatan
Memfilter berdasarkan kelompok Sumber daya default tidak didukung. |
rg-bp67acfmxazb4p**** |
| Tag |
array<object> |
No |
Daftar tag. |
|
|
object |
No |
Informasi tag. |
||
| key |
string |
No |
Kunci tag gambar. Catatan
[Tidak digunakan lagi] Parameter ini akan dihapus. Untuk kompatibilitas yang lebih baik, gunakan Tag.N.Key sebagai gantinya. |
null |
| Key |
string |
No |
Kunci tag gambar. Nilai valid N: 1 hingga 20. Saat Anda menggunakan satu tag untuk memfilter resource, jumlah resource dengan tag ini tidak boleh melebihi 1000. Saat Anda menggunakan beberapa tag untuk memfilter resource, jumlah resource yang dilampirkan ke semua tag yang ditentukan tidak boleh melebihi 1000. Jika jumlah resource melebihi 1000, panggil operasi ListTagResources untuk mengkueri resource. |
TestKey |
| Value |
string |
No |
Nilai tag gambar. Nilai valid N: 1 hingga 20. |
TestValue |
| value |
string |
No |
Nilai tag gambar. Catatan
[Tidak digunakan lagi] Parameter ini akan dihapus. Untuk kompatibilitas yang lebih baik, gunakan Tag.N.Value sebagai gantinya. |
null |
| Filter |
array<object> |
No |
Daftar kondisi filter saat mengkueri resource. |
|
|
object |
No |
Kondisi filter saat mengkueri resource. |
||
| Key |
string |
No |
Kunci filter saat mengkueri resource. Nilai valid:
Nilai default: null. |
CreationStartTime |
| Value |
string |
No |
Nilai filter saat mengkueri resource.
Nilai default: null. |
2017-12-05T22:40Z |
| IsPublic |
boolean |
No |
Apakah akan mengkueri gambar komunitas yang diterbitkan. Nilai valid:
Nilai default: false. |
false |
| ImageOwnerId |
integer |
No |
ID akun Alibaba Cloud tempat gambar berada. Parameter ini hanya berlaku saat Anda mengkueri gambar bersama atau gambar komunitas. |
20169351435666**** |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
|||
| PageSize |
integer |
Jumlah entri per halaman. |
1 |
| PageNumber |
integer |
Nomor halaman. |
1 |
| RequestId |
string |
ID permintaan. |
66189103-EDB2-43E2-BB60-BFF2B62F4EB8 |
| TotalCount |
integer |
Jumlah total gambar. |
1 |
| RegionId |
string |
ID wilayah gambar. |
cn-hangzhou |
| Images |
object |
||
| Image |
array<object> |
Kumpulan informasi gambar. |
|
|
array<object> |
Informasi gambar. |
||
| CreationTime |
string |
Waktu pembuatan gambar. Waktu mengikuti standar ISO 8601 dalam UTC. |
2019-11-15T06:07:05Z |
| Status |
string |
Status gambar. Nilai valid:
|
Available |
| ImageFamily |
string |
Nama family gambar. |
hangzhou-daily-update |
| Progress |
string |
Progres pembuatan gambar, dalam persentase. |
100% |
| IsCopied |
boolean |
Apakah gambar merupakan salinan dari gambar lain. |
false |
| IsSupportIoOptimized |
boolean |
Apakah gambar dapat digunakan pada instans yang dioptimalkan I/O. |
true |
| ImageOwnerAlias |
string |
Sumber gambar. Nilai valid:
|
self |
| IsSupportCloudinit |
boolean |
Apakah cloud-init didukung. |
true |
| ImageVersion |
string |
Versi gambar. |
2 |
| Usage |
string |
Tipe resource yang mereferensikan gambar. Nilai valid:
|
none |
| IsSelfShared |
string |
Apakah gambar kustom telah dibagikan ke pengguna lain. |
true |
| Description |
string |
Deskripsi gambar. |
Log arsip untuk Oracle |
| Size |
integer |
Ukuran gambar. Unit: GiB. Penting
Jika gambar berisi disk data, parameter ini hanya menunjukkan ukuran snapshot disk sistem yang terkait dengan gambar.
|
60 |
| ResourceGroupId |
string |
ID kelompok sumber daya tempat gambar berada. |
rg-bp67acfmxazb4p**** |
| Platform |
string |
Platform sistem operasi. |
Windows Server 2016 |
| OSNameEn |
string |
Nama bahasa Inggris sistem operasi. |
Windows Server 2016 Data Center Edition 64bit Chinese Edition |
| ImageName |
string |
Nama gambar. |
testImageName |
| OSName |
string |
Nama bahasa Tionghoa sistem operasi. |
Windows Server 2016 Datacenter 64-bit |
| ImageId |
string |
ID image. |
m-bp1g7004ksh0oeuc**** |
| OSType |
string |
Tipe sistem operasi. Nilai valid:
|
windows |
| IsSubscribed |
boolean |
Apakah Anda telah berlangganan ketentuan layanan untuk gambar Alibaba Cloud Marketplace yang terkait dengan kode produk. |
false |
| ProductCode |
string |
Kode produk gambar Alibaba Cloud Marketplace. |
test000**** |
| Architecture |
string |
Tipe arsitektur sistem gambar. Nilai valid:
|
x86_64 |
| BootMode |
string |
Mode boot gambar. Nilai valid:
Untuk informasi selengkapnya tentang mode boot gambar, lihat Mode boot gambar. |
BIOS |
| DiskDeviceMappings |
object |
||
| DiskDeviceMapping |
array<object> |
Kumpulan hubungan pemetaan disk ke snapshot dalam gambar. |
|
|
object |
Hubungan pemetaan disk ke snapshot dalam gambar. |
||
| Type |
string |
Tipe gambar. |
system |
| ImportOSSBucket |
string |
Bucket OSS yang berisi gambar yang diimpor. |
testEcsImport |
| Progress |
string |
Progres tugas penyalinan gambar untuk gambar yang sedang disalin. |
32% |
| SnapshotId |
string |
ID snapshot. |
s-bp17ot2q7x72ggtw**** |
| ImportOSSObject |
string |
Objek OSS yang berisi gambar yang diimpor. |
imageImport |
| Device |
string |
Nama perangkat disk, seperti /dev/xvdb. |
/dev/xvda |
| Size |
string |
Ukuran disk. Unit: GiB. |
60 |
| RemainTime |
integer |
Sisa waktu tugas penyalinan gambar untuk gambar yang sedang disalin. Unit: detik. |
233 |
| Format |
string |
Format gambar. |
qcow2 |
| Encrypted |
boolean |
Apakah gambar dienkripsi. |
true |
| Tags |
object |
||
| Tag |
array<object> |
Daftar pasangan kunci tag dan nilai tag gambar. |
|
|
object |
Pasangan kunci tag dan nilai tag gambar. |
||
| TagValue |
string |
Nilai tag gambar. |
Oracle |
| TagKey |
string |
Kunci tag gambar. |
DTS |
| IsPublic |
boolean |
Apakah gambar bersifat publik. Gambar publik mencakup gambar publik yang disediakan oleh Alibaba Cloud dan gambar kustom yang Anda terbitkan sebagai gambar komunitas. Nilai valid:
|
false |
| ImageOwnerId |
integer |
ID akun Alibaba Cloud tempat gambar berada. Parameter ini hanya berlaku saat Anda mengkueri gambar bersama atau gambar komunitas. |
1234567890 |
| LoginAsNonRootSupported |
boolean |
Apakah gambar mendukung masuk sebagai pengguna non-root. Nilai valid:
|
false |
| SupplierName |
string |
Nama perusahaan yang terverifikasi untuk gambar komunitas. |
TestName |
| DetectionOptions |
object |
Hasil deteksi gambar. |
|
| Status |
string |
Status tugas deteksi gambar. Nilai valid:
|
Processing |
| Items |
object |
||
| Item |
array<object> |
Daftar item deteksi gambar. |
|
|
object |
Item deteksi gambar. |
||
| Name |
string |
Nama item deteksi gambar. |
Nvme |
| Value |
string |
Hasil item deteksi gambar. |
Supported |
| RiskLevel |
string |
Tingkat risiko item deteksi gambar kustom yang diimpor. Bidang ini hanya dikembalikan ketika terdapat risiko. Nilai valid:
|
High |
| RiskCode |
string |
Cacat potensial item deteksi. |
NVMe.NotInstalled |
| Features |
object |
Properti terkait fitur gambar. |
|
| NvmeSupport |
string |
Apakah gambar mendukung NVMe. Nilai valid:
|
supported |
| ImdsSupport |
string |
Mode akses metadata gambar. Nilai valid:
|
v2 |
| CpuOnlineUpgrade |
string |
Apakah peningkatan CPU daring didukung. Nilai valid:
|
supported |
| CpuOnlineDowngrade |
string |
Apakah CPU daring mendukung menurunkan spesifikasi. Nilai valid:
|
supported |
| MemoryOnlineUpgrade |
string |
Apakah peningkatan memori daring didukung. Nilai valid:
|
unsupported |
| MemoryOnlineDowngrade |
string |
Apakah memori daring mendukung menurunkan spesifikasi. Nilai valid:
|
unsupported |
| LicenseType |
string |
Tipe lisensi. Properti ini menentukan metode penagihan dan logika aktivasi untuk instans ECS yang dibuat dari gambar ini. Properti ini hanya bermakna untuk gambar Server Windows. Nilai valid:
|
BYOL |
| Usable |
boolean |
Apakah gambar dapat digunakan. Nilai valid:
|
true |
| SecureBootOptions |
object |
Parameter terkait Secure Boot. |
|
| SecureBootSupport |
string |
Apakah gambar mendukung Secure Boot. Nilai valid:
|
supported |
Contoh
Respons sukses
JSONformat
{
"PageSize": 1,
"PageNumber": 1,
"RequestId": "66189103-EDB2-43E2-BB60-BFF2B62F4EB8",
"TotalCount": 1,
"RegionId": "cn-hangzhou",
"Images": {
"Image": [
{
"CreationTime": "2019-11-15T06:07:05Z",
"Status": "Available",
"ImageFamily": "hangzhou-daily-update",
"Progress": "100%",
"IsCopied": false,
"IsSupportIoOptimized": true,
"ImageOwnerAlias": "self",
"IsSupportCloudinit": true,
"ImageVersion": "2",
"Usage": "none",
"IsSelfShared": "true",
"Description": "Archive log for Oracle",
"Size": 60,
"ResourceGroupId": "rg-bp67acfmxazb4p****",
"Platform": "Windows Server 2016",
"OSNameEn": "Windows Server 2016 Data Center Edisi 64bit Chinese Edisi",
"ImageName": "testImageName",
"OSName": "Windows Server 2016 Datacenter 64-bit Chinese Edisi",
"ImageId": "m-bp1g7004ksh0oeuc****",
"OSType": "windows",
"IsSubscribed": false,
"ProductCode": "test000****",
"Architecture": "x86_64",
"BootMode": "BIOS",
"DiskDeviceMappings": {
"DiskDeviceMapping": [
{
"Type": "system",
"ImportOSSBucket": "testEcsImport",
"Progress": "32%",
"SnapshotId": "s-bp17ot2q7x72ggtw****",
"ImportOSSObject": "imageImport",
"Device": "/dev/xvda",
"Size": "60",
"RemainTime": 233,
"Format": "qcow2",
"Encrypted": true
}
]
},
"Tags": {
"Tag": [
{
"TagValue": "Oracle",
"TagKey": "DTS"
}
]
},
"IsPublic": false,
"ImageOwnerId": 1234567890,
"LoginAsNonRootSupported": false,
"SupplierName": "TestName",
"DetectionOptions": {
"Status": "Processing",
"Items": {
"Item": [
{
"Name": "Nvme",
"Value": "Supported",
"RiskLevel": "High",
"RiskCode": "NVMe.NotInstalled"
}
]
}
},
"Features": {
"NvmeSupport": "supported",
"ImdsSupport": "v2",
"CpuOnlineUpgrade": "supported",
"CpuOnlineDowngrade": "supported",
"MemoryOnlineUpgrade": "unsupported",
"MemoryOnlineDowngrade": "unsupported"
},
"LicenseType": "BYOL",
"Usable": true,
"SecureBootOptions": {
"SecureBootSupport": "supported"
}
}
]
}
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidImageOwnerAlias.ValueNotSupported | The specified ImageOwnerAlias value is not supported. | Alias pemilik image yang ditentukan tidak valid. Periksa apakah parameter sudah benar. |
| 400 | InvalidParamter | Invalid Parameter. | Permintaan berisi parameter yang tidak valid. |
| 400 | InvalidTag.Mismatch | The specified Tag.n.Key and Tag.n.Value are not match. | Tag.N.Key dan Tag.N.Value yang ditentukan tidak cocok. |
| 400 | InvalidTagCount | The specified tags are beyond the permitted range. | Tag yang ditentukan berada di luar rentang valid. |
| 400 | InvalidInstanceType.ValueNotSupported | The specified instance type %s does not exist. You can use the DescribeInstanceTypes API to query the available instance types. | Tipe instans yang ditentukan tidak valid karena berada di luar rentang yang tersedia. |
| 400 | InvalidFilterValue.NetworkType | The specified networkType value in the Filter is invalid. | Nilai jenis jaringan yang ditentukan dalam filter tidak valid. |
| 400 | InvalidOperation.ImageOwnerIdUnsupported | The parameter "ImageOwnerId" is not supported in this context, it is only valid when querying shared images or community images. | Parameter ImageOwnerId tidak didukung di sini. Parameter ini hanya valid saat Anda mengkueri gambar bersama atau gambar komunitas. |
| 400 | InvalidImageOwnerAlias.PublicImageUnsupported | When querying images, the parameter ImageOwnerAlias should be others while specified parameter IsPublic is true. | Jika parameter IsPublic diatur ke true untuk kueri image, parameter ImageOwnerAlias harus diatur ke others. |
| 400 | MissingParameter.Status | The specified parameter Status is not supplied. | Parameter Status tidak boleh kosong. |
| 500 | InternalError | The request processing has failed due to some unknown error. | |
| 403 | CurrentAccount.NotSupportPublicImage | Public image is not supported for current account. | Pengguna saat ini tidak diizinkan menggunakan gambar publik. |
| 404 | InvalidFilterKey.NotFound | The specified Filter Key is not found. | Parameter pengatur waktu mulai atau pengatur waktu kedaluwarsa yang ditentukan tidak valid. |
| 404 | InvalidFilterValue | The specified Filter Value is not valid. | Format waktu yang Anda masukkan tidak valid. |
| 404 | InvalidUsage | The specified Usage is not valid. | Tipe Sumber daya yang ditentukan dengan hubungan referensi (image, disk, image_disk, atau none) tidak valid. |
| 404 | InvalidOSType | The specified OSType is not valid. | Sistem operasi yang ditentukan tidak didukung. |
| 404 | InvalidArchitecture | The specified Architecture is not valid. | Arsitektur yang ditentukan tidak ada. |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.