すべてのプロダクト
Search
ドキュメントセンター

Platform For AI:UpdateServiceRollout

最終更新日:May 12, 2026

サービスロールアウトを更新します。

操作説明

注意事項

  • 少なくとも 1 つのパラメーターを指定PartitionBatch、または Paused パラメーターのいずれかを少なくとも 1 つ指定してください。

  • 相互排他の戦略: 同じリクエスト内で Partition パラメーターと Batch パラメーターの両方を指定することはできません。

  • 即時反映: 更新は即時に有効となり、進行中のサービスロールアウトに影響を与えます。

  • ロールバックPartition 値を増やすことでロールバックが可能です。ただし、これは自動プロセスではなく、サービスイメージを手動で更新する必要があります。

  • 一時停止はパラメーターに影響しない: ロールアウトを一時停止しても、設定済みの Partition または Batch パラメーターは変更されません。現在のロールアウト戦略のみが一時停止されます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

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

パスパラメータ

パラメーター

必須 / 任意

説明

ClusterId

string

必須

サービスが配置されているリージョン ID。

  • Type: string

  • Required: Yes

  • Description: サービスが配置されているリージョンの ID。

  • Example: cn-shanghai

cn-shanghai

ServiceName

string

必須

サービス名。

  • Type: string

  • Required: Yes

  • Description: リリースポリシーを更新する対象のサービス名。

  • Example: my-service

my-service

リクエストパラメーター

パラメーター

必須 / 任意

説明

body

object

任意

リクエストボディ。

Partition

object

任意

パーティションロールアウト構成。このパラメーターは Batch と相互排他です。

  • Type: object

  • Required: No

  • Description: パーティションロールアウト構成。このパラメーターはパーティション戦略のパラメーターを調整します。Batch と相互排他です。

Partition

string

任意

パーティション値

  • Type: string

  • Required: Yes

  • Description: パーティション値。このパラメーターは、旧バージョンのレプリカ数または割合を指定します。次の 2 つの形式をサポートしています。
    1. 整数(例: "5"): レプリカ数を指定。

    2. パーセンテージ(例: "50%"): レプリカの割合を指定。

    調整戦略:
    • 値を増やすと、旧バージョンのレプリカ数を増やすことで前のバージョンにロールバックします。

    • 値を減らすと、旧バージョンのレプリカ数を減らすことでロールアウトを継続します。

    • 値を "0" または "0%" に設定すると、ロールアウトが完了し、すべての旧バージョンのレプリカが置き換えられます。

  • Example: 30%

30%

Batch

object

任意

バッチロールアウト構成。このパラメーターは Partition と相互排他です。

  • Type: object

  • Required: No

  • Description: バッチポリシーパラメーターを調整するためのバッチロールアウト構成。このパラメーターは Partition と相互排他です。

BatchSize

string

任意

各バッチで更新するレプリカ数。整数またはパーセンテージを指定できます。デフォルトは "25%" です。

25%

Interval

string

任意

バッチ間の待機間隔。サポートされる単位には s(秒)、m(分)、h(時間)があります。

60s

Paused

boolean

任意

ロールアウトを一時停止する場合は true、再開する場合は false を設定します。

true

レスポンスフィールド

フィールド

説明

object

レスポンスボディ。

RequestId

string

リクエストの一意な識別子。トラブルシューティングや追跡にこのリクエスト ID を使用できます。

40325405-579C-4D82****

Message

string

リクエスト結果を示すメッセージ。取り得る値は以下のとおりです。

  • "Rollout updated successfully"

  • "Rollout paused successfully"

  • "Rollout resumed successfully"

Rollout updated successfully

成功レスポンス

JSONJSON

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

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。