Gunakan ListEdgeContainerAppVersions API - Edge Security Acceleration

Menampilkan daftar versi semua aplikasi berbasis kontainer.

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

esa:ListEdgeContainerAppVersions

none

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
AppId	string	Yes	ID aplikasi, yang dapat diperoleh dengan memanggil operasi ListEdgeContainerApps.	app-88068867578379****
PageNumber	integer	No	Nomor halaman. Nilai yang valid: 1 hingga 65535.	1
PageSize	integer	No	Jumlah entri per halaman. Nilai yang valid: 1 hingga 100.	10
OrderKey	string	No	Bidang pengurutan. Nilai yang valid: Name: nama versi. CreateTime: waktu saat versi dibuat. UpdateTime: waktu saat versi terakhir dimodifikasi.	Name
OrderType	string	No	Urutan pengurutan hasil kueri. Nilai yang valid: ASC: secara ascending. DESC: secara descending.	Desc
SearchType	string	No	Parameter yang digunakan untuk pencarian fuzzy. Nilai yang valid: VersionId dan Name.	VersionId
SearchKey	string	No	Kata kunci yang digunakan untuk pencarian.	ver-100568263967926****

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	F61CDR30-E83C-4FDA-BF73-9A94CDD44229
PageNumber	integer	Nomor halaman.	1
PageSize	integer	Jumlah entri per halaman.	10
TotalCount	integer	Total jumlah entri.	20
Versions	array<object>	Versi-versi tersebut.
	array<object>	Detail versi.
LastPublishTime	string	Waktu saat versi terakhir dirilis. Waktu mengikuti standar ISO 8601 dalam format YYYY-MM-DDThh:mm:ss. Waktu ditampilkan dalam UTC.	2023-02-10T02:48:36Z
PublishTime	string	Waktu saat versi dirilis. Waktu mengikuti standar ISO 8601 dalam format YYYY-MM-DDThh:mm:ss. Waktu ditampilkan dalam UTC.	2023-02-10T02:48:36Z
Status	string	Status versi saat ini. Nilai yang valid: created failed creating	created
CreateTime	string	Waktu saat versi dibuat. Waktu mengikuti standar ISO 8601 dalam format YYYY-MM-DDThh:mm:ss. Waktu ditampilkan dalam UTC.	2022-11-10T02:53:16Z
AppId	string	ID aplikasi.	app-88068867578379****
VersionId	string	ID versi.	ver-87962637161651****
Name	string	Nama versi.	version01
UpdateTime	string	Waktu saat versi terakhir dimodifikasi. Waktu mengikuti standar ISO 8601 dalam format YYYY-MM-DDThh:mm:ss. Waktu ditampilkan dalam UTC.	2023-04-16 10:51:00
Remarks	string	Keterangan.	test version
Containers	array<object>	Kontainer dalam versi tersebut.
	array<object>	Kontainer dalam versi tersebut.
EnvVariables	string	Variabel lingkungan kontainer.	ENV=prod
Args	string	Argumen yang diteruskan ke perintah startup kontainer.	-c a=1
Spec	string	Spesifikasi komputasi kontainer.	1C2G
Image	string	Alamat gambar kontainer.	nginx
Command	string	Perintah yang digunakan untuk menjalankan kontainer.	openresty -g \"daemon off;\"
ProbeType	string	Jenis probe kontainer.	httpGet
Name	string	Nama kontainer.	container1
PreStop	string	Perintah yang dijalankan sebelum kontainer dihentikan.	sh prestop.sh "echo hello world"
PostStart	string	Perintah yang dijalankan sebelum kontainer dimulai. Format: `{"exec":{"command":\["cat","/etc/group"\]}}`. Jika Anda ingin membatalkan konfigurasi ini, atur nilai parameter menjadi `""` atau `{}`. Jika Anda tidak menentukan parameter ini, konfigurasi ini akan diabaikan.	sh poststart.sh "echo hello world"
ProbeContent	object	Konten probe kontainer.
SuccessThreshold	integer	Jumlah pemeriksaan kesehatan berturut-turut yang berhasil yang diperlukan agar kontainer dianggap sehat.	1
Host	string	Nama domain yang digunakan untuk pemeriksaan kesehatan.	test.com
HttpHeaders	string	Header permintaan yang disertakan dalam permintaan pemeriksaan kesehatan kontainer.	{\"Content-Type\":\"application/json\"}
Scheme	string	Protokol yang digunakan oleh permintaan pemeriksaan kesehatan kontainer.	http
InitialDelaySeconds	integer	Latensi untuk inisialisasi probe kontainer.	10
Command	string	Perintah probe.	openresty -g "daemon off;
FailureThreshold	integer	Jumlah pemeriksaan kesehatan berturut-turut yang gagal yang diperlukan agar kontainer dianggap tidak sehat.	3
TimeoutSeconds	integer	Periode timeout pemeriksaan kesehatan kontainer.	30
Path	string	Jalur pemeriksaan kesehatan kontainer.	/health_check
Port	integer	Port pemeriksaan kesehatan kontainer.	80
PeriodSeconds	integer	Interval antara pemeriksaan kesehatan kontainer.	5

Contoh

Respons sukses

JSONformat

{
  "RequestId": "F61CDR30-E83C-4FDA-BF73-9A94CDD44229",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 20,
  "Versions": [
    {
      "LastPublishTime": "2023-02-10T02:48:36Z\n",
      "PublishTime": "2023-02-10T02:48:36Z",
      "Status": "created",
      "CreateTime": "2022-11-10T02:53:16Z",
      "AppId": "app-88068867578379****",
      "VersionId": "ver-87962637161651****",
      "Name": "version01",
      "UpdateTime": "2023-04-16 10:51:00",
      "Remarks": "test version",
      "Containers": [
        {
          "EnvVariables": "ENV=prod",
          "Args": "-c a=1",
          "Spec": "1C2G",
          "Image": "nginx",
          "Command": "openresty -g \\\"daemon off;\\\"",
          "ProbeType": "httpGet",
          "Name": "container1",
          "PreStop": "sh prestop.sh \"echo hello world\" ",
          "PostStart": "sh poststart.sh \"echo hello world\" ",
          "ProbeContent": {
            "SuccessThreshold": 1,
            "Host": "test.com",
            "HttpHeaders": "{\\\"Content-Type\\\":\\\"application/json\\\"}",
            "Scheme": "http",
            "InitialDelaySeconds": 10,
            "Command": "openresty -g  \"daemon off;",
            "FailureThreshold": 3,
            "TimeoutSeconds": 30,
            "Path": "/health_check",
            "Port": 80,
            "PeriodSeconds": 5
          }
        }
      ]
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidParameter.OrderType	The specified OrderType is invalid. Please check the OrderType parameter. You may not have set it to either Asc or Desc. Please make the necessary changes and call the interface again.	The OrderType parameter is invalid. Please check the OrderType parameter. You may not have set it to Asc or Desc. Please modify it and call the interface again.
400	InvalidParameter.OrderKey	The specified OrderKey is invalid. Please check the OrderKey parameter.	The OrderKey parameter is invalid. Please check the OrderKey parameter, as it cannot be assigned illegal characters such as @, #, % etc. Please make the necessary modifications and call the interface again.
400	InvalidParameter	Invalid parameter. Check the parameter configuration.	Invalid parameter. Check the parameter configuration.
400	InvalidParameter.appid	The format of the application ID is invalid. You can call ListEdgeContainerApps to obtain the application ID.	The format of the application ID is invalid. You can call ListEdgeContainerApps to obtain the application ID.
400	InvalidPageSize.ValueNotSupported	The PageSize value is invalid. The default value is set to 20. The acceptable range is between 1 and 500.	The request PageSize value is invalid. The default value is 20 and the value range is 1-500.
500	InternalError	Failed to call the service. Try again later or contact technical support.	Failed to call the service. Try again later or contact technical support.
404	InvalidApp.NotFound	The application does not exist. Check whether the application ID you specified is correct and try again.	The application does not exist. Check whether the application ID you specified is correct and try again.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.