ワークスペースの配置を一覧表示する

GET /api/v1/projects/{id}/workspaces/{workspace_id}/deployments
Bearer 認証

カーソルベースのページ分割と任意のステータス フィルターを使用して、ワークスペースの配置を一覧表示するためのプロキシ。プロジェクトスコープは ルート ID パス パラメーターによって保持され、 組織はそのプロジェクトから派生します。

path パラメータ

  • id string 必須

    プロジェクトID

  • Workspace_id string 必須

    ワークスペースID

クエリ パラメータ

  • cursor string

    不変ページ分割カーソル

  • limit integer

    ページサイズ（1-100、デフォルトは20）

  • 状態 string

    配置ステータス フィルター（queued、in_progress、processing_up、成功、失敗、ロールバック、キャンセル）

  • created_in_ Release string

    このリリースで出荷された配置を返します。これは独自のアーティファクト配置、およびそのカット前に終了した非リリースの配置です。ロールバックは除外されます。

応答

  • 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ステータス理由フレーズ。
  • 200

    OK

    応答属性の非表示 応答属性の表示 オブジェクト
    • 配置 array[オブジェクト]
      配置属性の非表示 配置属性の表示 オブジェクト
      • aer_http_endpoint string

        AERHTTPEndpoint は、エージェントサンドボックスHTTPエンドポイントのレガシー名です。

      • agent_http_endpoint string

        AgentHTTPEndpoint は、エージェントサンドボックスHTTPエンドポイントです。 aer_HTTP_endpoint と同じ値。

      • agent_stack_name string
      • app_id string
      • branch string
      • build_id string
      • commit_sha string
      • completed_at string
      • compound_images オブジェクト
        custom_images 属性を非表示 connector_images 属性を表示 オブジェクト
        • エア string

          AER は、エージェントサンドボックス イメージのレガシー名です。

        • エージェント string

          エージェントは、エージェントのサンドボックス イメージです。 aer と同じ値。

        • memory_server string
        • os string
        • ツール string
      • コンポーネント array[オブジェクト]

        詳細ビュー用の ECP からそのまま転送されるコンポーネントごとのヘルス。

        コンポーネント属性の非表示 コンポーネント属性の表示 オブジェクト
        • available ブール値
        • fail_message string
        • fail_理由 string
        • name string
        • ready_replicas integer
        • replicas integer

          Replicas は、必要なポッド数です。ゼロの場合は、プラットフォームがレポートを報告していないことを意味します。消費者は、ゼロをスケールしてゼロとして扱うことはできません。

        • sandbox string

          Sandbox は、既知のコンポーネント値（エージェント、 ツール）の標準サンドボックス名です。不明なアップストリーム名の場合は省略します。

        • タイプ string
      • 条件 array[オブジェクト]
        条件属性を非表示にする 条件属性を表示 オブジェクト
        • last_transition_time string
        • メッセージ string
        • 理由 string
        • 状態 string
        • タイプ string
      • created_at string

        タイムスタンプ。

      • deployment_id string

        同一性とサンプルコア ステータス（常に存在）。

      • duration_ms integer
      • errors_message string

        障害コンテキストが表示されると、管理者 UI は最初に Splunk にアクセスしなくてもトリガーできます。

      • execution_type string
      • first_deploy ブール値

        FirstDeploy は、ワークスペースの最初の配置が成功するまで（およびそれを含む）、すべての試行に対して true です。不明な場合は省略します。

      • 正常性 オブジェクト

        拡張フィールド。

        ヘルス属性の非表示 正常性属性の表示 オブジェクト
        • available ブール値
        • checkpoint_at string
        • コンポーネント array[オブジェクト]
          コンポーネント属性の非表示 コンポーネント属性の表示 オブジェクト
          • name string
          • ready ブール値
          • ready_replicas integer
          • sandbox string

            Sandbox は、既知のコンポーネント値（エージェント、 ツール）の標準サンドボックス名です。不明なアップストリーム名の場合は省略します。

      • image_uri string

        画像 / ソース。

      • 言語 string

        言語は、ECP から転送されたエージェントランタイム言語（"python"||"typescript"）です。設定されていない場合は省略されます（古いビルドのデフォルトは Python DownStream）。

      • last_event_seq integer
      • memory_enabled ブール値

        memoryEnabled は、配置の有効なランタイム メモリ設定です。使用できない場合は省略されます。

      • Missing_secrets array[string]
      • operator_namespace string
      • org_id string
      • post_deploy_error_message string
      • used_image_uri string
      • project_deleted ブール値

        配置の所有するプロジェクトがソフト削除された場合は true です。常に出力されるため、ユーザーはフィールド が存在しない場合ではなく、フィールドにブランチ できます。

      • project_id string
      • Release_number integer

        ReleaseNumber は、ワークスペースごとの単調なバージョン識別子です（ UIの v{N} ラベルをドライブします）。バックフィル移行前のレガシーレコードでは、0/省略

      • requested_images array[オブジェクト]

        requestedImages は、ダイジェスト固定された配置の意向です。イメージ ダイジェスト 追跡が有効になる前に作成されたレガシー配置では省略されます。 [] は、ライターが を実行したが、何も解決しなかったことを意味します。

        requested_images 属性を非表示 requested_images 属性の表示 オブジェクト
        • コンポーネントは string
        • ダイジェスト string
        • sandbox string

          Sandbox は、既知のコンポーネント値の標準サンドボックス名です。不明なアップストリーム名の場合は省略します。

      • requested_ target_id string

        RequestedTargetID は、内部フリードの出所であり、Gateway 応答によって意図的に表示されません。互換性のために空のままです。

      • rollback_error string
      • rollback_from_id string

        この配置がロールバックされたときに設定された

      • rollback_of string

        ロールバック リンク。

      • created_in_ Release string

        skipedInRelease は、この配置を出荷したリリースです。どのものにも属していない場合は省略されます。 ECP から転送。読み取り時に生成された。

      • source_Build_id string
      • source_project_id string
      • source_pro move_id string
      • source_workspace_id string
      • start_at string
      • 状態 string
      • target_namespace string

        Kubernetes の配置。

      • トリガーする string
      • Updated_at string
      • バージョン string

        バージョン は、ECP から転送される開発者宣言のエージェントバージョンです。バージョン化されていないレコードの場合は省略されます。

    • limit integer

      オフセットページ分割されたプラットフォーム全体の管理リストで設定されます。ワークスペースごとのエンドポイントでは、これらはゼロ値のままとなり、ワイヤ上では省略されます。

    • 次の_カーソル string

      カーソルページ分割されたワークスペースごとの管理リストで設定されます。プラットフォーム全体のエンドポイントは nil のままになります。

    • オフセット integer
    • 合計 integer
    応答属性の非表示 応答属性の表示 オブジェクト
    • 配置 array[オブジェクト]
      配置属性の非表示 配置属性の表示 オブジェクト
      • aer_http_endpoint string

        AERHTTPEndpoint は、エージェントサンドボックスHTTPエンドポイントのレガシー名です。

      • agent_http_endpoint string

        AgentHTTPEndpoint は、エージェントサンドボックスHTTPエンドポイントです。 aer_HTTP_endpoint と同じ値。

      • agent_stack_name string
      • app_id string
      • branch string
      • build_id string
      • commit_sha string
      • completed_at string
      • compound_images オブジェクト
        custom_images 属性を非表示 connector_images 属性を表示 オブジェクト
        • エア string

          AER は、エージェントサンドボックス イメージのレガシー名です。

        • エージェント string

          エージェントは、エージェントのサンドボックス イメージです。 aer と同じ値。

        • memory_server string
        • os string
        • ツール string
      • コンポーネント array[オブジェクト]

        詳細ビュー用の ECP からそのまま転送されるコンポーネントごとのヘルス。

        コンポーネント属性の非表示 コンポーネント属性の表示 オブジェクト
        • available ブール値
        • fail_message string
        • fail_理由 string
        • name string
        • ready_replicas integer
        • replicas integer

          Replicas は、必要なポッド数です。ゼロの場合は、プラットフォームがレポートを報告していないことを意味します。消費者は、ゼロをスケールしてゼロとして扱うことはできません。

        • sandbox string

          Sandbox は、既知のコンポーネント値（エージェント、 ツール）の標準サンドボックス名です。不明なアップストリーム名の場合は省略します。

        • タイプ string
      • 条件 array[オブジェクト]
        条件属性を非表示にする 条件属性を表示 オブジェクト
        • last_transition_time string
        • メッセージ string
        • 理由 string
        • 状態 string
        • タイプ string
      • created_at string

        タイムスタンプ。

      • deployment_id string

        同一性とサンプルコア ステータス（常に存在）。

      • duration_ms integer
      • errors_message string

        障害コンテキストが表示されると、管理者 UI は最初に Splunk にアクセスしなくてもトリガーできます。

      • execution_type string
      • first_deploy ブール値

        FirstDeploy は、ワークスペースの最初の配置が成功するまで（およびそれを含む）、すべての試行に対して true です。不明な場合は省略します。

      • 正常性 オブジェクト

        拡張フィールド。

        ヘルス属性の非表示 正常性属性の表示 オブジェクト
        • available ブール値
        • checkpoint_at string
        • コンポーネント array[オブジェクト]
          コンポーネント属性の非表示 コンポーネント属性の表示 オブジェクト
          • name string
          • ready ブール値
          • ready_replicas integer
          • sandbox string

            Sandbox は、既知のコンポーネント値（エージェント、 ツール）の標準サンドボックス名です。不明なアップストリーム名の場合は省略します。

      • image_uri string

        画像 / ソース。

      • 言語 string

        言語は、ECP から転送されたエージェントランタイム言語（"python"||"typescript"）です。設定されていない場合は省略されます（古いビルドのデフォルトは Python DownStream）。

      • last_event_seq integer
      • memory_enabled ブール値

        memoryEnabled は、配置の有効なランタイム メモリ設定です。使用できない場合は省略されます。

      • Missing_secrets array[string]
      • operator_namespace string
      • org_id string
      • post_deploy_error_message string
      • used_image_uri string
      • project_deleted ブール値

        配置の所有するプロジェクトがソフト削除された場合は true です。常に出力されるため、ユーザーはフィールド が存在しない場合ではなく、フィールドにブランチ できます。

      • project_id string
      • Release_number integer

        ReleaseNumber は、ワークスペースごとの単調なバージョン識別子です（ UIの v{N} ラベルをドライブします）。バックフィル移行前のレガシーレコードでは、0/省略

      • requested_images array[オブジェクト]

        requestedImages は、ダイジェスト固定された配置の意向です。イメージ ダイジェスト 追跡が有効になる前に作成されたレガシー配置では省略されます。 [] は、ライターが を実行したが、何も解決しなかったことを意味します。

        requested_images 属性を非表示 requested_images 属性の表示 オブジェクト
        • コンポーネントは string
        • ダイジェスト string
        • sandbox string

          Sandbox は、既知のコンポーネント値の標準サンドボックス名です。不明なアップストリーム名の場合は省略します。

      • requested_ target_id string

        RequestedTargetID は、内部フリードの出所であり、Gateway 応答によって意図的に表示されません。互換性のために空のままです。

      • rollback_error string
      • rollback_from_id string

        この配置がロールバックされたときに設定された

      • rollback_of string

        ロールバック リンク。

      • created_in_ Release string

        skipedInRelease は、この配置を出荷したリリースです。どのものにも属していない場合は省略されます。 ECP から転送。読み取り時に生成された。

      • source_Build_id string
      • source_project_id string
      • source_pro move_id string
      • source_workspace_id string
      • start_at string
      • 状態 string
      • target_namespace string

        Kubernetes の配置。

      • トリガーする string
      • Updated_at string
      • バージョン string

        バージョン は、ECP から転送される開発者宣言のエージェントバージョンです。バージョン化されていないレコードの場合は省略されます。

    • limit integer

      オフセットページ分割されたプラットフォーム全体の管理リストで設定されます。ワークスペースごとのエンドポイントでは、これらはゼロ値のままとなり、ワイヤ上では省略されます。

    • 次の_カーソル string

      カーソルページ分割されたワークスペースごとの管理リストで設定されます。プラットフォーム全体のエンドポイントは nil のままになります。

    • オフセット integer
    • 合計 integer
  • 400

    無効なリクエスト

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

    Forbidden

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

    バード ゲートウェイ

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
GET /api/v1 /projects/{id}/workspaces/{workspace_id}/deployments 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/workspaces/{workspace_id}/deployments' \
 --header "Authorization: $API_KEY"
応答の例（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"
}
応答の例（200） 
{
  "deployments": [
    {
      "aer_http_endpoint": "string",
      "agent_http_endpoint": "string",
      "agent_stack_name": "string",
      "app_id": "string",
      "branch": "string",
      "build_id": "string",
      "commit_sha": "string",
      "completed_at": "string",
      "component_images": {
        "aer": "string",
        "agent": "string",
        "memory_server": "string",
        "oe": "string",
        "tool": "string"
      },
      "components": [
        {
          "available": true,
          "failure_message": "string",
          "failure_reason": "string",
          "name": "string",
          "ready_replicas": 42,
          "replicas": 42,
          "sandbox": "string",
          "type": "string"
        }
      ],
      "conditions": [
        {
          "last_transition_time": "string",
          "message": "string",
          "reason": "string",
          "status": "string",
          "type": "string"
        }
      ],
      "created_at": "string",
      "deployment_id": "string",
      "duration_ms": 42,
      "error_message": "string",
      "executor_type": "string",
      "first_deploy": true,
      "health": {
        "available": true,
        "checked_at": "string",
        "components": [
          {
            "name": "string",
            "ready": true,
            "ready_replicas": 42,
            "sandbox": "string"
          }
        ]
      },
      "image_uri": "string",
      "language": "string",
      "last_event_seq": 42,
      "memory_enabled": true,
      "missing_secrets": [
        "string"
      ],
      "operator_namespace": "string",
      "org_id": "string",
      "post_deploy_error_message": "string",
      "previous_image_uri": "string",
      "project_deleted": true,
      "project_id": "string",
      "release_number": 42,
      "requested_images": [
        {
          "component": "string",
          "digest": "string",
          "sandbox": "string"
        }
      ],
      "requested_target_id": "string",
      "rollback_error": "string",
      "rollback_from_id": "string",
      "rollback_of": "string",
      "shipped_in_release": "string",
      "source_build_id": "string",
      "source_project_id": "string",
      "source_promotion_id": "string",
      "source_workspace_id": "string",
      "started_at": "string",
      "status": "string",
      "target_namespace": "string",
      "trigger": "string",
      "updated_at": "string",
      "version": "string"
    }
  ],
  "limit": 42,
  "next_cursor": "string",
  "offset": 42,
  "total": 42
}
応答の例（200） 
{
  "deployments": [
    {
      "aer_http_endpoint": "string",
      "agent_http_endpoint": "string",
      "agent_stack_name": "string",
      "app_id": "string",
      "branch": "string",
      "build_id": "string",
      "commit_sha": "string",
      "completed_at": "string",
      "component_images": {
        "aer": "string",
        "agent": "string",
        "memory_server": "string",
        "oe": "string",
        "tool": "string"
      },
      "components": [
        {
          "available": true,
          "failure_message": "string",
          "failure_reason": "string",
          "name": "string",
          "ready_replicas": 42,
          "replicas": 42,
          "sandbox": "string",
          "type": "string"
        }
      ],
      "conditions": [
        {
          "last_transition_time": "string",
          "message": "string",
          "reason": "string",
          "status": "string",
          "type": "string"
        }
      ],
      "created_at": "string",
      "deployment_id": "string",
      "duration_ms": 42,
      "error_message": "string",
      "executor_type": "string",
      "first_deploy": true,
      "health": {
        "available": true,
        "checked_at": "string",
        "components": [
          {
            "name": "string",
            "ready": true,
            "ready_replicas": 42,
            "sandbox": "string"
          }
        ]
      },
      "image_uri": "string",
      "language": "string",
      "last_event_seq": 42,
      "memory_enabled": true,
      "missing_secrets": [
        "string"
      ],
      "operator_namespace": "string",
      "org_id": "string",
      "post_deploy_error_message": "string",
      "previous_image_uri": "string",
      "project_deleted": true,
      "project_id": "string",
      "release_number": 42,
      "requested_images": [
        {
          "component": "string",
          "digest": "string",
          "sandbox": "string"
        }
      ],
      "requested_target_id": "string",
      "rollback_error": "string",
      "rollback_from_id": "string",
      "rollback_of": "string",
      "shipped_in_release": "string",
      "source_build_id": "string",
      "source_project_id": "string",
      "source_promotion_id": "string",
      "source_workspace_id": "string",
      "started_at": "string",
      "status": "string",
      "target_namespace": "string",
      "trigger": "string",
      "updated_at": "string",
      "version": "string"
    }
  ],
  "limit": 42,
  "next_cursor": "string",
  "offset": 42,
  "total": 42
}
応答の例（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
}
応答の例（502） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（502） 
{
  "code": "string",
  "error": "string",
  "success": true
}