全部產品
Search
文件中心

:CreateApplication - 建立一個SAE應用

更新時間:Feb 25, 2026

建立一個應用。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

sae:CreateApplication

create

*全部資源

*

請求文法

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

請求參數

名稱

類型

必填

描述

樣本值

AppName

string

應用程式名稱。允許數字、字母以及短劃線(-)組合。必須以字母開始,不允許以短劃線(-)結尾,不超過 36 個字元。

test

NamespaceId

string

SAE 命名空間 ID。僅支援名稱為小寫字母加短劃線(-)的命名空間,必須以字母開始。 命名空間可通過調用 DescribeNamespaceList 介面擷取。

cn-beijing:test

AppDescription

string

應用描述資訊。不超過 1024 個字元。

This is a test description.

VpcId

string

SAE 命名空間對應的 VPC。在 SAE 中,一個命名空間只能對應一個 VPC,且不能修改。第一次在命名空間內建立 SAE 應用將形成綁定關係。多個命名空間可以對應一個 VPC。不填則預設為命名空間綁定的 VPC ID。

vpc-bp1aevy8sofi8mh1q****

VSwitchId

string

應用執行個體彈性網卡所在的虛擬交換器。該交換器必須位於上述 VPC 內。該交換器與 SAE 命名空間同樣存在綁定關係。不填則預設為命名空間綁定的 vSwitch ID。

vsw-bp12mw1f8k3jgygk9****

PackageType

string

應用程式套件類型。取值說明如下:

  • 當您選擇用 Java 部署時,支援 FatJarWarImage

  • 當您選擇用 PHP 部署時,支援類型如下:

    • 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

  • 當您選擇用 Python 部署時,支援 PythonZipImage

  • 當您選用.NET Core 部署時,支援 DotnetZipImage

    說明

    當選擇 DotnetZip 時,Dotnet 為.NET Core 環境的版本號碼,支援.NET 3.1、.NET 5.0、.NET 6.0、.NET 7.0 和.NET 8.0。同時 Dotnet、Command 和 CommandArgs 選項為必填項。

FatJar

PackageVersion

string

部署套件的版本號碼。當Package TypeFatJarWarPythonZip 時必填。

1.0.0

PackageUrl

string

部署套件地址。當Package TypeFatJarWarPythonZip 時必填。

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

ImageUrl

string

鏡像地址。當Package TypeImage 時必填。

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

Jdk

string

部署套件依賴的 JDK 版本。支援版本如下:

  • Open JDK 8

  • Open JDK 7

  • Dragonwell 11

  • Dragonwell 8

  • openjdk-8u191-jdk-alpine3.9

  • openjdk-7u201-jdk-alpine3.9

Package TypeImage 時不支援。

Open JDK 8

WebContainer

string

WebContainer 部署套件依賴的 Tomcat 版本。支援版本如下:

  • apache-tomcat-7.0.91

  • apache-tomcat-8.5.42

Package TypeImage 時不支援。

apache-tomcat-7.0.91

Cpu

integer

每個執行個體所需的 CPU,單位為毫核,不能為 0。目前僅支援以下固定規格:

  • 500

  • 1000

  • 2000

  • 4000

  • 8000

  • 16000

  • 32000

1000

Memory

integer

每個執行個體所需的記憶體,單位為 MB,不能為 0。與 CPU 為一一對應關係,目前僅支援以下固定規格:

  • 1024:對應 CPU 為 500 毫核和 1000 毫核。

  • 2048:對應 CPU 為 500、1000 毫核和 2000 毫核。

  • 4096:對應 CPU 為 1000、2000 毫核和 4000 毫核。

  • 8192:對應 CPU 為 2000、4000 毫核和 8000 毫核。

  • 12288:對應 CPU 為 12000 毫核。

  • 16384:對應 CPU 為 4000、8000 毫核和 16000 毫核。

  • 24576:對應 CPU 為 12000 毫核。

  • 32768:對應 CPU 為 16000 毫核。

  • 65536:對應 CPU 為 8000、16000 和 32000 毫核。

  • 131072:對應 CPU 為 32000 毫核。

1024

Replicas

integer

初始執行個體數。

1

Command

string

鏡像啟動命令。該命令必須為容器記憶體在的可執行檔對象。樣本如下:

command:
      - echo
      - abc
      - >
      - file0

根據上述樣本,則Command="echo", CommandArgs=["abc", ">", "file0"]

重要 當 PackageType 選擇為 DotnetZip 時,此選項為必填項。

echo

CommandArgs

string

鏡像啟動命令參數。上述啟動命令 Command 所需參數。格式如下:

["a","b"]

在上述樣本中,CommandArgs=["abc", ">", "file0"],其中["abc", ">", "file0"]需要轉成 String 類型,裡面的格式為 JSON 數組。如果無此參數,則無需填寫。

重要 當 PackageType 選擇為 DotnetZip 時,此選項為必填項。

["a","b"]

Envs

string

容器環境變數參數。支援自訂或引用配置項。如需引用配置項,請先建立 ConfigMap 執行個體。更多資訊,請參見 CreateConfigMap 。取值說明如下:

  • 自訂配置
    • name:環境變數名稱。

    • value:環境變數值。優先順序高於 valueFrom。

  • 引用配置項(valueFrom)
    • name:環境變數名稱。支援引用單個或全部鍵,如果引用全部鍵,需輸入sae-sys-configmap-all-<配置項名稱>,例如sae-sys-configmap-all-test1

    • valueFrom:環境變數引用。取值為configMapRef
      • configMapId:配置項 ID。

      • key:鍵。如果引用全部健值,則不設定該欄位。

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

容器內自訂 Host 映射。取值說明如下:

  • hostName:網域名稱或主機名稱。

  • ip:IP 位址。

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

JarStartOptions

string

JAR 包啟動應用選項。應用預設啟動命令:$JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs

-Xms4G -Xmx4G

JarStartArgs

string

JAR 包啟動應用參數。應用預設啟動命令:$JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs

custom-args

Liveness

string

容器健全狀態檢查,健全狀態檢查失敗的容器將被關閉並恢複。支援方式如下:

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

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

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

說明

只能選擇一種方式進行健全狀態檢查。

參數說明如下:

  • exec.command:設定健全狀態檢查命令。

  • httpGet.path:訪問路徑。

  • httpGet.schemeHTTPHTTPS

  • httpGet.isContainKeyWordtrue 表示包含關鍵字,false 表示不包含關鍵字,缺失該欄位表示不使用進階功能。

  • httpGet.keyWord:自訂的關鍵字,使用時不能缺失 isContainKeyWord 欄位。

  • tcpSocket.port:tcp 串連檢測的連接埠 。

  • initialDelaySeconds:設定健全狀態檢查延遲檢測時間,預設為 10,單位為秒。

  • periodSeconds:設定健全狀態檢查周期,預設為 30,單位為秒。

  • timeoutSeconds:設定健全狀態檢查逾時等待時間,預設為 1,單位為秒。如果設定為 0 或不設定,預設逾時等待時間為 1 秒。

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

Readiness

string

應用啟動狀態檢查,多次健全狀態檢查失敗的容器將被關閉並重啟。不通過健全狀態檢查的容器將不會有 SLB 流量進入。支援 exechttpGettcpSocket 方式。具體樣本,請參見 Liveness 參數。

說明

只能選擇一種方式進行健全狀態檢查。

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

Deploy

boolean

是否立即部署。取值說明如下:

  • true:預設值,立即部署。

  • false:稍後部署。

true

EdasContainerVersion

string

HSF 架構中應用運行環境版本,例如 Ali-Tomcat 容器。

3.5.3

Timezone

string

時區,預設為Asia/Shanghai

Asia/Shanghai

SlsConfigs

string

日誌採集到 SLS 的配置。

  • 使用 SAE 自動建立的 SLS 資源:[{"logDir":"","logType":"stdout"},{"logDir":"/tmp/a.log"}]

  • 使用自訂的 SLS 資源:[{"projectName":"test-sls","logType":"stdout","logDir":"","logstoreName":"sae","logtailName":""},{"projectName":"test","logDir":"/tmp/a.log","logstoreName":"sae","logtailName":""}]

參數說明如下:

  • projectName:配置 SLS 上的 Project 名稱。

  • logDir:日誌路徑。

  • logType:日誌類型。stdout 表示容器標準輸出日誌,僅可設定 1 條;如果不設定,則表示收集檔案日誌。

  • logstoreName:配置 SLS 上的 Logstore 名稱。

  • logtailName:配置 SLS 上的 Logtail 名稱,如果不指定,則表示建立 Logtail。

多次部署時如果 SLS 採集配置沒有變更,則不需要設定該參數(即請求中無需包含 SlsConfigs 欄位);如果不再需要使用 SLS 採集功能,您需要在請求中將該欄位的值設定為空白字串(即請求中 SlsConfigs 欄位的值為"")。

說明

隨應用自動建立的 Project 會隨著應用刪除而刪除,因此在選擇已有 Project 時,不能選擇 SAE 自動建立的 Project。

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

NasId

string

不推薦配置該欄位,推薦配置 NasConfigs。掛載的 NAS 的 ID,必須與叢集處在同一個地區。它必須有可用的掛載點建立額度,或者其掛載點已經在 VPC 內的交換器上。如果不填,且存在 mountDescs 欄位,則預設將自動購買一個 NAS 並掛載至 VPC 內的交換器上。

部署時如果配置沒有變更,則不需要設定該參數(即請求中無需包含 NASId 欄位);如果需要清除 NAS 配置,您需要在請求中將該欄位的值設定為空白字串(即請求中 NASId 欄位的值為"")。

KSAK****

MountHost

string

不推薦配置該欄位,推薦配置 NasConfigs。NAS 在應用 VPC 內的掛載點。部署時如果配置沒有變更,則不需要設定該參數(即請求中無需包含 MountHost 欄位);如果需要清除 NAS 配置,您需要在請求中將該欄位的值設定為空白字串(即請求中 MountHost 欄位的值為"")。

example.com

MountDesc

string

不推薦配置該欄位,推薦配置 NasConfigs。NAS 掛載描述。部署時如果配置沒有變更,則不需要設定該參數(即請求中無需包含 MountDesc 欄位);如果需要清除 NAS 配置,您需要在請求中將該欄位的值設定為空白字串(即請求中 MountDesc 欄位的值為"")。

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

PreStop

string

容器停止前執行指令碼。在容器被刪除前觸發執行一段指令碼,格式如:{"exec":{"command":\["cat","/etc/group"]}}

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

PostStart

string

容器啟動後執行指令碼。在容器被建立後立刻觸發執行一段指令碼,格式如:{"exec":{"command":\["cat","/etc/group"]}}

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

WarStartOptions

string

設定 WAR 包部署應用的啟動命令,操作步驟與鏡像部署的啟動命令配置操作相同。更多資訊,請參見設定啟動命令

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

ConfigMapMountDesc

string

ConfigMap 掛載描述。使用在命名空間配置項頁面建立的配置項來向容器中注入配置資訊。參數說明如下:

說明

可通過傳遞sae-sys-configmap-all參數掛載所有鍵。

  • mountPath:掛載路徑。

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

SecurityGroupId

string

安全性群組 ID。

sg-wz969ngg2e49q5i4****

AutoConfig

boolean

是否自動設定網路環境。取值說明如下:

  • true:建立應用時 SAE 自動設定網路環境。NamespaceIdVpcIdvSwitchIdSecurityGroupId 的取值將被忽略。

  • false:建立應用時 SAE 手動設定網路環境。

說明

如果選擇為 true,則傳其他的 NamespaceId 會被忽略。

true

TerminationGracePeriodSeconds

integer

優雅下線逾時時間,預設為 30,單位為秒。取值範圍為 1~300。

30

PhpArmsConfigLocation

string

PHP 應用監控掛載路徑,需要您保證 PHP 伺服器一定會載入這個路徑的設定檔。 您無需關注配置內容,SAE 會自動渲染正確的設定檔。

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

PhpConfigLocation

string

PHP 應用啟動配置掛載路徑,需要您保證 PHP 伺服器會使用這個設定檔啟動。

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

PhpConfig

string

PHP 設定檔內容。

k1=v1

TomcatConfig

string

Tomcat 檔案配置,設定為""或"{}"表示刪除配置:

  • port:連接埠範圍為 1024~65535,小於 1024 的連接埠需要 Root 許可權才能操作。因為容器配置的是 Admin 許可權,所以請填寫大於 1024 的連接埠。如果不配置,則預設為 8080。

  • contextPath:訪問路徑,預設為根目錄"/"。

  • maxThreads:配置串連池的串連數大小,預設大小為 400。

  • uriEncoding:Tomcat 的編碼格式,包括UTF-8ISO-8859-1GBK 和 GB2312。如果不設定,則預設為ISO-8859-1

  • useBodyEncodingForUri:是否使用BodyEncoding for URL,預設為 true

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

OssMountDescs

string

OSS 掛載描述資訊。參數說明如下:

  • bucketName:Bucket 名稱。

  • bucketPath:您在 OSS 建立的目錄或 OSS 對象,如果 OSS 掛載目錄不存在,會觸發異常。

  • mountPath:您在 SAE 的容器路徑。如果路徑已存在,為覆蓋關係;如果路徑不存在,會建立。

  • readOnly:容器路徑是否對掛載目錄資源有可讀許可權,取值說明如下:
    • true:唯讀許可權。

    • false:讀寫權限。

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

OssAkId

string

OSS 讀寫的 AccessKey ID。

xxxxxx

OssAkSecret

string

OSS 讀寫的 AccessKey Secret。

xxxxxx

Php

string

PHP 部署套件依賴的 PHP 版本。鏡像不支援。

PHP-FPM 7.0

AcrInstanceId

string

Container Registry ACR 企業版執行個體 ID。當 ImageUrl 為Container Registry企業版時必填。

cri-xxxxxx

AcrAssumeRoleArn

string

跨帳號拉取鏡像時所需的 RAM 角色的 ARN。更多資訊,請參見通過 RAM 角色實現跨雲帳號授權

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

ImagePullSecrets

string

對應保密字典 ID。

10

AssociateEip

boolean

是否綁定 EIP。取值說明如下:

  • true:綁定。

  • false:不綁定。

true

ProgrammingLanguage

string

建立應用的技術棧語言。取值說明如下:

  • java:Java 語言。

  • php:PHP 語言。

  • python:Python 語言

  • dotnet:.NET Core 語言

  • other:多語言,例如 C++、Go 和 Node.js 等。

java

KafkaConfigs

string

日誌採集到 Kafka 的配置匯總資訊。取值說明如下:

  • kafkaEndpoint:Kafka API 的服務接入地址。

  • kafkaInstanceId:Kafka 執行個體 ID。

  • kafkaConfigs:單條或多條日誌的配置匯總資訊。取值說明,請參見本文的請求參數 kafkaConfigs

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

開啟 K8s Service 服務註冊發現。取值說明如下:

  • serviceName:服務名稱。格式為自訂-命名空間 ID,其中尾碼-命名空間 ID不支援自訂,需根據應用所在命名空間填寫。例如,選擇華北 2(北京)地區的預設命名空間,則為-cn-beijing-default

  • namespaceId:命名空間 ID。

  • portProtocols:連接埠與協議。連接埠取值範圍為[1,65535],協議支援 TCPUDP

  • portAndProtocol:連接埠與協議。連接埠取值範圍為[1,65535],協議支援 TCPUDP優先推薦 portProtocols,如果設定了 portProtocols,僅 portProtocols 生效

  • enable:開啟 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

選擇 Nacos 註冊中心,取值說明如下:

  • 0:SAE 內建 Nacos。

  • 1:使用者自建 Nacos。

  • 2:MSE 商業版 Nacos。

"0"

MicroRegistrationConfig

string

註冊中心配置資訊。

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

NasConfigs

string

掛載 NAS 的配置。取值說明如下:

  • mountPath:容器掛載路徑。

  • readOnly:取值為 false 時,表示擁有讀寫權限。

  • nasId:NAS ID。

  • mountDomain:容器掛載點地址。更多資訊,請參見 DescribeMountTargets

  • nasPath: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

Python 環境。支援PYTHON 3.9.15

PYTHON 3.9.15

PythonModules

string

自訂安裝模組依賴。預設安裝根目錄下 requirements.txt 定義的依賴項。如果未配置或自訂軟體包,可以指定安裝的依賴。

Flask==2.0

Dotnet

string

.NET 架構的版本號碼:

  • .NET 3.1

  • .NET 5.0

  • .NET 6.0

  • .NET 7.0

  • .NET 8.0

.NET 3.1

EnableEbpf

string

基於 eBPF 技術,對非 Java 應用開啟應用監控能力。取值說明如下:

  • true:開啟。

  • false:關閉。預設值。

false

SaeVersion

string

SAE 版本。支援版本如下:

  • v1

  • v2

v1

AppSource

string

選擇 micro_service,即為微服務應用。

micro_service

BaseAppId

string

基礎應用 ID。

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

ServiceTags

string

應用配置的灰階標籤

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

EnableNewArms

boolean

是否啟用新的 ARMS 功能:

  • true:啟用

  • false:不啟用

false

EnableCpuBurst

boolean

是否啟用 CPU Burst 功能:

  • true:啟用

  • false:不啟用

true

OidcRoleName

string

設定身份認證服務 RAM 角色。

說明

需要提前建立同地區的 OIDC 身份供應商和身份供應商角色。具體資訊,請參見建立 OIDC 身份供應商建立角色 SSO 身份供應商

sae-test

SidecarContainersConfig

array

容器配置資訊。

SidecarContainerConfig

容器配置資訊。

SecretMountDesc

string

Secret 掛載描述。使用在命名空間保密字典頁面建立的保密字典來向容器中注入保密資訊。參數說明如下:

  • secretId:secret 執行個體 ID。可通過 ListSecrets 介面擷取。

  • key:索引值。

說明

可通過傳遞sae-sys-secret-all參數掛載所有鍵。

  • mountPath:掛載路徑。

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

EnableSidecarResourceIsolated

boolean

是否啟用 Sidecar 資源隔離:

  • true:進行隔離

  • false:不進行隔離

true

CustomImageNetworkType

string

自訂鏡像類型,如果非自訂鏡像,需要設定為空白字串:

  • internet:公網鏡像

  • intranet:私網鏡像

internet

ResourceType

string

資源類型。支援 NULL(預設)、default(預設)和 haiguang(海光伺服器)類型。

NULL

NewSaeVersion

string

應用版本:

  • lite:輕量版

  • std:標準版

  • pro:專業版

pro

MicroserviceEngineConfig

string

配置微服務治理功能。

  • 是否開啟微服務治理(enable):

    • ture:開啟

    • false:不開啟

  • 配置無損上下線(mseLosslessRule):

    • delayTime:延遲時間

    • enable:是否啟用無損上線功能,ture 為開啟,false 為不開啟。

    • notice:是否啟用通知功能,ture 為啟用,false 為啟用。

    • warmupTime:小流量預熱時間長度,單位為秒。

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

DiskSize

integer

磁碟儲存大小(單位 GB)。

50

InitContainersConfig

array

初始化容器配置。

InitContainerConfig

初始化容器配置

GpuConfig

string

StartupProbe

string

啟用應用啟動探測。

  • 檢查成功:表示應用啟動成功,如果您配置了 Liveness 檢查和 Readiness 檢查,應用啟動成功後會執行 Liveness 檢查和 Readiness 檢查。

  • 檢查失敗:表示應用啟動失敗,會上報異常並自動重啟。

說明
  • 支援 exec、httpGet 和 tcpSocket 方式。具體樣本,請參見 Liveness 參數。

  • 只能選擇一種方式進行健全狀態檢查。

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

IsStateful

boolean

是否有狀態應用

EnablePrometheus

boolean

是否開啟 Prometheus 自訂指標採集

false

HeadlessPvtzDiscoverySvc

string

K8s Headless Service 服務註冊發現

  • serviceName:服務名稱

  • namespaceId: 命名空間 ID

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

Html

string

Nginx 版本

  • nginx 1.20

  • nginx 1.22

  • nginx 1.24

  • nginx 1.26

  • nginx 1.28

nginx 1.28

EmptyDirDesc

string

共用臨時儲存配置。

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

AgentVersion

string

AliyunAgent 版本

4.4.2

EnableNamespaceAgentVersion

boolean

是否複用命名空間 Agent 版本配置

true

EnableNamespaceSlsConfig

boolean

是否複用命名空間 SLS 日誌配置

true

SlsLogEnvTags

string

sls log tags

LokiConfigs

string

Labels

object

string

返回參數

名稱

類型

描述

樣本值

object

建立的應用資訊。

RequestId

string

請求 ID。

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

Message

string

附加資訊。取值說明如下:

  • 請求正常,返回 success

  • 請求異常,返回具體異常錯誤碼。

success

TraceId

string

調用鏈 ID,用於精確查詢調用資訊。

0a98a02315955564772843261e****

Data

object

返回結果。

ChangeOrderId

string

返回的發布單 ID,用於查詢任務執行狀態。

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

AppId

string

建立成功的應用 ID。

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

ErrorCode

string

錯誤碼。取值說明如下:

  • 請求成功:不返回 ErrorCode 欄位。

  • 請求失敗:返回 ErrorCode 欄位。具體資訊,請參見本文的錯誤碼列表。

Code

string

介面狀態或 POP 錯誤碼。取值說明如下:

  • 2xx:成功。

  • 3xx:重新導向。

  • 4xx:請求錯誤。

  • 5xx:伺服器錯誤。

200

Success

boolean

建立應用是否成功。取值說明如下:

  • true:建立成功。

  • false:建立失敗。

true

樣本

正常返回樣本

JSON格式

{
  "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
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 Application.MissingJdk Your application must at least contain a JDK component. 應用必須至少包含JDK組件。
400 InvalidPackageType.NotFound The package type must be War, FatJar, or Image. 包類型必須為WAR、FatJAR或Image。
400 InvalidParameter.NotEmpty You must specify the parameter %s. 不合法的參數:%s不可為空。
400 InvalidParameter.Obviously The specified parameter is invalid {%s}. 不合法的參數{%s}。
400 JarApplication.MissingJdk A FatJar application must contain JDK. FatJar類型應用必須包含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. Pandora應用缺少JDK組件。
400 PandoraApplication.OnlyJdk A Pandora application only requires JDK component. Pandora應用只需要JDK組件。
400 InvalidParameter.WithMessage The parameter is invalid {%s}: %s 不合法的參數{%s}:%s。
400 InvalidComponent.NotFound The current component (such as JDK, Tomcat, or EDASWebContainer) does not exist. 找不到當前組件(JDK、Tomcat、EDASWebContainer等)。
400 InvalidHostnameIp.Invalid The hostname and/or IP is invalid: Hostname [%s], IP [%s]. 主機名稱或IP不合法:主機名稱[%s],IP[%s]。
400 InvalidInstanceSpecification.Unsupported The instance specification is not supported: CPU [%s], memory [%s]. 不支援的執行個體規格。CPU[%s],Memory[%s]。
400 InvalidServerlessRegion.Unsupported The current region is not supported: %s 不支援當前地區:%s。
400 WarApplication.MissingJdkWebcontainer A War application must contain JDK and Tomcat. WAR類型應用必須包含JDK和Tomcat。
400 InvalidNamespace.WithUppercase This namespace does not support creating SAE apps because it contains uppercase letters. 命名空間不支援建立SAE應用,因為它帶有大寫字母。
400 LogService.ConfigQuotaExceed The maximum number of Log Service configs is exceeded. Log Service配置個數超過配額限制,請加入釘群32874633聯絡技術產品專家進行諮詢。
400 LogService.InternalError An exception occurred while calling Log Service. Please submit a ticket to solve the problem. 調用Log Service異常,請加入釘群32874633聯絡技術產品專家進行諮詢。
400 LogService.LogDirInvalid The log collection path is invalid. 日誌採集路徑不合法。
400 LogService.NotAvailable Log Service is unavailable. Please activate Log Service first. Log Service不可用,請先開通Log Service。
400 LogService.ProjectNumQuotaExceed The maximum number of Log Service projects is exceeded. Log Service專案個數超過配額限制,請加入釘群32874633聯絡技術產品專家進行諮詢。
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. 每個應用只允許建立%s個執行個體,請加入釘群32874633聯絡技術產品專家進行諮詢。
400 NoComputeResourceQuota.User.Exceed Your account is limited to create %s instances. Please submit a ticket to raise the quota. 您的賬戶限額%s個執行個體,請加入釘群32874633聯絡技術產品專家進行諮詢。
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. ConfigMap掛載路徑%s存在衝突。
400 NotFound.ConfigMap The ConfigMap object (ID: %s) does not exist. 找不到ConfigMap對象(ID=%s)。
400 NotFound.ConfigMapKey The key %s of ConfigMap object (ID: %s) does not exist. 找不到ConfigMap對象(ID=%s)的Key %s。
400 Sls.Config.Mixed.Multi.Project The specified Config contains multiple projects. 您輸入的SLS Config中指定了多個Project。
400 Sls.Config.User.Defined.Missing.Logstore.Info The specified Config is invalid. Both Project and Logstore must be specified. 您輸入的SLS Config為自訂SLS配置,但是只有Project配置,缺失Logstore配置。
400 Sls.Config.User.Defined.Missing.Project.Info The specified Config is invalid. Both Project and Logstore must be specified. 您輸入的SLS Config為自訂SLS配置,但是只有Logstore配置,缺失Project配置。
400 Sls.Logstore.Name.Invalid The specified name of Logstore is invalid. The Logstore name must not contain the prefix "sae-". 您輸入的SLS Logstore名稱不合法,首碼包含了"sae-",會與SAE自動建立的Logstore混淆。
400 Sls.Logstore.User.Defined.Not.Exist The user defined Logstore does not exist. 您輸入的自建Logstore不存在。
400 Sls.Project.Name.Invalid The specified project name is invalid. The project name must not contain the prefix "sae-". 您輸入的SLS Project名稱不合法,首碼包含了"sae-",會與SAE自動建立的Project混淆。
400 Sls.Project.User.Defined.Not.Exist The user defined project does not exist. 您輸入的自建Project不存在。
400 InvalidImageUrl.AcrInstanceId.Domain.NotMatch The specified domain of ImageUrl does not match AcrInstanceId domains. 指定的鏡像地址ImageUrl網域名稱與AcrInstanceId網域名稱不匹配。
400 PhpApplication.MissingPhpRuntime A PHP application must contain PHP Runtime. PHP類型應用必須包含PHP運行時。
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. 應用部署程式包名稱無效。名稱只能包含字母、數字和特殊字元“-”“_”。Java 軟體包部署,僅當選擇的部署版本支援JAR部署時方可上傳JAR包,否則只能上傳WAR包;PHP 軟體包部署,僅當選擇的部署版本支援ZIP部署時方可上傳ZIP包
400 Sls.Logtail.Name.Invalid The specified name of Logtail is invalid. The Logtail name must not contain the prefix sae-. 您輸入的SLS Logtail名稱不合法,首碼包含了"sae-",會與SAE自動建立的Logtail混淆。
400 vswitch.not.exist The specified vSwitch does not exist. vSwitch不存在,請更換vSwitch。
400 InvalidImageUrl.MissingAcrInstanceId The specified domain of ImageUrl is from ACREE, but you are not specified AcrInstanceId. 指定的鏡像地址 ImageUrl 網域名稱為Container Registry企業版 ACREE,但未指定執行個體 AcrInstanceId。
400 EnvFromSecretIdConflict.AlreadyExist The specified SecretId [%s] already exist in the specified Envs. 指定的保密字典[%s]已經存在於環境變數中。
400 MountConflict.Secret Conflict detected for Secret path %s. Secret掛載路徑%s存在衝突。
404 Associate.Eip.Not.Enough No sufficient EIPs are available. 綁定EIP時,EIP不足,需要您購買。
404 InvalidNamespaceId.NotFound The specified NamespaceId does not exist. 指定的NamespaceId不存在。
404 InvalidVpcId.NotFound The specified VpcId does not exist. 指定的VpcId不存在。
404 InvalidAcrInstanceId.NotFound The specified AcrInstanceId does not exist. 指定的 AcrInstanceId 不存在。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情