All Products
Search
Document Center

Serverless App Engine:CreateApplication

Last Updated:Jul 10, 2026

Membuat 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:CreateApplication

create

*All Resource

*

None None

Sintaks permintaan

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

Parameter permintaan

Parameter

Type

Required

Description

Example

AppName

string

Yes

Nama aplikasi. Nama dapat berisi angka, huruf, dan tanda hubung (-). Nama harus dimulai dengan huruf dan tidak boleh diakhiri dengan tanda hubung (-). Panjang nama maksimal 36 karakter.

test

NamespaceId

string

No

ID namespace SAE. Hanya namespace yang namanya berisi huruf kecil dan tanda hubung (-) yang didukung. Nama harus dimulai dengan huruf. Anda dapat memperoleh namespace dengan memanggil operasi DescribeNamespaceList.

cn-beijing:test

AppDescription

string

No

Deskripsi aplikasi. Panjang deskripsi maksimal 1024 karakter.

This is a test description.

VpcId

string

No

VPC yang sesuai dengan namespace SAE. Di SAE, satu namespace hanya dapat sesuai dengan satu VPC, dan pemetaan tidak dapat diubah. Hubungan pengikatan dibuat saat aplikasi SAE pertama dibuat di namespace. Beberapa namespace dapat sesuai dengan VPC yang sama. Jika Anda mengosongkan parameter ini, VPC yang terikat ke namespace akan digunakan secara default.

vpc-bp1aevy8sofi8mh1q****

VSwitchId

string

No

vSwitch tempat pengontrol antarmuka jaringan elastis (NIC) instans aplikasi berada. vSwitch harus berada di VPC yang ditentukan. vSwitch juga memiliki hubungan pengikatan dengan namespace SAE. Jika Anda mengosongkan parameter ini, vSwitch yang terpasang ke namespace akan digunakan secara default.

vsw-bp12mw1f8k3jgygk9****

PackageType

string

Yes

Tipe Paket penyebaran aplikasi. Nilai valid:

  • Jika Anda menggunakan Java untuk penyebaran, FatJar, War, dan Image didukung.

  • Jika Anda menggunakan PHP untuk penyebaran, 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

  • Jika Anda menggunakan Python untuk penyebaran, PythonZip dan Image didukung.

  • Jika Anda menggunakan .NET Core untuk penyebaran, DotnetZip dan Image didukung.

    Catatan

    Saat DotnetZip dipilih, Dotnet menentukan versi waktu proses .NET Core. .NET 3.1, .NET 5.0, .NET 6.0, .NET 7.0, dan .NET 8.0 didukung. Parameter Dotnet, Command, dan CommandArgs diperlukan.

FatJar

PackageVersion

string

No

Versi Paket penyebaran. Parameter ini diperlukan ketika Package Type diatur ke FatJar, War, atau PythonZip.

1.0.0

PackageUrl

string

No

Alamat Paket penyebaran. Parameter ini diperlukan ketika Package Type diatur ke FatJar, War, atau PythonZip.

http://myoss.oss-cn-****.aliyuncs.com/my-buc/2019-06-30/****.jar

ImageUrl

string

No

Alamat image. Parameter ini diperlukan ketika Package Type diatur ke Image.

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

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 ketika Package Type diatur ke Image.

Open JDK 8

WebContainer

string

No

Versi Tomcat yang menjadi dependensi Paket penyebaran WebContainer. Nilai valid:

  • apache-tomcat-7.0.91

  • apache-tomcat-8.5.42

Parameter ini tidak didukung ketika Package Type diatur ke Image.

apache-tomcat-7.0.91

Cpu

integer

No

Spesifikasi CPU yang diperlukan untuk setiap instans, dalam milicore. Parameter ini tidak dapat diatur ke 0. Hanya spesifikasi yang ditentukan berikut yang didukung:

  • 500

  • 1000

  • 2000

  • 4000

  • 8000

  • 16000

  • 32000

1000

Memory

integer

No

Memori yang diperlukan untuk setiap instans, dalam MB. Parameter ini tidak dapat diatur ke 0. Memori memiliki pemetaan satu-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

Yes

Jumlah awal instans.

1

Command

string

No

Perintah yang digunakan untuk memulai image. Perintah harus berupa objek yang dapat dieksekusi di dalam kontainer. Contoh:

command:
      - echo
      - abc
      - >
      - file0

Dalam contoh sebelumnya, Command="echo", CommandArgs=["abc", ">", "file0"].

Penting Parameter ini diperlukan ketika PackageType diatur ke DotnetZip.

echo

CommandArgs

string

No

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

["a","b"]

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

Penting Parameter ini diperlukan ketika PackageType diatur ke DotnetZip.

["a","b"]

Envs

string

No

Parameter variabel lingkungan kontainer. Anda dapat menyesuaikan variabel lingkungan atau mereferensikan ConfigMap. Untuk mereferensikan 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 ConfigMap (valueFrom)
    • name: nama variabel lingkungan. Anda dapat mereferensikan satu kunci atau semua kunci. 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. Jika Anda mereferensikan semua kunci, jangan atur bidang ini.

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

CustomHostAlias

string

No

Pemetaan host kustom di dalam kontainer. Nilai valid:

  • hostName: nama domain atau hostname.

  • ip: alamat IP.

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

JarStartOptions

string

No

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

-Xms4G -Xmx4G

JarStartArgs

string

No

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

custom-args

Liveness

string

No

Pemeriksaan kesehatan kontainer. Kontainer yang gagal 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

Anda hanya dapat menggunakan satu metode untuk pemeriksaan kesehatan.

Deskripsi parameter:

  • exec.command: 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. Jika bidang ini hilang, fitur lanjutan tidak digunakan.

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

  • tcpSocket.port: Port untuk deteksi koneksi TCP.

  • initialDelaySeconds: waktu deteksi penundaan pemeriksaan kesehatan. Nilai default: 10. Unit: detik.

  • periodSeconds: periode pemeriksaan kesehatan. Nilai default: 30. Unit: detik.

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

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

Readiness

string

No

Pemeriksaan status startup aplikasi. Kontainer yang gagal beberapa kali 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

Anda hanya dapat menggunakan satu metode untuk pemeriksaan kesehatan.

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

Deploy

boolean

No

Apakah akan segera menerapkan aplikasi. Nilai valid:

  • true: nilai default. Aplikasi segera diterapkan.

  • false: aplikasi diterapkan nanti.

true

EdasContainerVersion

string

No

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

3.5.3

Timezone

string

No

Zona waktu. Nilai default: Asia/Shanghai.

Asia/Shanghai

SlsConfigs

string

No

Konfigurasi untuk pengumpulan log ke Simple Log Service.

  • Gunakan Sumber daya SLS yang dibuat otomatis oleh SAE: [{"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":""}].

Deskripsi parameter:

  • projectName: nama Proyek di Simple Log Service.

  • logDir: jalur log.

  • logType: Tipe log. stdout menunjukkan log output standar kontainer. Anda hanya dapat mengonfigurasi satu entri untuk tipe ini. 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.

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 saat aplikasi dihapus. Oleh karena itu, jangan pilih project yang dibuat otomatis oleh SAE saat Anda memilih project yang sudah ada.

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

NasId

string

No

Kami menyarankan Anda untuk tidak mengatur parameter ini. Atur NasConfigs sebagai gantinya. ID sistem file NAS yang dipasang. Sistem file NAS harus berada di wilayah yang sama dengan kluster. Sistem file NAS harus memiliki kuota pembuatan titik pemasangan yang tersedia, atau titik pemasangannya harus sudah berada di vSwitch di VPC. Jika parameter ini dibiarkan kosong dan bidang mountDescs ada, sistem file NAS dibeli secara otomatis dan dipasang ke vSwitch di VPC.

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).

KSAK****

MountHost

string

No

Kami menyarankan Anda untuk tidak mengatur parameter ini. Atur NasConfigs sebagai gantinya. Titik pemasangan 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).

example.com

MountDesc

string

No

Kami menyarankan Anda untuk tidak mengatur parameter ini. Atur NasConfigs sebagai gantinya. Deskripsi pemasangan 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: "/"}]

PreStop

string

No

Skrip yang dijalankan sebelum kontainer dihentikan. Skrip dipicu dan dijalankan sebelum kontainer dihapus. Format: {"exec":{"command":\["cat","/etc/group"]}}

{"exec":{"command":["cat","/etc/group"]}}

PostStart

string

No

Skrip yang dijalankan setelah kontainer dimulai. Skrip dipicu dan dijalankan segera setelah kontainer dibuat. Format: {"exec":{"command":\["cat","/etc/group"]}}

{"exec":{"command":["cat","/etc/group"]}}

WarStartOptions

string

No

Perintah startup untuk menerapkan aplikasi paket WAR. Prosedur konfigurasinya sama dengan prosedur untuk perintah startup Penerapan image. Untuk informasi lebih lanjut, lihat Mengonfigurasi perintah startup.

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

ConfigMapMountDesc

string

No

Deskripsi pemasangan ConfigMap. Gunakan ConfigMap yang dibuat di halaman item konfigurasi namespace untuk menyuntikkan informasi konfigurasi ke dalam kontainer. Deskripsi parameter:

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

  • key: kunci.

Catatan

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

  • mountPath: jalur pemasangan.

[{"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:

  • true: SAE mengonfigurasi lingkungan jaringan secara otomatis saat aplikasi dibuat. Nilai NamespaceId, VpcId, vSwitchId, dan SecurityGroupId diabaikan.

  • false: SAE mengonfigurasi lingkungan jaringan secara manual saat aplikasi dibuat.

Catatan

Jika parameter ini diatur ke true, nilai NamespaceId lain yang diteruskan akan diabaikan.

true

TerminationGracePeriodSeconds

integer

No

Waktu tunggu untuk shutdown yang mulus. Nilai default: 30. Unit: detik. Nilai valid: 1 hingga 300.

30

PhpArmsConfigLocation

string

No

Jalur pemasangan untuk Pemantauan Aplikasi PHP. Pastikan server PHP memuat file konfigurasi dari jalur ini. Anda tidak perlu mengelola konten konfigurasi. SAE secara otomatis merender file konfigurasi yang benar.

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

PhpConfigLocation

string

No

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

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

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

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

  • maxThreads: jumlah maksimum Koneksi dalam 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 pemasangan OSS. Deskripsi parameter:

  • bucketName: nama bucket.

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

  • mountPath: jalur kontainer di SAE. Jika jalur sudah ada, itu adalah hubungan timpa. Jika jalur tidak ada, jalur tersebut dibuat.

  • readOnly: Apakah jalur kontainer memiliki izin baca-saja pada Sumber daya folder yang dipasang. Nilai valid:
    • true: izin baca-saja.

    • 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

Php

string

No

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

PHP-FPM 7.0

AcrInstanceId

string

No

ID instans dari instans Container Registry Instans Perusahaan. Parameter ini diperlukan ketika ImageUrl diatur ke image Container Registry Edisi Perusahaan.

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 mengaitkan EIP. Nilai valid:

  • true: mengaitkan EIP.

  • false: tidak mengaitkan EIP.

true

ProgrammingLanguage

string

No

Bahasa pemrograman dari tumpukan teknologi yang digunakan untuk membuat aplikasi. Nilai valid:

  • java: Java.

  • php: PHP.

  • python: Python.

  • dotnet: .NET Core.

  • other: banyak bahasa, seperti C++, Go, dan Node.js.

java

KafkaConfigs

string

No

Ringkasan konfigurasi untuk pengumpulan log ke Kafka. Nilai valid:

  • kafkaEndpoint: alamat pendaftaran layanan API Kafka.

  • kafkaInstanceId: ID instans Kafka.

  • kafkaConfigs: ringkasan konfigurasi untuk satu atau beberapa entri log. Untuk informasi lebih lanjut tentang nilai valid, 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:

  • serviceName: nama layanan. Format: nama kustom-ID namespace. Akhiran -ID namespace tidak dapat dikustomisasi dan harus diatur berdasarkan namespace aplikasi. Misalnya, jika Anda memilih namespace default di wilayah China (Beijing), akhirannya adalah -cn-beijing-default.

  • namespaceId: ID namespace.

  • 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.

{"serviceName":"bwm-poc-sc-gateway-cn-beijing-front","namespaceId":"cn-beijing:front","portAndProtocol":{"18012":"TCP"},"enable":true,"portProtocols":[{"port":18012,"protocol":"TCP"}]}

MicroRegistration

string

No

Menentukan registri Pusat Registrasi Nacos. Nilai valid:

  • 0: Pusat Registrasi Nacos bawaan SAE.

  • 1: Pusat Registrasi Nacos yang dikelola sendiri.

  • 2: Pusat Registrasi Nacos edisi komersial MSE.

"0"

MicroRegistrationConfig

string

No

Konfigurasi registri.

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

NasConfigs

string

No

Konfigurasi pemasangan NAS. Nilai valid:

  • mountPath: jalur pemasangan kontainer.

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

  • nasId: ID NAS.

  • mountDomain: alamat titik pemasangan 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 ditentukan dalam file requirements.txt di Folder Root diinstal. Jika file tidak dikonfigurasi atau Anda memerlukan paket kustom, tentukan dependensi yang akan diinstal.

Flask==2.0

Dotnet

string

No

Versi kerangka kerja .NET:

  • .NET 3.1

  • .NET 5.0

  • .NET 6.0

  • .NET 7.0

  • .NET 8.0

.NET 3.1

EnableEbpf

string

No

Apakah akan mengaktifkan Pemantauan Aplikasi untuk aplikasi non-Java berdasarkan teknologi eBPF. Nilai valid:

  • true: diaktifkan.

  • false: dinonaktifkan. Ini adalah nilai default.

false

SaeVersion

string

No

Versi SAE. Nilai valid:

  • v1

  • v2

v1

AppSource

string

No

Atur parameter ini ke micro_service untuk membuat aplikasi layanan mikro.

micro_service

BaseAppId

string

No

ID aplikasi dasar.

ee99cce6-1c8e-4bfa-96c3-3e2fa9de8a41

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.

false

EnableCpuBurst

boolean

No

Apakah akan mengaktifkan fitur CPU Burst:

  • true: Diaktifkan.

  • false: Dinonaktifkan.

true

OidcRoleName

string

No

Menentukan peran RAM untuk otentikasi identitas.

Catatan

Buat penyedia identitas OIDC dan peran penyedia identitas di wilayah yang sama terlebih dahulu. Untuk informasi lebih lanjut, lihat CreateOIDCProvider dan CreateSAMLProvider.

sae-test

SidecarContainersConfig

array

No

Konfigurasi kontainer sidecar.

SidecarContainerConfig

No

Konfigurasi kontainer sidecar.

SecretMountDesc

string

No

Deskripsi pemasangan Secret. Gunakan rahasia yang dibuat di halaman rahasia namespace untuk menyuntikkan informasi sensitif ke dalam kontainer. Deskripsi parameter:

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

  • key: kunci.

Catatan

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

  • mountPath: jalur pemasangan.

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

EnableSidecarResourceIsolated

boolean

No

Apakah akan mengaktifkan isolasi Sumber daya sidecar:

  • true: Terisolasi.

  • false: Tidak terisolasi.

true

CustomImageNetworkType

string

No

Tipe gambar kustom. Atur parameter ini ke string kosong jika image bukan gambar kustom:

  • internet: gambar publik

  • intranet: gambar privat

internet

ResourceType

string

No

Tipe Sumber daya. Nilai valid: NULL (default), default, dan haiguang (server Hygon).

NULL

NewSaeVersion

string

No

Versi aplikasi:

  • lite: Edisi Lite

  • std: Edisi Standar

  • pro: Edisi Profesional

pro

MicroserviceEngineConfig

string

No

Mengonfigurasi fitur tata kelola layanan mikro.

  • Menentukan apakah akan mengaktifkan tata kelola layanan mikro (enable):

    • true: Diaktifkan.

    • false: Dinonaktifkan.

  • Mengonfigurasi online/offline tanpa kehilangan (mseLosslessRule):

    • delayTime: waktu penundaan.

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

    • notice: menentukan apakah akan mengaktifkan fitur Notifikasi. true menunjukkan diaktifkan. false menunjukkan dinonaktifkan.

    • warmupTime: Durasi warm-up untuk peningkatan trafik, dalam detik.

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

DiskSize

integer

No

Ukuran penyimpanan disk, dalam GB.

50

InitContainersConfig

array

No

Konfigurasi kontainer init.

InitContainerConfig

No

Konfigurasi kontainer init.

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 dimulai ulang secara otomatis.

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

  • Anda hanya dapat menggunakan satu metode untuk pemeriksaan kesehatan.

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

IsStateful

boolean

No

Apakah aplikasi bersifat stateful.

EnablePrometheus

boolean

No

Apakah akan mengaktifkan pengumpulan data deret waktu kustom Prometheus.

false

HeadlessPvtzDiscoverySvc

string

No

Pendaftaran dan penemuan layanan berbasis K8s Headless Service.

  • serviceName: nama layanan.

  • namespaceId: ID namespace.

{\"serviceName\":\"leaf-test-headless\",\"namespaceId\":\"cn-zhangjiakou:prod\"}

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 sementara bersama.

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

AgentVersion

string

No

Apakah akan menggunakan kembali konfigurasi versi agen namespace.

4.4.2

EnableNamespaceAgentVersion

boolean

No

Versi AliyunAgent.

true

EnableNamespaceSlsConfig

boolean

No

Apakah akan menggunakan kembali konfigurasi log SLS namespace.

true

SlsLogEnvTags

string

No

tag log sls.

LokiConfigs

string

No

Labels

object

No

string

No

Elemen respons

Element

Type

Description

Example

object

Informasi tentang aplikasi yang dibuat.

RequestId

string

ID permintaan.

91F93257-7A4A-4BD3-9A7E-2F6EAE6D****

Message

string

Informasi tambahan. Nilai valid:

  • Jika permintaan berhasil, success dikembalikan.

  • Jika permintaan gagal, kode kesalahan spesifik dikembalikan.

success

TraceId

string

ID jejak, yang digunakan untuk mengkueri detail permintaan.

0a98a02315955564772843261e****

Data

object

Hasil yang dikembalikan.

ChangeOrderId

string

ID urutan perubahan yang dikembalikan, yang digunakan untuk mengkueri status eksekusi Tugas.

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

AppId

string

ID aplikasi yang dibuat.

017f39b8-dfa4-4e16-a84b-1dcee4b1****

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: berhasil.

  • 3xx: Pengalihan.

  • 4xx: kesalahan permintaan.

  • 5xx: kesalahan server.

200

Success

boolean

Apakah aplikasi dibuat. Nilai valid:

  • true: Aplikasi dibuat.

  • false: Aplikasi gagal dibuat.

true

Contoh

Respons sukses

JSONformat

{
  "RequestId": "91F93257-7A4A-4BD3-9A7E-2F6EAE6D****",
  "Message": "success",
  "TraceId": "0a98a02315955564772843261e****",
  "Data": {
    "ChangeOrderId": "01db03d3-3ee9-48b3-b3d0-dfce2d88****",
    "AppId": "017f39b8-dfa4-4e16-a84b-1dcee4b1****"
  },
  "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.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 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.
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 vswitch.not.exist The specified vSwitch does not exist.
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 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.