全部產品
Search
文件中心

Platform For AI:CreateServiceRollout - 建立服務更新計劃

更新時間:May 12, 2026

建立服務更新計劃

介面說明

請求說明

  • 策略互斥Partition(分區發布)和Batch(批量發布)兩種策略只能選擇其中一種,不能同時使用。

  • 請求速率限制:每秒最多 100 次請求。

  • 授權資訊:需要具備eas:CreateServiceRollout許可權才能調用此介面。

  • 資源 ARNacs:eas:{#regionId}:{#accountId}:service/{#ServiceName}

  • 暫停發布:通過設定Paused參數為true可以暫停發布流程,之後可通過UpdateServiceRollout介面恢複或解除發佈。

  • 監控與復原:在發布過程中建議持續監控服務指標,以便及時發現並處理問題;如需復原,可以通過調整Partition值或刪除發布策略來實現。

調試

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

調試

授權資訊

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

請求文法

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

路徑參數

名稱

類型

必填

描述

樣本值

ClusterId

string

地區 ID。服務所在的地區標識,可通過 ListServices 介面擷取可用地區列表。

cn-shanghai

ServiceName

string

服務名稱。要建立發布策略的服務名稱,服務名稱在同一地區內必須唯一。可通過 DescribeService 介面擷取服務詳情。

my-service

請求參數

名稱

類型

必填

描述

樣本值

body

object

請求 Body。

Partition

object

手動分批配置。

Partition

string

需要更新到新版本的執行個體數。

1

Batch

object

自動分批配置。

BatchSize

string

每批更新的執行個體數。

1

Interval

string

每批更新完成後的等待間隔。

5m

Paused

boolean

是否暫停更新。

False

返回參數

名稱

類型

描述

樣本值

object

響應 Body。

RequestId

string

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

40325405-579C-4D82****

Message

string

返回資訊。描述請求處理結果。

Rollout created successfully

樣本

正常返回樣本

JSON格式

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

錯誤碼

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

變更歷史

更多資訊,參考變更詳情