Todos los productos
Search
Centro de documentos

Serverless App Engine:CreateApplication

Última actualización: Sep 01, 2026

Crea una aplicación.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

sae:CreateApplication

create

*All Resource

*

Ninguna Ninguna

Sintaxis de la solicitud

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

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

AppName

string

Sí

El nombre de la aplicación. El nombre puede contener dígitos, letras y guiones (-). Debe comenzar con una letra y no puede terminar con un guion (-). La longitud máxima es de 36 caracteres.

test

NamespaceId

string

No

El ID del espacio de nombres de SAE. Solo se admiten espacios de nombres cuyos nombres contengan letras minúsculas y guiones (-). El nombre debe comenzar con una letra. Puede obtener los espacios de nombres mediante la operación DescribeNamespaceList.

cn-beijing:test

AppDescription

string

No

La descripción de la aplicación. La descripción puede tener una longitud máxima de 1024 caracteres.

Esta es una descripción de prueba

VpcId

string

No

La VPC que corresponde al espacio de nombres de SAE. En SAE, un espacio de nombres solo puede corresponder a una VPC, y la asignación no se puede modificar. La relación de vinculación se establece cuando se crea la primera aplicación de SAE en el espacio de nombres. Varios espacios de nombres pueden corresponder a la misma VPC. Si deja este parámetro vacío, se utiliza de forma predeterminada la VPC vinculada al espacio de nombres.

vpc-bp1aevy8sofi8mh1q****

VSwitchId

string

No

El vSwitch donde reside el controlador de interfaz de red elástica (NIC) de la instancia de la aplicación. El vSwitch debe estar en la VPC especificada. El vSwitch también tiene una relación de vinculación con el espacio de nombres de SAE. Si deja este parámetro vacío, se utiliza de forma predeterminada el vSwitch asociado al espacio de nombres.

vsw-bp12mw1f8k3jgygk9****

PackageType

string

Sí

El tipo de paquete de despliegue de la aplicación. Valores válidos:

  • Si utiliza Java para el despliegue, se admiten FatJar, War e Image.

  • Si utiliza PHP para el despliegue, se admiten los siguientes tipos:

    • 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

  • Si utiliza Python para el despliegue, se admiten PythonZip e Image.

  • Si utiliza .NET Core para el despliegue, se admiten DotnetZip e Image.

    Nota

    Cuando se selecciona DotnetZip, Dotnet especifica la versión del entorno de ejecución de .NET Core. Se admiten .NET 3.1, .NET 5.0, .NET 6.0, .NET 7.0 y .NET 8.0. Los parámetros Dotnet, Command y CommandArgs son obligatorios.

FatJar

PackageVersion

string

No

La versión del paquete de despliegue. Este parámetro es obligatorio cuando Package Type está configurado como FatJar, War o PythonZip.

1.0.0

PackageUrl

string

No

La dirección del paquete de despliegue. Este parámetro es obligatorio cuando Package Type está configurado como FatJar, War o PythonZip.

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

ImageUrl

string

No

La dirección de la imagen. Este parámetro es obligatorio cuando Package Type está configurado como Image.

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

Jdk

string

No

La versión de JDK de la que depende el paquete de despliegue. Valores válidos:

  • Open JDK 8

  • Open JDK 7

  • Dragonwell 11

  • Dragonwell 8

  • openjdk-8u191-jdk-alpine3.9

  • openjdk-7u201-jdk-alpine3.9

Este parámetro no se admite cuando Package Type está configurado como Image.

Open JDK 8

WebContainer

string

No

La versión de Tomcat de la que depende el paquete de despliegue de WebContainer. Valores válidos:

  • apache-tomcat-7.0.91

  • apache-tomcat-8.5.42

Este parámetro no se admite cuando Package Type está configurado como Image.

apache-tomcat-7.0.91

Cpu

integer

No

Las especificaciones de CPU requeridas para cada instancia, en milinúcleos. Este parámetro no se puede configurar en 0. Solo se admiten las siguientes especificaciones definidas:

  • 500

  • 1000

  • 2000

  • 4000

  • 8000

  • 16000

  • 32000

1000

Memory

integer

No

La memoria requerida para cada instancia, en MB. Este parámetro no se puede configurar en 0. La memoria tiene una asignación uno a uno con la CPU. Solo se admiten las siguientes especificaciones definidas:

  • 1024: corresponde a 500 y 1000 milinúcleos de CPU.

  • 2048: corresponde a 500, 1000 y 2000 milinúcleos de CPU.

  • 4096: corresponde a 1000, 2000 y 4000 milinúcleos de CPU.

  • 8192: corresponde a 2000, 4000 y 8000 milinúcleos de CPU.

  • 12288: corresponde a 12000 milinúcleos de CPU.

  • 16384: corresponde a 4000, 8000 y 16000 milinúcleos de CPU.

  • 24576: corresponde a 12000 milinúcleos de CPU.

  • 32768: corresponde a 16000 milinúcleos de CPU.

  • 65536: corresponde a 8000, 16000 y 32000 milinúcleos de CPU.

  • 131072: corresponde a 32000 milinúcleos de CPU.

1024

Replicas

integer

Sí

El número inicial de instancias.

1

Command

string

No

El comando que se utiliza para iniciar la imagen. El comando debe ser un objeto ejecutable en el contenedor. Ejemplo:

command:
      - echo
      - abc
      - >
      - file0

En el ejemplo anterior, Command="echo", CommandArgs=["abc", ">", "file0"].

Importante Este parámetro es obligatorio cuando PackageType está configurado como DotnetZip.

echo

CommandArgs

string

No

Los argumentos del comando de inicio de la imagen. Estos son los argumentos requeridos por el comando de inicio especificado en Command. Formato:

["a","b"]

En el ejemplo anterior, CommandArgs=["abc", ">", "file0"], donde ["abc", ">", "file0"] debe convertirse al tipo String. El formato interno es una matriz JSON. Si este parámetro no es necesario, déjelo vacío.

Importante Este parámetro es obligatorio cuando PackageType está configurado como DotnetZip.

["a","b"]

Envs

string

No

Los parámetros de variables de entorno del contenedor. Puede personalizar las variables de entorno o hacer referencia a un ConfigMap. Para hacer referencia a un ConfigMap, primero cree una instancia de ConfigMap. Para obtener más información, consulte CreateConfigMap. Valores válidos:

  • Configuración personalizada
    • name: el nombre de la variable de entorno.

    • value: el valor de la variable de entorno. Esto tiene prioridad sobre valueFrom.

  • Referencia a un ConfigMap (valueFrom)
    • name: el nombre de la variable de entorno. Puede hacer referencia a una sola clave o a todas las claves. Para hacer referencia a todas las claves, introduzca sae-sys-configmap-all-<nombre del ConfigMap>, por ejemplo, sae-sys-configmap-all-test1.

    • valueFrom: la referencia de la variable de entorno. Configure el valor como configMapRef.
      • configMapId: el ID del ConfigMap.

      • key: la clave. Si hace referencia a todas las claves, no configure este campo.

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

La asignación de host personalizada en el contenedor. Valores válidos:

  • hostName: el nombre de dominio o nombre de host.

  • ip: la dirección IP.

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

JarStartOptions

string

No

Las opciones para iniciar la aplicación de paquete JAR. El comando de inicio predeterminado para la aplicación: $JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs

-Xms4G -Xmx4G

JarStartArgs

string

No

Los argumentos para iniciar la aplicación de paquete JAR. El comando de inicio predeterminado para la aplicación: $JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs

custom-args

Liveness

string

No

La verificación de estado del contenedor. Los contenedores que no superan la verificación de estado se apagan y se recuperan. Se admiten los siguientes métodos:

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

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

  • tcpSocket: por ejemplo, {"tcpSocket":{"port":18091},"initialDelaySeconds":11,"periodSeconds":10,"timeoutSeconds":1}

Nota

Solo puede utilizar un método para las verificaciones de estado.

Descripción de parámetros:

  • exec.command: el comando de verificación de estado.

  • httpGet.path: la ruta de acceso.

  • httpGet.scheme: HTTP o HTTPS.

  • httpGet.isContainKeyWord: true indica que la palabra clave está incluida. false indica que la palabra clave no está incluida. Si falta este campo, no se utiliza la función avanzada.

  • httpGet.keyWord: la palabra clave personalizada. El campo isContainKeyWord debe estar presente cuando se utiliza este campo.

  • tcpSocket.port: el puerto para la detección de conexión TCP.

  • initialDelaySeconds: el tiempo de detección de retardo de la verificación de estado. Valor predeterminado: 10. Unidad: segundos.

  • periodSeconds: el periodo de verificación de estado. Valor predeterminado: 30. Unidad: segundos.

  • timeoutSeconds: el periodo de tiempo de espera de la verificación de estado. Valor predeterminado: 1. Unidad: segundos. Si este parámetro se configura en 0 o no se configura, el periodo de tiempo de espera predeterminado es de 1 segundo.

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

Readiness

string

No

La verificación del estado de inicio de la aplicación. Los contenedores que no superan múltiples verificaciones de estado se apagan y se reinician. Los contenedores que no superan la verificación de estado no reciben tráfico de SLB. Se admiten los métodos exec, httpGet y tcpSocket. Para ver ejemplos específicos, consulte el parámetro Liveness.

Nota

Solo puede utilizar un método para las verificaciones de estado.

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

Deploy

boolean

No

Especifica si se debe desplegar la aplicación inmediatamente. Valores válidos:

  • true: valor predeterminado. La aplicación se despliega inmediatamente.

  • false: la aplicación se despliega posteriormente.

true

EdasContainerVersion

string

No

La versión del entorno de ejecución de la aplicación en el framework HSF, como el contenedor Ali-Tomcat.

3.5.3

Timezone

string

No

La zona horaria. Valor predeterminado: Asia/Shanghai.

Asia/Shanghai

SlsConfigs

string

No

Las configuraciones para la recopilación de registros en Simple Log Service.

  • Utilice recursos de SLS creados automáticamente por SAE: [{"logDir":"","logType":"stdout"},{"logDir":"/tmp/a.log"}].

  • Utilice recursos de SLS personalizados: [{"projectName":"test-sls","logType":"stdout","logDir":"","logstoreName":"sae","logtailName":""},{"projectName":"test","logDir":"/tmp/a.log","logstoreName":"sae","logtailName":""}].

Descripción de parámetros:

  • projectName: el nombre del proyecto en Simple Log Service.

  • logDir: la ruta del registro.

  • logType: el tipo de registro. stdout indica registros de salida estándar del contenedor. Solo puede configurar una entrada para este tipo. Si no se configura este parámetro, se recopilan registros de archivos.

  • logstoreName: el nombre del Logstore en Simple Log Service.

  • logtailName: el nombre del Logtail en Simple Log Service. Si no se especifica este parámetro, se crea un nuevo Logtail.

Si la configuración de recopilación de SLS no cambia durante múltiples despliegues, no necesita configurar este parámetro (es decir, no es necesario incluir el campo SlsConfigs en la solicitud). Si ya no necesita la función de recopilación de SLS, configure el valor de este campo como una cadena vacía (es decir, configure el valor del campo SlsConfigs como "" en la solicitud).

Nota

Los proyectos que se crean automáticamente con la aplicación se eliminan cuando se elimina la aplicación. Por lo tanto, no seleccione un proyecto creado automáticamente por SAE cuando seleccione un proyecto existente.

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

NasId

string

No

Se recomienda no configurar este parámetro. Configure NasConfigs en su lugar. El ID del sistema de archivos NAS montado. El sistema de archivos NAS debe estar en la misma región que el clúster. El sistema de archivos NAS debe tener cuota disponible para la creación de destinos de montaje, o su destino de montaje ya debe estar en un vSwitch de la VPC. Si este parámetro se deja vacío y existe el campo mountDescs, se compra automáticamente un sistema de archivos NAS y se monta en un vSwitch de la VPC.

Si la configuración no cambia durante el despliegue, no necesita configurar este parámetro (es decir, no es necesario incluir el campo NASId en la solicitud). Para borrar la configuración de NAS, configure el valor de este campo como una cadena vacía (es decir, configure el valor del campo NASId como "" en la solicitud).

KSAK****

MountHost

string

No

Se recomienda no configurar este parámetro. Configure NasConfigs en su lugar. El destino de montaje del sistema de archivos NAS en la VPC de la aplicación. Si la configuración no cambia durante el despliegue, no necesita configurar este parámetro (es decir, no es necesario incluir el campo MountHost en la solicitud). Para borrar la configuración de NAS, configure el valor de este campo como una cadena vacía (es decir, configure el valor del campo MountHost como "" en la solicitud).

example.com

MountDesc

string

No

Se recomienda no configurar este parámetro. Configure NasConfigs en su lugar. La descripción del montaje de NAS. Si la configuración no cambia durante el despliegue, no necesita configurar este parámetro (es decir, no es necesario incluir el campo MountDesc en la solicitud). Para borrar la configuración de NAS, configure el valor de este campo como una cadena vacía (es decir, configure el valor del campo MountDesc como "" en la solicitud).

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

PreStop

string

No

El script que se ejecuta antes de detener el contenedor. Se activa y ejecuta un script antes de eliminar el contenedor. Formato: {"exec":{"command":\["cat","/etc/group"]}}

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

PostStart

string

No

El script que se ejecuta después de iniciar el contenedor. Se activa y ejecuta un script inmediatamente después de crear el contenedor. Formato: {"exec":{"command":\["cat","/etc/group"]}}

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

WarStartOptions

string

No

El comando de inicio para desplegar una aplicación de paquete WAR. El procedimiento de configuración es el mismo que para el comando de inicio de un despliegue de imagen. Para obtener más información, consulte Configurar un comando de inicio.

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

ConfigMapMountDesc

string

No

La descripción del montaje de ConfigMap. Utilice un ConfigMap creado en la página de elementos de configuración del espacio de nombres para inyectar información de configuración en el contenedor. Descripción de parámetros:

  • configMapId: el ID de la instancia de ConfigMap. Puede obtener el ID mediante la operación ListNamespacedConfigMaps.

  • key: la clave.

Nota

Puede montar todas las claves pasando el parámetro sae-sys-configmap-all.

  • mountPath: la ruta de montaje.

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

SecurityGroupId

string

No

El ID del grupo de seguridad.

sg-wz969ngg2e49q5i4****

AutoConfig

boolean

No

Especifica si se debe configurar automáticamente el entorno de red. Valores válidos:

  • true: SAE configura automáticamente el entorno de red cuando se crea la aplicación. Se ignoran los valores de NamespaceId, VpcId, vSwitchId y SecurityGroupId.

  • false: SAE configura manualmente el entorno de red cuando se crea la aplicación.

Nota

Si este parámetro se configura como true, se ignora cualquier otro valor de NamespaceId que se pase.

true

TerminationGracePeriodSeconds

integer

No

El periodo de tiempo de espera para el apagado graceful. Valor predeterminado: 30. Unidad: segundos. Valores válidos: de 1 a 300.

30

PhpArmsConfigLocation

string

No

La ruta de montaje para el monitoreo de aplicaciones PHP. Asegúrese de que el servidor PHP cargue el archivo de configuración desde esta ruta. No necesita gestionar el contenido de la configuración. SAE genera automáticamente el archivo de configuración correcto.

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

PhpConfigLocation

string

No

La ruta de montaje para la configuración de inicio de la aplicación PHP. Asegúrese de que el servidor PHP utilice este archivo de configuración para iniciarse.

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

PhpConfig

string

No

El contenido del archivo de configuración de PHP.

k1=v1

TomcatConfig

string

No

La configuración de Tomcat. Configure este parámetro como "" o "{}" para eliminar la configuración:

  • port: el número de puerto. Valores válidos: de 1024 a 65535. Los puertos inferiores a 1024 requieren permisos de root. Dado que el contenedor está configurado con permisos de administrador, especifique un puerto mayor que 1024. Valor predeterminado: 8080.

  • contextPath: la ruta de acceso. Valor predeterminado: directorio raíz "/".

  • maxThreads: el número máximo de conexiones en el pool de conexiones. Valor predeterminado: 400.

  • uriEncoding: el formato de codificación de Tomcat. Valores válidos: UTF-8, ISO-8859-1, GBK y GB2312. Valor predeterminado: ISO-8859-1.

  • useBodyEncodingForUri: especifica si se debe utilizar BodyEncoding for URL. Valor predeterminado: true.

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

OssMountDescs

string

No

La descripción del montaje de OSS. Descripción de parámetros:

  • bucketName: el nombre del bucket.

  • bucketPath: la carpeta u objeto que creó en OSS. Si la carpeta de montaje de OSS no existe, se activa una excepción.

  • mountPath: la ruta del contenedor en SAE. Si la ruta ya existe, es una relación de sobrescritura. Si la ruta no existe, se crea.

  • readOnly: especifica si la ruta del contenedor tiene permiso de solo lectura sobre los recursos de la carpeta montada. Valores válidos:
    • true: permiso de solo lectura.

    • false: permiso de lectura y escritura.

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

OssAkId

string

No

El AccessKey ID para operaciones de lectura y escritura en OSS.

xxxxxx

OssAkSecret

string

No

El AccessKey Secret para operaciones de lectura y escritura en OSS.

xxxxxx

Php

string

No

La versión de PHP de la que depende el paquete de despliegue. No se admite para imágenes.

PHP-FPM 7.0

AcrInstanceId

string

No

El ID de instancia de Container Registry Enterprise. Este parámetro es obligatorio cuando ImageUrl está configurado como una imagen de Container Registry Enterprise Edition.

cri-xxxxxx

AcrAssumeRoleArn

string

No

El ARN del rol de RAM requerido para la extracción de imágenes entre cuentas. Para obtener más información, consulte Otorgar permisos entre cuentas de Alibaba Cloud mediante un rol de RAM.

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

ImagePullSecrets

string

No

El ID de secreto correspondiente.

10

AssociateEip

boolean

No

Especifica si se debe asociar una EIP. Valores válidos:

  • true: asociar una EIP.

  • false: no asociar una EIP.

true

ProgrammingLanguage

string

No

El lenguaje de programación de la pila tecnológica utilizada para crear la aplicación. Valores válidos:

  • java: Java.

  • php: PHP.

  • python: Python.

  • dotnet: .NET Core.

  • other: múltiples lenguajes, como C++, Go y Node.js.

java

KafkaConfigs

string

No

El resumen de configuraciones para la recopilación de registros en Kafka. Valores válidos:

  • kafkaEndpoint: la dirección de registro del servicio de la API de Kafka.

  • kafkaInstanceId: el ID de la instancia de Kafka.

  • kafkaConfigs: el resumen de configuraciones para una o más entradas de registro. Para obtener más información sobre los valores válidos, consulte el parámetro de solicitud kafkaConfigs en este tema.

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

Habilita el registro y descubrimiento de servicios basado en K8s Service. Valores válidos:

  • serviceName: el nombre del servicio. Formato: nombre personalizado-ID de espacio de nombres. El sufijo -ID de espacio de nombres no se puede personalizar y debe configurarse según el espacio de nombres de la aplicación. Por ejemplo, si selecciona el espacio de nombres predeterminado en la región China (Beijing), el sufijo es -cn-beijing-default.

  • namespaceId: el ID del espacio de nombres.

  • portProtocols: el puerto y el protocolo. Valores de puerto válidos: [1,65535]. Valores de protocolo válidos: TCP y UDP.

  • portAndProtocol: el puerto y el protocolo. Valores de puerto válidos: [1,65535]. Valores de protocolo válidos: TCP y UDP. Se recomienda portProtocols. Si se configura portProtocols, solo portProtocols surte efecto.

  • enable: habilita el registro y descubrimiento de servicios basado en 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

Especifica el registro de Nacos. Valores válidos:

  • 0: Nacos integrado en SAE.

  • 1: Nacos autogestionado.

  • 2: Nacos de edición comercial de MSE.

"0"

MicroRegistrationConfig

string

No

La configuración del registro.

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

NasConfigs

string

No

La configuración de montaje de NAS. Valores válidos:

  • mountPath: la ruta de montaje del contenedor.

  • readOnly: configure como false para otorgar permiso de lectura y escritura.

  • nasId: el ID de NAS.

  • mountDomain: la dirección de destino de montaje del contenedor. Para obtener más información, consulte DescribeMountTargets.

  • nasPath: el directorio de archivos relativo de 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

El entorno de Python. Se admite PYTHON 3.9.15.

PYTHON 3.9.15

PythonModules

string

No

Las dependencias de módulos de instalación personalizada. De forma predeterminada, se instalan las dependencias definidas en el archivo requirements.txt de la carpeta raíz. Si el archivo no está configurado o necesita paquetes personalizados, especifique las dependencias a instalar.

Flask==2.0

Dotnet

string

No

La versión del framework .NET:

  • .NET 3.1

  • .NET 5.0

  • .NET 6.0

  • .NET 7.0

  • .NET 8.0

.NET 3.1

EnableEbpf

string

No

Especifica si se debe habilitar el monitoreo de aplicaciones para aplicaciones que no son de Java basado en tecnología eBPF. Valores válidos:

  • true: habilitado.

  • false: deshabilitado. Este es el valor predeterminado.

false

SaeVersion

string

No

La versión de SAE. Valores válidos:

  • v1

  • v2

v1

AppSource

string

No

Configure este parámetro como micro_service para crear una aplicación de microservicios.

micro_service

BaseAppId

string

No

El ID de la aplicación base.

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

ServiceTags

string

No

Las etiquetas de lanzamiento canary configuradas para la aplicación.

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

EnableNewArms

boolean

No

Especifica si se debe habilitar la nueva función de ARMS:

  • true: Habilitado.

  • false: Deshabilitado.

false

EnableCpuBurst

boolean

No

Especifica si se debe habilitar la función CPU Burst:

  • true: Habilitado.

  • false: Deshabilitado.

true

OidcRoleName

string

No

Especifica el rol de RAM para la autenticación de identidad.

Nota

Cree previamente un proveedor de identidad OIDC y un rol de proveedor de identidad en la misma región. Para obtener más información, consulte CreateOIDCProvider y CreateSAMLProvider.

sae-test

SidecarContainersConfig

array

No

La configuración del contenedor sidecar.

SidecarContainerConfig

No

La configuración del contenedor sidecar.

SecretMountDesc

string

No

La descripción del montaje de Secret. Utilice un secreto creado en la página de secretos del espacio de nombres para inyectar información confidencial en el contenedor. Descripción de parámetros:

  • secretId: el ID de la instancia de secreto. Puede obtener el ID mediante la operación ListSecrets.

  • key: la clave.

Nota

Puede montar todas las claves pasando el parámetro sae-sys-secret-all.

  • mountPath: la ruta de montaje.

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

EnableSidecarResourceIsolated

boolean

No

Especifica si se debe habilitar el aislamiento de recursos del sidecar:

  • true: Aislado.

  • false: No aislado.

true

CustomImageNetworkType

string

No

El tipo de imagen personalizada. Configure este parámetro como una cadena vacía si la imagen no es una imagen personalizada:

  • internet: imagen pública

  • intranet: imagen privada

internet

ResourceType

string

No

El tipo de recurso. Valores válidos: NULL (predeterminado), default y haiguang (servidor Hygon).

NULL

NewSaeVersion

string

No

La versión de la aplicación:

  • lite: Edición Lite

  • std: Edición Estándar

  • pro: Edición Profesional

pro

MicroserviceEngineConfig

string

No

Configura la función de gobernanza de microservicios.

  • Especifica si se debe habilitar la gobernanza de microservicios (enable):

    • true: Habilitado.

    • false: Deshabilitado.

  • Configura la conexión y desconexión sin pérdidas (mseLosslessRule):

    • delayTime: el tiempo de retraso.

    • enable: especifica si se debe habilitar la función de conexión sin pérdidas. true indica habilitado. false indica deshabilitado.

    • notice: especifica si se debe habilitar la función de notificación. true indica habilitado. false indica deshabilitado.

    • warmupTime: la duración del calentamiento para el aumento gradual de tráfico, en segundos.

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

DiskSize

integer

No

El tamaño de almacenamiento del disco, en GB.

50

InitContainersConfig

array

No

La configuración del contenedor de inicialización.

InitContainerConfig

No

La configuración del contenedor de inicialización.

GpuConfig

string

No

StartupProbe

string

No

Habilita la sonda de inicio de la aplicación.

  • Verificación exitosa: indica que la aplicación se inició correctamente. Si configuró verificaciones de Liveness y Readiness, estas se realizan después de que la aplicación se inicia correctamente.

  • Verificación fallida: indica que la aplicación no se pudo iniciar. Se reporta una excepción y la aplicación se reinicia automáticamente.

Nota
  • Se admiten los métodos exec, httpGet y tcpSocket. Para ejemplos específicos, consulte el parámetro Liveness.

  • Solo puede utilizar un método para las verificaciones de estado.

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

IsStateful

boolean

No

Especifica si la aplicación es con estado.

EnablePrometheus

boolean

No

Especifica si se debe habilitar la recopilación de métricas personalizadas de Prometheus.

false

HeadlessPvtzDiscoverySvc

string

No

El registro y descubrimiento de servicios basado en Headless Service de K8s.

  • serviceName: el nombre del servicio.

  • namespaceId: el ID del espacio de nombres.

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

Html

string

No

La versión de Nginx.

  • nginx 1.20

  • nginx 1.22

  • nginx 1.24

  • nginx 1.26

  • nginx 1.28

nginx 1.28

EmptyDirDesc

string

No

La configuración de almacenamiento efímero compartido.

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

EnableNamespaceAgentVersion

boolean

No

Especifica si se debe reutilizar la configuración de versión del agente del espacio de nombres.

true

AgentVersion

string

No

La versión de AliyunAgent.

4.4.2

EnableNamespaceSlsConfig

boolean

No

Especifica si se debe reutilizar la configuración de registros de SLS del espacio de nombres.

true

SlsLogEnvTags

string

No

Etiquetas de registros de SLS.

LokiConfigs

string

No

Labels

object

No

string

No

RaspConfig

object

No

EnableRasp

boolean

No

RaspAppName

string

No

RaspAppKey

string

No

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

La información sobre la aplicación creada.

RequestId

string

El ID de la solicitud.

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

Message

string

La información adicional. Valores válidos:

  • Si la solicitud es exitosa, se devuelve success.

  • Si la solicitud falla, se devuelve un código de error específico.

success

TraceId

string

El ID de rastreo, que se utiliza para consultar los detalles de una solicitud.

0a98a02315955564772843261e****

Data

object

El resultado devuelto.

ChangeOrderId

string

El ID de orden de cambio devuelto, que se utiliza para consultar el estado de ejecución de la tarea.

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

AppId

string

El ID de la aplicación que se crea.

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

ErrorCode

string

El código de error. Valores válidos:

  • Si la solicitud es exitosa, no se devuelve el campo ErrorCode.

  • Si la solicitud falla, se devuelve el campo ErrorCode. Para obtener más información, consulte la sección Códigos de error en este tema.

空

Code

string

El estado de la API o el código de error POP. Valores válidos:

  • 2xx: éxito.

  • 3xx: redirección.

  • 4xx: error de solicitud.

  • 5xx: error del servidor.

200

Success

boolean

Indica si la aplicación se creó. Valores válidos:

  • true: La aplicación se creó.

  • false: No se pudo crear la aplicación.

true

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

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. The maximum number of Log Service configs is exceeded, please join the DingTalk group 32874633 for technical support.
400 LogService.InternalError An exception occurred while calling Log Service. Please submit a ticket to solve the problem. An exception occurred while calling log service. please join the DingTalk group 32874633 for technical support.
400 LogService.LogDirInvalid The log collection path is invalid. The log collection path is invalid.
400 LogService.NotAvailable Log Service is unavailable. Please activate Log Service first. The log service is not available. Please open the log service first.
400 LogService.ProjectNumQuotaExceed The maximum number of Log Service projects is exceeded. The maximum number of Log Service projects is exceeded, please join the DingTalk group 32874633 for technical support.
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. You can create %s instances for each application. please join the DingTalk group 32874633 for technical support.
400 NoComputeResourceQuota.User.Exceed Your account is limited to create %s instances. Please submit a ticket to raise the quota. Your account is limited to create %s instances. please join the DingTalk group 32874633 for technical support.
400 System.Upgrading The system is being upgraded. Please try again later.
400 VolumnPath.Conflict Conflict between log collection directory and persistent storage directory. 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. The specified vSwitch does not exist. Please change the vSwitch.
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. Secret mount path% s has conflict.
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.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.