All Products
Search
Document Center

Elastic Compute Service:ModifyApp

Last Updated:Feb 02, 2026

Modifies 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

No

The name of the application.

App1

AppTags

array<object>

Yes

The custom tags.

default

object

No

TagKey

string

No

The tag key.

key

TagValue

string

No

The tag value.

value

SubscribeStatus

string

Yes

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

  • UnSubscribe

  • Subscribe

Subscribe

SubscribePeriod

string

Yes

The interval at which the application usage report is sent. Valid values:

  • Weekly

  • Biweekly

  • Monthly

Weekly

Description

string

No

The description of the application.

This is description.

ReportSendEnabled

boolean

No

Specifies whether to send reports to your email and internal messages.

true

RegionId

string

No

The region ID. Call DescribeRegions to view the latest list of Alibaba Cloud regions.

cn-shanghai

Owner

string

No

The owner.

dev789`

ClientToken

string

No

A server-generated string that identifies a client request.

0c593ea1-3bea-11e9-b96b-88e9fe63****

AppId

string

No

The ID of the application.

app-xxx

Response elements

Element

Type

Description

Example

object

LensResponse

RequestId

string

The ID of the request.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Code

string

The response code.

OK

UserCode

string

The user code.

OK

Message

string

The returned message.

successful

Success

boolean

Indicates whether the request was successful. Valid values: true: The request was successful. false: The request failed.

true

HttpStatusCode

integer

The HTTP status code.

200

DynamicCode

string

The error code.

200

DynamicMessage

string

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

-

AccessDeniedDetail

string

The details about the access denial.

None

Examples

Success response

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "Code": "OK",
  "UserCode": "OK",
  "Message": "successful",
  "Success": true,
  "HttpStatusCode": 200,
  "DynamicCode": "200",
  "DynamicMessage": "-",
  "AccessDeniedDetail": "None"
}

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.
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.