# Dừng môi trường chạy đám mây

Dừng runtime trên cloud mà một profile đang chạy trong đó.
- **Điều kiện tiên quyết**
: phải có một lần chạy đang hoạt động do bạn khởi động cho profile đó. Gọi khi runtime đã dừng hoặc đang được giải phóng sẽ trả về thành công mà không làm gì.
- **Tác động**
: dừng tính phí, chốt mức sử dụng, giải phóng khóa của profile, và yêu cầu client lưu trữ profile cùng cookie về cloud trước khi runtime được giải phóng.
- **Hoàn tất**
:
**đã tiếp nhận, chưa hoàn tất.**
 Hãy hỏi vòng
`/cloudbrowser/page`
 cho đến khi
`cloudBrowserStatus`
 là
`CLOSED`
 và
`cloudBrowserArchiveStatus`
 đạt
`COMPLETED`
 hoặc
`FAILED`
.
- **Khi lưu trữ thất bại**
: lần chạy vẫn bị tính phí và vẫn hiển thị là
`RUNNING`
.
`force`

**chỉ**
 có hiệu lực trong trạng thái đó: nó bỏ qua bước lưu trữ và giải phóng runtime, khiến các thay đổi profile của phiên này bị loại bỏ.
- **Đồng thời**
: các lệnh dừng đồng thời cho cùng một lần chạy được xếp tuần tự, nên gọi trùng là an toàn.

Các mã lỗi nghiệp vụ đã ghi nhận: `40002`, `40006`, `40008`, `40020`. Xem [Error Codes](/vi/api-reference/getting-started/error-codes) để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

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

## Request fields (application/json):

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

  - `force` (boolean)
    Whether to forcibly release the cloud runtime. Only takes effect when the current run has
an archive status of `FAILED`; in that case the archive step is skipped and runtime
resources are reclaimed. Ignored in all other cases.
    Example: false

## 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` (null)
    Example: null

