Operasi ini membuat templat pekerjaan.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
sae:CreateJob |
create |
*全部资源
|
None | None |
Sintaks permintaan
POST /pop/v1/sam/job/createJob HTTP/1.1
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| AppName |
string |
Yes |
Nama templat pekerjaan. Nama dapat berisi huruf, digit, dan tanda hubung (-). Harus diawali dengan huruf dan panjangnya tidak boleh melebihi 36 karakter. |
test |
| NamespaceId |
string |
No |
ID namespace SAE. Nama namespace hanya dapat berisi huruf kecil dan tanda hubung (-), serta harus diawali dengan huruf. |
cn-beijing:test |
| AppDescription |
string |
No |
Deskripsi templat pekerjaan. Panjangnya tidak boleh melebihi 1.024 karakter. |
This is a test description. |
| VpcId |
string |
No |
ID VPC untuk namespace SAE. Di SAE, sebuah namespace hanya dapat diikat ke satu VPC, dan ikatan ini tidak dapat diubah. Ikatan dibuat saat Anda membuat templat pekerjaan SAE pertama di namespace tersebut. Satu VPC dapat dikaitkan dengan beberapa namespace. Jika Anda tidak menentukan parameter ini, ID VPC yang diikat ke namespace akan digunakan secara default. |
vpc-bp1aevy8sofi8mh1q**** |
| VSwitchId |
string |
No |
ID vSwitch untuk antarmuka jaringan elastis instans tugas. vSwitch harus berada di VPC yang ditentukan. vSwitch juga diikat ke namespace SAE. Jika Anda tidak menentukan parameter ini, ID vSwitch yang diikat ke namespace akan digunakan secara default. |
vsw-bp12mw1f8k3jgygk9**** |
| PackageType |
string |
Yes |
Tipe Paket penyebaran. Nilai valid:
|
FatJar |
| PackageVersion |
string |
No |
Versi Paket penyebaran. Parameter ini wajib diisi ketika PackageType diatur ke FatJar, War, atau PythonZip. |
1.0.1 |
| PackageUrl |
string |
No |
URL Paket penyebaran. Parameter ini wajib diisi ketika PackageType diatur ke FatJar, War, atau PythonZip. |
http://myoss.oss-cn-hangzhou.aliyuncs.com/my-buc/2019-06-30/****.jar |
| ImageUrl |
string |
No |
URL image. Parameter ini wajib diisi ketika PackageType diatur ke Image. |
registry.cn-hangzhou.aliyuncs.com/sae_test/ali_sae_test:0.0.1 |
| Jdk |
string |
No |
Versi JDK yang diperlukan oleh Paket penyebaran. Versi berikut didukung:
Parameter ini tidak didukung ketika PackageType diatur ke Image. |
Open JDK 8 |
| WebContainer |
string |
No |
Versi Tomcat yang diperlukan oleh Paket penyebaran. Versi berikut didukung:
Parameter ini tidak didukung ketika PackageType diatur ke Image. |
apache-tomcat-7.0.91 |
| Cpu |
integer |
No |
CPU yang diperlukan untuk setiap Instans, dalam millicores. Nilai ini tidak boleh 0. Hanya spesifikasi tetap berikut yang saat ini didukung:
|
1000 |
| Memory |
integer |
No |
Memori yang diperlukan untuk setiap Instans, dalam MB. Nilai ini tidak boleh 0. Spesifikasi CPU dan memori digabungkan. Spesifikasi berikut saat ini didukung:
|
1024 |
| Replicas |
integer |
Yes |
Jumlah instans tugas konkuren. |
3 |
| Command |
string |
No |
Perintah entrypoint untuk kontainer. Perintah harus berupa file yang dapat dieksekusi di dalam kontainer. Contoh:
Untuk contoh sebelumnya, |
echo |
| CommandArgs |
string |
No |
Argumen untuk perintah entrypoint (Command). Formatnya adalah sebagai berikut:
Pada contoh untuk parameter |
["a","b"] |
| Envs |
string |
No |
Variabel lingkungan yang akan diatur di kontainer. Untuk mereferensikan variabel, ConfigMap harus sudah ada. Untuk informasi selengkapnya, lihat CreateConfigMap. Nilai dapat dikonfigurasi dengan salah satu cara berikut:
|
[{"name":"envtmp","value":"0"}] |
| CustomHostAlias |
string |
No |
Alias host yang memetakan hostname ke alamat IP di kontainer. Parameter dijelaskan sebagai berikut:
|
[{"hostName":"samplehost","ip":"127.0.0.1"}] |
| JarStartOptions |
string |
No |
Opsi startup untuk paket JAR. Perintah startup default adalah: |
custom-option |
| JarStartArgs |
string |
No |
Argumen startup untuk paket JAR. Perintah startup default adalah: |
-Xms4G -Xmx4G |
| EdasContainerVersion |
string |
No |
Versi lingkungan runtime HSF untuk Tugas, seperti Kontainer Ali-Tomcat. |
3.5.3 |
| Timezone |
string |
No |
Zona waktu. Nilai default: Asia/Shanghai. |
Asia/Shanghai |
| SlsConfigs |
string |
No |
Konfigurasi untuk mengumpulkan log ke Simple Log Service (SLS).
Parameter dijelaskan sebagai berikut:
Jika konfigurasi pengumpulan log tidak berubah selama Penerapan berikutnya, Anda tidak perlu mengatur parameter ini (permintaan tidak perlu menyertakan bidang SlsConfigs). Jika Anda tidak lagi perlu menggunakan fitur pengumpulan log, atur nilai parameter ini ke string kosong ("") di permintaan Anda. Catatan
SAE menghapus Proyek yang dibuat secara otomatis saat Anda menghapus Templat Pekerjaan yang sesuai. Oleh karena itu, jika Anda menentukan Proyek yang sudah ada, jangan gunakan Proyek yang dibuat secara otomatis oleh SAE. |
[{"logDir":"","logType":"stdout"},{"logDir":"/tmp/a.log"}] |
| NasId |
string |
No |
ID sistem file NAS. Jika konfigurasi ini tidak berubah dalam Penerapan berikutnya, Anda dapat mengabaikan parameter ini. Untuk menghapus konfigurasi NAS, atur parameter ini ke string kosong (""). |
10d3b4**** |
| MountHost |
string |
No |
Titik pemasangan NAS di VPC Templat Pekerjaan. Jika konfigurasi ini tidak berubah dalam Penerapan berikutnya, Anda dapat mengabaikan parameter ini. Untuk menghapus konfigurasi NAS, atur parameter ini ke string kosong (""). |
10d3b4bc9****.com |
| MountDesc |
string |
No |
Deskripsi pemasangan NAS. Jika konfigurasi ini tidak berubah dalam Penerapan berikutnya, Anda dapat mengabaikan parameter ini. Untuk menghapus konfigurasi NAS, atur parameter ini ke string kosong (""). |
[{mountPath: "/tmp", nasPath: "/"}] |
| PreStop |
string |
No |
Panggilan balik PreStop. Skrip ini berjalan segera sebelum Kontainer dihentikan. Nilai harus berupa string JSON, misalnya: |
{"exec":{"command":["sh","-c","echo hello"]}} |
| PostStart |
string |
No |
Panggilan balik PostStart. Skrip ini berjalan segera setelah Kontainer dibuat. Nilai harus berupa string JSON, misalnya: |
{"exec":{"command":["sh","-c","echo hello"]}} |
| WarStartOptions |
string |
No |
Perintah startup untuk Penerapan paket WAR. Langkah konfigurasi sama dengan Penerapan berbasis image. Untuk informasi selengkapnya, lihat Set a startup command. |
CATALINA_OPTS=\"$CATALINA_OPTS $Options\" catalina.sh run |
| ConfigMapMountDesc |
string |
No |
Deskripsi pemasangan ConfigMap. Gunakan ConfigMap yang dibuat di namespace untuk menyuntikkan konfigurasi ke kontainer. Parameter dijelaskan sebagai berikut:
Catatan
Anda dapat meneruskan parameter
|
[{"configMapId":16,"key":"test","mountPath":"/tmp"}] |
| SecurityGroupId |
string |
No |
ID grup keamanan. |
sg-wz969ngg2e49q5i4**** |
| AutoConfig |
boolean |
No |
Apakah akan mengonfigurasi lingkungan jaringan secara otomatis. Nilai valid:
|
false |
| TerminationGracePeriodSeconds |
integer |
No |
Pengatur waktu shutdown yang mulus, dalam detik. Nilai harus berupa bilangan bulat dari 1 hingga 300. Nilai default: 30. |
10 |
| PhpConfigLocation |
string |
No |
Jalur memasang file konfigurasi startup untuk Tugas PHP. Pastikan server PHP menggunakan file konfigurasi ini saat startup. |
/usr/local/etc/php/php.ini |
| PhpConfig |
string |
No |
Konten file konfigurasi PHP. |
k1=v1 |
| TomcatConfig |
string |
No |
Konfigurasi Tomcat. Untuk menghapus konfigurasi, atur parameter ini ke
|
{"port":8080,"contextPath":"/","maxThreads":400,"uriEncoding":"ISO-8859-1","useBodyEncodingForUri":true} |
| OssMountDescs |
string |
No |
Deskripsi memasang Object Storage Service (OSS). Parameter dijelaskan sebagai berikut:
|
[{"bucketName": "oss-bucket", "bucketPath": "data/user.data", "mountPath": "/usr/data/user.data", "readOnly": true}] |
| OssAkId |
string |
No |
AccessKey ID untuk membaca dari dan menulis ke OSS. |
xxxxxx |
| OssAkSecret |
string |
No |
Rahasia AccessKey untuk membaca dari dan menulis ke OSS. |
xxxxxx |
| AcrInstanceId |
string |
No |
ID instans Container Registry (ACR) Edisi Perusahaan. Parameter ini wajib diisi ketika ImageUrl mengarah ke image di instans ACR Edisi Perusahaan. |
cri-xxxxxx |
| AcrAssumeRoleArn |
string |
No |
Nama Sumber Daya Alibaba Cloud (ARN) dari Peran RAM yang diperlukan untuk menarik image lintas akun. Untuk informasi selengkapnya, lihat Memberikan izin untuk menarik image lintas akun Alibaba Cloud menggunakan Peran RAM. |
acs:ram::123456789012****:role/adminrole |
| ImagePullSecrets |
string |
No |
ID rahasia yang digunakan untuk menarik image. |
10 |
| EnableImageAccl |
boolean |
No |
Apakah akan mengaktifkan akselerasi image. Nilai valid:
|
false |
| Workload |
string |
Yes |
Beban kerja. Atur nilai ke |
job |
| TriggerConfig |
string |
No |
Konfigurasi pemicu Tugas, yang bervariasi berdasarkan tipe Tugas.
|
{"type":"time","config":"0 1 */1 * ?","timezone":"GMT+8:00"} |
| ConcurrencyPolicy |
string |
No |
Kebijakan konkurensi untuk tugas. Nilai valid:
|
Allow |
| Timeout |
integer |
No |
Pengatur waktu Tugas, dalam detik. |
3600 |
| BackoffLimit |
integer |
No |
Jumlah maksimum percobaan ulang untuk tugas sebelum ditandai sebagai gagal. |
3 |
| Slice |
boolean |
No |
Apakah akan mengaktifkan sharding tugas. |
true |
| SliceEnvs |
string |
No |
Parameter untuk sharding tugas. |
[0,1,2] |
| RefAppId |
string |
No |
ID pekerjaan yang direferensikan. |
7171a6ca-d1cd-4928-8642-7d5cfe69**** |
| ProgrammingLanguage |
string |
No |
Bahasa pemrograman. Nilai valid: java, php, python, dan shell. |
java |
| Python |
string |
No |
Lingkungan Python. PYTHON 3.9.15 didukung. |
PYTHON 3.9.15 |
| PythonModules |
string |
No |
Dependensi Python yang akan diinstal menggunakan pip. Jika Anda tidak mengatur parameter ini, SAE menginstal dependensi dari file requirements.txt di direktori root proyek Anda. |
Flask==2.0 |
| NasConfigs |
string |
No |
Konfigurasi untuk memasang sistem file NAS. |
|
| BestEffortType |
string |
No |
Kebijakan BestEffort. |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Details of the created job template. |
||
| RequestId |
string |
The request ID. |
01CF26C7-00A3-4AA6-BA76-7E95F2A3*** |
| Message |
string |
Additional information. Valid values:
|
success |
| TraceId |
string |
The call trace ID. You can use this ID to query detailed information about the call. |
ac1a0b2215622246421415014e**** |
| Data |
object |
The returned data. |
|
| ChangeOrderId |
string |
The change order ID. You can use this ID to check the execution status of the task. |
01db03d3-3ee9-48b3-b3d0-dfce2d88**** |
| AppId |
string |
The job template ID. |
7171a6ca-d1cd-4928-8642-7d5cfe69**** |
| ErrorCode |
string |
The error code.
|
|
| Code |
string |
The HTTP status code or a POP error code. Valid values:
|
200 |
| Success |
boolean |
Indicates whether the job template was created successfully. Valid values:
|
true |
Contoh
Respons sukses
JSONformat
{
"RequestId": "01CF26C7-00A3-4AA6-BA76-7E95F2A3***",
"Message": "success",
"TraceId": "ac1a0b2215622246421415014e****",
"Data": {
"ChangeOrderId": "01db03d3-3ee9-48b3-b3d0-dfce2d88****",
"AppId": "7171a6ca-d1cd-4928-8642-7d5cfe69****"
},
"ErrorCode": "",
"Code": "200",
"Success": true
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | Application.MissingJdk | Your application must at least contain a JDK component. | |
| 400 | InvalidPackageType.NotFound | The package type must be War, FatJar, or Image. | |
| 400 | InvalidParameter.FileName | The application deployment package name is invalid. This name can contain only alphanumeric characters, hyphens (-), and underscores (_). In addition, you can upload JAR files only if the selected deployment version supports JAR file. Otherwise, upload WAR files only. | |
| 400 | InvalidParameter.NotEmpty | You must specify the parameter %s. | |
| 400 | InvalidParameter.Obviously | The specified parameter is invalid {%s}. | |
| 400 | JarApplication.MissingJdk | A FatJar application must contain JDK. | |
| 400 | NoAvailableCluster.NotFound | No clusters are available for the current region. | |
| 400 | NoComputeResourceQuota.Exceed | Your compute resource is insufficient. Please contact us to raise the quota. | |
| 400 | PandoraApplication.MissingJdk | The Pandora application is missing a JDK component. | |
| 400 | PandoraApplication.OnlyJdk | A Pandora application only requires JDK component. | |
| 400 | InvalidParameter.WithMessage | The parameter is invalid {%s}: %s | |
| 400 | InvalidComponent.NotFound | The current component (such as JDK, Tomcat, or EDASWebContainer) does not exist. | |
| 400 | InvalidHostnameIp.Invalid | The hostname and/or IP is invalid: Hostname [%s], IP [%s]. | |
| 400 | InvalidInstanceSpecification.Unsupported | The instance specification is not supported: CPU [%s], memory [%s]. | |
| 400 | InvalidServerlessRegion.Unsupported | The current region is not supported: %s | |
| 400 | WarApplication.MissingJdkWebcontainer | A War application must contain JDK and Tomcat. | |
| 400 | InvalidNamespace.WithUppercase | This namespace does not support creating SAE apps because it contains uppercase letters. | |
| 400 | LogService.ConfigQuotaExceed | The maximum number of Log Service configs is exceeded. | |
| 400 | LogService.InternalError | An exception occurred while calling Log Service. Please submit a ticket to solve the problem. | |
| 400 | LogService.LogDirInvalid | The log collection path is invalid. | |
| 400 | LogService.NotAvailable | Log Service is unavailable. Please activate Log Service first. | |
| 400 | LogService.ProjectNumQuotaExceed | The maximum number of Log Service projects is exceeded. | |
| 400 | vswitch.not.exist | The specified VSwitch does not exist. | |
| 400 | user.indebt | The user has an outstanding payment. | |
| 400 | NoComputeResourceQuota.App.Exceed | You can create %s instances for each application. Please submit a ticket to raise the quota. | |
| 400 | NoComputeResourceQuota.User.Exceed | Your account is limited to create %s instances. Please submit a ticket to raise the quota. | |
| 400 | System.Upgrading | The system is being upgraded. Please try again later. | |
| 400 | VolumnPath.Conflict | Conflict between log collection directory and persistent storage directory. | |
| 400 | MountConflict.ConfigMap | Conflict detected for ConfigMap path %s. | |
| 400 | NotFound.ConfigMap | The ConfigMap object (ID: %s) does not exist. | |
| 400 | NotFound.ConfigMapKey | The key %s of ConfigMap object (ID: %s) does not exist. | |
| 400 | Sls.Config.Mixed.Multi.Project | The specified Config contains multiple projects. | |
| 400 | Sls.Config.User.Defined.Missing.Logstore.Info | The specified Config is invalid. Both Project and Logstore must be specified. | |
| 400 | Sls.Config.User.Defined.Missing.Project.Info | The specified Config is invalid. Both Project and Logstore must be specified. | |
| 400 | Sls.Logstore.Name.Invalid | The specified name of Logstore is invalid. The Logstore name must not contain the prefix "sae-". | |
| 400 | Sls.Logstore.User.Defined.Not.Exist | The user defined Logstore does not exist. | |
| 400 | Sls.Project.Name.Invalid | The specified project name is invalid. The project name must not contain the prefix "sae-". | |
| 400 | Sls.Project.User.Defined.Not.Exist | The user defined project does not exist. | |
| 400 | InvalidImageUrl.AcrInstanceId.Domain.NotMatch | The specified domain of ImageUrl does not match AcrInstanceId domains. | |
| 400 | PhpApplication.MissingPhpRuntime | A PHP application must contain PHP Runtime. | |
| 404 | Associate.Eip.Not.Enough | No sufficient EIPs are available. | |
| 404 | InvalidNamespaceId.NotFound | The specified NamespaceId does not exist. | |
| 404 | InvalidVpcId.NotFound | The specified VpcId does not exist. | |
| 404 | InvalidAcrInstanceId.NotFound | The specified AcrInstanceId does not exist. |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.