All Products
Search
Document Center

Serverless App Engine:DescribeApplicationConfig

Last Updated:Jul 10, 2026

Retrieves the configuration information 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 response data.

RequestId

string

The request ID.

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

Message

string

The additional information about the call result.

success

TraceId

string

The trace ID, which is used to query the details of a call.

ac1a0b2215622246421415014e****

Data

object

The application information.

VpcId

string

VPC ID。

vpc-2ze0i263cnn311nvj****

Readiness

string

The application startup status check. Containers that fail multiple health checks are shut down and restarted. Containers that do not pass the health check do not receive SLB traffic. The exec, httpGet, and tcpSocket methods are supported. For specific examples, see the Liveness parameter.

Note

You can select only one method for health checks.

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

ConfigMapMountDesc

array<object>

The ConfigMap information.

object

The ConfigMap information.

Key

string

The key of the key-value pair.

k1

ConfigMapName

string

The name of the ConfigMap.

test

MountPath

string

The mount path of the container.

/tmp

ConfigMapId

integer

The ID of the ConfigMap.

1

SecurityGroupId

string

The security group ID.

sg-wz969ngg2e49q5i4****

BatchWaitTime

integer

The wait time between batches during a phased release, in seconds.

10

Jdk

string

The JDK version on which the deployment package depends. Valid values:

  • 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 image URL. This parameter is required when Package Type is set to Image.

docker.io/library/nginx:1.14.2

SlsConfigs

string

The settings for log collection to Simple Log Service (SLS).

  • To use SLS resources that are automatically created by Serverless App Engine (SAE): [{"logDir":"","logType":"stdout"},{"logDir":"/tmp/a.log"}].

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

Parameter descriptions:

  • projectName: The name of the project in SLS.

  • logDir: The log path.

  • logType: The log type. stdout indicates container standard output logs. You can set only one stdout entry. If this parameter is not set, file logs are collected.

  • logstoreName: The name of the Logstore in SLS.

  • logtailName: The name of the Logtail in SLS. If this parameter is not specified, a new Logtail is created through automatic creation.

If the SLS collection configuration has not changed during multiple deployments, you do not need to set this parameter (that is, the SlsConfigs field does not need to be included in the request). If you no longer need the SLS collection feature, set the value of this field to an empty string in the request (that is, set the value of the SlsConfigs field to "").

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

Liveness

string

The container health check settings. Containers that fail the health check are shut down and recovered. The following 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 select only one method for health checks.

Parameter descriptions:

  • 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. false indicates that the keyword is not included. If this field is missing, the advanced feature is not used.

  • httpGet.keyWord: The custom keyword. The isContainKeyWord field must be present when this parameter is used.

  • tcpSocket.port: The port for TCP connection detection.

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

  • periodSeconds: The health check period. Default value: 30. Unit: seconds.

  • timeoutSeconds: The health check timeout period. Default value: 1. Unit: seconds. If this parameter is set to 0 or is not set, 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 deployment package URL. If your deployment package is uploaded through SAE, note the following:

  • This URL cannot be used for direct download. Use the GetPackageVersionAccessableUrl operation to obtain a downloadable URL (valid for 10 minutes).

  • SAE retains the package for a maximum of 90 days. After 90 days, the URL is no longer returned and the package is no longer available for download.

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

PackageType

string

The application package type. Valid values:

  • When you deploy with Java, FatJar, War, and Image are supported.

  • When you deploy with PHP, the following types 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 run before the container stops. A script is triggered before the container is deleted. Format: {"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 application. The default startup command for the application: $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 application. The default startup command for the application: $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. When the minimum number of available instances is 1, the value of the UpdateStrategy field is "". When the minimum number of available instances is greater than 1, examples are as follows:

  • Canary release of 1 instance + 2 subsequent batches + automatic batching + 1-minute batch interval: {"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}

  • Canary release of 1 instance + 2 subsequent batches + manual batching: {"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"manual"},"grayUpdate":{"gray":1}}

  • 2 batches + automatic batching + 0-minute batch interval: {"type":"BatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":0}}

Parameter descriptions:

  • type: The release policy type. Valid values: GrayBatchUpdate (grayscale batch release) and BatchUpdate (batch release).

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

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

    • batchWaitTime: The interval between deployments within a batch, in seconds.

  • grayUpdate: The remaining batches after grayscale 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 available instances. Valid values:

  • If set to 0, the application interrupts services during the upgrade process.

  • If set to -1, the system-recommended value is used, which is 25% of the current number of instances. If the current number of instances is 5, 5 × 25% = 1.25, which is rounded up to 2.

Note

Set the minimum number of available instances to ≥ 1 for each rolling deployment to avoid service interruptions.

1

MinReadyInstanceRatio

integer

The minimum percentage of available instances. Valid values:

  • -1: The default value, which indicates that the percentage is not used. If this parameter is not specified, the system uses -1 by default.

  • 0~100: The unit is percentage, rounded up. For example, if set to 50%, and the current number of instances is 5, the minimum number of available instances is 3.

Note

When both MinReadyInstance and MinReadyInstanceRatio are specified and the value of MinReadyInstanceRatio is not -1, the MinReadyInstanceRatio parameter takes precedence. For example, if MinReadyInstances is set to 5 and MinReadyInstanceRatio is set to 50, the system uses MinReadyInstanceRatio to calculate the minimum number of available instances.

-1

Memory

integer

The memory size required by each instance, in MB. This value cannot be 0. The memory size has a one-to-one mapping with CPU. Only the following defined specifications are supported:

  • 1024: Corresponds to 500 millicores and 1000 millicores of CPU.

  • 2048: Corresponds to 500, 1000, and 2000 millicores of CPU.

  • 4096: Corresponds to 1000, 2000, and 4000 millicores of CPU.

  • 8192: Corresponds to 2000, 4000, and 8000 millicores of CPU.

  • 12288: Corresponds to 12000 millicores of CPU.

  • 16384: Corresponds to 4000, 8000, and 16000 millicores of CPU.

  • 24576: Corresponds to 12000 millicores of CPU.

  • 32768: Corresponds to 16000 millicores of CPU.

  • 65536: Corresponds to 8000, 16000, and 32000 millicores of CPU.

  • 131072: Corresponds to 32000 millicores of CPU.

2048

Php

string

The PHP version on which the PHP deployment package depends. Images are not supported.

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. Make sure that the PHP server uses this configuration file for startup.

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

PostStart

string

The script that is run after the container starts. A script is triggered immediately after the container is created. Format: {"exec":{"command":\["cat","/etc/group"\]}}

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

TerminationGracePeriodSeconds

integer

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

10

CommandArgs

string

The arguments for the image startup command. These are the arguments required by the startup command Command. Format:

["a","b"]

In the example for the Command parameter, CommandArgs=["abc", ">", "file0"], where ["abc", ">", "file0"] must be converted to the String type and the internal format is a JSON array. If this parameter is not required, leave it empty.

["a","b"]

NamespaceId

string

The namespace ID.

cn-beijing:test

MountHost

string

The mount point of NAS within the application VPC. If the configuration has not changed during deployment, you do not need to set this parameter (that is, the MountHost field does not need to be included in the request). To clear the NAS configuration, set the value of this field to an empty string in the request (that is, set the value of the MountHost field to "").

example.com

TomcatConfig

string

The Tomcat configuration. Set this parameter to "" or "{}" to delete the configuration:

  • port: The port number. Valid values: 1024 to 65535. Ports smaller than 1024 require root permissions. Because the container is configured with admin permissions, specify a port greater than 1024. Default value: 8080.

  • contextPath: The access path. Default value: root directory "/".

  • 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. Default value: ISO-8859-1.

  • 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

vSwitch ID。

vsw-2ze559r1z1bpwqxwp****

Cpu

integer

The CPU required by each instance, in millicores. This value cannot be 0. Only the following defined specifications are supported:

  • 500

  • 1000

  • 2000

  • 4000

  • 8000

  • 16000

  • 32000

1000

Envs

string

The container environment variable parameters. Custom values or references to configuration items are supported. To reference a configuration item, create a ConfigMap instance first. For more information, see CreateConfigMap. Valid values:

  • Custom configuration
    • name: The environment variable name.

    • value: The environment variable value.

  • Reference to a configuration item
    • name: The environment variable name. 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 environment variable reference. Set the value to configMapRef.

    • configMapId: The ConfigMap ID.

    • key: The key. If all keys are referenced, do not set this field.

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

MountDesc

array<object>

The mount description information.

object

The mount description information.

MountPath

string

The mount path of the container.

/tmp

NasPath

string

The path of the NAS file system.

/

EnableAhas

string

Specifies whether to connect to Application High Availability Service (AHAS). Valid values:

  • true: Connected to AHAS.

  • false: Not connected to AHAS.

true

CustomHostAlias

string

The custom host mapping 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 on which the deployment package depends. Valid values:

  • 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 image startup command. This command must be an executable object that exists in the container. Example:

command:
      - echo
      - abc
      - >
      - file0

Based on the preceding example, Command="echo", CommandArgs=["abc", ">", "file0"].

echo

WarStartOptions

string

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

custom-option

PhpArmsConfigLocation

string

The mount path for PHP application monitoring. Make sure that the PHP server loads the configuration file from this path.

You do not need to manage the configuration content. SAE automatically renders the correct configuration file.

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

NasId

string

NAS ID。

AKSN****

OssAkId

string

The AccessKey ID for OSS read/write operations.

xxxxxx

OssAkSecret

string

The AccessKey Secret for OSS read/write operations.

xxxxxx

OssMountDescs

array<object>

The OSS mount description.

object

The OSS mount description.

bucketName

string

The bucket name.

oss-bucket

bucketPath

string

The directory or object that you created in OSS. An error occurs if the mount directory does not exist.

data/user.data

mountPath

string

The path of the container 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 the read-only permission on the mount directory resources. Valid values:

  • true: The read-only permission.

  • false: The read and write permissions.

true

EdasContainerVersion

string

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

3.5.3

Timezone

string

The time zone. Default value: Asia/Shanghai.

Asia/Shanghai

AppDescription

string

The application description.

Sample application

EnableGreyTagRoute

boolean

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

  • true: Enabled.

  • false: Disabled.

false

MseApplicationId

string

The application ID on the Microservices Engine (MSE) side.

xxxxxxx@xxxxx

AcrInstanceId

string

The ACR Enterprise instance ID.

cri-xxxxxx

AcrAssumeRoleArn

string

The ARN of the RAM role required for pulling images across accounts. For more information, see Pull Alibaba Cloud images across accounts and Grant cross-account permissions by using RAM roles.

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

ImagePullSecrets

string

The corresponding secret ID.

10

AssociateEip

boolean

Specifies whether to associate an EIP. Valid values:

  • true: Associated.

  • false: Not associated.

true

KafkaConfigs

string

The summary of log collection configurations for Kafka. Valid values:

  • kafkaEndpoint: The endpoint of the Kafka API.

  • kafkaInstanceId: The Kafka instance ID.

  • kafkaConfigs: The configuration summary for one or more log entries. For example values and parameter descriptions, 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 technology stack used to create the application. Valid values:

  • java: Java.

  • php: PHP.

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

java

PvtzDiscovery

string

Enables K8s Service-based service registration and discovery.

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

SwimlanePvtzDiscovery

string

Configures K8s Service-based service registration and discovery with end-to-end canary release.

{\"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: Self-managed Nacos.

  • 2: MSE commercial edition Nacos.

"0"

NasConfigs

string

The NAS mount configurations.

[{"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 custom installation module dependencies. By default, the dependencies defined in the requirements.txt file in the root directory are installed. If no dependencies are configured or custom packages are needed, you can specify the dependencies to install.

Flask==2.0

MseApplicationName

string

The application name after the SAE service is registered with MSE.

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

AppSource

string

The SAE application type.

  • micro_service

  • web

  • job

micro_service

ServiceTags

object

The canary release tags configured for the application.

string

The canary release tag value.

tag1

Dotnet

string

The .NET framework version:

  • .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 takes effect 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 idle mode. Valid values:

  • true: Enabled.

  • false: Disabled.

false

EnableNewArms

boolean

Specifies whether to enable the new ARMS feature. Valid values:

  • true: Enabled.

  • false: Not enabled.

false

EnableCpuBurst

string

Specifies whether to enable the CPU Burst feature. Valid values:

  • true: Enabled.

  • false: Not enabled.

true

OidcRoleName

string

The RAM role for identity authentication.

Note

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 role for SSO identity provider.

sae-test

SecretMountDesc

array<object>

The Secret mount description.

object

The Secret mount description.

Key

string

The key of the data value that is encoded in Base64.

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 queried secret instance.

520

SidecarContainersConfig

array<object>

The sidecar container configuration.

array<object>

The sidecar container configuration.

Name

string

The container name.

test

Cpu

integer

The maximum CPU resources that the sidecar container can use from the main container.

500

Memory

integer

The maximum memory resources that the sidecar container can use from the main container.

1024

ImageUrl

string

The image URL.

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 the preceding example, Command="echo", CommandArgs=["abc", ">", "file0"].

/bin/sh

CommandArgs

string

The arguments of the image startup command. The arguments are required by the preceding startup command Command. Format:

["a","b"]

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

[\"-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 takes precedence over valueFrom.

  • Reference a configuration item (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>, for example, sae-sys-configmap-all-test1.

    • valueFrom: The reference of 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 that you want to mount. Use the configuration item that you created on the Namespace Configuration Items page to inject configuration information into the container. The parameters are described as follows:

  • 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 that you want to mount.

Key

string

The key of the ConfigMap.

key

ConfigMapName

string

The name of the ConfigMap.

ConfigMap-test

MountPath

string

The mount path of the container.

/mnt/test

ConfigMapId

integer

The ID of the ConfigMap instance.

7361

EmptyDirDesc

array<object>

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

object

The shared temporary storage.

Name

string

The name of the temporary storage.

sidecar-container

MountPath

string

The path on which the volume is mounted in the container.

/mnt/cache

SecretMountDesc

array<object>

The description of the secret that you want to mount.

object

Key

string

The key of the data value that is encoded in Base64.

SecretName

string

The name of the secret instance.

MountPath

string

The mount path.

SecretId

integer

The ID of the secret instance.

Liveness

string

The health check on the container.

Readiness

string

The check on the application startup status.

PreStop

string

PostStart

string

InitContainersConfig

array<object>

The init container configuration.

array<object>

The init container configuration.

Name

string

The name of the init container.

init-container

ImageUrl

string

The URL of the image that is 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 the preceding example, Command="echo", CommandArgs=["abc", ">", "file0"].

/bin/sh

CommandArgs

string

The arguments of the image startup command. The arguments are required by the preceding startup command Command. Format:

["a","b"]

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

["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 takes precedence over valueFrom.

  • Reference a configuration item (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>, for example, sae-sys-configmap-all-test1.

    • valueFrom: The reference of 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 a 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>, for example, sae-sys-secret-all-test1.

    • valueFrom: The reference of 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 configurations of the ConfigMap.

object

The key-value pair of the ConfigMap.

Key

string

The key of the key-value pair.

k1

ConfigMapName

string

The name of the ConfigMap.

test

MountPath

string

The mount path of the container.

/tmp

ConfigMapId

integer

The ID of the ConfigMap.

1

EmptyDirDesc

array<object>

The shared temporary storage.

object

Name

string

The name of the temporary storage.

MountPath

string

The path on which the volume is mounted in the container.

SecretMountDesc

array<object>

The description of the secret that you want to mount.

object

Key

string

The key.

SecretName

string

The name of the secret instance.

MountPath

string

The mount path.

SecretId

integer

The ID of the secret instance.

CustomImageNetworkType

string

The type of the custom image. If the image is not a custom image, set this parameter to an empty string. Valid values:

  • internet: public image

  • intranet: internal 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

The microservice governance configuration.

  • Specifies whether to enable microservice governance (enable):

    • true: enabled

    • false: disabled

  • Lossless rolling update configuration (mseLosslessRule):

    • delayTime: the delay time.

    • enable: specifies whether to enable the lossless online feature. true indicates enabled. false indicates disabled.

    • notice: specifies whether to enable the notification feature. true indicates enabled. false indicates disabled.

    • warmupTime: the warm-up duration for traffic ramping, in 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. Valid values:

  • lite: Lite Edition

  • std: Standard Edition

  • pro: Professional Edition

pro

ClusterId

string

The cluster ID.

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

DiskSize

integer

The disk storage size, in 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

The number of GPUs.

GpuType

string

The GPU type.

EnablePrometheus

boolean

Indicates whether Prometheus custom metric collection is enabled.

IsStateful

boolean

Indicates whether the application is stateful.

CmsServiceId

string

The CloudMonitor service ID.

HeadlessPvtzDiscovery

string

Html

string

EmptyDirDesc

array<object>

The shared temporary storage.

object

The shared ephemeral storage configuration.

Name

string

The name of the temporary storage.

MountPath

string

The mount path.

DeploymentName

string

The instance name of the application in the ASI cluster.

demo-b0cdce9b-3d1f-4168-b206-b59f348f1a8a

AlbIngressReadinessGate

string

The ALB gateway ReadinessGate configuration.

MaxSurgeInstances

integer

The Peak Volume of instances.

MaxSurgeInstanceRatio

integer

The Peak Volume instance ratio.

AgentVersion

string

The agent version.

EnableNamespaceAgentVersion

boolean

Indicates whether the namespace agent version configuration is reused.

SlsLogEnvTags

string

sls log env tags

LokiConfigs

string

LokiConfigs

IdleHour

string

Labels

object

The labels.

string

RaspConfig

array<object>

object

EnableRasp

boolean

RaspAppName

string

RaspAppKey

string

ErrorCode

string

The error code. Valid values:

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

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

Code

string

The API status or POP error code. Valid values:

  • 2xx: success.

  • 3xx: redirection.

  • 4xx: request error.

  • 5xx: server error.

200

Success

boolean

Indicates whether the application configuration information is retrieved. Valid values:

  • true: Retrieved.

  • false: Failed to retrieve.

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": "Sample application",
    "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"
          }
        ],
        "SecretMountDesc": [
          {
            "Key": "",
            "SecretName": "",
            "MountPath": "",
            "SecretId": 0
          }
        ],
        "Liveness": "",
        "Readiness": "",
        "PreStop": "",
        "PostStart": ""
      }
    ],
    "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": ""
          }
        ],
        "SecretMountDesc": [
          {
            "Key": "",
            "SecretName": "",
            "MountPath": "",
            "SecretId": 0
          }
        ]
      }
    ],
    "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": "demo-b0cdce9b-3d1f-4168-b206-b59f348f1a8a",
    "AlbIngressReadinessGate": "",
    "MaxSurgeInstances": 0,
    "MaxSurgeInstanceRatio": 0,
    "AgentVersion": "",
    "EnableNamespaceAgentVersion": false,
    "SlsLogEnvTags": "",
    "LokiConfigs": "",
    "IdleHour": "",
    "Labels": {
      "key": ""
    },
    "RaspConfig": [
      {
        "EnableRasp": true,
        "RaspAppName": "",
        "RaspAppKey": ""
      }
    ]
  },
  "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.