All Products
Search
Document Center

Elastic Compute Service:CreateApp

Last Updated:Feb 02, 2026

Creates 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

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

AppName

string

Yes

The application name.

App1

AppTags

array<object>

Yes

The custom tags of the application.

default

object

No

TagKey

string

No

The tag key.

controlledBy

TagValue

string

No

The tag value of the dedicated cluster.

ear

SubscribeStatus

string

Yes

The subscription status for the application usage report. Valid values:

  • UnSubscribe

  • Subscribe

Subscribe

SubscribePeriod

string

Yes

The interval at which application usage reports are sent. Valid values:

  • Weekly

  • Biweekly

  • Monthly. Default Weekly.

Weekly

Description

string

No

The description of the application.

test

ReportSendEnabled

boolean

No

Specifies whether to send reports to your mailbox and as internal messages.

false

RegionId

string

No

The region ID. You can call DescribeRegions to view the latest list of Alibaba Cloud regions.

cn-hangzhou

Owner

string

No

The Alibaba Cloud UID of the baseline owner.

1/0

ClientToken

string

No

A server-side generated string to identify a client request.

123e4567-e89b-12d3-a456-42665544****

Response elements

Element

Type

Description

Example

object

LensResponse

RequestId

string

The request ID.

E604ABBF-FD0F-5080-BE2B-BCF674A9E941

Code

string

The status code. A value of `OK` indicates that the request was successful.

OK

UserCode

string

The status code.

OK

Message

string

The response message. If the request is successful, `successful` is returned. If the request fails, an error message is returned.

successful

Success

boolean

Indicates whether the application was created. A value of `true` indicates that the application was created. A value of `false` indicates that the application failed to be created.

True

HttpStatusCode

integer

The message for the error code.

200

DynamicCode

string

The dynamic error code.

200

DynamicMessage

string

The dynamic message. This parameter is not used. Ignore this parameter.

-

AccessDeniedDetail

string

The detailed reason why the access was denied.

None

AppId

string

The application ID.

app-bd5e3533

AppName

string

The application name.

TestApp_g5t

Examples

Success response

JSON format

{
  "RequestId": "E604ABBF-FD0F-5080-BE2B-BCF674A9E941",
  "Code": "OK",
  "UserCode": "OK",
  "Message": "successful",
  "Success": true,
  "HttpStatusCode": 200,
  "DynamicCode": "200",
  "DynamicMessage": "-",
  "AccessDeniedDetail": "None",
  "AppId": "app-bd5e3533",
  "AppName": "TestApp_g5t"
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidParameter The parameter %s is invalid. The specified parameter value is invalid.
400 InvalidParameter.Conflict The specified parameter %s and %s are not blank at the same time.
400 InvalidParameter.Format Specified parameter format is not valid. english description
400 MissingParameter The input parameter %s that is mandatory for processing this request is not supplied. The parameter must be specified.
400 App.NumberExceed The number of apps exceeded.
500 InternalError The request processing has failed due to some unknown error, exception or failure. An internal error has occurred.
403 Forbidden User is not authorized to operate. You are not authorized to manage the resource. Check the account permissions or contact the Alibaba Cloud account.
403 Forbidden.Action User is not authorized to operate this action. You are not authorized to perform this operation. Check the account permissions or contact the Alibaba Cloud account.
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance.
403 LastTokenProcessing The last token request is processing. The value of clientToken is used in another request that is being processed. Try again later.
403 NoPermission.SLR The RAM user does not have the permission to create service linked role: AliyunServiceLinkedRoleForEBS. You are not authorized to create service-linked roles.
403 OperationDenied The operation is not allowed. The operation is not supported.
404 InvalidApi.NotFound Specified api is not found, please check your url and method.
404 NoSuchResource The specified resource does not exist. The specified resource does not exist.
504 RequestTimeout The request is timeout, please try again later. The request has timed out. Try again later.
429 BLOCK.LimitedRequest Request was denied due to user flow control.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.