Starts an application.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request headers

This operation uses only common request headers and does not have operation-specific request headers. For more information, see Common request and response headers.

Request syntax

PUT /pop/v1/sam/app/startApplication HTTP/1.1

Request parameters

ParameterTypePositionRequiredExampleDescription
AppIdStringQueryYes0099b7be-5f5b-4512-a7fc-56049ef1****

The application ID.

Response parameters

ParameterTypeExampleDescription
RequestIdString7BD8F4C7-D84C-4D46-9885-8212997E****

The request ID.

MessageStringsuccess

The returned message. Valid values:

  • success: If the call is successful, success is returned.
  • An error code: If the call fails, an error code is returned.
TraceIdString0bc3b6e215637275918588187d****

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

DataObject

The returned result.

ChangeOrderIdString4a815998-b468-4bea-b7d8-59f52a44****

The ID of the change order.

ErrorCodeStringNull

The error code. Valid values:

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

The HTTP status code. Valid values:

  • 2xx: The call was successful.
  • 3xx: The call was redirected.
  • 4xx: The call failed.
  • 5xx: A server error occurred.
SuccessBooleantrue

Indicates whether the application was started. Valid values:

  • true: The application was started.
  • false: The application failed to be started.

Examples

Sample requests

PUT /pop/v1/sam/app/startApplication?AppId=0099b7be-5f5b-4512-a7fc-56049ef1**** HTTP/1.1
Host:sae.aliyuncs.com
Content-Type:application/json

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<StartApplicationResponse>
    <RequestId>7BD8F4C7-D84C-4D46-9885-8212997E****</RequestId>
    <Message>success</Message>
    <TraceId>0bc3b6e215637275918588187d****</TraceId>
    <Data>
        <ChangeOrderId>4a815998-b468-4bea-b7d8-59f52a44****</ChangeOrderId>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</StartApplicationResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "7BD8F4C7-D84C-4D46-9885-8212997E****",
  "Message" : "success",
  "TraceId" : "0bc3b6e215637275918588187d****",
  "Data" : {
    "ChangeOrderId" : "4a815998-b468-4bea-b7d8-59f52a44****"
  },
  "Code" : "200",
  "Success" : true
}

Error codes

HTTP status codeError codeError messageDescription
400InvalidApplication.NotFoundThe current application does not exist.The specified application is not found.
400InvalidParameter.NotEmptyYou must specify the parameter %s.The value of the %s parameter is invalid. This parameter cannot be left empty.
400InvalidParameter.ObviouslyThe specified parameter is invalid {%s}.The value of the {%s} parameter is invalid.
400InvalidParameter.WithMessageThe parameter is invalid {%s}: %sThe value %s of the {%s} parameter is invalid.
400vswitch.not.existThe specified vSwitch does not exist.The specified vSwitch does not exist.
400user.indebtThe user has an outstanding payment.The current user has overdue payments.
400NoComputeResourceQuota.App.ExceedYou can create %s instances for each application. Please submit a ticket to raise the quota.A maximum of %s instances can be created for each application. Join the DingTalk group 32874633 for technical support.
400NoComputeResourceQuota.User.ExceedYour account is limited to create %s instances. Please submit a ticket to raise the quota.A maximum of %s instances can be created within your account. Join the DingTalk group 32874633 for technical support.
400System.UpgradingThe system is being upgraded. Please try again later.The system is being upgraded. Try again later.
400Application.ChangerOrderRunningAn application change process is in progress. Please try again later.An application change is in progress. Try again later.
400Application.InvalidStatusThe application status is abnormal. Please try again later.The application is in an abnormal state. Try again later.
400Application.NotDeployYetThe application has not been deployed. Please deploy it and try again.The application is not deployed. Deploy the application and try again.

For a list of error codes, see Service error codes.