# Danh sách môi trường chạy đám mây

Truy vấn các hồ sơ trình duyệt mà thành viên đã xác thực có thể xem, cùng trạng thái môi trường chạy đám mây của thành viên đó.
`envId` cũng chấp nhận bí danh trường `id`. `groupId` bằng `0` có nghĩa là chưa được nhóm.

Endpoint: POST /api/cloudbrowser/page
Version: 1.0.0

## 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 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-15T10:30:00.000+00:00

