全部產品
Search
文件中心

Platform For AI:UpdateServiceRollout - 更新服務更新計劃

更新時間:May 11, 2026

更新服務發布計劃

介面說明

請求說明

  • 至少提供一個參數:必須在請求中指定PartitionBatchPaused中的至少一個參數。

  • 互斥策略:不能同時提供PartitionBatch配置。

  • 即時生效:更新將立即生效,影響進行中的服務發布過程。

  • 後援動作:通過增加Partition值可以實現版本回退,但不會自動觸發,需要手動更新服務鏡像。

  • 暫停不影響參數:暫停發布不會改變已設定的PartitionBatch參數,僅暫停執行當前策略。

調試

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

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

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

路徑參數

名稱

類型

必填

描述

樣本值

ClusterId

string

ClusterId

  • 類型: string

  • 必填: 是

  • 說明: 地區 ID。服務所在的地區標識。

  • 樣本值: cn-shanghai

cn-shanghai

ServiceName

string

ServiceName

  • 類型: string

  • 必填: 是

  • 說明: 服務名稱。要更新發布策略的服務名稱。

  • 樣本值: my-service

my-service

請求參數

名稱

類型

必填

描述

樣本值

body

object

請求 Body。

Partition

object

Partition

  • 類型: object

  • 必填: 否

  • 說明: 分區發布配置。用於調整分區策略參數。與 Batch 互斥。

Partition

string

Partition

  • 類型: string

  • 必填: 是

  • 說明: 分區值。支援兩種格式:
    1. 整數格式:如 "5",表示保留 5 箇舊副本

    2. 百分比格式:如 "50%",表示保留 50%的舊副本 調整策略:

    • 調大值:回退到舊版本,增加舊副本比例

    • 調小值:推進到新版本,減少舊副本比例

    • 設定為"0%":完成全部更新,所有副本切換到新版本

  • 樣本值: 30%

30%

Batch

object

Batch

  • 類型: object

  • 必填: 否

  • 說明: 批量發布配置。用於調整批量策略參數。與 Partition 互斥。

BatchSize

string

批次大小。每批次更新的副本數量。支援整數或百分比格式。預設值:"25%"

25%

Interval

string

批次間隔。兩次發布之間的等待時間。支援單位:s(秒)、m(分鐘)、h(小時)

60s

Paused

boolean

是否暫停發布。true表示暫停,false表示恢複。

true

返回參數

名稱

類型

描述

樣本值

object

響應 Body。

RequestId

string

請求 ID。每次請求返回的唯一標識,用於問題排查和追蹤。

40325405-579C-4D82****

Message

string

返回資訊。描述請求處理結果。可能值:

  • "Rollout updated successfully":更新策略成功

  • "Rollout paused successfully":暫停發布成功

  • "Rollout resumed successfully":恢複發布成功

Rollout updated successfully

樣本

正常返回樣本

JSON格式

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

錯誤碼

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

變更歷史

更多資訊,參考變更詳情