# クラウドランタイムの一覧

呼び出しメンバーから見えるブラウザープロファイルを、クラウドランタイムの状態と併せて一覧します。
- **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。
- **ステータス値**：`cloudBrowserStatus` は `STARTING`、`RUNNING`、`CLOSED` のいずれかのみです。**`RUNNING` はブラウザーが使用可能であることを意味しません** — 停止中、アーカイブ中、停止に失敗したランタイムも `RUNNING` として報告されます。両者は `cloudBrowserArchiveStatus`（`PENDING`、`ARCHIVING`、`COMPLETED`、`FAILED`）で区別でき、処理がない場合は null です。
- **一貫性**：ランタイムの解決は全件成功か全件失敗のいずれかです。ページ全体について解決できない場合、部分データを返すのではなく呼び出し自体が失敗します。

Endpoint: POST /api/cloudbrowser/page
Version: 2026-09-05

## Request fields (application/json):

  - `uniqueIds` (array)
    Environment sequence numbers. Up to 100 items.
    Example: [1001,1002]

  - `envId` (string)
    Environment ID. The request also accepts the field alias `id`.
    Example: 1800000000000001

  - `envName` (string)
    Environment name.
    Example: marketing-01

  - `keyword` (string)
    Keyword filter. Matches environment name, group name, tag name, and remark.
    Example: marketing

  - `groupId` (string)
    Group ID. `0` means ungrouped.
    Example: 0

  - `pageNo` (integer, required)
    Current page number, starting from 1. Default is 1.
    Example: 1

  - `pageSize` (integer, required)
    Number of items per page. Default is 10, maximum 100.
    Example: 10

## Response 200:

  - `200` (unknown)
    Success

## Response 200 fields (application/json):

  - `code` (integer, required)
    Return result code. `0` means success; other codes indicate exceptions.
    Example: 0

  - `msg` (string | null, required)
    Error message. Usually `null` on success.
    Example: null

  - `requestId` (string)
    Operation request ID. This field may be present when the request passes through the API gateway.
    Example: 1d4f3ea968664593860b94b35d4ebf5e

  - `data` (object, required)

  - `data.total` (string, required)
    Total number of records.
    Example: 42

  - `data.current` (string, required)
    Current page number.
    Example: 1

  - `data.pages` (string, required)
    Total number of pages.
    Example: 5

  - `data.dataList` (array, required)
    Environments on the current page. Empty array when there are no results.

  - `data.dataList.id` (string, required)
    Browser profile (environment) ID. Serialized as a decimal string to avoid JavaScript
precision loss on 64-bit integers.
    Example: 1800000000000001

  - `data.dataList.envName` (string, required)
    Environment name.
    Example: marketing-01

  - `data.dataList.proxyId` (string | null)
    Proxy ID currently bound to the profile. `null` when no proxy is configured.
    Example: 1800000000000101

  - `data.dataList.cloudBrowserStatus` (string, required)
    Cloud runtime status:
- `STARTING` — starting up
- `RUNNING` — running and ready to connect
- `CLOSED` — not started, closed, or failed to start
    Enum: "STARTING", "RUNNING", "CLOSED"

  - `data.dataList.cloudBrowserArchiveStatus` (string | null)
    Archive status of the current cloud run. `null` when there is no active run record:
- `PENDING` — pending archive
- `ARCHIVING` — archiving
- `COMPLETED` — archive completed
- `FAILED` — archive failed
    Enum: "PENDING", "ARCHIVING", "COMPLETED", "FAILED", null

  - `data.dataList.startDate` (string | null)
    Cloud runtime start time. `null` while starting, or when not started or closed.
    Example: 2026-01-15 10:30:00

