このワークスペースへのビルドを推奨

POST /api/v1/projects/{id}/workspaces/{workspace_id}/pro moves
Bearer 認証

同じ組織内の別のワークスペースからこのワークスペースに既存の成功したビルドのイメージをコピーし、配置可能なビルドを作成します。ソース ビルドのプロジェクトと ターゲットプロジェクト の両方に対する配置管理が必要です。強制するには、ターゲットのプロジェクト所有者ロールが追加で必要です。処理は非同期です。準備が完了するまで、返された昇格をポーリングします。

path パラメータ

  • id string 必須

    ターゲットプロジェクトID

  • Workspace_id string 必須

    ターゲット ワークスペースID

application/ JSON

body 必須

昇格リクエスト

  • 確認 ブール値 必須

    Confirmedは true である必要があります。昇格では アーティファクトが別のプロジェクトにコピーされる ため、 APICLI/ UI がユーザーから収集する明示的な確認が必要です。

  • 力 ブール値

    ECP のデプロイメント プロトコル ゲートを強制的にバイパスします。には、ターゲットプロジェクト所有者のロールが必要です。

  • source_Build_id string 必須

    SourceBuildID は、プロモートする成功したビルドを識別します。呼び出し元の組織の任意のプロジェクトに存在できます。

応答

  • 406

    サポートされていないAPIバージョンまたは不正な API バージョン、選択した公開契約で利用できない操作、または受け入れができない表現（サポートされていないメディアタイプのパラメーター、または除外された SSE を含む）。既存の認証、認可、およびレート制限の失敗が優先されます。

    応答属性の非表示 応答属性の表示 オブジェクト
    • validRequestDetail オブジェクト

      標準エラースキーマによって定義される任意の検証の詳細。 APIネゴシエート エラーでは、このフィールドは出力されません。

      validRequestDetail 属性を非表示にする validRequestDetail 属性の表示 オブジェクト
      • フィールド array[オブジェクト]

        検証に失敗したフィールド。

        フィールド属性を非表示にする フィールド属性の表示 オブジェクト

        フィールドとその検証の失敗。

        • 説明 string 必須

          人間が判読できる検証の失敗。

        • フィールド string 必須

          無効なリクエストフィールドの名前またはパス。

    • 詳細 string 必須

      人間が判読できるエラーの詳細。

    • エラー integer 必須

      HTTP status code.

    • errorCode string 必須

      マシンが判読できるエラー コード。

    • パラメーター array[string]

      エラーに関連付けられたリクエスト パラメータ名。該当しない場合は省略します。

    • 理由 string 必須

      HTTPステータス理由フレーズ。

    応答属性の非表示 応答属性の表示 オブジェクト
    • validRequestDetail オブジェクト

      標準エラースキーマによって定義される任意の検証の詳細。 APIネゴシエート エラーでは、このフィールドは出力されません。

      validRequestDetail 属性を非表示にする validRequestDetail 属性の表示 オブジェクト
      • フィールド array[オブジェクト]

        検証に失敗したフィールド。

        フィールド属性を非表示にする フィールド属性の表示 オブジェクト

        フィールドとその検証の失敗。

        • 説明 string 必須

          人間が判読できる検証の失敗。

        • フィールド string 必須

          無効なリクエストフィールドの名前またはパス。

    • 詳細 string 必須

      人間が判読できるエラーの詳細。

    • エラー integer 必須

      HTTP status code.

    • errorCode string 必須

      マシンが判読できるエラー コード。

    • パラメーター array[string]

      エラーに関連付けられたリクエスト パラメータ名。該当しない場合は省略します。

    • 理由 string 必須

      HTTPステータス理由フレーズ。
  • 202

    承認済み

    応答属性の非表示 応答属性の表示 オブジェクト
    • created_at string
    • fail_理由 string
    • completed_at string
    • 力 ブール値
    • inherited_by string
    • org_id string
    • protocol_id string
    • source_Build_id string
    • 状態 string

      ステータスは、保留中、コピー、準備完了、または失敗のいずれかです。準備完了と失敗はターミナル結果です。保留中とコピーは、観察可能な非終了のポーリング状態です。

      値は、pending、copying、ready、または failed です。

    • target_Build_id string
    • target_project_id string
    • target_workスペース_id string
    応答属性の非表示 応答属性の表示 オブジェクト
    • created_at string
    • fail_理由 string
    • completed_at string
    • 力 ブール値
    • inherited_by string
    • org_id string
    • protocol_id string
    • source_Build_id string
    • 状態 string

      ステータスは、保留中、コピー、準備完了、または失敗のいずれかです。準備完了と失敗はターミナル結果です。保留中とコピーは、観察可能な非終了のポーリング状態です。

      値は、pending、copying、ready、または failed です。

    • target_Build_id string
    • target_project_id string
    • target_workスペース_id string
  • 400

    無効なリクエスト

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 403

    Forbidden

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 404

    見つかりません

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 409

    競合

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 413

    エンティティが大きすぎるリクエスト

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 429

    リクエストが多すぎる

    ヘッダー属性を非表示 ヘッダー属性を表示
    • 再試行後 string

      再試行する前に待機する秒数

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 500

    内部サーバーエラー

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 502

    バード ゲートウェイ

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 503

    サービスは利用できません

    ヘッダー属性を非表示 ヘッダー属性を表示
    • 再試行後 string

      キャパシティー拒否後の再試行までに待機する秒数

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
POST /api/v1 /projects/{id}/workspaces/{workspace_id}/pro moves 
curl \
 --request POST 'https://agentengine.mongodb.com/api/v1/projects/{id}/workspaces/{workspace_id}/promotions' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "confirmed": true,
  "force": true,
  "source_build_id": "string"
}'
リクエスト例 
{
  "confirmed": true,
  "force": true,
  "source_build_id": "string"
}
応答の例（406） 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
応答の例（406） 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
応答の例（202） 
{
  "created_at": "string",
  "failure_reason": "string",
  "finished_at": "string",
  "force": true,
  "initiated_by": "string",
  "org_id": "string",
  "promotion_id": "string",
  "source_build_id": "string",
  "status": "pending",
  "target_build_id": "string",
  "target_project_id": "string",
  "target_workspace_id": "string"
}
応答の例（202） 
{
  "created_at": "string",
  "failure_reason": "string",
  "finished_at": "string",
  "force": true,
  "initiated_by": "string",
  "org_id": "string",
  "promotion_id": "string",
  "source_build_id": "string",
  "status": "pending",
  "target_build_id": "string",
  "target_project_id": "string",
  "target_workspace_id": "string"
}
応答の例（400） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（400） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（403） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（403） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（404） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（404） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（409） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（409） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（413） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（413） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（429） 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（429） 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（500） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（500） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（502） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（502） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（503） 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（503） 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}