POST/api/public/v1/devices/{id}/draining

devices.draining.set

devices.draining.set — Tạm ngừng (draining: true) hoặc tiếp tục nhận phiên mới trên máy: khi tạm ngừng, không người, lượt chạy hay ứng dụng nào mở được trình duyệt ở đó (mở phiên trả CAPACITY_UNAVAILABLE với reason draining; chọn máy tự động sẽ sang máy khác); trình duyệt đang chạy vẫn tiếp tục.

Quyền: device.manageLệnh (chống trùng)Tool MCP: devices_draining_set

Xem dạng Markdown

Tham số

Tên	Kiểu	Bắt buộc	Mô tả
`id`path	string (uuid)	Có	ID máy
`command_id`body	string (uuid)	Có	UUID do chương trình khách tạo cho lệnh; gửi lại cùng id và nội dung để nhận biên nhận đã lưu; cùng id nhưng khác nội dung trả CONFLICT
`draining`body	boolean	Có	true tạm ngừng phiên mới trên máy này (phiên đang chạy vẫn tiếp tục); false để nhận lại

Ví dụ

curl -X POST "https://browlix.com/api/public/v1/devices/<id>/draining" \
  -H "Authorization: Bearer $BROWLIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"command_id":"<uuid>","draining":true}'

Phản hồi

201 với { data, replayed: false, correlation_id } lần đầu; 200 với replayed: true khi cùng command_id và nội dung được gửi lại.

Trường	Kiểu	Luôn có	Mô tả
data	object	Có
data.device_id	string (uuid)	Có
data.draining	boolean	Có	true khi đang tạm ngừng phiên mới
data.draining_since	string (date-time)	Không
data.running	integer	Có	Số trình duyệt còn chạy trên máy (vẫn tiếp tục) (tối thiểu -9007199254740991, tối đa 9007199254740991)
data.revision	integer	Có	(tối thiểu -9007199254740991, tối đa 9007199254740991)
correlation_id	string (uuid)	Có
replayed	boolean	Không	true khi command_id này đã được áp dụng và trả lại biên nhận đã lưu

Trường mới có thể xuất hiện bất cứ lúc nào; hãy bỏ qua trường bạn không biết.

Lỗi

Mã	HTTP	Thử lại
UNAUTHENTICATED	401	Không
FORBIDDEN	403	Không
RATE_LIMITED	429	Có
VALIDATION_FAILED	422	Không
NOT_FOUND	404	Không
CONFLICT	409	Không
OUTCOME_UNKNOWN	202	Có
CAPACITY_UNAVAILABLE	503	Có
DEPENDENCY_UNAVAILABLE	503	Có
UNKNOWN	500	Không

Mọi mã lỗi và khi nào nên thử lại

Mọi thao tác

discovery
- GETget
openapi
- GETget
workspace
- GETget
- PATCHrename
members
- GETlist
invites
- POSTcreate
audit
- GETlist
receipts
- GETget
profiles
- GETlist
- GETget
- POSTcreate
- PATCHupdate
- POSTaccept_egress_change
- POSTtrash
- POSTrestore
- GETsync.get
- POSTsync.restore
- GETcleanup.preflight
- POSTcleanup.run
- GETcleanup.list
- POSTsync.release
- GETextensions
- GETbookmarks
groups
- GETlist
- POSTcreate
- PATCHupdate
- POSTdelete
tags
- GETlist
- POSTcreate
- PATCHupdate
- POSTdelete
preference_templates
- GETlist
- GETget
- POSTcreate
- POSTpublish
- PATCHupdate
- POSTupgrade_profiles
proxies
- GETlist
- GETget
- POSTcreate
- PATCHupdate
- POSTdelete
devices
- GETlist
- POSTstorage.move
- POSTadspower_api.set
- POSTdraining.set
- GETcapabilities
sessions
- GETlist
- GETget
- POSTstart
- POSTstop
- POSTattach
- POSTrecover
- POSTacquire
- POSTrenew
- POSTdetach
- GETevents
bindings
- GETlist
- POSTcreate
- PATCHupdate
- POSTdelete
sync
- GEToverview
- PATCHretention.set
shares
- GETpreview
- POSTcreate
- GETlist
- POSTrevoke
- POSTretry
- GETinbox
- POSTaccept
- POSTdecline
extensions
- GETlist
- GETget
- POSTupload
- POSTadd
- POSTreview
- POSTset_active
- POSTset_state
- POSTassign
- POSTunassign
- POSTdelete
bookmarks
- POSTimport
- GETlist
- GETget
- POSTdelete
- POSTpreview
- POSTapply
- POSTcancel
data_keys
- POSTrotate
usage
- GETget
webhooks
- GETlist
- POSTcreate
- PATCHupdate
- POSTrotate_secret
- POSTdelete
- POSTtest
- GETdeliveries
- POSTredeliver
flows
- GETlist
- GETget
- POSTrun
runs
- GETlist
- GETget
- POSTstop
- POSTpause
- POSTretry
run_targets
- GETget
- POSTresolve
tasks
- GETlist
- POSTrun
schedules
- GETlist
- POSTset_state
approvals
- GETlist
- POSTdecide
feedback
- POSTsubmit
- GETlist
- GETget
- POSTcomment

Đang dùng AI agent?

Các tool Browlix có feedback_submit — sau khi dùng, báo lỗi, bất tiện hay câu hỏi chưa có lời đáp, mỗi vấn đề một lần.

Cách phản hồi hoạt động