Gunakan RollbackApplication untuk Mengembalikan Aplikasi SAE - Serverless App Engine - Alibaba Cloud - Serverless App Engine

Mengembalikan aplikasi.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

sae:RollbackApplication

update

*全部资源

*

None

Sintaks permintaan

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

Parameter permintaan

Parameter	Type	Required	Description	Example
AppId	string	Yes	ID aplikasi.	017f39b8-dfa4-4e16-a84b-1dcee4b1****
VersionId	string	Yes	ID versi aplikasi. Panggil operasi ListAppVersions untuk mendapatkan ID versi.	0026ff7f-2b57-4127-bdd0-9bf202bb9****
BatchWaitTime	integer	No	Pengatur waktu tunggu antar batch. Unit: detik.	10
MinReadyInstances	integer	No	Jumlah minimum instans yang tersedia. Perhatikan aturan berikut: Jika Anda menetapkan nilai ke 0, gangguan bisnis akan terjadi saat aplikasi diperbarui. Jika Anda menetapkan nilai ke -1, jumlah minimum instans yang tersedia akan otomatis ditetapkan ke nilai yang direkomendasikan sistem. Nilai tersebut adalah bilangan bulat terdekat yang dibulatkan ke atas dari hasil perhitungan rumus berikut: Jumlah instans saat ini × 25%. Misalnya, jika tersedia lima instans, jumlah minimum instans yang tersedia dihitung menggunakan rumus berikut: 5 × 25% = 1,25. Dalam hal ini, jumlah minimum instans yang tersedia adalah 2. Catatan Pastikan setidaknya satu instans tersedia selama penerapan dan rollback aplikasi untuk mencegah gangguan bisnis.	1
MinReadyInstanceRatio	integer	No	Persentase jumlah minimum instans yang tersedia. Perhatikan aturan berikut: Jika Anda menetapkan nilai ke -1, jumlah minimum instans yang tersedia tidak ditentukan berdasarkan parameter ini. Nilai default: -1. Jika Anda menetapkan nilai ke angka dari 0 hingga 100, jumlah minimum instans yang tersedia dihitung menggunakan rumus berikut: Jumlah instans saat ini × (Nilai MinReadyInstanceRatio × 100%). Nilai tersebut adalah bilangan bulat terdekat yang dibulatkan ke atas dari hasil perhitungan. Misalnya, jika persentase ditetapkan ke 50% dan tersedia lima instans, jumlah minimum instans yang tersedia adalah 3. Catatan Jika MinReadyInstance dan MinReadyInstanceRatio keduanya ditentukan dan MinReadyInstanceRatio ditetapkan ke angka dari 0 hingga 100, nilai MinReadyInstanceRatio akan diutamakan. Misalnya, jika MinReadyInstances ditetapkan ke 5, dan MinReadyInstanceRatio ditetapkan ke 50, jumlah minimum instans yang tersedia ditetapkan ke bilangan bulat terdekat yang dibulatkan ke atas dari hasil perhitungan rumus berikut: Jumlah instans saat ini × 50%.	-1
UpdateStrategy	string	No	Kebijakan penerapan. Jika jumlah minimum instans yang tersedia adalah 1, nilai parameter UpdateStrategy adalah string kosong (""). Jika jumlah minimum instans yang tersedia lebih dari 1, tentukan parameter ini berdasarkan kebutuhan Anda. Contoh: Lakukan rilis canary untuk satu instans dan rilis instans yang tersisa dalam dua batch secara otomatis dengan interval satu menit antara penerapan setiap instans: `{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}` Lakukan rilis canary untuk satu instans dan rilis instans yang tersisa dalam dua batch secara manual: `{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"manual"},"grayUpdate":{"gray":1}}` Rilis instans dalam dua batch secara otomatis tanpa interval antara penerapan setiap instans: `{"type":"BatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":0}}` Tabel berikut menjelaskan parameter yang digunakan dalam pernyataan sebelumnya. type: tipe kebijakan rilis. Nilai valid: GrayBatchUpdate dan BatchUpdate. batchUpdate: kebijakan rilis bertahap. batch: jumlah batch rilis. releaseType: metode pemrosesan untuk batch. Nilai valid: auto dan manual. batchWaitTime: interval antar batch rilis. Unit: detik. grayUpdate: jumlah batch rilis dalam rilis bertahap setelah rilis canary. Parameter ini hanya dikembalikan jika parameter type ditetapkan ke GrayBatchUpdate.	{"type":"GrayBatchUpdate","batchUpdate":{"batch":2,"releaseType":"auto","batchWaitTime":1},"grayUpdate":{"gray":1}}
AutoEnableApplicationScalingRule	string	No	Apakah akan mengaktifkan kebijakan Penyesuaian Skala Otomatis untuk aplikasi. Perhatikan aturan berikut: true: mengaktifkan Logon-free Sharing false: menonaktifkan Logon-free Sharing.	true

Elemen respons

Element	Type	Description	Example
	object	The returned data.
RequestId	string	The ID of the request.	91F93257-7A4A-4BD3-9A7E-2F6EAE6D****
Message	string	The message returned for the operation.	success
TraceId	string	The trace ID that is used to query the details of the request.	0a98a02315955564772843261e****
Data	object	The response.
ChangeOrderId	string	The ID of the change process.	01db03d3-3ee9-48b3-b3d0-dfce2d88****
IsNeedApproval	boolean	Specifies whether approval is required when a RAM user performs release. Take note of the following rules: true false	true
ErrorCode	string	The error code returned if the request failed. Take note of the following rules: The ErrorCode parameter is not returned if the request succeeds. If the call fails, the ErrorCode parameter is returned. For more information, see the "Error codes" section of this topic.
Code	string	The HTTP status code. Take note of the following rules: 2xx: The call was successful. 3xx: The call was redirected. 4xx: The call failed. 5xx: A server error occurred.	200
Success	boolean	Indicates whether the application is successfully rolled back. Take note of the following rules: true false	true

Contoh

Respons sukses

JSONformat

{
  "RequestId": "91F93257-7A4A-4BD3-9A7E-2F6EAE6D****",
  "Message": "success",
  "TraceId": "0a98a02315955564772843261e****",
  "Data": {
    "ChangeOrderId": "01db03d3-3ee9-48b3-b3d0-dfce2d88****",
    "IsNeedApproval": true
  },
  "ErrorCode": "Null\n",
  "Code": "200",
  "Success": true
}

Kode kesalahan

HTTP status code	Error code	Error message
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.
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.
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.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.