All Products
Search
Document Center

Serverless App Engine:DescribeApplicationConfig

Last Updated:Feb 25, 2026

Retrieves application configuration information.

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

Application ID.

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

VersionId

string

No

Version ID.

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

Response elements

Element

Type

Description

Example

object

Response data.

RequestId

string

Request ID.

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

Message

string

Additional information about the call result.

success

TraceId

string

Trace ID used for precise query of call information.

ac1a0b2215622246421415014e****

Data

object

Application information.

VpcId

string

VPC ID.

vpc-2ze0i263cnn311nvj****

Readiness

string

Application startup status check. Containers that fail multiple health checks will be shut down and restarted. Containers that fail the readiness check will not receive traffic from SLB. Supported methods include exec, httpGet, and tcpSocket. For examples, see the Liveness parameter.

Note

You can only choose one method for health checks.

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

ConfigMapMountDesc

array<object>

ConfigMap information.

object

ConfigMap information.

Key

string

ConfigMap key-value pair.

k1

ConfigMapName

string

ConfigMap name.

test

MountPath

string

Container mount path.

/tmp

ConfigMapId

integer

ConfigMap ID.

1

SecurityGroupId

string

Security group ID.

sg-wz969ngg2e49q5i4****

BatchWaitTime

integer

Waiting time between batches during phased release, in seconds.

10

Jdk

string

JDK version required by the deployment package. Supported versions:

  • Open JDK 8

  • Open JDK 7

  • Dragonwell 11

  • Dragonwell 8

  • openjdk-8u191-jdk-alpine3.9

  • openjdk-7u201-jdk-alpine3.9

Not supported when Package Type is Image.

Open JDK 8

ImageUrl

string

Image address. Required when Package Type is Image.

docker.io/library/nginx:1.14.2

SlsConfigs

string

Configuration for log collection to SLS.

  • Use SLS resources automatically created by SAE: [{"logDir":"","logType":"stdout"},{"logDir":"/tmp/a.log"}].

  • 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: Project name in SLS.

  • logDir: Log path.

  • logType: Log type. stdout indicates container standard output logs. Only one entry can be set. If not specified, file logs are collected.

  • logstoreName: Logstore name in SLS.

  • logtailName: Logtail name in SLS. If not specified, a new Logtail is created.

If the SLS collection configuration does not change during redeployment, you do not need to set this parameter (omit the SlsConfigs field in the request). If you no longer need SLS collection, set this field to an empty string (SlsConfigs = "").

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

Liveness

string

Container health check. Containers that fail the liveness check will be shut down and recovered. Supported methods:

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

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

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

Note

You can only choose one method for health checks.

Parameter descriptions:

  • exec.command: Set the health check command.

  • httpGet.path: Access path.

  • httpGet.scheme: HTTP or HTTPS.

  • httpGet.isContainKeyWord: true means the response contains the keyword. false means it does not. If omitted, advanced features are not used.

  • httpGet.keyWord: Custom keyword. The isContainKeyWord field must be present when using this.

  • tcpSocket.port: Port for TCP connection detection.

  • initialDelaySeconds: Delay before the first health check. Default is 10 seconds.

  • periodSeconds: Interval between health checks. Default is 30 seconds.

  • timeoutSeconds: Timeout for health checks. Default is 1 second. If set to 0 or omitted, the default timeout is 1 second.

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

Tags

array<object>

Tag information.

object

Tag information.

Key

string

Tag key.

k1

Value

string

Tag value.

v1

PackageUrl

string

Deployment package URL. If your package was uploaded through SAE, note the following:

  • This URL cannot be downloaded directly. Use the GetPackageVersionAccessableUrl API to get a downloadable URL (valid for 10 minutes).

  • SAE retains the package for up to 90 days. After 90 days, the URL is no longer returned and downloads are unavailable.

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

PackageType

string

Application package type. Values:

  • For Java deployments: FatJar, War, and Image.

  • For PHP deployments:
    • 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

Script executed before container termination. Runs before the container is deleted. Format: {"exec":{"command":["cat","/etc/group"]}}

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

PackageVersion

string

Deployment package version. Required when Package Type is FatJar or War.

1.0

JarStartArgs

string

JAR package startup arguments. Default startup command: $JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs

start

AppName

string

Application name.

demo-app

AppId

string

Application ID.

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

JarStartOptions

string

JAR package startup options. Default startup command: $JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs

-Dtest=true

Replicas

integer

Number of application instances.

2

UpdateStrategy

string

Deployment strategy. When the minimum number of ready instances is 1, UpdateStrategy is "". When greater than 1, examples:

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

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

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

Parameter descriptions:

  • type: Release strategy type. Options: canary release GrayBatchUpdate or phased release BatchUpdate.

  • batchUpdate: Phased release strategy.
    • batch: Number of release batches.

    • releaseType: Batch processing method. Options: auto auto or manual manual.

    • batchWaitTime: Time between batches, in seconds.

  • grayUpdate: Instances after canary phase. Required when type is GrayBatchUpdate.

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

MinReadyInstances

integer

Minimum number of ready instances. Values:

  • If set to 0, the application will experience service interruption during upgrades.

  • If set to -1, the system uses its recommended value (25% of current instances). For example, with 5 instances: 5 × 25% = 1.25 → rounded up to 2.

Note

Set the minimum number of ready instances to ≥1 during rolling updates to avoid service interruption.

1

MinReadyInstanceRatio

integer

Percentage of minimum ready instances. Values:

  • -1: Default value. Percentage is not used. If omitted, defaults to -1.

  • 0~100: Percentage value, rounded up. For example, 50% with 5 instances → 3 ready instances.

Note

When both MinReadyInstance and MinReadyInstanceRatio are provided and MinReadyInstanceRatio-1, MinReadyInstanceRatio takes precedence. For example, if MinReadyInstances = 5 and MinReadyInstanceRatio = 50, the system calculates based on MinReadyInstanceRatio.

-1

Memory

integer

Memory required per instance, in MB. Cannot be 0. Must match CPU specifications. Supported fixed specifications:

  • 1024: Corresponds to 500 or 1000 millicores CPU.

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

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

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

  • 12288: Corresponds to 12000 millicores CPU.

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

  • 24576: Corresponds to 12000 millicores CPU.

  • 32768: Corresponds to 16000 millicores CPU.

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

  • 131072: Corresponds to 32000 millicores CPU.

2048

Php

string

PHP version required by the deployment package. Not supported for images.

PHP-FPM 7.0

PhpConfig

string

PHP configuration file content.

k1=v1

PhpConfigLocation

string

Mount path for PHP application startup configuration. Ensure the PHP server uses this configuration file at startup.

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

PostStart

string

Script executed after container startup. Runs immediately after the container is created. Format: {"exec":{"command":["cat","/etc/group"]}}

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

TerminationGracePeriodSeconds

integer

Graceful shutdown timeout. Default is 30 seconds. Range: 1–300 seconds.

10

CommandArgs

string

Image startup command arguments. Arguments for the Command parameter. Format:

["a","b"]

In the Command example, CommandArgs=["abc", ">", "file0"] must be converted to a JSON array string. Omit if not needed.

["a","b"]

NamespaceId

string

Namespace ID.

cn-beijing:test

MountHost

string

NAS mount point within the application VPC. If the configuration hasn't changed during deployment, omit this parameter. To clear NAS configuration, set this field to an empty string ("").

example.com

TomcatConfig

string

Tomcat configuration. Set to "" or "{}" to delete configuration:

  • port: Port range 1024–65535. Ports below 1024 require root privileges. Since containers run as admin, use ports above 1024. Default: 8080.

  • contextPath: Access path. Default: root directory "/".

  • maxThreads: Connection pool size. Default: 400.

  • uriEncoding: Tomcat encoding format. Options: UTF-8, ISO-8859-1, GBK, GB2312. Default: ISO-8859-1.

  • useBodyEncoding: Whether to use BodyEncoding for URL. Default: true.

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

RegionId

string

Region ID.

cn-beijing

VSwitchId

string

vSwitch ID.

vsw-2ze559r1z1bpwqxwp****

Cpu

integer

CPU required per instance, in millicores. Cannot be 0. Supported fixed specifications:

  • 500

  • 1000

  • 2000

  • 4000

  • 8000

  • 16000

  • 32000

1000

Envs

string

Container environment variables. Supports custom values or ConfigMap references. To reference a ConfigMap, create a ConfigMap instance first. For more information, see CreateConfigMap. Values:

  • Custom configuration
    • name: Environment variable name.

    • value: Environment variable value.

  • ConfigMap reference
    • name: Environment variable name. To reference all keys, use sae-sys-configmap-all-<ConfigMap name>, for example sae-sys-configmap-all-test1.

    • valueFrom: Environment variable reference. Value: configMapRef.

    • configMapId: ConfigMap ID.

    • key: Key. Omit if referencing all keys.

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

MountDesc

array<object>

Mount description.

object

Mount description.

MountPath

string

Container mount path.

/tmp

NasPath

string

NAS relative file directory.

/

EnableAhas

string

Whether to integrate with AHAS. Values:

  • true: Integrate with AHAS.

  • false: Do not integrate with AHAS.

true

CustomHostAlias

string

Custom host mapping inside the container. Values:

  • hostName: Domain name or hostname.

  • ip: IP address.

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

WebContainer

string

Tomcat version required by the deployment package. Supported versions:

  • apache-tomcat-7.0.91

  • apache-tomcat-8.5.42

Not supported when Package Type is Image.

apache-tomcat-7.0.91

Command

string

Image startup command. Must be an executable object inside the container. Example:

command:
      - echo
      - abc
      - >
      - file0

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

echo

WarStartOptions

string

WAR package startup options. Default startup command: java $JAVA_OPTS $CATALINA_OPTS -Options org.apache.catalina.startup.Bootstrap "$@" start.

custom-option

PhpArmsConfigLocation

string

Mount path for PHP application monitoring configuration. Ensure the PHP server loads this configuration file.

You don't 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

OSS read/write AccessKey ID.

xxxxxx

OssAkSecret

string

OSS read/write AccessKey secret.

xxxxxx

OssMountDescs

array<object>

OSS mount description.

object

OSS mount description.

bucketName

string

Bucket name.

oss-bucket

bucketPath

string

Directory or object you created in OSS. If the OSS mount directory doesn't exist, an error occurs.

data/user.data

mountPath

string

Container path in SAE. If the path exists, it's overwritten. If it doesn't exist, it's created.

/usr/data/user.data

readOnly

boolean

Whether the container path has read-only access to the mounted directory. Values:

  • true: Read-only.

  • false: Read-write.

true

EdasContainerVersion

string

Application runtime environment version in the HSF framework, such as Ali-Tomcat container.

3.5.3

Timezone

string

Time zone. Default: Asia/Shanghai.

Asia/Shanghai

AppDescription

string

Application description.

示例应用

EnableGreyTagRoute

boolean

Whether to enable traffic grayscale rules. Applies only to Spring Cloud and Dubbo applications. Values:

  • true: Enable grayscale rules.

  • false: Disable grayscale rules.

false

MseApplicationId

string

MSE product-side application ID.

xxxxxxx@xxxxx

AcrInstanceId

string

ACR Enterprise Edition instance ID.

cri-xxxxxx

AcrAssumeRoleArn

string

ARN of the RAM role required for cross-account image pulling. For more information, see Pull Alibaba Cloud images across accounts and Authorize across cloud accounts using RAM roles.

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

ImagePullSecrets

string

Corresponding secret ID.

10

AssociateEip

boolean

Whether to bind an EIP. Values:

  • true: Bind.

  • false: Do not bind.

true

KafkaConfigs

string

Aggregated configuration for log collection to Kafka. Values:

  • kafkaEndpoint: Service endpoint for Kafka API.

  • kafkaInstanceId: Kafka instance ID.

  • kafkaConfigs: Aggregated configuration for single or multiple logs. For examples and parameter descriptions, see the request parameter kafkaConfigs 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

Technology stack language for application creation. Values:

  • java: Java.

  • php: PHP.

  • other: Multi-language, such as Python, C++, Go, .NET, and Node.js.

java

PvtzDiscovery

string

Enable K8s 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

Configure K8s 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

Select Nacos registry. Values:

  • 0: Built-in Nacos in SAE.

  • 1: Self-managed Nacos.

  • 2: MSE commercial Nacos.

"0"

NasConfigs

string

NAS mount configuration.

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

Python environment. Supports PYTHON 3.9.15.

PYTHON 3.9.15

PythonModules

string

Custom module dependencies. By default, dependencies defined in requirements.txt in the root directory are installed. If not configured or using custom packages, specify the dependencies to install.

Flask==2.0

MseApplicationName

string

Application name after SAE registers with MSE.

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

AppSource

string

SAE application type.

  • micro_service.

  • web.

  • job.

micro_service

ServiceTags

object

Grayscale tags configured for the application

string

Grayscale tag value

tag1

Dotnet

string

.NET framework version:

  • .NET 3.1

  • .NET 5.0

  • .NET 6.0

  • .NET 7.0

  • .NET 8.0

.NET 8.0

MicroRegistrationConfig

string

Registry configuration. Only effective when the registry type is MSE Nacos Enterprise Edition.

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

EnableIdle

boolean

Whether to enable idle mode:

  • true: Enable

  • false: Disable

false

EnableNewArms

boolean

Whether to enable the new ARMS feature:

  • true: Enable

  • false: Disable

false

EnableCpuBurst

string

Whether to enable CPU Burst:

  • true: Enable

  • false: Disable

true

OidcRoleName

string

Set the RAM role for identity authentication.

Note

Create an OIDC identity provider and identity provider role in the same region beforehand. For details, see Create an OIDC identity provider and Create a role SSO identity provider.

sae-test

SecretMountDesc

array<object>

Secret mount description.

object

Secret mount description

Key

string

Key for Base64-encoded data value.

task-center

SecretName

string

Secret instance name.

dummy-name-opaque-894

MountPath

string

Mount path.

/opt/www/runtime/logs

SecretId

integer

Query Secret instance ID.

520

SidecarContainersConfig

array<object>

Sidecar container configuration.

array<object>

Sidecar container configuration.

Name

string

Container name.

test

Cpu

integer

Set the CPU resource limit that the sidecar container can use from the main container.

500

Memory

integer

Set the memory resource limit that the sidecar container can use from the main container.

1024

ImageUrl

string

Image address.

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

AcrInstanceId

string

ACR Enterprise Edition instance ID. Required when ImageUrl is from Container Registry Enterprise Edition.

cri-fhzlneorxala66ip

Command

string

Image startup command. Must be an executable object inside the container. Example:

command:
      - echo
      - abc
      - >
      - file0

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

/bin/sh

CommandArgs

string

Image startup command arguments. Arguments for the Command parameter above. Format:

["a","b"]

In the example above, CommandArgs=["abc", ">", "file0"] must be converted to a JSON array string. Omit if not needed.

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

Envs

string

Container environment variables. Supports custom values or ConfigMap references. To reference a ConfigMap, create a ConfigMap instance first. For more information, see CreateConfigMap. Values:

  • Custom configuration
    • name: Environment variable name.

    • value: Environment variable value. Takes precedence over valueFrom.

  • ConfigMap reference (valueFrom)
    • name: Environment variable name. To reference all keys, use sae-sys-configmap-all-<ConfigMap name>, for example sae-sys-configmap-all-test1.

    • valueFrom: Environment variable reference. Value: configMapRef
      • configMapId: The ID of the ConfigMap.

      • key: The key. Leave this field empty if you reference all key-value pairs.

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

ConfigMapMountDesc

array<object>

ConfigMap mount description. Inject configuration information into containers using ConfigMaps created on the namespace configuration page. Parameter descriptions:

Note

Pass the sae-sys-configmap-all parameter to mount all keys.

  • mountPath: Mount path.

  • ConfigMapName: ConfigMap name.

object

ConfigMap mount description.

Key

string

ConfigMap key.

key

ConfigMapName

string

ConfigMap name.

ConfigMap-test

MountPath

string

Container mount path.

/mnt/test

ConfigMapId

integer

ConfigMap instance ID.

7361

EmptyDirDesc

array<object>

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

object

Shared temporary storage.

Name

string

Temporary storage name.

sidecar-container

MountPath

string

Mount path of the volume inside the container.

/mnt/cache

InitContainersConfig

array<object>

Initialization container configuration.

array<object>

Initialization container configuration.

Name

string

Initialization container name.

init-container

ImageUrl

string

Image address used by the initialization container.

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

Command

string

Image startup command. Must be an executable object inside the container. Example:

command:
      - echo
      - abc
      - >
      - file0

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

/bin/sh

CommandArgs

string

Image startup command arguments. Arguments for the Command parameter above. Format:

["a","b"]

In the example above, CommandArgs=["abc", ">", "file0"] must be converted to a JSON array string. Omit if not needed.

["a","b"]

Envs

string

Container environment variables. Supports custom values or ConfigMap references. To reference a ConfigMap, create a ConfigMap instance first. For more information, see CreateConfigMap. Values:

  • Custom configuration
    • name: Environment variable name.

    • value: Environment variable value. Takes precedence over valueFrom.

  • ConfigMap reference (valueFrom)
    • name: Environment variable name. To reference all keys, use sae-sys-configmap-all-<ConfigMap name>, for example sae-sys-configmap-all-test1.

    • valueFrom: Environment variable reference. Value: configMapRef.

    • configMapId: ConfigMap ID.

    • key: Key. Omit if referencing all keys.

  • Secret reference (valueFrom)
    • name: Environment variable name. To reference all keys, use sae-sys-secret-all-<secret name>, for example sae-sys-secret-all-test1.

    • valueFrom: Environment variable reference. Value: secretRef.

    • secretId: Secret ID.

    • key: Key. Omit if referencing all keys.

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

ConfigMapMountDesc

array<object>

ConfigMap information.

object

ConfigMap key-value pair.

Key

string

ConfigMap key-value pair.

k1

ConfigMapName

string

ConfigMap name.

test

MountPath

string

Container mount path.

/tmp

ConfigMapId

integer

ConfigMap ID.

1

EmptyDirDesc

array<object>

object

Name

string

MountPath

string

CustomImageNetworkType

string

Custom image type. Set to an empty string if not a custom image:

  • internet: Public network image

  • intranet: Private network image

internet

ResourceType

string

Resource type. Only supports application.

application

BaseAppId

string

Baseline application ID.

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

MicroserviceEngineConfig

string

Configure microservice governance features.

  • Enable microservice governance (enable):

    • true: Enable

    • false: Disable

  • Configure graceful start and shutdown (mseLosslessRule):

    • delayTime: Delay time

    • enable: Whether to enable graceful start. true to enable, false to disable.

    • notice: Whether to enable notification. true to enable, false to disable.

    • warmupTime: Warm-up duration for small traffic, in seconds.

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

NewSaeVersion

string

Application version:

  • lite: Lite edition

  • std: Standard edition

  • pro: Professional edition

pro

ClusterId

string

Cluster ID.

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

DiskSize

integer

Disk storage size (in GB).

20

StartupProbe

string

Application startup probe.

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

sls log env tags

LokiConfigs

string

IdleHour

string

Labels

object

string

ErrorCode

string

Error code. Values:

  • Success: ErrorCode field is not returned.

  • Failure: ErrorCode field is returned. For details, see the Error codes list in this topic.

Code

string

API status or POP error code. Values:

  • 2xx: Success.

  • 3xx: Redirection.

  • 4xx: Request error.

  • 5xx: Server error.

200

Success

boolean

Whether getting application configuration information succeeded. Values:

  • true: Success.

  • false: Failure.

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": "",
    "IdleHour": "",
    "Labels": {
      "key": ""
    }
  },
  "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.