全部產品
Search
文件中心

Serverless App Engine:RestartApplication - 重啟應用

更新時間:Apr 24, 2026

調用RestartApplication介面重啟應用。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

sae:RestartApplication

none

*全部資源

*

請求文法

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

請求參數

名稱

類型

必填

描述

樣本值

AppId

string

目標應用 ID。

0099b7be-5f5b-4512-a7fc-56049ef1****

MinReadyInstances

integer

最小存活執行個體數。取值說明如下:

  • 如果設定為 0,應用在升級過程中將會中斷業務。

  • 如果設定為**-1**,最小存活執行個體數將使用系統推薦值,即取現有執行個體數的 25%。如果當前為 5 個執行個體,5×25%=1.25,向上取整後,最小存活執行個體數為 2。

說明

每次滾動部署最小存活的執行個體數建議≥1,保證業務不中斷。

1

MinReadyInstanceRatio

integer

最小存活執行個體數百分比。取值說明如下:

  • -1:初始化值,表示不採用百分比。

  • 0~100:單位為百分比,向上取整。例如設定為 50%,如果當前為 5 個執行個體,則最小存活執行個體數為 3。

說明

MinReadyInstanceMinReadyInstanceRatio 同時傳遞時,且 MinReadyInstanceRatio 的取值非**-1**時,以 MinReadyInstanceRatio 參數為準。假設 MinReadyInstances 取值為 5MinReadyInstanceRatio 取值為 50,則會用 50 來計算最小存活執行個體數。

-1

AutoEnableApplicationScalingRule

boolean

是否自動啟用應用Auto Scaling策略。取值說明如下:

  • true:開啟。

  • false:關閉。

false

返回參數

名稱

類型

描述

樣本值

object

返回資料。

RequestId

string

請求 ID。

91F93257-7A4A-4BD3-9A7E-2F6EAE6D****

Message

string

附加資訊。取值說明如下:

  • 請求正常,返回 success

  • 請求異常,返回具體異常錯誤碼。

success

TraceId

string

調用鏈 ID,用於精確查詢調用資訊。

0a98a02315955564772843261e****

Data

object

返回結果。

ChangeOrderId

string

變更單 ID。

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

ErrorCode

string

錯誤碼。取值說明如下:

  • 請求成功:不返回 ErrorCode 欄位。

  • 請求失敗:返回 ErrorCode 欄位。具體資訊,請參見本文的錯誤碼列表。

Code

string

介面狀態或 POP 錯誤碼。取值說明如下:

  • 2xx:成功。

  • 3xx:重新導向。

  • 4xx:請求錯誤。

  • 5xx:伺服器錯誤。

200

Success

boolean

重啟執行個體是否成功。取值說明如下:

  • true:表示重啟成功。

  • false:表示重啟失敗。

true

樣本

正常返回樣本

JSON格式

{
  "RequestId": "91F93257-7A4A-4BD3-9A7E-2F6EAE6D****",
  "Message": "success",
  "TraceId": "0a98a02315955564772843261e****",
  "Data": {
    "ChangeOrderId": "4a815998-b468-4bea-b7d8-59f52a44****"
  },
  "ErrorCode": "",
  "Code": "200",
  "Success": true
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 InvalidApplication.NotFound The current application does not exist. 找不到當前應用。
400 InvalidParameter.NotEmpty You must specify the parameter %s. 不合法的參數:%s不可為空。
400 InvalidParameter.Obviously The specified parameter is invalid {%s}. 不合法的參數{%s}。
400 InvalidParameter.WithMessage The parameter is invalid {%s}: %s 不合法的參數{%s}:%s。
400 NoComputeResourceQuota.Exceed Your compute resource is insufficient. Please contact us to raise the quota.
400 user.indebt The user has an outstanding payment. 目前使用者處於欠費狀態。
400 NoComputeResourceQuota.App.Exceed You can create %s instances for each application. Please submit a ticket to raise the quota. 每個應用只允許建立%s個執行個體,請加入釘群32874633聯絡技術產品專家進行諮詢。
400 NoComputeResourceQuota.User.Exceed Your account is limited to create %s instances. Please submit a ticket to raise the quota. 您的賬戶限額%s個執行個體,請加入釘群32874633聯絡技術產品專家進行諮詢。
400 System.Upgrading The system is being upgraded. Please try again later. 系統正在升級,請稍後操作。
400 Application.ChangerOrderRunning An application change process is in progress. Please try again later. 應用有變更流程正在執行,請稍後重試。
400 Application.InvalidStatus The application status is abnormal. Please try again later. 應用狀態異常,請稍後重試。
400 Application.NotDeployYet The application has not been deployed. Please deploy it and try again. 應用沒有部署,請部署後重試。
404 Associate.Eip.Not.Enough No sufficient EIPs are available. 綁定EIP時,EIP不足,需要您購買。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情