| 说明 | 列出沙箱策略 |
| 用法 | sbx policy ls [SANDBOX] [flags] |
描述
列出生效中的沙箱策略。
不带 SANDBOX 时，命令会为每个策略显示一行概览，包含其来源、适用范围，以及 按资源类型汇总的决策。带 SANDBOX 时，则汇总适用于该沙箱的生效规则。
使用 --wide 可显示详细的规则级表格，其中 POLICY、POLICY_ID、RULE 和 RULE_ID 各自成列，并附带资源、状态和规则元数据。RULE_ID 是 "sbx policy rm network --id" 所接受的标识符（仅适用于本地规则）。使用 --json 可获得经过筛选的守护进程响应。
启用远程治理时，非活动的策略规则默认隐藏。 使用 --include-inactive 可在排查问题时显示非活动规则。 使用 "sbx policy inspect <policy-or-rule>" 可查看选定策略或规则的完整详情。
使用 --cloud： 列出云端网络策略的默认模式以及允许和拒绝模式。
不带 SANDBOX 时显示账号策略。指定沙箱名称或 ID 则显示该沙箱的策略。云端规则 没有规则 ID；使用 "sbx --cloud policy rm network" 并配合 --resource 移除某个模式。
选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--created-via | 按创建方式筛选策略："default"、"added"、"provisioned" 或 "approval" | |
--decision | 按决策筛选策略："allow" 或 "deny" | |
--format | 输出格式：table、json 或 yaml | |
--include-inactive | 显示被远程治理隐藏的未生效策略规则 | |
--json | 以 JSON 格式输出 | |
--protocol | 按协议筛选网络规则：tcp 或 udp | |
-q, --quiet | 仅显示规则 ID（配合 --cloud 时为网络模式） | |
--source | 按来源筛选策略："local"、"org" 或 "kit" | |
--type | all | 按类型过滤策略："all"、"network"、"http"、"filesystem"（默认 "all"） |
--wide | 显示规则级别的明细输出，包含规则 ID 和资源 |
全局选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--cloud | 改为调用 Docker Cloud Sandboxes API，而不是本地 sandboxd（支持的动词正在逐步增加，运行 sbx --cloud --help 查看当前列表） | |
-D, --debug | 启用调试日志 | |
--no-input | 从不提示；需要应答的命令会直接失败，并给出应当运行的命令 |
示例
console
# 列出所有策略
sbx policy ls
# 列出适用于某个沙箱的策略
sbx policy ls my-sandbox
# 显示包含规则 ID 和资源的详细规则级行
sbx policy ls --wide
# 以 JSON 输出筛选后的规则
sbx policy ls --json
# 只列出规则 ID
sbx policy ls -q
# 只列出网络策略
sbx policy ls --type network
# 列出组织中拒绝访问的策略
sbx policy ls --source org --decision deny
# 列出由审批提示创建的持久规则
sbx policy ls --wide --created-via approval
# 包含被远程治理隐藏的非活动规则
sbx policy ls --include-inactive
# 显示账号策略
sbx --cloud policy ls
# 显示某个沙箱的策略
sbx --cloud policy ls my-sandbox
# 以 JSON 输出策略
sbx --cloud policy ls --format json
# 只列出网络模式
sbx --cloud policy ls -q参见
sbx policy— 管理沙箱策略