All Products
Search

This Product

    Serverless App Engine:RestartApplication

    Document Center

    Serverless App Engine:RestartApplication

    Last Updated:Jun 11, 2026

    Merestart 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:RestartApplication

    none

    *全部资源

    *

    		 None None

    Sintaks permintaan

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

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    AppId

    string

    Yes

    ID aplikasi.

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

    integer

    No

    Jumlah minimum instans yang tersedia. Nilai khusus:

    • Jika Anda menetapkan nilai ke 0, gangguan bisnis terjadi saat aplikasi diperbarui.

    • Jika Anda menetapkan nilai ke -1, jumlah minimum instans yang tersedia secara 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 lima instans tersedia, jumlah minimum instans yang tersedia dihitung dengan 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 dengan 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 lima instans tersedia, jumlah minimum instans yang tersedia adalah 3.

    Catatan

    Saat MinReadyInstance dan MinReadyInstanceRatio 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
    AutoEnableApplicationScalingRule

    boolean

    No

    Apakah akan mengaktifkan kebijakan Penyesuaian Skala Otomatis untuk aplikasi secara otomatis. Nilai valid:

    • true: Diaktifkan.

    • false: Dinonaktifkan.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    The data returned.

    RequestId

    string

    The ID of the request.

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

    string

    The additional information that is returned. Take note of the following rules:

    • success: If the call is successful, success is returned.

    • An error code: If the call fails, an error code is returned.

    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.

    4a815998-b468-4bea-b7d8-59f52a44****
    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 instance is successfully restarted. 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": "4a815998-b468-4bea-b7d8-59f52a44****"
  },
  "ErrorCode": "Null\n",
  "Code": "200",
  "Success": true
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    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.
    404 Associate.Eip.Not.Enough No sufficient EIPs are available.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.