All Products
Search
Document Center

Serverless App Engine:DeployApplication

Last Updated:Jul 10, 2026

Mendeploy 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:DeployApplication

update

*All Resource

*

None None

Sintaks permintaan

POST /pop/v1/sam/app/deployApplication HTTP/1.1

Parameter permintaan

Parameter

Type

Required

Description

Example

AppId

string

Yes

ID aplikasi yang akan dideploy.

7171a6ca-d1cd-4928-8642-7d5cfe69****

Jdk

string

No

Versi JDK yang menjadi dependensi paket penyebaran. Nilai valid:

  • Open JDK 8

  • Open JDK 7

  • Dragonwell 11

  • Dragonwell 8

  • openjdk-8u191-jdk-alpine3.9

  • openjdk-7u201-jdk-alpine3.9

Parameter ini tidak didukung jika Package Type diatur ke Image.

Open JDK 8

WebContainer

string

No

Versi Tomcat yang menjadi dependensi paket penyebaran. Nilai valid:

  • apache-tomcat-7.0.91

  • apache-tomcat-8.5.42

Parameter ini tidak didukung jika Package Type diatur ke Image.

apache-tomcat-7.0.91

PackageVersion

string

No

Nomor versi paket penyebaran. Parameter ini wajib diisi jika Package Type diatur ke FatJar, War, atau PythonZip.

1.0.1

PackageUrl

string

No

URL paket penyebaran. Parameter ini wajib diisi jika Package Type 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 jika Package Type diatur ke Image.

registry.cn-hangzhou.aliyuncs.com/sae_test/ali_sae_test:0.0.1

Command

string

No

Perintah startup image. Perintah harus berupa objek yang dapat dieksekusi dalam kontainer. Contoh:

command:
      - echo
      - abc
      - >
      - file0

Berdasarkan contoh di atas, Command="echo", CommandArgs=["abc", ">", "file0"].

echo

CommandArgs

string

No

Argumen perintah startup image. Ini adalah argumen yang diperlukan oleh perintah startup yang ditentukan dalam Command. Format:

["a","b"]

Dalam contoh di atas, CommandArgs=["abc", ">", "file0"], di mana ["abc", ">", "file0"] harus dikonversi ke tipe String, dan format internalnya adalah array JSON. Jika parameter ini tidak diperlukan, biarkan kosong.

["a","b"]

Envs

string

No

Parameter variabel lingkungan kontainer. Anda dapat menyesuaikan variabel lingkungan atau mereferensikan item ConfigMap. Untuk mereferensikan item ConfigMap, buat instans ConfigMap terlebih dahulu. Untuk informasi lebih lanjut, lihat CreateConfigMap. Nilai valid:

  • Konfigurasi kustom
    • name: nama variabel lingkungan.

    • value: nilai variabel lingkungan. Ini memiliki prioritas lebih tinggi daripada valueFrom.

  • Mereferensikan item ConfigMap (valueFrom)
    • name: nama variabel lingkungan. Untuk mereferensikan semua kunci, masukkan sae-sys-configmap-all-<nama ConfigMap>, seperti sae-sys-configmap-all-test1.

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

    • configMapId: ID ConfigMap.

    • key: kunci. Jangan atur bidang ini jika Anda ingin mereferensikan semua kunci.

  • Mereferensikan rahasia (valueFrom)
    • name: nama variabel lingkungan. Untuk mereferensikan semua kunci, masukkan sae-sys-secret-all-<nama rahasia>, seperti sae-sys-secret-all-test1.

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

    • secretId: ID rahasia.

    • key: kunci. Jangan atur bidang ini jika Anda ingin mereferensikan semua kunci.

[ { "name": "sae-sys-configmap-all-hello", "valueFrom": { "configMapRef": { "configMapId": 100, "key": "" } } }, { "name": "hello", "valueFrom": { "configMapRef": { "configMapId": 101, "key": "php-fpm" } } }, { "name": "sae-sys-secret-all-hello", "valueFrom": { “secretRef": { “secretId": 100, "key": "" } } }, { "name": “password”, "valueFrom": { “secretRef": { “secretId": 101, "key": “password” } } }, { "name": "envtmp", "value": "newenv" } ]

CustomHostAlias

string

No

Pemetaan host kustom dalam kontainer. Nilai valid:

  • hostName: nama domain atau hostname.

  • ip: alamat IP.

[{"hostName":"samplehost","ip":"127.0.0.1"}]

JarStartOptions

string

No

Opsi startup untuk aplikasi berbasis paket JAR. Perintah startup default adalah $JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs.

custom-option

JarStartArgs

string

No

Argumen startup untuk aplikasi berbasis paket JAR. Perintah startup default adalah $JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs.

-Xms4G -Xmx4G

Liveness

string

No

Pemeriksaan kesehatan kontainer. Kontainer yang gagal dalam pemeriksaan kesehatan akan di-shutdown dan dipulihkan. Metode berikut didukung:

  • exec: misalnya, {"exec":{"command":\["sh","-c","cat/home/admin/start.sh"]},"initialDelaySeconds":30,"periodSeconds":30,"timeoutSeconds":2}

  • httpGet: misalnya, {"httpGet":{"path":"/","port":18091,"scheme":"HTTP","isContainKeyWord":true,"keyWord":"SAE"},"initialDelaySeconds":11,"periodSeconds":10,"timeoutSeconds":1}

  • tcpSocket: misalnya, {"tcpSocket":{"port":18091},"initialDelaySeconds":11,"periodSeconds":10,"timeoutSeconds":1}

Catatan

Hanya satu metode yang dapat dipilih untuk pemeriksaan kesehatan.

Pengaturan:

  • exec.command: mengatur perintah pemeriksaan kesehatan.

  • httpGet.path: jalur akses.

  • httpGet.scheme: HTTP atau HTTPS.

  • httpGet.isContainKeyWord: true menunjukkan bahwa kata kunci disertakan, false menunjukkan bahwa kata kunci tidak disertakan, dan tidak adanya bidang ini menunjukkan bahwa fitur lanjutan tidak digunakan.

  • httpGet.keyWord: kata kunci kustom. Bidang isContainKeyWord harus ada saat parameter ini digunakan.

  • tcpSocket.port: Port untuk deteksi koneksi TCP.

  • initialDelaySeconds: mengatur penundaan awal untuk pemeriksaan kesehatan. Nilai default: 10. Unit: detik.

  • periodSeconds: mengatur epoch pemeriksaan kesehatan. Nilai default: 30. Unit: detik.

  • timeoutSeconds: mengatur periode timeout pemeriksaan kesehatan. Nilai default: 1. Unit: detik. Jika parameter ini diatur ke 0 atau tidak diatur, periode timeout default adalah 1 detik.

{"exec":{"command":["sleep","5s"]},"initialDelaySeconds":10,"timeoutSeconds":11}

Readiness

string

No

Pemeriksaan status startup aplikasi. Kontainer yang gagal dalam beberapa pemeriksaan kesehatan akan di-shutdown dan dimulai ulang. Kontainer yang tidak lulus pemeriksaan kesehatan tidak menerima trafik SLB. Metode exec, httpGet, dan tcpSocket didukung. Untuk contoh spesifik, lihat parameter Liveness.

Catatan

Hanya satu metode yang dapat dipilih untuk pemeriksaan kesehatan.

{"exec":{"command":["sleep","6s"]},"initialDelaySeconds":15,"timeoutSeconds":12}

MinReadyInstances

integer

No

Jumlah minimum instans yang tersedia. Nilai valid:

  • Jika parameter ini diatur ke 0, layanan akan terganggu selama peningkatan.

  • Jika parameter ini diatur ke -1, nilai yang direkomendasikan sistem digunakan, yaitu 25% dari jumlah instans saat ini. Jika jumlah instans saat ini adalah 5, 5 × 25% = 1,25, yang dibulatkan ke atas menjadi 2.

Catatan

Jumlah minimum instans yang tersedia untuk setiap penyebaran bergulir harus ≥ 1 untuk mencegah gangguan layanan.

1

MinReadyInstanceRatio

integer

No

Persentase minimum instans yang tersedia. Nilai valid:

  • -1: nilai inisialisasi, yang menunjukkan bahwa persentase tidak digunakan.

  • 0~100: unitnya adalah persentase, dibulatkan ke atas. Misalnya, jika parameter ini diatur ke 50% dan jumlah instans saat ini adalah 5, jumlah minimum instans yang tersedia adalah 3.

Catatan

Ketika MinReadyInstance dan MinReadyInstanceRatio keduanya ditentukan dan nilai MinReadyInstanceRatio bukan -1, parameter MinReadyInstanceRatio yang diutamakan. Misalnya, jika MinReadyInstances diatur ke 5 dan MinReadyInstanceRatio diatur ke 50, nilai 50 digunakan untuk menghitung jumlah minimum instans yang tersedia.

-1

BatchWaitTime

integer

No

Interval antar batch penerapan. Unit: detik.

10

EdasContainerVersion

string

No

Versi lingkungan waktu proses aplikasi dalam framework HSF, seperti kontainer Ali-Tomcat.

3.5.3

UpdateStrategy

string

No

Kebijakan penerapan. Ketika jumlah minimum instans yang tersedia adalah 1, nilai bidang UpdateStrategy adalah "". Ketika jumlah minimum instans yang tersedia lebih besar dari 1, contohnya adalah sebagai berikut:

  • Grayscale 1 instans + 2 batch berikutnya + batching otomatis + interval batch 1 menit: {"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}

  • Grayscale 1 instans + 2 batch berikutnya + batching manual: {"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"manual"},"grayUpdate":{"gray":1}}

  • 2 batch + batching otomatis + interval batch 0 menit: {"type":"BatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":0}}

Pengaturan:

  • type: tipe kebijakan publikasi. Nilai valid: GrayBatchUpdate (publikasi grayscale) dan BatchUpdate (publikasi batch).

  • batchUpdate: kebijakan publikasi batch.

    • batch: jumlah batch publikasi.

    • releaseType: metode pemrosesan antar batch. Nilai valid: auto (otomatis) dan manual (manual).

    • batchWaitTime: interval antar batch. Unit: menit.

  • grayUpdate: jumlah instans grayscale. Parameter ini wajib diisi jika type diatur ke GrayBatchUpdate.

{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}

SlsConfigs

string

No

Konfigurasi untuk pengumpulan log ke Simple Log Service.

  • Gunakan sumber daya SLS yang dibuat otomatis oleh Serverless App Engine: [{"logDir":"","logType":"stdout"},{"logDir":"/tmp/a.log"}].

  • Gunakan sumber daya SLS kustom: [{"projectName":"test-sls","logType":"stdout","logDir":"","logstoreName":"sae","logtailName":""},{"projectName":"test","logDir":"/tmp/a.log","logstoreName":"sae","logtailName":""}].

Pengaturan:

  • projectName: nama proyek di Simple Log Service.

  • logDir: jalur log.

  • logType: tipe log. stdout menunjukkan log output standar kontainer, dan hanya satu entri yang dapat diatur. Jika parameter ini tidak diatur, log file dikumpulkan.

  • logstoreName: nama penyimpanan log di Simple Log Service.

  • logtailName: nama Logtail di Simple Log Service. Jika parameter ini tidak ditentukan, Logtail baru dibuat melalui pembuatan otomatis.

Jika konfigurasi pengumpulan SLS tidak berubah selama beberapa penerapan, Anda tidak perlu mengatur parameter ini (yaitu, bidang SlsConfigs tidak perlu disertakan dalam permintaan). Jika Anda tidak lagi memerlukan fitur pengumpulan SLS, atur nilai bidang ini ke string kosong (yaitu, atur nilai bidang SlsConfigs ke "" dalam permintaan).

Catatan

Proyek yang dibuat otomatis bersama aplikasi akan dihapus ketika aplikasi dihapus. Oleh karena itu, jangan pilih proyek yang dibuat otomatis oleh Serverless App Engine saat memilih proyek yang sudah ada.

[{"logDir":"","logType":"stdout"},{"logDir":"/tmp/a.log"}]

Timezone

string

No

Zona waktu. Nilai default: Asia/Shanghai.

Asia/Shanghai

NasId

string

No

Kami tidak menyarankan Anda mengonfigurasi bidang ini. Konfigurasikan NasConfigs sebagai gantinya. ID sistem file NAS. Jika konfigurasi tidak berubah selama penerapan, Anda tidak perlu mengatur parameter ini (yaitu, bidang NasId tidak perlu disertakan dalam permintaan). Untuk menghapus konfigurasi NAS, atur nilai bidang ini ke string kosong (yaitu, atur nilai bidang NasId ke "" dalam permintaan).

10d3b4****

MountHost

string

No

Kami tidak menyarankan Anda mengonfigurasi bidang ini. Konfigurasikan NasConfigs sebagai gantinya. Titik memasang sistem file NAS di VPC aplikasi. Jika konfigurasi tidak berubah selama penerapan, Anda tidak perlu mengatur parameter ini (yaitu, bidang MountHost tidak perlu disertakan dalam permintaan). Untuk menghapus konfigurasi NAS, atur nilai bidang ini ke string kosong (yaitu, atur nilai bidang MountHost ke "" dalam permintaan).

10d3b4bc9****.com

MountDesc

string

No

Kami tidak menyarankan Anda mengonfigurasi bidang ini. Konfigurasikan NasConfigs sebagai gantinya. Deskripsi memasang NAS. Jika konfigurasi tidak berubah selama penerapan, Anda tidak perlu mengatur parameter ini (yaitu, bidang MountDesc tidak perlu disertakan dalam permintaan). Untuk menghapus konfigurasi NAS, atur nilai bidang ini ke string kosong (yaitu, atur nilai bidang MountDesc ke "" dalam permintaan).

[{mountPath: "/tmp", nasPath: "/"}]

PostStart

string

No

Skrip yang dijalankan setelah kontainer dimulai. Skrip dipicu segera setelah kontainer dibuat. Format: {"exec":{"command":\["sh","-c","echo hello"\]}}.

{"exec":{"command":["sh","-c","echo hello"]}}

PreStop

string

No

Skrip yang dijalankan sebelum kontainer berhenti. Skrip dipicu sebelum kontainer dihapus. Format: {"exec":{"command":\["sh","-c","echo hello"\]}}.

{"exec":{"command":["sh","-c","echo hello"]}}

ChangeOrderDesc

string

No

Deskripsi pesanan perubahan.

Start application

WarStartOptions

string

No

Perintah startup untuk mendeploy aplikasi berbasis paket WAR. Prosedur konfigurasinya sama dengan perintah startup untuk penerapan berbasis image. Untuk informasi lebih lanjut, lihat Mengonfigurasi perintah startup.

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

AutoEnableApplicationScalingRule

boolean

No

Apakah akan mengaktifkan kebijakan skalabilitas elastis aplikasi secara otomatis. Nilai valid:

  • true: diaktifkan.

  • false: dinonaktifkan.

true

ConfigMapMountDesc

string

No

Deskripsi memasang ConfigMap. Gunakan ConfigMap yang dibuat pada halaman item konfigurasi namespace untuk menyuntikkan informasi konfigurasi ke dalam kontainer. Pengaturan:

  • configMapId: ID instans ConfigMap. Anda dapat memperolehnya dengan memanggil operasi ListNamespacedConfigMaps.

  • key: kunci.

Catatan

Anda dapat memasang semua kunci dengan meneruskan parameter sae-sys-configmap-all.

  • mountPath: jalur memasang.

[{"configMapId":16,"key":"test","mountPath":"/tmp"}]

TerminationGracePeriodSeconds

integer

No

Periode timeout shutdown yang mulus. Nilai default: 30. Unit: detik. Nilai valid: 1 hingga 300.

10

EnableAhas

string

No

Apakah akan mengaktifkan Application High Availability Service (AHAS). Nilai valid:

  • true: mengaktifkan AHAS.

  • false: tidak mengaktifkan AHAS.

false

PhpArmsConfigLocation

string

No

Jalur memasang untuk pemantauan aplikasi PHP. Pastikan server PHP memuat file konfigurasi dari jalur ini. Anda tidak perlu mengelola konten konfigurasi karena Serverless App Engine secara otomatis merender file konfigurasi yang benar.

/usr/local/etc/php/conf.d/arms.ini

PhpConfigLocation

string

No

Jalur memasang untuk konfigurasi startup aplikasi PHP. Pastikan server PHP menggunakan file konfigurasi ini untuk startup.

/usr/local/etc/php/php.ini

PhpConfig

string

No

Konten file konfigurasi PHP.

k1=v1

TomcatConfig

string

No

Konfigurasi Tomcat. Atur parameter ini ke "" atau "{}" untuk menghapus konfigurasi. Nilai valid:

  • port: nomor Port. Nilai valid: 1024 hingga 65535. Port yang lebih kecil dari 1024 memerlukan izin root. Karena kontainer dikonfigurasi dengan izin admin, tentukan Port yang lebih besar dari 1024. Nilai default: 8080.

  • contextPath: jalur akses. Nilai default: direktori root "/".

  • maxThreads: ukuran Kolam koneksi. Nilai default: 400.

  • uriEncoding: format encoding Tomcat. Nilai valid: UTF-8, ISO-8859-1, GBK, dan GB2312. Nilai default: ISO-8859-1.

  • useBodyEncodingForUri: apakah akan menggunakan BodyEncoding for URL. Nilai default: true.

{"port":8080,"contextPath":"/","maxThreads":400,"uriEncoding":"ISO-8859-1","useBodyEncodingForUri":true}

OssMountDescs

string

No

Deskripsi memasang OSS. Pengaturan parameter:

  • bucketName: nama bucket.

  • bucketPath: folder atau objek yang Anda buat di OSS. Jika folder memasang OSS tidak ada, pengecualian akan dipicu.

  • mountPath: jalur kontainer di Serverless App Engine. Jika jalur sudah ada, itu adalah hubungan overwrite. Jika jalur tidak ada, jalur tersebut dibuat.

  • readOnly: apakah jalur kontainer memiliki izin read-only pada sumber daya folder yang dipasang. Nilai valid:
    • true: izin read-only.

    • false: izin baca dan tulis.

[{"bucketName": "oss-bucket", "bucketPath": "data/user.data", "mountPath": "/usr/data/user.data", "readOnly": true}]

OssAkId

string

No

AccessKey ID untuk operasi baca dan tulis OSS.

xxxxxx

OssAkSecret

string

No

Rahasia AccessKey untuk operasi baca dan tulis OSS.

xxxxxx

EnableGreyTagRoute

boolean

No

Apakah akan mengaktifkan aturan rilis canary trafik. Aturan ini hanya berlaku untuk aplikasi yang menggunakan framework Spring Cloud atau Dubbo. Nilai valid:

  • true: mengaktifkan aturan rilis canary.

  • false: menonaktifkan aturan rilis canary.

false

Php

string

No

Versi PHP yang menjadi dependensi paket penyebaran. Tidak didukung untuk image.

PHP-FPM 7.0

AcrInstanceId

string

No

ID instans Perusahaan Container Registry. Parameter ini wajib diisi jika ImageUrl diatur ke image instans Perusahaan Container Registry.

cri-xxxxxx

AcrAssumeRoleArn

string

No

Nama Sumber Daya Alibaba Cloud peran RAM yang diperlukan untuk pengambilan image lintas akun. Untuk informasi lebih lanjut, lihat Memberikan izin lintas akun Alibaba Cloud dengan menggunakan peran RAM.

acs:ram::123456789012****:role/adminrole

ImagePullSecrets

string

No

ID rahasia yang sesuai.

10

AssociateEip

boolean

No

Apakah akan mengasosiasikan elastic IP address (EIP). Nilai valid:

  • true: mengasosiasikan EIP.

  • false: tidak mengasosiasikan EIP.

true

KafkaConfigs

string

No

Ringkasan konfigurasi pengumpulan log untuk Kafka. Nilai valid:

  • kafkaEndpoint: Titik akhir API Kafka.

  • kafkaInstanceId: ID instans Kafka.

  • kafkaConfigs: ringkasan konfigurasi untuk satu atau beberapa entri log. Untuk contoh nilai dan deskripsi parameter, lihat parameter permintaan kafkaConfigs dalam topik ini.

{"kafkaEndpoint":"10.0.X.XXX:XXXX,10.0.X.XXX:XXXX,10.0.X.XXX:XXXX","kafkaInstanceId":"alikafka_pre-cn-7pp2l8kr****","kafkaConfigs":[{"logType":"file_log","logDir":"/tmp/a.log","kafkaTopic":"test2"},{"logType":"stdout","logDir":"","kafkaTopic":"test"}]}

PvtzDiscoverySvc

string

No

Mengaktifkan pendaftaran dan penemuan layanan berbasis K8s Service. Nilai valid:

  • portProtocols: Port dan protokol. Nilai Port valid: [1,65535]. Nilai protokol valid: TCP dan UDP.

  • portAndProtocol: Port dan protokol. Nilai Port valid: [1,65535]. Nilai protokol valid: TCP dan UDP. portProtocols direkomendasikan. Jika portProtocols diatur, hanya portProtocols yang berlaku.

  • enable: mengaktifkan pendaftaran dan penemuan layanan berbasis K8s Service.

{"portProtocols":[{"port":18012,"protocol":"TCP"}],"portAndProtocol":{"18012":"TCP"},"enable":true}

SwimlanePvtzDiscoverySvc

string

No

Mengonfigurasi pendaftaran dan penemuan layanan berbasis K8s Service dengan rilis canary end-to-end:

  • enable: apakah akan mengaktifkan rilis canary end-to-end berbasis K8s Service.
    • true: diaktifkan.

    • false: dinonaktifkan.

  • namespaceId: ID namespace.

  • portAndProtocol: Port listening dan protokol. Format: {"port:j jenis protokol":"Port kontainer"}.

  • portProtocols: menentukan Port layanan dan protokol.
    • port: Port.

    • protocol: protokol.

    • targetPort: Port kontainer.

  • pvtzDiscoveryName: nama penemuan layanan.

  • serviceId: ID layanan.

  • serviceName: nama layanan.

{\"enable\":\"false\",\"namespaceId\":\"cn-beijing:test\",\"portAndProtocol\":{\"2000:TCP\":\"18081\"},\"portProtocols\":[{\"port\":2000,\"protocol\":\"TCP\",\"targetPort\":18081}],\"pvtzDiscoveryName\":\"cn-beijing-1421801774382676\",\"serviceId\":\"3513\",\"serviceName\":\"demo-gray.test\"}

MicroRegistration

string

No

Menentukan registri Nacos. Nilai valid:

  • 0: Pusat Registrasi Nacos bawaan Serverless App Engine.

  • 1: Pusat Registrasi Nacos yang dikelola sendiri.

  • 2: Pusat Registrasi Nacos edisi komersial Microservices Engine (MSE).

Catatan

Jika Anda memilih Pusat Registrasi Nacos bawaan Serverless App Engine, Anda tidak dapat memperoleh konfigurasi Pusat Registrasi Nacos bawaan.

"0"

MicroRegistrationConfig

string

No

Konfigurasi registri, yang hanya berlaku ketika tipe registri adalah MSE Nacos Edisi Perusahaan.

{\"instanceId\":\"mse-cn-zvp2bh6h70r\",\"namespace\":\"4c0aa74f-57cb-423c-b6af-5d9f2d0e3dbd\"}

NasConfigs

string

No

Konfigurasi memasang NAS. Nilai valid:

  • mountPath: jalur memasang kontainer.

  • readOnly: atur ke false untuk izin baca dan tulis.

  • nasId: ID NAS.

  • mountDomain: alamat titik memasang kontainer. Untuk informasi lebih lanjut, lihat DescribeMountTargets.

  • nasPath: direktori file relatif NAS.

[{"mountPath":"/test1","readOnly":false,"nasId":"nasId1","mountDomain":"nasId1.cn-shenzhen.nas.aliyuncs.com","nasPath":"/test1"},{"nasId":"nasId2","mountDomain":"nasId2.cn-shenzhen.nas.aliyuncs.com","readOnly":false,"nasPath":"/test2","mountPath":"/test2"}]

Python

string

No

Lingkungan Python. PYTHON 3.9.15 didukung.

PYTHON 3.9.15

PythonModules

string

No

Dependensi modul instalasi kustom. Secara default, dependensi yang didefinisikan dalam file requirements.txt di Folder Root diinstal. Jika tidak ada dependensi yang dikonfigurasi atau paket kustom diperlukan, Anda dapat menentukan dependensi yang akan diinstal.

Flask==2.0

Dotnet

string

No

Versi framework .NET:

  • .NET 3.1

  • .NET 5.0

  • .NET 6.0

  • .NET 7.0

  • .NET 8.0

.NET 3.1

Deploy

string

No

Parameter ini hanya berlaku untuk aplikasi dalam status stopped. Jika Anda memanggil operasi DeployApplication untuk aplikasi yang berjalan, aplikasi akan segera dideploy ulang.

  • true: nilai default. Segera mendeploy, menerapkan konfigurasi penerapan baru, dan memulai instans.

  • false: hanya menerapkan konfigurasi penerapan baru, tanpa memulai instans aplikasi.

true

PackageType

string

No

Tipe paket aplikasi. Nilai valid:

  • Saat Anda mendeploy dengan Java, tipe berikut didukung: FatJar, War, dan Image.

  • Saat Anda mendeploy dengan PHP, tipe berikut didukung:
    • PhpZip

    • IMAGE_PHP_5_4

    • IMAGE_PHP_5_4_ALPINE

    • IMAGE_PHP_5_5

    • IMAGE_PHP_5_5_ALPINE

    • IMAGE_PHP_5_6

    • IMAGE_PHP_5_6_ALPINE

    • IMAGE_PHP_7_0

    • IMAGE_PHP_7_0_ALPINE

    • IMAGE_PHP_7_1

    • IMAGE_PHP_7_1_ALPINE

    • IMAGE_PHP_7_2

    • IMAGE_PHP_7_2_ALPINE

    • IMAGE_PHP_7_3

    • IMAGE_PHP_7_3_ALPINE

  • Saat Anda mendeploy dengan Python, tipe berikut didukung: PythonZip dan Image.

FatJar

Cpu

integer

No

Sumber daya CPU yang diperlukan untuk setiap instans. Unit: milicore. Parameter ini tidak dapat diatur ke 0. Hanya spesifikasi yang ditentukan berikut yang didukung:

  • 500

  • 1000

  • 2000

  • 4000

  • 8000

  • 12000

  • 16000

  • 32000

1000

Memory

integer

No

Memori yang diperlukan untuk setiap instans. Unit: MB. Parameter ini tidak dapat diatur ke 0. Memori memiliki pemetaan satu-ke-satu dengan CPU. Hanya spesifikasi yang ditentukan berikut yang didukung:

  • 1024: sesuai dengan 500 dan 1000 milicore CPU.

  • 2048: sesuai dengan 500, 1000, dan 2000 milicore CPU.

  • 4096: sesuai dengan 1000, 2000, dan 4000 milicore CPU.

  • 8192: sesuai dengan 2000, 4000, dan 8000 milicore CPU.

  • 12288: sesuai dengan 12000 milicore CPU.

  • 16384: sesuai dengan 4000, 8000, dan 16000 milicore CPU.

  • 24576: sesuai dengan 12000 milicore CPU.

  • 32768: sesuai dengan 16000 milicore CPU.

  • 65536: sesuai dengan 8000, 16000, dan 32000 milicore CPU.

  • 131072: sesuai dengan 32000 milicore CPU.

1024

Replicas

integer

No

Jumlah instans.

1

SecurityGroupId

string

No

ID grup keamanan.

sg-wz969ngg2e49q5i4****

VSwitchId

string

No

vSwitch tempat antarmuka jaringan (NIC) instans aplikasi berada. vSwitch harus berada di VPC yang ditentukan.

vsw-bp12mw1f8k3jgygk9****

ServiceTags

string

No

Tag rilis canary yang dikonfigurasi untuk aplikasi.

{\"alicloud.service.tag\":\"g1\"}

EnableNewArms

boolean

No

Apakah akan mengaktifkan fitur ARMS baru:

  • true: diaktifkan.

  • false: dinonaktifkan.

true

EnableCpuBurst

boolean

No

Apakah akan mengaktifkan fitur CPU Burst:

  • true: diaktifkan.

  • false: dinonaktifkan.

true

OidcRoleName

string

No

Peran RAM untuk otentikasi identitas.

Catatan

Buat penyedia identitas OIDC dan peran penyedia identitas di wilayah yang sama sebelumnya. Untuk informasi lebih lanjut, lihat Membuat penyedia identitas OIDC dan Membuat peran untuk penyedia identitas Single Sign-On (SSO).

sae-test

SidecarContainersConfig

array

No

Konfigurasi kontainer sidecar.

SidecarContainerConfig

No

Konfigurasi kontainer sidecar.

SecretMountDesc

string

No

Deskripsi memasang rahasia. Gunakan rahasia yang dibuat pada halaman secrets namespace untuk menyuntikkan informasi sensitif ke dalam kontainer. Pengaturan:

  • secretId: ID instans rahasia. Anda dapat memperolehnya dengan memanggil operasi ListSecrets.

  • key: kunci.

Catatan

Anda dapat memasang semua kunci dengan meneruskan parameter sae-sys-secret-all.

  • mountPath: jalur memasang.

[{“secretId":10,”key":"test","mountPath":"/tmp"}]

EnableSidecarResourceIsolated

boolean

No

Apakah akan mengaktifkan isolasi sumber daya sidecar:

  • true: mengaktifkan isolasi.

  • false: tidak mengaktifkan isolasi.

true

CustomImageNetworkType

string

No

Tipe gambar kustom. Jika image bukan gambar kustom, atur parameter ini ke string kosong:

  • internet: gambar publik.

  • intranet: gambar privat.

internet

MicroserviceEngineConfig

string

No

Mengonfigurasi governance layanan mikro.

  • Menentukan apakah akan mengaktifkan governance layanan mikro (enable):

    • true: diaktifkan.

    • false: dinonaktifkan.

  • Mengonfigurasi online/offline tanpa kehilangan (mseLosslessRule):

    • delayTime: penundaan waktu.

    • enable: apakah akan mengaktifkan fitur online tanpa kehilangan. true menunjukkan diaktifkan, dan false menunjukkan dinonaktifkan.

    • notice: apakah akan mengaktifkan fitur notifikasi. true menunjukkan diaktifkan, dan false menunjukkan dinonaktifkan.

    • warmupTime: durasi warm-up untuk skenario trafik rendah. Unit: detik.

{"enable": true,"mseLosslessRule": {"delayTime": 0,"enable": false,"notice": false,"warmupTime": 120}}

NewSaeVersion

string

No

Versi aplikasi:

  • lite: edisi lite.

  • std: edisi standar.

  • pro: edisi profesional.

pro

InitContainersConfig

array

No

Konfigurasi init kontainer.

InitContainerConfig

No

Konfigurasi init kontainer.

GpuConfig

string

No

StartupProbe

string

No

Mengaktifkan probe startup aplikasi.

  • Pemeriksaan berhasil: menunjukkan bahwa aplikasi berhasil dimulai. Jika Anda mengonfigurasi pemeriksaan Liveness dan Readiness, pemeriksaan tersebut dilakukan setelah aplikasi berhasil dimulai.

  • Pemeriksaan gagal: menunjukkan bahwa aplikasi gagal dimulai. Pengecualian dilaporkan dan aplikasi secara otomatis dimulai ulang.

Catatan

Ini adalah konten deskripsi.

  • Metode exec, httpGet, dan tcpSocket didukung. Untuk contoh spesifik, lihat parameter Liveness.

  • Hanya satu metode yang dapat dipilih untuk pemeriksaan kesehatan.

{"exec":{"command":["sh","-c","cat /home/admin/start.sh"]},"initialDelaySeconds":30,"periodSeconds":30,"timeoutSeconds":2}

EnablePrometheus

boolean

No

Apakah akan mengaktifkan pengumpulan data deret waktu Prometheus kustom.

false

Html

string

No

Versi Nginx.

  • nginx 1.20

  • nginx 1.22

  • nginx 1.24

  • nginx 1.26

  • nginx 1.28

nginx 1.28

EmptyDirDesc

string

No

Konfigurasi penyimpanan ephemeral bersama.

[{\"name\":\"workdir\",\"mountPath\":\"/usr/local/tomcat/webapps\"}]

AlbIngressReadinessGate

string

No

Konfigurasi ReadinessGate gerbang ALB.

default

MaxSurgeInstances

integer

No

Jumlah maksimum instans surge. Nilai valid:

Jika jumlah minimum instans yang tersedia adalah 100%, surge maksimum tidak dapat diatur ke 0. Jika parameter ini diatur ke -1, nilai yang direkomendasikan sistem sebesar 30% digunakan, yaitu 30% dari jumlah instans saat ini. Misalnya, jika jumlah instans saat ini adalah 10, nilainya adalah 10 × 30% = 3.

-1

MaxSurgeInstanceRatio

integer

No

Persentase instans surge maksimum. Nilai valid:

Jika jumlah minimum instans yang tersedia adalah 100%, surge maksimum tidak dapat diatur ke 0. Jika parameter ini diatur ke -1, nilai yang direkomendasikan sistem sebesar 30% digunakan, yaitu 30% dari jumlah instans saat ini. Misalnya, jika jumlah instans saat ini adalah 10, nilainya adalah 10 × 30% = 3.

-1

AgentVersion

string

No

Versi AliyunAgent.

4.4.2

EnableNamespaceAgentVersion

boolean

No

Apakah akan menggunakan kembali konfigurasi versi Agent namespace.

true

SlsLogEnvTags

string

No

tag log sls.

LokiConfigs

string

No

Labels

object

No

string

No

Elemen respons

Element

Type

Description

Example

object

Informasi aplikasi yang dideploy.

RequestId

string

ID permintaan.

01CF26C7-00A3-4AA6-BA76-7E95F2A3***

Message

string

Informasi tambahan. Nilai valid:

  • Jika permintaan berhasil, success dikembalikan.

  • Jika permintaan gagal, kode kesalahan tertentu dikembalikan.

success

TraceId

string

ID jejak, yang digunakan untuk mengkueri detail permintaan.

ac1a0b2215622246421415014e****

Data

object

Hasil yang dikembalikan.

ChangeOrderId

string

ID pesanan perubahan yang dikembalikan, yang digunakan untuk mengkueri status eksekusi tugas.

01db03d3-3ee9-48b3-b3d0-dfce2d88****

AppId

string

ID aplikasi.

7171a6ca-d1cd-4928-8642-7d5cfe69****

IsNeedApproval

boolean

Indicates whether the change published by a Resource Access Management (RAM) user requires approval. Valid values:

  • true: persetujuan diperlukan.

  • false: persetujuan tidak diperlukan.

true

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 error POP. Nilai valid:

  • 2xx: sukses.

  • 3xx: pengalihan.

  • 4xx: error permintaan.

  • 5xx: error server.

200

Success

boolean

Apakah penerapan aplikasi berhasil. Nilai valid:

  • true: Penerapan berhasil.

  • false: Penerapan gagal.

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****",
    "IsNeedApproval": true
  },
  "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 InvalidApplication.NotFound The current application does not exist.
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 InvalidPackageType.NotFound The package type must be War, FatJar, or Image.
400 InvalidParameter.NotEmpty You must specify the parameter %s.
400 InvalidParameter.Obviously The specified parameter is invalid {%s}.
400 InvalidParameter.WithMessage The parameter is invalid {%s}: %s
400 JarApplication.MissingJdk A FatJar application must contain JDK.
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 WarApplication.MissingJdkWebcontainer A War application must contain JDK and Tomcat.
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 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 Application.ChangerOrderRunning An application change process is in progress. Please try again later.
400 Application.InvalidStatus The application status is abnormal. Please try again later.
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 Package.Version.Too.Long The maximum length of package version is exceeded.
400 App.Package.Version.Exists The package version of application already exists.
400 Slb.Occupied The SLB instance is occupied.
400 Slb.Tag.Not.Qualified The current SLB instance cannot be reused because it may have been occupied by %s.
400 MinReadyInstances.Not.Smaller.Replicas The minimum number of available instances must be less than the number of application instances.
400 MinReadyInstanceRatio.Invalid The ratio of minimum available instances must be between 0 and 100.
400 BatchWaitTime.Not.Smaller.Zero BatchWaitTime must not be smaller than zero.
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 Sae.Errorcode.Ahas.Create.Error.Message Failed to create AHAS.
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.
400 InvalidParameter.FileName The application deployment package name is invalid. This name can contain only alphanumeric characters, hyphens (-), and underscores (_). For deploying java package, you can upload JAR files only if the selected deployment version supports JAR file. Otherwise, upload WAR files only. For deploying php package, you can upload ZIP files only if the selected deployment version supports ZIP file.
400 Sls.Logtail.Name.Invalid The specified name of Logtail is invalid. The Logtail name must not contain the prefix sae-.
400 InvalidImageUrl.MissingAcrInstanceId The specified domain of ImageUrl is from ACREE, but you are not specified AcrInstanceId.
400 EnvFromSecretIdConflict.AlreadyExist The specified SecretId [%s] already exist in the specified Envs.
400 MountConflict.Secret Conflict detected for Secret path %s.
404 InvalidNamespaceId.NotFound The specified NamespaceId does not exist.
404 InvalidAcrInstanceId.NotFound The specified AcrInstanceId does not exist.
404 Associate.Eip.Not.Enough No sufficient EIPs are available.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.