All Products
Search
Document Center

Serverless App Engine:DescribeApplicationConfig

Last Updated:Jan 14, 2026

Retrieves the configuration of an application.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

sae:DescribeApplicationConfig

get

*All Resource

*

None None

Request syntax

GET /pop/v1/sam/app/describeApplicationConfig HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

AppId

string

Yes

The application ID.

7171a6ca-d1cd-4928-8642-7d5cfe69****

VersionId

string

No

The version ID.

0026ff7f-2b57-4127-bdd0-9bf202bb****

Response elements

Element

Type

Description

Example

object

The returned data.

RequestId

string

The request ID.

01CF26C7-00A3-4AA6-BA76-7E95F2A3****

Message

string

The additional information returned.

success

TraceId

string

The trace ID that is used to query the details of the request.

ac1a0b2215622246421415014e****

Data

object

The information about the application.

VpcId

string

The ID of the VPC.

vpc-2ze0i263cnn311nvj****

Readiness

string

The readiness probe of the application. A container that fails the health check multiple times is stopped and restarted. A container that fails the health check does not receive traffic from SLB. The exec, httpGet, and tcpSocket check methods are supported. For more information about the examples, see the Liveness parameter.

Note

You can set only one health check method.

{"exec":{"command":["curl http://localhost:8080"]},"initialDelaySeconds":20,"timeoutSeconds":5}

ConfigMapMountDesc

array<object>

The information about the ConfigMap.

object

The information about the ConfigMap.

Key

string

The key-value pair of the ConfigMap.

k1

ConfigMapName

string

The name of the ConfigMap.

test

MountPath

string

The mount path in the container.

/tmp

ConfigMapId

integer

The ID of the ConfigMap.

1

SecurityGroupId

string

The ID of the security group.

sg-wz969ngg2e49q5i4****

BatchWaitTime

integer

The wait time between batches for a phased release. Unit: seconds.

10

Jdk

string

The JDK version that is required by the deployment package. The following versions are supported:

  • Open JDK 8

  • Open JDK 7

  • Dragonwell 11

  • Dragonwell 8

  • openjdk-8u191-jdk-alpine3.9

  • openjdk-7u201-jdk-alpine3.9

This parameter is not supported when Package Type is set to Image.

Open JDK 8

ImageUrl

string

The address of the image. This parameter is required when Package Type is set to Image.

docker.io/library/nginx:1.14.2

SlsConfigs

string

The configurations of log collection for SLS.

  • If you use an SLS resource that is automatically created by SAE: [{"logDir":"","logType":"stdout"},{"logDir":"/tmp/a.log"}].

  • If you use a custom SLS resource: [{"projectName":"test-sls","logType":"stdout","logDir":"","logstoreName":"sae","logtailName":""},{"projectName":"test","logDir":"/tmp/a.log","logstoreName":"sae","logtailName":""}].

The following parameters are included:

  • projectName: The name of the SLS project.

  • logDir: The path of the log.

  • logType: The log type. stdout specifies the standard output log of the container. You can specify only one standard output log. If you do not configure this parameter, file logs are collected.

  • logstoreName: The name of the Logstore in SLS.

  • logtailName: The name of the Logtail in SLS. If you do not specify this parameter, a new Logtail is created.

If the SLS log collection configuration is not changed during a deployment, you do not need to set this parameter. If you no longer need to use the SLS log collection feature, you must set this parameter to an empty string ("") in the request.

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

Liveness

string

The liveness health check of the container. A container that fails the health check is stopped and restored. The following check methods are supported:

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

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

  • tcpSocket: For example, {"tcpSocket":{"port":18091},"initialDelaySeconds":11,"periodSeconds":10,"timeoutSeconds":1}

Note

You can set only one health check method.

The following parameters are included:

  • exec.command: The health check command.

  • httpGet.path: The access path.

  • httpGet.scheme: HTTP or HTTPS.

  • httpGet.isContainKeyWord: true indicates that the keyword is included, and false indicates that the keyword is not included. If you do not specify this parameter, the advanced feature is not used.

  • httpGet.keyWord: The custom keyword. The isContainKeyWord parameter must be specified.

  • tcpSocket.port: The port that is used for the TCP connection check.

  • initialDelaySeconds: The startup delay for the health check. Default value: 10. Unit: seconds.

  • periodSeconds: The interval for the health check. Default value: 30. Unit: seconds.

  • timeoutSeconds: The timeout period of the health check. Default value: 1. Unit: seconds. If you set this parameter to 0 or do not specify this parameter, the default timeout period is 1 second.

{"exec":{"command":["curl http://localhost:8080"]},"initialDelaySeconds":20,"timeoutSeconds":3}

Tags

array<object>

The tag information.

object

The tag information.

Key

string

The tag key.

k1

Value

string

The tag value.

v1

PackageUrl

string

The URL of the deployment package. If you uploaded the deployment package using SAE, note the following points:

  • This URL cannot be used to download the package. You must call the GetPackageVersionAccessableUrl operation to obtain a download URL that is valid for 10 minutes.

  • SAE stores the package for a maximum of 90 days. After 90 days, the URL is not returned and the package cannot be downloaded.

https://edas-bj.oss-cn-beijing.aliyuncs.com/apps/K8s_APP_ID/d4c97c37-aba3-403e-ae1e-6f7d8742****/hello-sae.war

PackageType

string

The type of the application package. Valid values:

  • If you use a Java package, FatJar, War, and Image are supported.

  • If you use a PHP package, the following values are supported:
    • 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

War

PreStop

string

The script that is executed before the container is stopped. The script is executed before the container is deleted. Example: {"exec":{"command":\["cat","/etc/group"\]}}

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

PackageVersion

string

The version of the deployment package. This parameter is required when Package Type is set to FatJar or War.

1.0

JarStartArgs

string

The arguments for starting the JAR package. The default startup command is: $JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs

start

AppName

string

The application name.

demo-app

AppId

string

The application ID.

7171a6ca-d1cd-4928-8642-7d5cfe69****

JarStartOptions

string

The options for starting the JAR package. The default startup command is: $JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs

-Dtest=true

Replicas

integer

The number of application instances.

2

UpdateStrategy

string

The deployment policy. If the minimum number of surviving instances is 1, the value of UpdateStrategy is an empty string. If the minimum number of surviving instances is greater than 1, the following examples are applicable:

  • One-instance canary release, followed by a two-batch release with an interval of one minute between batches: {"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}

  • One-instance canary release, followed by a two-batch release that requires manual confirmation: {"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"manual"},"grayUpdate":{"gray":1}}

  • Two-batch release with an interval of zero minutes between batches: {"type":"BatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":0}}

The following parameters are included:

  • type: The type of the release policy. Valid values: GrayBatchUpdate (canary release) and BatchUpdate (phased release).

  • batchUpdate: The phased release policy.
    • batch: The number of release batches.

    • releaseType: The processing method between batches. Valid values: auto and manual.

    • batchWaitTime: The interval between batches. Unit: seconds.

  • grayUpdate: The number of remaining batches after the canary release. This parameter is required when type is set to GrayBatchUpdate.

{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}

MinReadyInstances

integer

The minimum number of surviving instances. Valid values:

  • If you set this parameter to 0, the application may be unavailable during the upgrade.

  • If you set this parameter to -1, the minimum number of surviving instances is determined by the system. The value is 25% of the current number of instances. For example, if you have five instances, the minimum number of surviving instances is 5 × 25% = 1.25, which is rounded up to 2.

Note

We recommend that you set the minimum number of surviving instances to a value that is greater than or equal to 1 to ensure that your business is not interrupted during a rolling update.

1

MinReadyInstanceRatio

integer

The percentage of the minimum number of surviving instances. Valid values:

  • -1: This is the default value. It indicates that the percentage is not used. If you do not specify this parameter, the default value -1 is used.

  • 0 to 100: The value is a percentage that is rounded up. For example, if you set the value to 50% and you have five instances, the minimum number of surviving instances is 3.

Note

If you specify both MinReadyInstances and MinReadyInstanceRatio, and MinReadyInstanceRatio is not -1, MinReadyInstanceRatio takes precedence. For example, if MinReadyInstances is 5 and MinReadyInstanceRatio is 50, the minimum number of surviving instances is calculated based on MinReadyInstanceRatio.

-1

Memory

integer

The memory required by each instance. Unit: MB. This parameter cannot be 0. It must correspond to the CPU specifications. The following specifications are supported:

  • 1024: corresponds to 500 and 1,000 millicores of CPU.

  • 2048: corresponds to 500, 1,000, and 2,000 millicores of CPU.

  • 4096: corresponds to 1,000, 2,000, and 4,000 millicores of CPU.

  • 8192: corresponds to 2,000, 4,000, and 8,000 millicores of CPU.

  • 12288: corresponds to 12,000 millicores of CPU.

  • 16384: corresponds to 4,000, 8,000, and 16,000 millicores of CPU.

  • 24576: corresponds to 12,000 millicores of CPU.

  • 32768: corresponds to 16,000 millicores of CPU.

  • 65536: corresponds to 8,000, 16,000, and 32,000 millicores of CPU.

  • 131072: corresponds to 32,000 millicores of CPU.

2048

Php

string

The PHP version that is required for the PHP deployment package. This parameter is not supported for images.

PHP-FPM 7.0

PhpConfig

string

The content of the PHP configuration file.

k1=v1

PhpConfigLocation

string

The mount path of the PHP application startup configuration. You must make sure that the PHP server uses this configuration file to start.

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

PostStart

string

The script that is executed after the container is started. The script is executed immediately after the container is created. Example: {"exec":{"command":\["cat","/etc/group"\]}}

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

TerminationGracePeriodSeconds

integer

The timeout period for a graceful shutdown. Default value: 30. Unit: seconds. Valid values: 1 to 300.

10

CommandArgs

string

The arguments of the startup command. The arguments are required by the Command parameter. Example:

["a","b"]

In the example of the Command parameter, CommandArgs=["abc", ">", "file0"]. The value ["abc", ">", "file0"] must be a JSON array that is converted into a string. If you do not need to specify this parameter, leave it empty.

["a","b"]

NamespaceId

string

The namespace ID.

cn-beijing:test

MountHost

string

The mount target of the NAS file system in the application's VPC. If the configuration is not changed during a deployment, you do not need to set this parameter. If you want to remove the NAS configuration, set this parameter to an empty string ("") in the request.

example.com

TomcatConfig

string

The Tomcat file configuration. Set this parameter to an empty string ("") or "{}" to delete the configuration:

  • port: The port number. Valid values: 1024 to 65535. Ports smaller than 1024 require root permissions. Because the container has only administrator permissions, you must specify a port that is greater than 1024. If you do not specify this parameter, the default port 8080 is used.

  • contextPath: The access path. Default value: /.

  • maxThreads: The maximum number of connections in the connection pool. Default value: 400.

  • uriEncoding: The encoding format of Tomcat. Valid values: UTF-8, ISO-8859-1, GBK, and GB2312. If you do not specify this parameter, the default value ISO-8859-1 is used.

  • useBodyEncoding: Specifies whether to use BodyEncoding for URL. Default value: true.

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

RegionId

string

The region ID.

cn-beijing

VSwitchId

string

The vSwitch ID.

vsw-2ze559r1z1bpwqxwp****

Cpu

integer

The CPU required by each instance. Unit: millicores. This parameter cannot be 0. The following specifications are supported:

  • 500

  • 1000

  • 2000

  • 4000

  • 8000

  • 16000

  • 32000

1000

Envs

string

The environment variables of the container. You can customize environment variables or reference a ConfigMap. To reference a ConfigMap, you must first create a ConfigMap instance. For more information, see CreateConfigMap. Valid values:

  • Custom configuration
    • name: The name of the environment variable.

    • value: The value of the environment variable.

  • Reference configuration
    • name: The name of the environment variable. You can reference a single key or all keys. To reference all keys, enter sae-sys-configmap-all-<ConfigMap name>, such as sae-sys-configmap-all-test1.

    • valueFrom: The reference to the environment variable. Set the value to configMapRef.

    • configMapId: The ID of the ConfigMap.

    • key: The key. If you want to reference all keys, do not specify this parameter.

[{"name":"TEST_ENV_KEY","value":"TEST_ENV_VAR"}]

MountDesc

array<object>

The mount description.

object

The mount description.

MountPath

string

The mount path in the container.

/tmp

NasPath

string

The relative path in the NAS file system.

/

EnableAhas

string

Specifies whether to enable AHAS. Valid values:

  • true: Enable AHAS.

  • false: Do not enable AHAS.

true

CustomHostAlias

string

The custom mapping between a host and an IP address in the container. Valid values:

  • hostName: The domain name or hostname.

  • ip: The IP address.

[{"hostName":"test.host.name","ip":"0.0.0.0"}]

WebContainer

string

The Tomcat version that is required by the deployment package. The following versions are supported:

  • apache-tomcat-7.0.91

  • apache-tomcat-8.5.42

This parameter is not supported when Package Type is set to Image.

apache-tomcat-7.0.91

Command

string

The startup command of the image. The command must be an executable object that exists in the container. Example:

command:
      - echo
      - abc
      - >
      - file0

Based on this example, Command="echo" and CommandArgs=["abc", ">", "file0"].

echo

WarStartOptions

string

The options for starting the WAR package. The default startup command is: java $JAVA_OPTS $CATALINA_OPTS -Options org.apache.catalina.startup.Bootstrap "$@" start.

custom-option

PhpArmsConfigLocation

string

The mount path of the Application Monitoring configuration for the PHP application. You must make sure that the PHP server loads the configuration file from this path.

You do not need to pay attention to the content of the configuration file. SAE automatically renders the correct configuration file.

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

NasId

string

The NAS ID.

AKSN****

OssAkId

string

The AccessKey ID that is used to read data from and write data to OSS.

xxxxxx

OssAkSecret

string

The AccessKey secret that is used to read data from and write data to OSS.

xxxxxx

OssMountDescs

array<object>

The description of the OSS mount.

object

The description of the OSS mount.

bucketName

string

The name of the bucket.

oss-bucket

bucketPath

string

The directory or object that you created in OSS. If the mount directory does not exist in OSS, an exception is thrown.

data/user.data

mountPath

string

The container path in SAE. If the path exists, the path is overwritten. If the path does not exist, a new path is created.

/usr/data/user.data

readOnly

boolean

Specifies whether the container has read-only permissions on the mount directory. Valid values:

  • true: Read-only permission.

  • false: Read and write permissions.

true

EdasContainerVersion

string

The version of the application runtime environment in the HSF, such as the Ali-Tomcat container.

3.5.3

Timezone

string

The time zone. Default value: Asia/Shanghai.

Asia/Shanghai

AppDescription

string

The description of the application.

示例应用

EnableGreyTagRoute

boolean

Specifies whether to enable the canary release rule. This rule is applicable only to applications that use the Spring Cloud and Dubbo frameworks. Valid values:

  • true: Enable the canary release rule.

  • false: Disable the canary release rule.

false

MseApplicationId

string

The ID of the application in MSE.

xxxxxxx@xxxxx

AcrInstanceId

string

The ID of the Container Registry Enterprise Edition instance.

cri-xxxxxx

AcrAssumeRoleArn

string

The ARN of the RAM role that is required to pull images across accounts. For more information, see Pull images across accounts and Create a RAM role for a trusted Alibaba Cloud account.

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

ImagePullSecrets

string

The ID of the secret.

10

AssociateEip

boolean

Specifies whether to bind an EIP. Valid values:

  • true: Bind an EIP.

  • false: Do not bind an EIP.

true

KafkaConfigs

string

The configurations of log collection for Kafka. Valid values:

  • kafkaEndpoint: The endpoint of the Kafka API.

  • kafkaInstanceId: The ID of the Kafka instance.

  • kafkaConfigs: The configurations of one or more logs. For more information about the example and parameters, see the kafkaConfigs request parameter in this topic.

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

ProgrammingLanguage

string

The programming language of the application. Valid values:

  • java: Java

  • php: PHP

  • other: other languages, such as Python, C++, Go, .NET, and Node.js.

java

PvtzDiscovery

string

Enable service registration and discovery for the Kubernetes Service.

{ "serviceName": "bwm-poc-sc-gateway-cn-beijing-front", "namespaceId": "cn-beijing:front", "portAndProtocol": { "18012": "TCP" }, "portProtocols": [ { "port": "18012", "protocol": "TCP" } ], "enable": true }

SwimlanePvtzDiscovery

string

Configure service registration and discovery and end-to-end canary release based on the Kubernetes Service.

{\"enable\":\"false\",\"namespaceId\":\"cn-beijing:test\",\"portAndProtocol\":{\"2000:TCP\":\"18081\"},\"portProtocols\":[{\"port\":2000,\"protocol\":\"TCP\",\"targetPort\":18081}],\"pvtzDiscoveryName\":\"cn-beijing-1421801774382676\",\"serviceId\":\"3513\",\"serviceName\":\"demo-gray.test\"}

MicroRegistration

string

The Nacos registry. Valid values:

  • 0: SAE built-in Nacos.

  • 1: User-created Nacos.

  • 2: MSE Nacos Enterprise Edition.

"0"

NasConfigs

string

The configurations for mounting the NAS file system.

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

The Python environment. PYTHON 3.9.15 is supported.

PYTHON 3.9.15

PythonModules

string

The dependencies of custom installation modules. By default, the dependencies defined in the requirements.txt file in the root directory are installed. If no custom package is configured, you can specify the dependencies to be installed.

Flask==2.0

MseApplicationName

string

The name of the application after it is registered with MSE.

cn-shenzhen-alb-demo-5c****

AppSource

string

The type of the SAE application.

  • micro_service.

  • web.

  • job.

micro_service

ServiceTags

object

The canary release tags of the application configuration

string

The value of the canary release tag

tag1

Dotnet

string

The version of the .NET framework:

  • .NET 3.1

  • .NET 5.0

  • .NET 6.0

  • .NET 7.0

  • .NET 8.0

.NET 8.0

MicroRegistrationConfig

string

The registry configuration. This parameter is valid only when the registry type is MSE Nacos Enterprise Edition.

{\"instanceId\":\"mse-cn-1ls43******\",\"namespace\":\"62ee12fb-c279-4da4-be96-21**********\"}

EnableIdle

boolean

Specifies whether to enable the idle mode:

  • true: Enable

  • false: Disable

false

EnableNewArms

boolean

Specifies whether to enable the new ARMS feature:

  • true: Enable

  • false: Disable

false

EnableCpuBurst

string

Specifies whether to enable the CPU Burst feature:

  • true: Enable

  • false: Disable

true

OidcRoleName

string

The RAM role of the identity authentication service.

Note

You must create an OIDC identity provider and an identity provider role in the same region in advance. For more information, see Create an OIDC identity provider and Create a RAM role for an SSO identity provider.

sae-test

SecretMountDesc

array<object>

The description of the secret mount.

object

The description of the secret mount

Key

string

The key of the Base64-encoded data value.

task-center

SecretName

string

The name of the secret instance.

dummy-name-opaque-894

MountPath

string

The mount path.

/opt/www/runtime/logs

SecretId

integer

The ID of the secret instance that you want to query.

520

SidecarContainersConfig

array<object>

The configurations of the sidecar container.

array<object>

The configurations of the sidecar container.

Name

string

The container name.

test

Cpu

integer

The maximum CPU resources that the sidecar container can use.

500

Memory

integer

The maximum memory resources that the sidecar container can use.

1024

ImageUrl

string

The address of the image.

registry.cn-beijing.aliyuncs.com/sae-dev-test/nginx:stable

AcrInstanceId

string

The ID of the Container Registry Enterprise Edition instance. This parameter is required if ImageUrl is set to an image in Container Registry Enterprise Edition.

cri-fhzlneorxala66ip

Command

string

The startup command of the image. The command must be an executable object that exists in the container. Example:

command:
      - echo
      - abc
      - >
      - file0

Based on this example, Command="echo" and CommandArgs=["abc", ">", "file0"].

/bin/sh

CommandArgs

string

The arguments of the startup command. The arguments are required by the Command parameter. Example:

["a","b"]

In the preceding example, CommandArgs=["abc", ">", "file0"]. The value ["abc", ">", "file0"] must be a JSON array that is converted into a string. If you do not need to specify this parameter, leave it empty.

[\"-c\",\"echo \\\"test\\\" > /home/nas/test.log && sleep 10000000s\"]

Envs

string

The environment variables of the container. You can customize environment variables or reference a ConfigMap. To reference a ConfigMap, you must first create a ConfigMap instance. For more information, see CreateConfigMap. Valid values:

  • Custom configuration
    • name: The name of the environment variable.

    • value: The value of the environment variable. This parameter has a higher priority than valueFrom.

  • Reference configuration (valueFrom)
    • name: The name of the environment variable. You can reference a single key or all keys. To reference all keys, enter sae-sys-configmap-all-<ConfigMap name>, such as sae-sys-configmap-all-test1.

    • valueFrom: The reference to the environment variable. Set the value to configMapRef.
      • configMapId: The ID of the ConfigMap.

      • key: The key. If you want to reference all keys, do not specify this parameter.

[{\"name\":\"k1\",\"value\":\"c8e3a815-e5d3-4adf-abb3-98b106a607c4\"}]

ConfigMapMountDesc

array<object>

The description of the ConfigMap mount. Use the configuration items created on the Namespace Configurations page to inject configuration information into the container. The following parameters are included:

  • configMapId: The ID of the ConfigMap instance. You can call the ListNamespacedConfigMaps operation to obtain the ID.

  • key: The key.

Note

You can pass the sae-sys-configmap-all parameter to mount all keys.

  • mountPath: The mount path.

  • ConfigMapName: The name of the ConfigMap.

object

The description of the ConfigMap mount.

Key

string

The key of the ConfigMap.

key

ConfigMapName

string

The name of the ConfigMap.

ConfigMap-test

MountPath

string

The mount path in the container.

/mnt/test

ConfigMapId

integer

The ID of the ConfigMap instance.

7361

EmptyDirDesc

array<object>

Shared temporary storage. Set a temporary storage directory and mount it to the main container and the sidecar container.

object

Shared temporary storage.

Name

string

The name of the temporary storage.

sidecar-container

MountPath

string

The mount path of the volume in the container.

/mnt/cache

InitContainersConfig

array<object>

The configurations of the init container.

array<object>

The configurations of the init container.

Name

string

The name of the init container.

init-container

ImageUrl

string

The address of the image used by the init container.

registry.cn-shenzhen.aliyuncs.com/sae-serverless-demo/sae-demo:microservice-java-provider-v1.0

Command

string

The startup command of the image. The command must be an executable object that exists in the container. Example:

command:
      - echo
      - abc
      - >
      - file0

Based on this example, Command="echo" and CommandArgs=["abc", ">", "file0"].

/bin/sh

CommandArgs

string

The arguments of the startup command. The arguments are required by the Command parameter. Example:

["a","b"]

In the preceding example, CommandArgs=["abc", ">", "file0"]. The value ["abc", ">", "file0"] must be a JSON array that is converted into a string. If you do not need to specify this parameter, leave it empty.

["a","b"]

Envs

string

The environment variables of the container. You can customize environment variables or reference a ConfigMap. To reference a ConfigMap, you must first create a ConfigMap instance. For more information, see CreateConfigMap. Valid values:

  • Custom configuration
    • name: The name of the environment variable.

    • value: The value of the environment variable. This parameter has a higher priority than valueFrom.

  • Reference configuration (valueFrom)
    • name: The name of the environment variable. You can reference a single key or all keys. To reference all keys, enter sae-sys-configmap-all-<ConfigMap name>, such as sae-sys-configmap-all-test1.

    • valueFrom: The reference to the environment variable. Set the value to configMapRef.

    • configMapId: The ID of the ConfigMap.

    • key: The key. If you want to reference all keys, do not specify this parameter.

  • Reference secret (valueFrom)
    • name: The name of the environment variable. You can reference a single key or all keys. To reference all keys, enter sae-sys-secret-all-<Secret name>, such as sae-sys-secret-all-test1.

    • valueFrom: The reference to the environment variable. Set the value to secretRef.

    • secretId: The ID of the secret.

    • key: The key. If you want to reference all keys, do not specify this parameter.

[{"name":"TEST_ENV_KEY","value":"TEST_ENV_VAR"}]

ConfigMapMountDesc

array<object>

The information about the ConfigMap.

object

The key-value pair of the ConfigMap.

Key

string

The key-value pair of the ConfigMap.

k1

ConfigMapName

string

The name of the ConfigMap.

test

MountPath

string

The mount path in the container.

/tmp

ConfigMapId

integer

The ID of the ConfigMap.

1

EmptyDirDesc

array<object>

object

Name

string

MountPath

string

CustomImageNetworkType

string

The type of the custom image. If you do not use a custom image, set this parameter to an empty string:

  • internet: public image

  • intranet: private image

internet

ResourceType

string

The resource type. Only application is supported.

application

BaseAppId

string

The ID of the baseline application.

8c573618-8d72-4407-baf4-f7b64b******

MicroserviceEngineConfig

string

Configure the microservice governance feature.

  • Specifies whether to enable microservice governance (enable):

    • true: Enable

    • false: Disable

  • Configure graceful start and shutdown (mseLosslessRule):

    • delayTime: The delay event.

    • enable: Specifies whether to enable graceful start. true indicates that graceful start is enabled. false indicates that graceful start is disabled.

    • notice: Specifies whether to enable notifications. true indicates that notifications are enabled. false indicates that notifications are disabled.

    • warmupTime: The warm-up duration for small traffic. Unit: seconds.

{\"Enable\":true,\"MseLosslessRule\":{\"enable\":true,\"notice\":true,\"delayTime\":10,\"warmupTime\":120,\"funcType\":2,\"aligned\":false,\"related\":false,\"lossLessDetail\":false}}

NewSaeVersion

string

The application version:

  • lite: Lightweight Edition

  • std: Standard Edition

  • pro: Professional Edition

pro

ClusterId

string

The cluster ID.

495fc79c-ae61-4600-866d-a09d68******

DiskSize

integer

The disk storage size. Unit: GB.

20

StartupProbe

string

The startup probe of the application.

{\"exec\":{\"command\":[\"/bin/sh\",\"-c\",\"#!Note: If microservice config is enabled, the application will be automatically injected with the prestop configuration for lossless offline. If you delete this prestop configuration, lossless offline will not be effective.\\n echo stop > /tmp/prestop; /home/admin/.tools/curl http://127.0.0.1:54199/offline; sleep 30\"]}}

GpuCount

string

GpuType

string

EnablePrometheus

boolean

IsStateful

boolean

CmsServiceId

string

HeadlessPvtzDiscovery

string

Html

string

EmptyDirDesc

array<object>

object

Name

string

MountPath

string

DeploymentName

string

AlbIngressReadinessGate

string

MaxSurgeInstances

integer

MaxSurgeInstanceRatio

integer

AgentVersion

string

EnableNamespaceAgentVersion

boolean

SlsLogEnvTags

string

The tags of the SLS log environment.

LokiConfigs

string

ErrorCode

string

The error code. Valid values:

  • If the request is successful, the ErrorCode parameter is not returned.

  • If the request fails, the ErrorCode parameter is returned. For more information, see the "Error codes" section in this topic.

Code

string

The status of the interface or the POP error code. Valid values:

  • 2xx: The request is successful.

  • 3xx: The request is redirected.

  • 4xx: A request error occurred.

  • 5xx: A server error occurred.

200

Success

boolean

Indicates whether the application configuration was obtained. Valid values:

  • true: The application configuration was obtained.

  • false: The application configuration failed to be obtained.

true

Examples

Success response

JSON format

{
  "RequestId": "01CF26C7-00A3-4AA6-BA76-7E95F2A3****",
  "Message": "success",
  "TraceId": "ac1a0b2215622246421415014e****",
  "Data": {
    "VpcId": "vpc-2ze0i263cnn311nvj****",
    "Readiness": "{\"exec\":{\"command\":[\"curl http://localhost:8080\"]},\"initialDelaySeconds\":20,\"timeoutSeconds\":5}",
    "ConfigMapMountDesc": [
      {
        "Key": "k1",
        "ConfigMapName": "test",
        "MountPath": "/tmp",
        "ConfigMapId": 1
      }
    ],
    "SecurityGroupId": "sg-wz969ngg2e49q5i4****",
    "BatchWaitTime": 10,
    "Jdk": "Open JDK 8",
    "ImageUrl": "docker.io/library/nginx:1.14.2",
    "SlsConfigs": "[{\"logDir\":\"\",\"logType\":\"stdout\"},{\"logDir\":\"/tmp/a.log\"}]",
    "Liveness": "{\"exec\":{\"command\":[\"curl http://localhost:8080\"]},\"initialDelaySeconds\":20,\"timeoutSeconds\":3}",
    "Tags": [
      {
        "Key": "k1",
        "Value": "v1"
      }
    ],
    "PackageUrl": "https://edas-bj.oss-cn-beijing.aliyuncs.com/apps/K8s_APP_ID/d4c97c37-aba3-403e-ae1e-6f7d8742****/hello-sae.war",
    "PackageType": "War",
    "PreStop": "{\"exec\":{\"command\":[\"cat\",\"/etc/group\"]}}",
    "PackageVersion": "1.0",
    "JarStartArgs": "start",
    "AppName": "demo-app",
    "AppId": "7171a6ca-d1cd-4928-8642-7d5cfe69****",
    "JarStartOptions": "-Dtest=true",
    "Replicas": 2,
    "UpdateStrategy": "{\"type\":\"GrayBatchUpdate\",\"batchUpdate\":{\"batch\":2,\"releaseType\":\"auto\",\"batchWaitTime\":1},\"grayUpdate\":{\"gray\":1}}",
    "MinReadyInstances": 1,
    "MinReadyInstanceRatio": -1,
    "Memory": 2048,
    "Php": "PHP-FPM 7.0",
    "PhpConfig": "k1=v1",
    "PhpConfigLocation": "/usr/local/etc/php/php.ini",
    "PostStart": "{\"exec\":{\"command\":[\"cat\",\"/etc/group\"]}}",
    "TerminationGracePeriodSeconds": 10,
    "CommandArgs": "[\"a\",\"b\"]",
    "NamespaceId": "cn-beijing:test",
    "MountHost": "example.com",
    "TomcatConfig": "{\"port\":8080,\"contextPath\":\"/\",\"maxThreads\":400,\"uriEncoding\":\"ISO-8859-1\",\"useBodyEncodingForUri\":true}",
    "RegionId": "cn-beijing",
    "VSwitchId": "vsw-2ze559r1z1bpwqxwp****",
    "Cpu": 1000,
    "Envs": "[{\"name\":\"TEST_ENV_KEY\",\"value\":\"TEST_ENV_VAR\"}]",
    "MountDesc": [
      {
        "MountPath": "/tmp",
        "NasPath": "/"
      }
    ],
    "EnableAhas": "true",
    "CustomHostAlias": "[{\"hostName\":\"test.host.name\",\"ip\":\"0.0.0.0\"}]",
    "WebContainer": "apache-tomcat-7.0.91",
    "Command": "echo",
    "WarStartOptions": "custom-option",
    "PhpArmsConfigLocation": "/usr/local/etc/php/conf.d/arms.ini",
    "NasId": "AKSN****",
    "OssAkId": "xxxxxx",
    "OssAkSecret": "xxxxxx",
    "OssMountDescs": [
      {
        "bucketName": "oss-bucket",
        "bucketPath": "data/user.data",
        "mountPath": "/usr/data/user.data",
        "readOnly": true
      }
    ],
    "EdasContainerVersion": "3.5.3",
    "Timezone": "Asia/Shanghai",
    "AppDescription": "示例应用",
    "EnableGreyTagRoute": false,
    "MseApplicationId": "xxxxxxx@xxxxx",
    "AcrInstanceId": "cri-xxxxxx",
    "AcrAssumeRoleArn": "acs:ram::123456789012****:role/adminrole",
    "ImagePullSecrets": "10",
    "AssociateEip": true,
    "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\"}]}",
    "ProgrammingLanguage": "java",
    "PvtzDiscovery": "{     \"serviceName\": \"bwm-poc-sc-gateway-cn-beijing-front\",     \"namespaceId\": \"cn-beijing:front\",     \"portAndProtocol\": {         \"18012\": \"TCP\"     },     \"portProtocols\": [         {             \"port\": \"18012\",             \"protocol\": \"TCP\"         }     ],     \"enable\": true }",
    "SwimlanePvtzDiscovery": "{\\\"enable\\\":\\\"false\\\",\\\"namespaceId\\\":\\\"cn-beijing:test\\\",\\\"portAndProtocol\\\":{\\\"2000:TCP\\\":\\\"18081\\\"},\\\"portProtocols\\\":[{\\\"port\\\":2000,\\\"protocol\\\":\\\"TCP\\\",\\\"targetPort\\\":18081}],\\\"pvtzDiscoveryName\\\":\\\"cn-beijing-1421801774382676\\\",\\\"serviceId\\\":\\\"3513\\\",\\\"serviceName\\\":\\\"demo-gray.test\\\"}",
    "MicroRegistration": "\"0\"",
    "NasConfigs": "[{\"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": "PYTHON 3.9.15",
    "PythonModules": "Flask==2.0",
    "MseApplicationName": "cn-shenzhen-alb-demo-5c****",
    "AppSource": "micro_service",
    "ServiceTags": {
      "key": "tag1"
    },
    "Dotnet": ".NET 8.0",
    "MicroRegistrationConfig": "{\\\"instanceId\\\":\\\"mse-cn-1ls43******\\\",\\\"namespace\\\":\\\"62ee12fb-c279-4da4-be96-21**********\\\"}",
    "EnableIdle": false,
    "EnableNewArms": false,
    "EnableCpuBurst": "true",
    "OidcRoleName": "sae-test",
    "SecretMountDesc": [
      {
        "Key": "task-center",
        "SecretName": "dummy-name-opaque-894",
        "MountPath": "/opt/www/runtime/logs",
        "SecretId": 520
      }
    ],
    "SidecarContainersConfig": [
      {
        "Name": "test",
        "Cpu": 500,
        "Memory": 1024,
        "ImageUrl": "registry.cn-beijing.aliyuncs.com/sae-dev-test/nginx:stable",
        "AcrInstanceId": "cri-fhzlneorxala66ip",
        "Command": "/bin/sh",
        "CommandArgs": "[\\\"-c\\\",\\\"echo \\\\\\\"test\\\\\\\" > /home/nas/test.log && sleep 10000000s\\\"]",
        "Envs": "[{\\\"name\\\":\\\"k1\\\",\\\"value\\\":\\\"c8e3a815-e5d3-4adf-abb3-98b106a607c4\\\"}]",
        "ConfigMapMountDesc": [
          {
            "Key": "key",
            "ConfigMapName": "ConfigMap-test",
            "MountPath": "/mnt/test",
            "ConfigMapId": 7361
          }
        ],
        "EmptyDirDesc": [
          {
            "Name": "sidecar-container",
            "MountPath": "/mnt/cache"
          }
        ]
      }
    ],
    "InitContainersConfig": [
      {
        "Name": "init-container",
        "ImageUrl": "registry.cn-shenzhen.aliyuncs.com/sae-serverless-demo/sae-demo:microservice-java-provider-v1.0",
        "Command": "/bin/sh",
        "CommandArgs": "[\"a\",\"b\"]\n",
        "Envs": "[{\"name\":\"TEST_ENV_KEY\",\"value\":\"TEST_ENV_VAR\"}]\n",
        "ConfigMapMountDesc": [
          {
            "Key": "k1\n",
            "ConfigMapName": "test\n",
            "MountPath": "/tmp\n",
            "ConfigMapId": 1
          }
        ],
        "EmptyDirDesc": [
          {
            "Name": "",
            "MountPath": ""
          }
        ]
      }
    ],
    "CustomImageNetworkType": "internet",
    "ResourceType": "application",
    "BaseAppId": "8c573618-8d72-4407-baf4-f7b64b******",
    "MicroserviceEngineConfig": "{\\\"Enable\\\":true,\\\"MseLosslessRule\\\":{\\\"enable\\\":true,\\\"notice\\\":true,\\\"delayTime\\\":10,\\\"warmupTime\\\":120,\\\"funcType\\\":2,\\\"aligned\\\":false,\\\"related\\\":false,\\\"lossLessDetail\\\":false}}",
    "NewSaeVersion": "pro",
    "ClusterId": "495fc79c-ae61-4600-866d-a09d68******",
    "DiskSize": 20,
    "StartupProbe": "{\\\"exec\\\":{\\\"command\\\":[\\\"/bin/sh\\\",\\\"-c\\\",\\\"#!Note: If microservice config is enabled, the application will be automatically injected with the prestop configuration for lossless offline. If you delete this prestop configuration, lossless offline will not be effective.\\\\n echo stop > /tmp/prestop; /home/admin/.tools/curl http://127.0.0.1:54199/offline; sleep 30\\\"]}}",
    "GpuCount": "",
    "GpuType": "",
    "EnablePrometheus": false,
    "IsStateful": false,
    "CmsServiceId": "",
    "HeadlessPvtzDiscovery": "",
    "Html": "",
    "EmptyDirDesc": [
      {
        "Name": "",
        "MountPath": ""
      }
    ],
    "DeploymentName": "",
    "AlbIngressReadinessGate": "",
    "MaxSurgeInstances": 0,
    "MaxSurgeInstanceRatio": 0,
    "AgentVersion": "",
    "EnableNamespaceAgentVersion": false,
    "SlsLogEnvTags": "",
    "LokiConfigs": ""
  },
  "ErrorCode": "空",
  "Code": "200",
  "Success": true
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidApplication.NotFound The current application does not exist.
404 InvalidAppId.NotFound The specified AppId does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.