CreateApplication

应用名称。允许数字、字母以及短划线（-）组合。必须以字母开始，不允许以短划线（-）结尾，不超过36个字符。

SAE命名空间ID。仅支持名称为小写字母加短划线（-）的命名空间，必须以字母开始。 命名空间可通过调用DescribeNamespaceList接口获取。

应用描述信息。不超过1024个字符。

SAE命名空间对应的VPC。在SAE中，一个命名空间只能对应一个VPC，且不能修改。第一次在命名空间内创建SAE应用将形成绑定关系。多个命名空间可以对应一个VPC。不填则默认为命名空间绑定的VPC ID。

应用实例弹性网卡所在的虚拟交换机。该交换机必须位于上述VPC内。该交换机与SAE命名空间同样存在绑定关系。不填则默认为命名空间绑定的vSwitch ID。

应用包类型。取值说明如下：

• 当您选择用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。

部署包的版本号。当Package Type为FatJar、War或PythonZip时必填。

部署包地址。当Package Type为FatJar、War或PythonZip时必填。

镜像地址。当Package Type为Image时必填。

部署包依赖的JDK版本。支持版本如下：

• Open JDK 8
• Open JDK 7
• Dragonwell 11
• Dragonwell 8
• openjdk-8u191-jdk-alpine3.9
• openjdk-7u201-jdk-alpine3.9

当Package Type为Image时不支持。

WebContainer部署包依赖的Tomcat版本。支持版本如下：

• apache-tomcat-7.0.91
• apache-tomcat-8.5.42

当Package Type为Image时不支持。

每个实例所需的CPU，单位为毫核，不能为0。目前仅支持以下固定规格：

• 500
• 1000
• 2000
• 4000
• 8000
• 16000
• 32000

每个实例所需的内存，单位为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毫核。

初始实例数。

镜像启动命令。该命令必须为容器内存在的可执行的对象。示例如下：

command:
      - echo
      - abc
      - >
      - file0

根据上述示例，则Command="echo", CommandArgs=["abc", ">", "file0"]。

镜像启动命令参数。上述启动命令Command所需参数。格式如下：

["a","b"]

在上述示例中，CommandArgs=["abc", ">", "file0"]，其中["abc", ">", "file0"]需要转成String类型，里面的格式为JSON数组。如果无此参数，则无需填写。

容器环境变量参数。支持自定义或引用配置项。如需引用配置项，请先创建ConfigMap实例。更多信息，请参见CreateConfigMap。取值说明如下：

• 自定义配置
  • name：环境变量名称。
  • value：环境变量值。优先级高于valueFrom。
• 引用配置项（valueFrom）
  • name：环境变量名称。支持引用单个或全部键，如果引用全部键，需输入sae-sys-configmap-all-<配置项名称>，例如sae-sys-configmap-all-test1。
  • valueFrom：环境变量引用。取值为configMapRef。
  • configMapId：配置项ID。
  • key：键。如果引用全部健值，则不设置该字段。

容器内自定义Host映射。取值说明如下：

• hostName：域名或主机名。
• ip：IP地址。

JAR包启动应用选项。应用默认启动命令：$JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs

JAR包启动应用参数。应用默认启动命令：$JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs

容器健康检查，健康检查失败的容器将被关闭并恢复。支持方式如下：

• 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秒。

应用启动状态检查，多次健康检查失败的容器将被关闭并重启。不通过健康检查的容器将不会有SLB流量进入。支持exec、httpGet和tcpSocket方式。具体示例，请参见Liveness参数。

是否立即部署。取值说明如下：

• true：默认值，立即部署。
• false：稍后部署。

HSF框架中应用运行环境版本，例如Ali-Tomcat容器。

时区，默认为Asia/Shanghai。

日志采集到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字段的值为""）。

不推荐配置该字段，推荐配置NasConfigs。挂载的NAS的ID，必须与集群处在同一个地域。它必须有可用的挂载点创建额度，或者其挂载点已经在VPC内的交换机上。如果不填，且存在mountDescs字段，则默认将自动购买一个NAS并挂载至VPC内的交换机上。

部署时如果配置没有变更，则不需要设置该参数（即请求中无需包含NASId字段）；如果需要清除NAS配置，您需要在请求中将该字段的值设置为空字符串（即请求中NASId字段的值为""）。

不推荐配置该字段，推荐配置NasConfigs。NAS在应用VPC内的挂载点。部署时如果配置没有变更，则不需要设置该参数（即请求中无需包含MountHost字段）；如果需要清除NAS配置，您需要在请求中将该字段的值设置为空字符串（即请求中MountHost字段的值为""）。

不推荐配置该字段，推荐配置NasConfigs。NAS挂载描述。部署时如果配置没有变更，则不需要设置该参数（即请求中无需包含MountDesc字段）；如果需要清除NAS配置，您需要在请求中将该字段的值设置为空字符串（即请求中MountDesc字段的值为""）。

容器停止前执行脚本。在容器被删除前触发执行一段脚本，格式如：{"exec":{"command":\["cat","/etc/group"]}}

容器启动后执行脚本。在容器被创建后立刻触发执行一段脚本，格式如：{"exec":{"command":\["cat","/etc/group"]}}

设置WAR包部署应用的启动命令，操作步骤与镜像部署的启动命令配置操作相同。更多信息，请参见设置启动命令。

ConfigMap挂载描述。使用在命名空间配置项页面创建的配置项来向容器中注入配置信息。参数说明如下：

• configMapId：ConfigMap实例ID。可通过调用ListNamespacedConfigMaps接口获取。
• key：键值。

• mountPath：挂载路径。

安全组ID。

是否自动配置网络环境。取值说明如下：

• true：创建应用时SAE自动配置网络环境。NamespaceId、VpcId、vSwitchId和SecurityGroupId的取值将被忽略。
• false：创建应用时SAE手动配置网络环境。

优雅下线超时时间，默认为30，单位为秒。取值范围为1~300。

PHP应用监控挂载路径，需要您保证PHP服务器一定会加载这个路径的配置文件。 您无需关注配置内容，SAE会自动渲染正确的配置文件。

PHP应用启动配置挂载路径，需要您保证PHP服务器会使用这个配置文件启动。

PHP配置文件内容。

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。

OSS挂载描述信息。参数说明如下：

• bucketName：Bucket名称。
• bucketPath：您在OSS创建的目录或OSS对象，如果OSS挂载目录不存在，会触发异常。
• mountPath：您在SAE的容器路径。如果路径已存在，为覆盖关系；如果路径不存在，会新建。
• readOnly：容器路径是否对挂载目录资源有可读权限，取值说明如下：
  • true：只读权限。
  • false：读写权限。

OSS读写的AccessKey ID。

OSS读写的AccessKey Secret。

PHP部署包依赖的PHP版本。镜像不支持。

容器镜像服务ACR企业版实例ID。当ImageUrl为容器镜像服务企业版时必填。

跨账号拉取镜像时所需的RAM角色的ARN。更多信息，请参见通过RAM角色实现跨云账号授权。

对应保密字典ID。

是否绑定EIP。取值说明如下：

• true：绑定。
• false：不绑定。

创建应用的技术栈语言。取值说明如下：

• java：Java语言。
• php：PHP语言。
• other：多语言，例如Python、C++、Go、.NET和Node.js等。

日志采集到Kafka的配置汇总信息。取值说明如下：

• kafkaEndpoint：Kafka API的服务接入地址。
• kafkaInstanceId：Kafka实例ID。
• kafkaConfigs：单条或多条日志的配置汇总信息。取值说明，请参见本文的请求参数kafkaConfigs。

开启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服务注册发现。

选择Nacos注册中心，取值说明如下：

• 0：SAE内置Nacos。
• 1：用户自建Nacos。
• 2：MSE商业版Nacos。

挂载NAS的配置。取值说明如下：

• mountPath：容器挂载路径。
• readOnly：取值为false时，表示拥有读写权限。
• nasId：NAS ID。
• mountDomain：容器挂载点地址。更多信息，请参见DescribeMountTargets。
• nasPath：NAS相对文件目录。

Python环境。支持PYTHON 3.9.15。

自定义安装模块依赖。默认安装根目录下requirements.txt定义的依赖项。如果未配置或自定义软件包，可以指定安装的依赖。

基于eBPF技术，对非Java应用开启应用监控能力。取值说明如下：

• true：开启。
• false：关闭。默认值。

请求ID。

附加信息。取值说明如下：

• 请求正常，返回success。
• 请求异常，返回具体异常错误码。

调用链ID，用于精确查询调用信息。

错误码。取值说明如下：

• 请求成功：不返回ErrorCode字段。
• 请求失败：返回ErrorCode字段。具体信息，请参见本文的错误码列表。

接口状态或POP错误码。取值说明如下：

• 2xx：成功。
• 3xx：重定向。
• 4xx：请求错误。
• 5xx：服务器错误。

创建应用是否成功。取值说明如下：

• true：创建成功。
• false：创建失败。