Gunakan ListCustomImages untuk kueri image kustom - Simple Application Server - Alibaba Cloud - Simple Application Server

Mengkueri informasi tentang satu atau beberapa gambar kustom yang telah dibuat di wilayah tertentu.

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

swas-open:ListCustomImages

get

*Gambar Kustom.

acs:swas-open:{#regionId}:{#accountId}:customimage/*

*Gambar Kustom.

acs:swas-open:{#regionId}:{#accountId}:customimage/{#CustomImageId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah server aplikasi sederhana. Anda dapat memanggil ListRegions untuk mengkueri daftar wilayah yang didukung.	cn-hangzhou
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Token klien dihasilkan dari klien Anda dan harus unik di antara berbagai permintaan. ClientToken hanya mendukung karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.	123e4567-e89b-12d3-a456-426655440000
ImageIds	string	No	ID gambar server aplikasi sederhana. Nilainya dapat berupa array JSON yang terdiri dari hingga 100 ID instans. Pisahkan beberapa ID instans dengan koma (,).	["fe9c66133a9d4688872869726b52**", "794c230fd3e64ea19f83f4d7a0ad**"]
PageSize	integer	No	Jumlah entri per halaman untuk kueri berhalaman. Nilai maksimum: 100. Nilai default: 10.	10
PageNumber	integer	No	Nomor halaman daftar snapshot. Nilai default: 1.	1
ImageNames	string	No	Nama gambar server aplikasi sederhana. Nilainya dapat berupa array JSON yang terdiri dari hingga 100 ID instans. Pisahkan beberapa ID instans dengan koma (,).	["test1**", "test2**"]
SystemSnapshotId	string	No	ID snapshot cloud disk sistem.	s-bp14m09pq8***0g6
DataSnapshotId	string	No	ID snapshot cloud disk data.	s-acscasca****
Tag	array<object>	No	Tag gambar kustom.
	object	No	Tag.
Key	string	No	Kunci tag gambar kustom. Panjang kunci tag yang valid: 1 hingga 64. Nilai N yang valid: 1 hingga 20.	TestKey
Value	string	No	Nilai tag gambar kustom. Panjang nilai tag yang valid: 1 hingga 64. Nilai N yang valid: 1 hingga 20.	TestValue
ResourceGroupId	string	No	ID kelompok sumber daya.	rg-aek2bti7cf7yj2i
Share	boolean	No	Apakah akan mengkueri gambar bersama. Nilai valid: False: Tanggapan tidak menyertakan gambar bersama. True: Hanya gambar bersama yang dikembalikan. Jika parameter ini tidak ditentukan, semua gambar dikembalikan secara default.	False
InstanceId	string	No	ID instans server aplikasi sederhana tempat gambar dibuat.	ace0706b2ac4454d984295a94213****

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	20758A-585D-4A41-A9B2-28DA8F4F534F
CustomImages	array<object>	Gambar kustom.
	array<object>	Gambar kustom.
CreationTime	string	Pengatur waktu pembuatan snapshot. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.	2022-10-09T02:28:06Z
DataSnapshotName	string	Nama snapshot cloud disk data.	DataDiskSnapshot
SystemSnapshotId	string	ID snapshot cloud disk sistem.	s-bp1h173hj21puxb***
InShare	boolean	Menunjukkan apakah gambar kustom dibagikan ke ECS.	false
InShareUser	boolean	Menunjukkan apakah gambar kustom dibagikan lintas akun.	False
InstanceId	string	ID instans server aplikasi sederhana tempat gambar dibuat.	2d06ee0520b44de1ae88d4be****
DataSnapshotId	string	ID snapshot cloud disk data.	s-bp19rn9u8eqzlfb***
RegionId	string	ID wilayah.	cn-hangzhou
SystemSnapshotName	string	Nama snapshot cloud disk sistem.	SystemDiskSnapshot
Description	string	Deskripsi.	CustomImage-1
Name	string	Nama gambar kustom.	test
ImageId	string	ID gambar kustom.	m-bp1e79zktg26n2b***
Status	string	Status gambar kustom. Nilai valid: 0: menyalin. 1: aktif. 2: tidak tersedia. 3: pembuatan gagal. 4: membuat.	1
Tags	array<object>	Tag gambar kustom.
	object	Tag.
Key	string	Kunci tag gambar kustom.	TestKey
Value	string	Nilai tag gambar kustom.	TestValue
InstanceName	string	Nama instans server aplikasi sederhana.	swas-asdf23***
ResourceGroupId	string	ID kelompok sumber daya.	rg-acfm2h2lvp3ublq
CreateInstances	array	Informasi tentang instans yang dibuat dari gambar.
	string	ID instans dari instans yang dibuat dari gambar.	9ffb716db6ae406ca78a476c0c81****
UserId	integer	ID akun Alibaba Cloud pemilik gambar.	180185828710****
OsType	string	Tipe sistem operasi gambar.	Linux
RequiredSystemDiskSize	integer	Ukuran cloud disk sistem gambar. Unit: GiB.	20
RequiredDataDiskSize	integer	Ukuran cloud disk data gambar. Unit: GiB.	20
SourceImageName	string	Nama gambar sumber.	CentOS
SourceImageVersion	string	Versi gambar dari gambar sumber.	8.0
TotalCount	string	Jumlah total entri.	4
PageSize	string	Jumlah entri per halaman dalam Pengaturan untuk kueri berhalaman.	10
PageNumber	string	Nomor halaman.	1

Contoh

Respons sukses

JSONformat

{
  "RequestId": "20758A-585D-4A41-A9B2-28DA8F4F534F",
  "CustomImages": [
    {
      "CreationTime": "2022-10-09T02:28:06Z",
      "DataSnapshotName": "数据盘快照",
      "SystemSnapshotId": "s-bp1h173hj21puxb***",
      "InShare": false,
      "InShareUser": true,
      "InstanceId": "2d06ee0520b44de1ae88d4be****",
      "DataSnapshotId": "s-bp19rn9u8eqzlfb***",
      "RegionId": "cn-hangzhou",
      "SystemSnapshotName": "系统盘快照",
      "Description": "自定义镜像-1",
      "Name": "test",
      "ImageId": "m-bp1e79zktg26n2b***",
      "Status": "1",
      "Tags": [
        {
          "Key": "TestKey",
          "Value": "TestValue"
        }
      ],
      "InstanceName": "swas-asdf23***",
      "ResourceGroupId": "rg-acfm2h2lvp3ublq",
      "CreateInstances": [
        "9ffb716db6ae406ca78a476c0c81****"
      ],
      "UserId": 0,
      "OsType": "Linux",
      "RequiredSystemDiskSize": 20,
      "RequiredDataDiskSize": 20,
      "SourceImageName": "CentOS",
      "SourceImageVersion": "8.0"
    }
  ],
  "TotalCount": "4",
  "PageSize": "10",
  "PageNumber": "1"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
500	InternalError	An error occurred while processing your request.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.