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

Platform For AI:DescribeServiceRollout

最終更新日:May 11, 2026

サービスロールアウトの詳細を取得します。

今すぐお試しください

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

テスト

RAM 認証

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

リクエスト構文

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

パスパラメータ

パラメーター

必須 / 任意

説明

ClusterId

string

任意

サービスがデプロイされているリージョン ID です。

cn-shanghai

ServiceName

string

任意

サービスの名前です。

foo

リクエストパラメーター

パラメーター

必須 / 任意

説明

リクエストパラメーターは必要ありません。

レスポンスフィールド

フィールド

説明

object

レスポンスボディです。

RequestId

string

リクエスト ID です。各リクエストに一意な ID であり、トラブルシューティングに使用されます。

40325405-579C-4D82****

Rollout

object

サービスロールアウトの詳細です。ロールアウト戦略 (Strategy) と実行ステータス (Status) が含まれます。

Strategy

object

ロールアウト戦略の設定です。このオブジェクトには、カナリアリリースまたはバッチリリースのパラメーターが含まれます。

Partition

object

カナリアリリースの設定です。このオブジェクトは、カナリアリリース戦略が使用されている場合に返されます。

Partition

string

保持する古いレプリカの数または割合を指定します。たとえば、値が 50% の場合、古いレプリカの 50% が保持されることを示します。

50%

Batch

object

バッチリリースの設定です。このオブジェクトは、バッチリリース戦略が使用されている場合に返されます。

BatchSize

string

各バッチで更新するレプリカの数または割合です。

1

Interval

string

バッチ間の待機時間です。

5m

Status

object

ロールアウトの現在の進行状況とフェーズです。

Phase

string

現在のリリースフェーズです。有効な値は次のとおりです:

  • Pending:ロールアウトは保留中です。

  • Running:ロールアウトは実行中です。

  • Paused:ロールアウトは一時停止中です。

  • Completed:ロールアウトは完了です。

  • Failed:ロールアウトは失敗です。

Running

TotalReplicas

integer

サービスの希望するレプリカの総数です。

10

UpdatedReplicas

integer

新しいリビジョンに更新されたレプリカの数です。

5

CurrentRevision

string

現在実行中のリビジョンの識別子です。

service-abc123-v1

UpdateRevision

string

ターゲットリビジョンの識別子です。

service-abc123-v2

NextBatchStartTime

string

次のバッチの開始予定時刻です。

2026/05/08 16:10:56

成功レスポンス

JSONJSON

{
  "RequestId": "40325405-579C-4D82****",
  "Rollout": {
    "Strategy": {
      "Partition": {
        "Partition": "50%"
      },
      "Batch": {
        "BatchSize": "1",
        "Interval": "5m"
      }
    },
    "Status": {
      "Phase": "Running",
      "TotalReplicas": 10,
      "UpdatedReplicas": 5,
      "CurrentRevision": "service-abc123-v1",
      "UpdateRevision": "service-abc123-v2",
      "NextBatchStartTime": "2026/05/08 16:10:56"
    }
  }
}

エラーコード

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

変更履歴

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