Picu eksekusi job dengan ExecJob API - Serverless App Engine - Alibaba Cloud - Serverless App Engine

Menjalankan 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

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 yang dapat disesuaikan untuk memastikan idempotensi. Sistem hanya membuat satu pekerjaan untuk permintaan yang memiliki ID event yang sama.	custom
Command	string	No	Perintah startup, yang harus berupa file yang dapat dieksekusi dan ada di kontainer. Contoh: `command: - echo - abc - > - file0` Berdasarkan contoh ini, `Command` adalah `echo` dan `CommandArgs` adalah `["abc", ">", "file0"]`.	echo
CommandArgs	string	No	Argumen untuk parameter Command. Nilai harus berupa string yang merepresentasikan array JSON. Format: `["a","b"]` Pada contoh sebelumnya untuk parameter `Command`, `CommandArgs` adalah `["abc", ">", "file0"]`. Array JSON `["abc", ">", "file0"]` harus dikonversi menjadi string. Parameter ini bersifat opsional.	["a","b"]
Envs	string	No	Variabel lingkungan kontainer. Anda dapat menentukan variabel lingkungan kustom atau mereferensikan ConfigMap yang sudah ada. Untuk informasi selengkapnya tentang pembuatan ConfigMap, lihat CreateConfigMap. Konfigurasi kustom name: Nama variabel lingkungan. value: Nilai variabel lingkungan. Mereferensikan ConfigMap name: Nama variabel lingkungan. Anda dapat mereferensikan satu kunci atau semua kunci. Untuk mereferensikan semua kunci, gunakan format `sae-sys-configmap-all-<nama ConfigMap>`. Contoh: `sae-sys-configmap-all-test1`. valueFrom: Sumber variabel lingkungan. Atur nilai menjadi `configMapRef`. configMapId: ID ConfigMap. key: Kunci yang ingin Anda referensikan. Jika ingin mereferensikan semua pasangan kunci-nilai, jangan tentukan parameter ini.	[{"name":"envtmp","value":"0"}]
JarStartOptions	string	No	Opsi untuk memulai pekerjaan yang diterapkan dari paket JAR. Perintah startup default adalah: `$JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArg`.	-Xms4G -Xmx4G
JarStartArgs	string	No	Argumen untuk memulai pekerjaan yang diterapkan dari paket JAR. Perintah startup default adalah: `$JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs`.	custom-args
WarStartOptions	string	No	Perintah startup untuk pekerjaan yang diterapkan dari paket WAR. Konfigurasi sama dengan penerapan berbasis image. Untuk informasi selengkapnya, lihat Configure a startup command.	CATALINA_OPTS=\"$CATALINA_OPTS $Options\" catalina.sh run
Time	string	No	Pengatur waktu untuk Pemicu pekerjaan, ditentukan dalam 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	The returned data.
RequestId	string	The request ID.	67DD9A98-9CCC-5BE8-8C9E-B45E72F4****
Message	string	The returned message. If the request is successful, success is returned. If the request fails, an error code is returned.	success
TraceId	string	The trace ID for retrieving detailed information about the call.	0b87b7e716575071334387401e****
Data	object	The returned data.
Data	string	The job ID.	manual-3db7a8fa-5d40-4edc-92e4-49d50eab****
Msg	string	The returned message. If the request is successful, success is returned. If the request fails, an error code is returned.	success
Success	string	Whether the job was successfully executed. true: The execution was successful. false: The execution failed.	true
Code	string	The HTTP status code or a POP error code. 2xx: Success. 3xx: Redirection. 4xx: Request error. 5xx: Server error.	200
ErrorCode	string	The error code. This parameter is omitted for successful requests. This parameter is included for failed requests. For more information, see the Error codes section of this topic.
Code	string	The HTTP status code or a POP error code. 2xx: Success. 3xx: Redirection. 4xx: Request error. 5xx: Server error.	200
Success	boolean	Indicates whether the request was successful. true: The request was successful. false: The request failed.	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
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.