Security

Updated at:

Alibaba Cloud Bailian CLI commands for security protection statistics, asset distribution, and risk alerts.

Query Agent security protection statistics, asset distribution, and risk alerts in the terminal.

ImportantAppend --help to any command for full parameter details, for example bl agents security overview --help. Command details on this page are verified against bl 2.2.1.

Usage is also shown on the feature pages, see Using the CLI.

Command reference

bl agents security overview

Show the Agent security protection overview (last 24 hours). Requires API Key authentication.

Usage

bl agents security overview [flags]
ParameterTypeRequiredDescription
--workspace-id <id>stringnoWorkspace ID for API endpoint URL (or set BAILIAN_WORKSPACE_ID)

Example: Show Agent security protection overview for a workspace

bl agents security overview --workspace-id ws-xxx
  • Auth: uses DashScope API Key (Bearer token).
  • --workspace-id can be set via BAILIAN_WORKSPACE_ID env or config workspace_id.
  • Fixed to the last 24 hours; the AgentStudio region is always cn-beijing and is not configurable.
  • AgentStudio host: derived from --workspace-id by default; point --base-url / DASHSCOPE_BASE_URL (or auth login --base-url) at a workspace or pre-release origin such as https://<workspace-id>.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio to override it, and --workspace-id is then not required.

bl agents security alerts

List Agent security alerts. Requires API Key authentication.

Usage

bl agents security alerts [flags]
ParameterTypeRequiredDescription
--workspace-id <id>stringnoWorkspace ID for API endpoint URL (or set BAILIAN_WORKSPACE_ID)
--page <n>numbernoPage number (default: 1)
--page-size <n>numbernoResults per page (default: 20)
--risk-level <level>stringnoFilter by risk level: high, medium, low
--risk-name <text>stringnoFilter by risk name
--status <status>stringnoFilter by handling status
--status-list <status>arraynoFilter by multiple statuses (repeatable)
--app-name <name>stringnoFilter by application name
--asset-type <type>stringnoFilter by asset type: agent, tool, skill, knowledge_base, memory, channel
--vendor <vendor>stringnoFilter by vendor
--order-by <field>stringnoSort field (default: check_time)
--order <dir>stringnoSort direction: asc, desc (default: desc)
--lang <lang>stringnoResponse language: zh, en

Example: List Agent security alerts for a workspace

bl agents security alerts --workspace-id ws-xxx
  • Auth: uses DashScope API Key (Bearer token).
  • --workspace-id can be set via BAILIAN_WORKSPACE_ID env or config workspace_id.
  • Filters, pagination and sorting go in the query string; enum flags are validated before any request is sent.
  • AgentStudio host: derived from --workspace-id by default; point --base-url / DASHSCOPE_BASE_URL (or auth login --base-url) at a workspace or pre-release origin such as https://<workspace-id>.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio to override it, and --workspace-id is then not required.