全部產品
Search

搜尋本產品

    Serverless App Engine：CreateApplication

    文件中心

    Serverless App Engine：CreateApplication

    更新時間：Jul 10, 2026

    建立一個應用程式。

    調試

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

    調試

    授權資訊

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

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

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    sae:CreateApplication

    create

    *All Resource

    *

    		 無 無

    請求文法

    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 部署時，支援 FatJar、War 和 Image。

    • 當您選擇用 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 部署時，支援 PythonZip 和 Image。

    • 當您選用 .NET Core 部署時，支援 DotnetZip 和 Image。

      說明

      當選擇 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 Type 為 FatJar、War 或 PythonZip 時必填。

    1.0.0
    PackageUrl

    string

    否

    部署套件位址。當 Package Type 為 FatJar、War 或 PythonZip 時必填。

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

    string

    否

    映像位址。當 Package Type 為 Image 時必填。

    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 Type 為 Image 時不支援。

    Open JDK 8
    WebContainer

    string

    否

    WebContainer 部署套件相依的 Tomcat 版本。支援版本如下：

    • apache-tomcat-7.0.91

    • apache-tomcat-8.5.42

    當 Package Type 為 Image 時不支援。

    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.scheme：HTTP 或 HTTPS。

    • httpGet.isContainKeyWord：true 表示包含關鍵字，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 流量進入。支援 exec、httpGet 和 tcpSocket 方式。具體範例，請參見 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 自動設定網路環境。NamespaceId、VpcId、vSwitchId 和 SecurityGroupId 的取值將被忽略。

    • 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-8、ISO-8859-1、GBK 和 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

    否

    容器映像服務 ACR 企業版執行個體 ID。當 ImageUrl 為容器映像服務企業版時必填。

    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]，通訊協定支援 TCP 和 UDP。

    • portAndProtocol：連接埠與通訊協定。連接埠取值範圍為 [1,65535]，通訊協定支援 TCP 和 UDP。優先推薦 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

    否

    是否複用命名空間 Agent 版本設定。

    4.4.2
    EnableNamespaceAgentVersion

    boolean

    否

    AliyunAgent 版本。

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

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

    變更歷史

    更多資訊，參考變更詳情。