All Products
Search
Document Center

Platform For AI:UpdateServiceRollout

Last Updated:Jun 11, 2026

Memperbarui rollout layanan.

Deskripsi operasi

Catatan penggunaan

  • Berikan minimal satu parameter: Tentukan minimal salah satu dari parameter Partition, Batch, atau Paused.

  • Strategi yang saling eksklusif: Anda tidak dapat menentukan parameter Partition dan Batch secara bersamaan dalam permintaan yang sama.

  • Berlaku segera: Pembaruan langsung berlaku dan memengaruhi rollout layanan yang sedang berjalan.

  • Rollback: Anda dapat melakukan rollback dengan menambah nilai Partition. Namun, proses ini tidak otomatis, dan Anda harus memperbarui image layanan secara manual.

  • Jeda tidak memengaruhi parameter: Menjeda rollout tidak mengubah parameter Partition atau Batch yang telah dikonfigurasi. Ini hanya menangguhkan strategi rollout saat ini.

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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

PUT /api/v2/services/{ClusterId}/{ServiceName}/rollout HTTP/1.1

Path Parameters

Parameter

Type

Required

Description

Example

ClusterId

string

Yes

ID wilayah tempat layanan berada.

  • Tipe: string

  • Wajib: Ya

  • Deskripsi: ID wilayah tempat layanan berada.

  • Contoh: cn-shanghai

cn-shanghai

ServiceName

string

Yes

Nama layanan.

  • Tipe: string

  • Wajib: Ya

  • Deskripsi: Nama layanan yang kebijakan rilisnya akan diperbarui.

  • Contoh: my-service

my-service

Parameter permintaan

Parameter

Type

Required

Description

Example

body

object

No

Isi permintaan.

Partition

object

No

Konfigurasi rollout partition. Parameter ini saling eksklusif dengan Batch.

  • Tipe: object

  • Wajib: Tidak

  • Deskripsi: Konfigurasi rollout partition. Parameter ini menyesuaikan parameter untuk strategi partition. Saling eksklusif dengan Batch.

Partition

string

No

Nilai partition

  • Tipe: string

  • Wajib: Ya

  • Deskripsi: Nilai partition. Parameter ini menentukan jumlah atau persentase replika versi lama yang akan dipertahankan. Mendukung dua format:

    1. Bilangan bulat, seperti "5", untuk jumlah replika.

    2. Persentase, seperti "50%", untuk proporsi replika.

    Strategi penyesuaian:

    • Menambah nilai akan melakukan rollback ke versi sebelumnya dengan meningkatkan jumlah replika versi lama.

    • Mengurangi nilai akan melanjutkan rollout dengan mengurangi jumlah replika versi lama.

    • Mengatur nilai ke "0" atau "0%" akan menyelesaikan rollout, mengganti semua replika versi lama.

  • Contoh: 30%

30%

Batch

object

No

Konfigurasi rollout batch. Parameter ini saling eksklusif dengan Partition.

  • Tipe: object

  • Wajib: Tidak

  • Deskripsi: Konfigurasi rollout batch untuk menyesuaikan parameter kebijakan batch. Parameter ini saling eksklusif dengan Partition.

BatchSize

string

No

Jumlah replika yang akan diperbarui dalam setiap batch. Dapat berupa bilangan bulat atau persentase. Nilai default-nya adalah "25%".

25%

Interval

string

No

Interval tunggu antar batch. Satuan yang didukung mencakup s (detik), m (menit), dan h (jam).

60s

Paused

boolean

No

Atur ke true untuk menjeda rollout atau false untuk melanjutkannya.

true

Elemen respons

Element

Type

Description

Example

object

Isi respons.

RequestId

string

Pengenal unik untuk permintaan. Anda dapat menggunakan ID permintaan ini untuk pemecahan masalah dan pelacakan.

40325405-579C-4D82****

Message

string

Pesan yang menunjukkan hasil permintaan. Nilai yang mungkin meliputi:

  • "Rollout updated successfully"

  • "Rollout paused successfully"

  • "Rollout resumed successfully"

Rollout updated successfully

Contoh

Respons sukses

JSONformat

{
  "RequestId": "40325405-579C-4D82****",
  "Message": "Rollout updated successfully"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.