All Products
Search
Document Center

Serverless App Engine:ExecJob

Last Updated:Mar 17, 2026

Menjalankan sebuah Pekerjaan.

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

*全部资源

*

None None

Sintaks permintaan

GET /pop/v1/sam/job/execJob HTTP/1.1

Parameter permintaan

Parameter

Type

Required

Description

Example

AppId

string

Yes

ID templat Pekerjaan.

ee1a7a07-abcb-4652-a1d3-2d57f415****

EventId

string

No

ID event. Ini adalah parameter yang ditentukan pengguna untuk idempotensi sehingga hanya satu Pekerjaan yang dibuat untuk ID event yang sama.

custom

Command

string

No

Perintah yang digunakan untuk menjalankan image. Perintah tersebut harus merupakan objek executable yang sudah ada di dalam Kontainer. Contoh:

command:
      - echo
      - abc
      - >
      - file0

Pada contoh ini, parameter Command diatur menjadi Command="echo", CommandArgs=["abc", ">", "file0"].

echo

CommandArgs

string

No

Parameter perintah startup image. Parameter CommandArgs menentukan parameter yang diperlukan untuk parameter Command. Nama harus memenuhi persyaratan format berikut:

["a","b"]

Pada contoh sebelumnya, parameter CommandArgs diatur menjadi CommandArgs=["abc", ">", "file0"]. Tipe data dari ["abc", ">", "file0"] harus berupa array string dalam format JSON. Parameter ini bersifat opsional.

["a","b"]

Envs

string

No

Variabel lingkungan. Anda dapat mengonfigurasi variabel lingkungan kustom atau mereferensikan ConfigMap. Jika ingin mereferensikan ConfigMap, Anda harus terlebih dahulu membuat ConfigMap. Untuk informasi selengkapnya, lihat CreateConfigMap. Nilai yang valid:

  • Mengonfigurasi variabel lingkungan kustom

    • name: nama variabel lingkungan.

    • value: nilai variabel lingkungan.

  • Referensi ConfigMap

    • name: nama variabel lingkungan. Anda dapat mereferensikan satu atau semua kunci. Jika ingin mereferensikan semua kunci, tentukan sae-sys-configmap-all-<ConfigMap name>. Contoh: sae-sys-configmap-all-test1.

    • valueFrom: referensi variabel lingkungan. Atur nilainya ke configMapRef.

    • configMapId: ID ConfigMap.

    • key: kunci. Jika ingin mereferensikan semua kunci, jangan konfigurasi parameter ini.

[{"name":"envtmp","value":"0"}]

JarStartOptions

string

No

Pengaturan opsi dalam paket JAR. Pengaturan ini digunakan untuk menjalankan Pekerjaan. Perintah startup default adalah $JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArg.

-Xms4G -Xmx4G

JarStartArgs

string

No

Argumen dalam paket JAR. Argumen ini digunakan untuk menjalankan Pekerjaan. Perintah startup default adalah $JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs.

custom-args

WarStartOptions

string

No

Perintah startup paket WAR. Untuk informasi tentang cara mengonfigurasi perintah startup, lihat Configure a startup command.

CATALINA_OPTS=\"$CATALINA_OPTS $Options\" catalina.sh run

Time

string

No

Waktu pemicu Pekerjaan. Format: yyyy-MM-dd'T'HH:mm:ss'Z'.

2023-09-14T14:25:02Z

Replicas

string

No

Jumlah Instans konkuren.

3

Elemen respons

Element

Type

Description

Example

object

Respons.

RequestId

string

ID permintaan.

67DD9A98-9CCC-5BE8-8C9E-B45E72F4****

Message

string

Pesan yang dikembalikan. Nilai yang valid:

  • success: Jika pemanggilan berhasil, success dikembalikan.

  • Kode kesalahan: Jika pemanggilan gagal, kode kesalahan dikembalikan.

success

TraceId

string

ID jejak. Parameter ini digunakan untuk mengkueri informasi panggilan secara tepat.

0b87b7e716575071334387401e****

Data

object

Data yang dikembalikan.

Data

string

ID Pekerjaan.

manual-3db7a8fa-5d40-4edc-92e4-49d50eab****

Msg

string

Pesan yang dikembalikan. Nilai yang valid:

  • success: Jika pemanggilan berhasil, success dikembalikan.

  • Kode kesalahan: Jika pemanggilan gagal, kode kesalahan dikembalikan.

success

Success

string

Menunjukkan apakah permintaan berhasil. Nilai yang valid:

  • true

  • false

true

Code

string

Kode status HTTP. Nilai yang valid:

  • 2xx: Pemanggilan berhasil.

  • 3xx: Pemanggilan dialihkan.

  • 4xx: Pemanggilan gagal.

  • 5xx: Terjadi kesalahan server.

200

ErrorCode

string

Kode kesalahan. Nilai yang valid:

  • Jika pemanggilan berhasil, parameter ErrorCode tidak dikembalikan.

  • Jika pemanggilan gagal, parameter ErrorCode dikembalikan. Untuk informasi selengkapnya, lihat bagian Error codes dalam topik ini.

Code

string

Kode status HTTP. Nilai yang valid:

  • 2xx: Pemanggilan berhasil.

  • 3xx: Pemanggilan dialihkan.

  • 4xx: Pemanggilan gagal.

  • 5xx: Terjadi kesalahan server.

200

Success

boolean

Menunjukkan apakah permintaan berhasil. Nilai yang valid:

  • true

  • false

true

Contoh

Respons sukses

JSONformat

{
  "RequestId": "67DD9A98-9CCC-5BE8-8C9E-B45E72F4****",
  "Message": "success",
  "TraceId": "0b87b7e716575071334387401e****",
  "Data": {
    "Data": "manual-3db7a8fa-5d40-4edc-92e4-49d50eab****",
    "Msg": "success",
    "Success": "true",
    "Code": "200"
  },
  "ErrorCode": "空",
  "Code": "200",
  "Success": true
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidApplication.NotFound The current application does not exist.
400 JobForbidPolicy You cannot execute new jobs because ongoing jobs exist.
400 JobSuspend The job is suspended.
400 user.indebt The user has an outstanding payment.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.