CreateJob

任务模板名称。允许数字、字母以及短划线（-）组合。必须以字母开始，不超过36个字符。

SAE命名空间ID。仅支持名称为小写字母加短划线（-）的命名空间，必须以字母开始。

任务模板描述信息。不超过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时不支持。

部署包依赖的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所需参数。格式如下：

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

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

• 自定义配置
  • name：环境变量名称。
  • value：环境变量值。
• 引用配置项
  • 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

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字段的值为""）。

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

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

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

容器停止前执行脚本。在容器被删除前触发执行一段脚本，格式如：{"exec":{"command":["sh","-c","echo hello"]}}

容器启动后执行脚本。在容器被创建后立刻触发执行一段脚本，格式如：{"exec":{"command":["sh","-c","echo hello"]}}

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

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

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

• mountPath：挂载路径。

安全组ID。

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

• true：创建任务模板时SAE自动配置网络环境。NamespaceId、VpcId、VSwitchId和SecurityGroupId的取值将被忽略。
• false：创建任务模板时SAE手动配置网络环境。

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

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。
• useBodyEncoding：是否使用BodyEncoding for URL，默认为true。

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

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

OSS读写的AccessKey ID。

OSS读写的AccessKey Secret。

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

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

对应保密字典ID。

是否开启镜像加速。取值说明如下：

• true：开启。
• false：关闭。

Workload需指定为job。

任务触发配置，根据任务类型进行配置。

• 定时任务：type字段设为time，config字段为具体Cron表达式，timezone字段为指定时区。

  配置示例：{"type":"time","config":"0 1 */1 * ?","timezone":"GMT+8:00"}

• 一次性任务：type字段设为http，config配置具体的HTTP触发规则。更多信息，请参见请求参数SourceHttpEventParameters。

  配置示例：{"type":"http","config":{"type":"HTTPS","method"、["GET"],"ip":[],"referer":[],"securityConfig":"none"}}

任务并发策略。取值说明如下：

• Forbid：禁止并发运行，在前一个任务未完成时，不创建新任务。
• Allow：允许并发运行任务。
• Replace：当到达新任务创建时间点，而前一个任务未完成时，新的任务会取代前一个任务。

任务超时时间，单位为秒。

任务重试次数。

启用任务分片。

任务分片参数。

引用的任务目标ID。

程序编程语言。支持java、php、python和shell。

Python环境。支持PYTHON 3.9.15。

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

请求ID。

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

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

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

错误码。取值说明如下：

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

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

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

创建任务模板是否成功。取值说明如下：

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