跳转到主要内容
安全与审计相关接口/安全

查询安恒实例列表

查询当前用户可见的安恒安全实例列表。

GET/api/v1/security/anheng/instances

操作 ID

ListAnhengInstances

起始版本

1.2.8

执行模式

同步

认证信息

需要认证

认证信息

调用该 API 时需要在请求头中携带以下认证信息。

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

查询参数

  • capabilityCode
    String

    唯一代码安恒能力。

  • capabilityState
    String

    已使用过滤结果。

  • taskState
    String

    已使用过滤结果。

  • limit
    Integer

    最多返回的记录数。

    示例: 0

  • offset
    Integer

    查询起始偏移量。

    示例: 0

响应状态

200 OK
200 OK

该 API 成功时返回以下响应结构。

  • items
    List

    条目列表。

    示例: (nested array)

    • instanceUuid
      String

      资源。

      示例: value

    • capabilityCode
      String

      资源。

      示例: value

    • capabilityState
      String

      资源。

      示例: value

    • taskState
      String

      资源。

      示例: value

    • enterReady
      Boolean

      进入就绪。

      示例: true

    • allowedActions
      List

      资源。

      示例: item1,item2

    • blockedReasons
      List

      资源。

      示例: (nested array)

      • code
        String

        编码值。

        示例: value

      • source
        String

        来源信息。

        示例: value

      • message
        String

        错误返回消息。

        示例: value

      • retryable
        Boolean

        资源。

        示例: true

      • severity
        String

        告警级别。

        示例: value

      • owner
        String

        资源。

        示例: value

    • vm
      Object

      虚拟机器详情关联资源。

      • vmUuid
        String

        云主机UUID。

        示例: value

      • state
        String

        当前状态。

        示例: value

      • ip
        String

        来源IP地址。

        示例: value

      • mac
        String

        地址已指派虚拟机器。

        示例: value

      • l3NetworkUuid
        String

        资源。

        示例: value

      • name
        String

        资源名称。

        示例: my-resource

    • imageArtifactId
      String

      资源。

      示例: value

    • currentSpecCode
      String

      资源。

      示例: value

    • expireTime
      String

      过期时间。

      示例: 2026-01-15T08:00:00Z

    • lastTaskId
      String

      资源。

      示例: value

    • currentTaskId
      String

      资源。

      示例: value

    • currentTaskType
      String

      资源。

      示例: value

    • currentTaskState
      String

      资源。

      示例: value

    • currentSpec
      Object

      资源。

      • cpuNum
        Integer

        资源。

        示例: 10

      • memoryBytes
        String

        资源。

        示例: 10

      • rootDiskBytes
        String

        资源。

        示例: 10

      • dataDiskBytes
        List

        资源。

        示例: item1,item2

  • total
    Integer

    返回结果总数。

    示例: 10

  • limit
    Integer

    最大返回条目数。

    示例: 10

  • offset
    Integer

    查询起始偏移量。

    示例: 10

  • 变更时间

    新增请求参数 X-ZStack-Session
    查看 API