All Products
Search
Document Center

Serverless App Engine:ListApplications

Last Updated:Jul 10, 2026

Mengambil daftar aplikasi.

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

sae:ListApplications

get

*All Resource

*

None None

Sintaks permintaan

GET /pop/v1/sam/app/listApplications HTTP/1.1

Parameter permintaan

Parameter

Type

Required

Description

Example

CurrentPage

integer

No

Nomor halaman saat ini.

1

PageSize

integer

No

Jumlah entri per halaman dalam kueri berhalaman. Nilai valid: [0,10000].

20

AppName

string

No

Nama aplikasi.

demo-app

NamespaceId

string

No

ID namespace.

cn-beijing:demo

Tags

string

No

Pasangan kunci-nilai tag. Nilai valid:

  • key: kunci tag. Panjang harus berada dalam rentang [1,128].

  • value: nilai tag. Panjang harus berada dalam rentang [1,128].

Tag peka terhadap huruf besar/kecil. Jika Anda menentukan beberapa tag, semua tag yang ditentukan akan dibuat dan dilampirkan ke Sumber daya. Setiap kunci tag pada Sumber daya yang sama hanya dapat memiliki satu nilai tag. Jika Anda menambahkan kunci tag yang sudah ada, nilai tag yang sesuai diperbarui ke nilai baru.

Tag tidak boleh dimulai dengan aliyun atau acs:, dan tidak boleh berisi http:// atau https://.

[{"key":"key","value":"value"}]

OrderBy

string

No

Bidang untuk mengurutkan aplikasi. Nilai valid:

  • runnings: mengurutkan berdasarkan jumlah target instans saat ini.

  • instances: mengurutkan berdasarkan jumlah target instans.

runnings

Reverse

boolean

No

Apakah akan mengurutkan instans aplikasi berdasarkan status Berjalan. Jika instans memiliki status yang sama, instans diurutkan berdasarkan ID instans. Nilai valid:

  • true: mengurutkan dalam urutan menaik. Instans diatur berdasarkan urutan startup. Misalnya, untuk mencapai status Berjalan, instans harus melalui langkah-langkah seperti memulai kontainer, menarik image, dan menginisialisasi instans.

  • false: mengurutkan dalam urutan menurun.

Urutan menaik instans adalah sebagai berikut:

  1. Error: terjadi kesalahan selama startup instans.

  2. CrashLoopBackOff: kontainer gagal dimulai, mengalami kesalahan selama startup, dan mengalami kesalahan lagi setelah restart.

  3. ErrImagePull: terjadi kesalahan saat menarik gambar kontainer untuk instans.

  4. ImagePullBackOff: gambar kontainer tidak dapat diperoleh.

  5. Pending: instans menunggu dijadwalkan.

  6. Unknown: terjadi pengecualian yang tidak diketahui.

  7. Terminating: instans sedang dihentikan.

  8. NotFound: instans tidak dapat ditemukan.

  9. PodInitializing: instans sedang diinisialisasi.

  10. Init:0/1: instans sedang menginisialisasi.

  11. Running: instans sedang Berjalan.

true

FieldType

string

No

Dimensi untuk memfilter aplikasi. Nilai valid:

  • appName: nama aplikasi.

  • appIds: ID aplikasi.

  • slbIps: alamat IP SLB.

  • instanceIps: alamat IP instans.

appName

FieldValue

string

No

Nama aplikasi, ID aplikasi, alamat IP SLB, atau alamat IP instans dari aplikasi target.

demo-app

AppSource

string

No

Tipe aplikasi Serverless App Engine (SAE).

  • micro_service.

  • web.

  • job.

micro_service

IsStateful

string

No

Apakah aplikasi bersifat stateful.

NewSaeVersion

string

No

Versi aplikasi. Nilai valid:

  • lite: Edisi Lite

  • std: Edisi Standar

  • pro: Edisi Profesional

Elemen respons

Element

Type

Description

Example

object

Data tanggapan.

Message

string

Informasi tambahan tentang hasil panggilan.

success

RequestId

string

ID permintaan.

B4D805CA-926D-41B1-8E63-7AD0C1ED****

Data

object

Daftar aplikasi.

CurrentPage

integer

Nomor halaman saat ini.

1

TotalSize

integer

Jumlah total aplikasi.

2

PageSize

integer

Ukuran halaman.

20

Applications

array<object>

Daftar aplikasi.

array<object>

Informasi daftar aplikasi.

AppName

string

Nama aplikasi.

demo-app

NamespaceId

string

ID namespace.

cn-beijing:demo

AppDeletingStatus

boolean

Menunjukkan apakah aplikasi sedang dihapus. Nilai yang valid:

  • true: Aplikasi sedang dihapus.

  • false: Aplikasi tidak sedang dihapus.

false

AppId

string

ID aplikasi.

f7730764-d88f-4b9a-8d8e-cd8efbfe****

Tags

array<object>

Larik tag yang ditetapkan untuk aplikasi.

object

Detail sebuah tag.

Key

string

Kunci tag.

key

Value

string

Nilai tag.

value

RunningInstances

integer

Jumlah instans yang berjalan.

2

Instances

integer

Jumlah instans aplikasi yang dikonfigurasi.

2

RegionId

string

ID wilayah tempat aplikasi di-deploy.

cn-beijing

AppDescription

string

Deskripsi aplikasi.

description

Cpu

integer

CPU yang dialokasikan untuk setiap instans, diukur dalam millicore. Nilai ini tidak boleh 0. Nilai yang valid:

  • 500

  • 1000

  • 2000

  • 4000

  • 8000

  • 16000

  • 32000

1000

Mem

integer

Memori yang dialokasikan untuk setiap instans, diukur dalam megabyte (MB). Nilai ini tidak boleh 0 dan harus kompatibel dengan alokasi CPU. Opsi berikut tersedia:

  • 1024: Untuk alokasi CPU sebesar 500 atau 1.000 millicore.

  • 2048: Untuk alokasi CPU sebesar 500, 1.000, atau 2.000 millicore.

  • 4096: Untuk alokasi CPU sebesar 1.000, 2.000, atau 4.000 millicore.

  • 8192: Untuk alokasi CPU sebesar 2.000, 4.000, atau 8.000 millicore.

  • 12288: Untuk alokasi CPU sebesar 12.000 millicore.

  • 16384: Untuk alokasi CPU sebesar 4.000, 8.000, atau 16.000 millicore.

  • 24576: Untuk alokasi CPU sebesar 12.000 millicore.

  • 32768: Untuk alokasi CPU sebesar 16.000 millicore.

  • 65536: Untuk alokasi CPU sebesar 8.000, 16.000, atau 32.000 millicore.

  • 131072: Untuk alokasi CPU sebesar 32.000 millicore.

1024

MseEnabled

boolean

Menunjukkan apakah Microservices Engine (MSE) diaktifkan untuk aplikasi.

true

MseNamespaceId

string

ID namespace MSE. Nilai ini menentukan edisi layanan.

  • default: Edisi Free

  • sae-pro: Edisi Professional

  • sae-ent: Edisi Enterprise

sae-ent

BaseAppId

string

ID aplikasi dasar. Parameter ini hanya dikembalikan untuk aplikasi canary release.

xxx-xxx-xx-xxx

ProgrammingLanguage

string

Bahasa pemrograman aplikasi.

java

Children

array<object>

Larik aplikasi canary release yang terkait dengan aplikasi ini.

array<object>

Detail sebuah aplikasi canary release.

AppName

string

Nama aplikasi canary release.

app1

NamespaceId

string

ID namespace.

cn-beijing:demo

AppDeletingStatus

boolean

Menunjukkan apakah aplikasi canary release sedang dihapus.

false

AppId

string

ID aplikasi canary release.

xxx-xxx-xxx-xxx

ScaleRuleEnabled

boolean

Menunjukkan apakah kebijakan auto scaling diaktifkan.

false

ScaleRuleType

string

Jenis kebijakan auto scaling.

timing

Tags

array<object>

Larik tag yang ditetapkan untuk aplikasi canary release.

object

Detail sebuah objek tag.

Key

string

Kunci tag.

key

Value

string

Nilai tag.

value

RunningInstances

integer

Jumlah instans yang berjalan.

2

Instances

integer

Jumlah instans yang dikonfigurasi untuk aplikasi canary release.

2

RegionId

string

ID wilayah.

cn-beijing

AppDescription

string

Deskripsi aplikasi.

Test application

Cpu

integer

Spesifikasi CPU.

2000

Mem

integer

Spesifikasi memori.

2048

MseEnabled

boolean

Menunjukkan apakah Microservices Engine (MSE) diaktifkan untuk aplikasi.

true

BaseAppId

string

ID aplikasi dasar.

ee99cce6-1c8e-4bfa-96c3-3e2fa9******

ProgrammingLanguage

string

Bahasa pemrograman aplikasi.

java

AppType

string

Metode deployment aplikasi.

Image

NamespaceName

string

Nama namespace.

demo

IsStateful

boolean

Menunjukkan apakah aplikasi canary release bersifat stateful.

NewSaeVersion

string

Edisi aplikasi:

  • lite: Lite

  • std: Standard

  • pro: Pro

pro

ResourceType

string

Jenis sumber daya.

EnableIdle

string

Menunjukkan apakah aplikasi dikonfigurasi untuk berhenti secara otomatis saat idle.

ImageUrl

string

URL image kontainer.

registry.cn-hangzhou.aliyuncs.com/sae-serverless-demo/sae-demo:microservice-java-provider-v1.0

PackageUrl

string

URL paket deployment aplikasi.

https://sae-oss-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/apps/K8S_APP_ID/1421801774382676/adf2624a-66fd-4a2b-8caa-6921da******/hello-sae.jar

AppType

string

Metode deployment aplikasi.

Image

NamespaceName

string

Nama namespace.

demo

IsStateful

boolean

Menunjukkan apakah aplikasi bersifat stateful.

NewSaeVersion

string

Edisi aplikasi:

  • lite: Lite

  • std: Standard

  • pro: Pro

pro

EnableIdle

string

Menunjukkan apakah aplikasi dikonfigurasi untuk berhenti secara otomatis saat idle.

false

DiskSize

integer

Ukuran disk dalam GB.

20

VpcId

string

ID VPC.

ResourceType

string

Jenis sumber daya.

Labels

object

Label aplikasi.

string

RaspEnabled

boolean

ErrorCode

string

Kode kesalahan. Nilai valid:

  • Jika permintaan berhasil, bidang ErrorCode tidak dikembalikan.

  • Jika permintaan gagal, bidang ErrorCode dikembalikan. Untuk informasi lebih lanjut, lihat bagian Kode kesalahan dalam topik ini.

Code

string

Status API atau kode kesalahan POP. Nilai valid:

  • 2xx: Sukses.

  • 3xx: Pengalihan.

  • 4xx: Kesalahan permintaan.

  • 5xx: Kesalahan server.

200

Success

boolean

Menunjukkan apakah daftar aplikasi berhasil diambil. Nilai valid:

  • true: Berhasil diambil.

  • false: Gagal diambil.

true

CurrentPage

integer

Nomor halaman saat ini.

1

TotalSize

integer

Jumlah total aplikasi.

2

PageSize

integer

Ukuran halaman.

20

Contoh

Respons sukses

JSONformat

{
  "Message": "success",
  "RequestId": "B4D805CA-926D-41B1-8E63-7AD0C1ED****",
  "Data": {
    "CurrentPage": 1,
    "TotalSize": 2,
    "PageSize": 20,
    "Applications": [
      {
        "AppName": "demo-app",
        "NamespaceId": "cn-beijing:demo",
        "AppDeletingStatus": false,
        "AppId": "f7730764-d88f-4b9a-8d8e-cd8efbfe****",
        "Tags": [
          {
            "Key": "key",
            "Value": "value"
          }
        ],
        "RunningInstances": 2,
        "Instances": 2,
        "RegionId": "cn-beijing",
        "AppDescription": "description",
        "Cpu": 1000,
        "Mem": 1024,
        "MseEnabled": true,
        "MseNamespaceId": "sae-ent",
        "BaseAppId": "xxx-xxx-xx-xxx",
        "ProgrammingLanguage": "java",
        "Children": [
          {
            "AppName": "app1",
            "NamespaceId": "cn-beijing:demo",
            "AppDeletingStatus": false,
            "AppId": "xxx-xxx-xxx-xxx",
            "ScaleRuleEnabled": false,
            "ScaleRuleType": "timing",
            "Tags": [
              {
                "Key": "key",
                "Value": "value"
              }
            ],
            "RunningInstances": 2,
            "Instances": 2,
            "RegionId": "cn-beijing",
            "AppDescription": "Test application",
            "Cpu": 2000,
            "Mem": 2048,
            "MseEnabled": true,
            "BaseAppId": " ee99cce6-1c8e-4bfa-96c3-3e2fa9******",
            "ProgrammingLanguage": "java",
            "AppType": "Image",
            "NamespaceName": "demo",
            "IsStateful": false,
            "NewSaeVersion": "pro",
            "ResourceType": "",
            "EnableIdle": ""
          }
        ],
        "ImageUrl": "registry.cn-hangzhou.aliyuncs.com/sae-serverless-demo/sae-demo:microservice-java-provider-v1.0",
        "PackageUrl": "https://sae-oss-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/apps/K8S_APP_ID/1421801774382676/adf2624a-66fd-4a2b-8caa-6921da******/hello-sae.jar",
        "AppType": "Image",
        "NamespaceName": "demo",
        "IsStateful": false,
        "NewSaeVersion": "pro",
        "EnableIdle": "false",
        "DiskSize": 20,
        "VpcId": "",
        "ResourceType": "",
        "Labels": {
          "key": ""
        },
        "RaspEnabled": false
      }
    ]
  },
  "ErrorCode": "",
  "Code": "200",
  "Success": true,
  "CurrentPage": 1,
  "TotalSize": 2,
  "PageSize": 20
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 Illegal.argument Illegal argument

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.