調用RollbackApplication回退應用歷史版本-Serverless 應用引擎-阿里雲 - Serverless App Engine

調用RollbackApplication介面回退應用歷史版本。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

sae:RollbackApplication

update

*全部資源

*

無

請求文法

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

請求參數

名稱	類型	必填	描述	樣本值
AppId	string	是	應用 ID。	017f39b8-dfa4-4e16-a84b-1dcee4b1****
VersionId	string	是	版本 ID，需要調用 ListAppVersions 介面查看。	0026ff7f-2b57-4127-bdd0-9bf202bb9****
BatchWaitTime	integer	否	分批等待時間，單位為秒。	10
MinReadyInstances	integer	否	最小存活執行個體數。取值說明如下：如果設定為 0，應用在升級過程中將會中斷業務。如果設定為-1，最小存活執行個體數將使用系統推薦值，即取現有執行個體數的 25%。如果當前為 5 個執行個體，5×25%=1.25，向上取整後，最小存活執行個體數為 2。說明每次滾動部署最小存活的執行個體數建議≥1，保證業務不中斷。	1
MinReadyInstanceRatio	integer	否	最小存活執行個體數百分比。取值說明如下： -1：初始化值，表示不採用百分比。 0~100：單位為百分比，向上取整。例如設定為 50%，如果當前為 5 個執行個體，則最小存活執行個體數為 3。說明當 MinReadyInstance 和 MinReadyInstanceRatio 同時傳遞時，且 MinReadyInstanceRatio 的取值非-1時，以 MinReadyInstanceRatio 參數為準。假設 MinReadyInstances 取值為 5，MinReadyInstanceRatio 取值為 50，則會用 50 來計算最小存活執行個體數。	-1
UpdateStrategy	string	否	部署策略。當最小存活執行個體數等於 1 時，UpdateStrategy 欄位的值為""。當最小存活執行個體數大於 1 時，樣本如下：灰階 1 台+後續分 2 批+自動分批+分批間隔 1 分鐘。 `{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}` 灰階 1 台+後續分 2 批+手動分批。 `{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"manual"},"grayUpdate":{"gray":1}}` 分 2 批+自動分批+分批間隔 0 分鐘。 `{"type":"BatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":0}}` 參數說明如下： type：發布策略類型，可選灰階發布 GrayBatchUpdate 或分批發布 BatchUpdate。 batchUpdate：分批發布策略。 batch：發布批次。 releaseType：分批間處理方式，可選自動 auto 或手動 manual。 batchWaitTime：批次內部署間隔時間，單位為秒。 grayUpdate：灰階後剩餘批次，當 type 為 GrayBatchUpdate 時必填。	{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}
AutoEnableApplicationScalingRule	string	否	是否自動啟用應用Auto Scaling策略。取值說明如下： true：開啟。 false：關閉。	true

返回參數

名稱	類型	描述	樣本值
	object	返回資料
RequestId	string	請求 ID。	91F93257-7A4A-4BD3-9A7E-2F6EAE6D****
Message	string	調用結果的附加資訊。	success
TraceId	string	調用鏈 ID，用於精確查詢調用資訊。	0a98a02315955564772843261e****
Data	object	返回結果。
ChangeOrderId	string	變更流程 ID。	01db03d3-3ee9-48b3-b3d0-dfce2d88****
IsNeedApproval	boolean	RAM 使用者發布變更是否需要審批。取值說明如下： true：需審批。 false：無需審批。	true
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": "01db03d3-3ee9-48b3-b3d0-dfce2d88****",
    "IsNeedApproval": true
  },
  "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.	應用沒有部署，請部署後重試。
400	rollback.error	Failed to roll back.	復原異常。
400	Application.MissingJdk	Your application must at least contain a JDK component.	應用必須至少包含JDK組件。
400	JarApplication.MissingJdk	A FatJar application must contain JDK.	FatJar類型應用必須包含JDK。
400	PandoraApplication.MissingJdk	The Pandora application is missing a JDK component.	Pandora應用缺少JDK組件。
400	WarApplication.MissingJdkWebcontainer	A War application must contain JDK and Tomcat.	WAR類型應用必須包含JDK和Tomcat。
400	InvalidComponent.NotFound	The current component (such as JDK, Tomcat, or EDASWebContainer) does not exist.	找不到當前組件（JDK、Tomcat、EDASWebContainer等）。
400	InvalidHostnameIp.Invalid	The hostname and/or IP is invalid: Hostname [%s], IP [%s].	主機名稱或IP不合法：主機名稱[%s]，IP[%s]。
400	InvalidInstanceSpecification.Unsupported	The instance specification is not supported: CPU [%s], memory [%s].	不支援的執行個體規格。CPU[%s]，Memory[%s]。
400	InvalidPackageType.NotFound	The package type must be War, FatJar, or Image.	包類型必須為WAR、FatJAR或Image。
400	LogService.ConfigQuotaExceed	The maximum number of Log Service configs is exceeded.	Log Service配置個數超過配額限制，請加入釘群32874633聯絡技術產品專家進行諮詢。
400	LogService.InternalError	An exception occurred while calling Log Service. Please submit a ticket to solve the problem.	調用Log Service異常，請加入釘群32874633聯絡技術產品專家進行諮詢。
400	LogService.LogDirInvalid	The log collection path is invalid.	日誌採集路徑不合法。
400	LogService.NotAvailable	Log Service is unavailable. Please activate Log Service first.	Log Service不可用，請先開通Log Service。
400	LogService.ProjectNumQuotaExceed	The maximum number of Log Service projects is exceeded.	Log Service專案個數超過配額限制，請加入釘群32874633聯絡技術產品專家進行諮詢。
400	VolumnPath.Conflict	Conflict between log collection directory and persistent storage directory.	日誌採集目錄與持久化儲存目錄衝突。
400	MountConflict.ConfigMap	Conflict detected for ConfigMap path %s.	ConfigMap掛載路徑%s存在衝突。
400	NotFound.ConfigMap	The ConfigMap object (ID: %s) does not exist.	找不到ConfigMap對象（ID=%s）。
400	NotFound.ConfigMapKey	The key %s of ConfigMap object (ID: %s) does not exist.	找不到ConfigMap對象（ID=%s）的Key %s。
400	MinReadyInstances.Not.Smaller.Replicas	The minimum number of available instances must be less than the number of application instances.	最小可用執行個體數必須小於應用執行個體數。
400	MinReadyInstanceRatio.Invalid	The ratio of minimum available instances must be between 0 and 100.	最小存活執行個體數比例值必須在0~100之間。
400	Package.Version.Too.Long	The maximum length of package version is exceeded.	應用部署套件版本號碼長度超過限制。
400	App.Package.Version.Exists	The package version of application already exists.	應用部署套件版本號碼已經存在。
400	Slb.Occupied	The SLB instance is occupied.	SLB執行個體被佔用。
400	Slb.Tag.Not.Qualified	The current SLB instance cannot be reused because it may have been occupied by %s.	SLB執行個體正在被%s使用，不建議複用。
400	InvalidParameter.FileName	The application deployment package name is invalid. This name can contain only alphanumeric characters, hyphens (-), and underscores (_). For deploying java package, you can upload JAR files only if the selected deployment version supports JAR file. Otherwise, upload WAR files only. For deploying php package, you can upload ZIP files only if the selected deployment version supports ZIP file.	應用部署程式包名稱無效。名稱只能包含字母、數字和特殊字元“-”“_”。Java 軟體包部署，僅當選擇的部署版本支援JAR部署時方可上傳JAR包，否則只能上傳WAR包；PHP 軟體包部署，僅當選擇的部署版本支援ZIP部署時方可上傳ZIP包
400	vswitch.not.exist	The specified vSwitch does not exist.	vSwitch不存在，請更換vSwitch。
404	InvalidNamespaceId.NotFound	The specified NamespaceId does not exist.	指定的NamespaceId不存在。

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

變更歷史

更多資訊，參考變更詳情。