すべてのプロダクト
Search
ドキュメントセンター

Serverless App Engine:RollbackApplication

最終更新日:Apr 23, 2026

アプリケーションをロールバックします。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

sae:RollbackApplication

update

*All Resource

*

なし なし

リクエスト構文

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

リクエストパラメーター

パラメーター

必須 / 任意

説明

AppId

string

必須

アプリケーションの ID。

017f39b8-dfa4-4e16-a84b-1dcee4b1****

VersionId

string

必須

ListAppVersions 操作を呼び出して取得したアプリケーションバージョンの ID。

0026ff7f-2b57-4127-bdd0-9bf202bb9****

BatchWaitTime

integer

任意

バッチ間の待機時間。 単位:秒。

10

MinReadyInstances

integer

任意

利用可能なインスタンスの最小数。 次のルールにご注意ください:

  • 値を 0 に設定すると、アプリケーションの更新時にビジネスの中断が発生します。

  • 値を -1 に設定すると、利用可能なインスタンスの最小数はシステムが推奨する値に自動的に設定されます。この値は、次の数式で計算された結果を切り上げた最も近い整数です:現在のインスタンス数 × 25%。 たとえば、5 つのインスタンスが利用可能な場合、利用可能なインスタンスの最小数は次の数式を使用して計算されます:5 × 25% = 1.25。 この場合、利用可能なインスタンスの最小数は 2 です。

説明

ビジネスの中断を防ぐために、アプリケーションのデプロイとロールバック中に少なくとも 1 つのインスタンスが利用可能であることを確認してください。

1

MinReadyInstanceRatio

integer

任意

利用可能なインスタンスの最小数の割合。 次のルールにご注意ください:

  • 値を -1 に設定した場合、利用可能なインスタンスの最小数はこのパラメーターに基づいて決定されません。 デフォルト値:-1。

  • 値を 0 から 100 の数値に設定した場合、利用可能なインスタンスの最小数は次の数式を使用して計算されます:現在のインスタンス数 × (MinReadyInstanceRatio の値 × 100%)。 この値は、計算結果から切り上げられた最も近い整数です。 たとえば、割合が 50% に設定され、5 つのインスタンスが利用可能な場合、利用可能なインスタンスの最小数は 3 です。

説明

MinReadyInstanceMinReadyInstanceRatio の両方が指定され、MinReadyInstanceRatio が 0 から 100 の数値に設定されている場合、MinReadyInstanceRatio の値が優先されます。** たとえば、MinReadyInstances が **5** に設定され、MinReadyInstanceRatio50 に設定されている場合、利用可能なインスタンスの最小数は、次の数式で計算された結果から切り上げられた最も近い整数に設定されます:現在のインスタンス数 × 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 つのバッチで自動的にリリースし、各インスタンスのデプロイメント間に間隔を設けない場合:

    {"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

任意

アプリケーションに対して、自動スケーリングポリシーを自動的に有効にするかどうかを指定します。次のルールにご注意ください:

  • 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

HTTP ステータスコード。 次のルールにご注意ください:

  • 2xx:呼び出しは成功しました。

  • 3xx:呼び出しはリダイレクトされました。

  • 4xx:呼び出しは失敗しました。

  • 5xx:サーバーエラーが発生しました。

200

Success

boolean

アプリケーションが正常にロールバックされたかどうかを示します。 次のルールにご注意ください:

  • true

  • false

true

成功レスポンス

JSONJSON

{
  "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 ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidApplication.NotFound The current application does not exist.
400 InvalidParameter.NotEmpty You must specify the parameter %s.
400 InvalidParameter.Obviously The specified parameter is invalid {%s}.
400 InvalidParameter.WithMessage The parameter is invalid {%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.
400 NoComputeResourceQuota.User.Exceed Your account is limited to create %s instances. Please submit a ticket to raise the quota.
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. 日文说明1
400 Application.InvalidStatus The application status is abnormal. Please try again later. 日文说明1
400 Application.NotDeployYet The application has not been deployed. Please deploy it and try again. 日文说明1
400 rollback.error Failed to roll back.
400 Application.MissingJdk Your application must at least contain a JDK component.
400 JarApplication.MissingJdk A FatJar application must contain JDK.
400 PandoraApplication.MissingJdk The Pandora application is missing a JDK component.
400 WarApplication.MissingJdkWebcontainer A War application must contain JDK and Tomcat.
400 InvalidComponent.NotFound The current component (such as JDK, Tomcat, or EDASWebContainer) does not exist.
400 InvalidHostnameIp.Invalid The hostname and/or IP is invalid: Hostname [%s], IP [%s].
400 InvalidInstanceSpecification.Unsupported The instance specification is not supported: CPU [%s], memory [%s].
400 InvalidPackageType.NotFound The package type must be War, FatJar, or Image.
400 LogService.ConfigQuotaExceed The maximum number of Log Service configs is exceeded.
400 LogService.InternalError An exception occurred while calling Log Service. Please submit a ticket to solve the problem.
400 LogService.LogDirInvalid The log collection path is invalid.
400 LogService.NotAvailable Log Service is unavailable. Please activate Log Service first.
400 LogService.ProjectNumQuotaExceed The maximum number of Log Service projects is exceeded.
400 VolumnPath.Conflict Conflict between log collection directory and persistent storage directory.
400 MountConflict.ConfigMap Conflict detected for ConfigMap path %s.
400 NotFound.ConfigMap The ConfigMap object (ID: %s) does not exist.
400 NotFound.ConfigMapKey The key %s of ConfigMap object (ID: %s) does not exist.
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.
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.
400 Slb.Tag.Not.Qualified The current SLB instance cannot be reused because it may have been occupied by %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.
400 vswitch.not.exist The specified vSwitch does not exist.
404 InvalidNamespaceId.NotFound The specified NamespaceId does not exist.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。