跳转到主要内容
近期删除/近期删除

获取受管代理

使用 `agent.read` 权限在 `Agent` 已保存的作用域内读取详情,包括操作可用性、能力和证书摘要以及任务引用。指标查询失败时,连续性为 `unknown`,不改变 `Agent` 健康状态或任务。访问权限已撤销不代表已在本地卸载。

GET/api/v1/lifecycle/managed-agent/agents/{id}

操作 ID

GetManagedAgent

起始版本

1.3.0

执行模式

同步

认证信息

需要认证

认证信息

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

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

路径参数

  • id
    String必填

    资源ID。

响应状态

200 OK
200 OK

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

  • agentId
    String

    代理ID。

    示例: value

  • displayName
    String

    显示名称。用于界面展示。

    示例: value

  • scope
    Object

    作用范围。

    • platformUuid
      String

      平台UUID。

      示例: value

    • regionUuid
      String

      资源。

      示例: value

  • agentVersion
    String

    代理版本。

    示例: value

  • accessState
    String

    资源。

    示例: value

  • healthStatus
    String

    资源。

    示例: value

  • runtimeState
    String

    资源。

    示例: value

  • primaryStatus
    String

    资源。

    示例: value

  • agentLifecycleAlertDestination
    String

    资源。

    示例: value

  • effectiveConfigRevision
    String

    资源。

    示例: 10

  • lastHeartbeatAt
    String

    最近一次心跳时间。

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

  • lastStatusChangedAt
    String

    最近一次状态变更时间。

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

  • rowVersion
    String

    资源。

    示例: 10

  • technicalDetails
    Object

    资源。

    • agentKind
      String

      资源。

      示例: value

    • managementOwner
      String

      资源。

      示例: value

  • operations
    Object

    资源。

    • restart
      Object

      资源。

      • available
        Boolean

        资源。

        示例: true

      • blockedBy
        List

        资源。

        示例: item1,item2

      • targetAgentVersion
        String

        资源。

        示例: value

      • targetAgentRelease
        String

        该资源的目标 `Agent` 发布版本。

        示例: 10

    • upgrade
      Object

      资源。

      • available
        Boolean

        资源。

        示例: true

      • blockedBy
        List

        资源。

        示例: item1,item2

      • targetAgentVersion
        String

        资源。

        示例: value

      • targetAgentRelease
        String

        该资源的目标 `Agent` 发布版本。

        示例: 10

    • revokeAccess
      Object

      资源。

      • available
        Boolean

        资源。

        示例: true

      • blockedBy
        List

        资源。

        示例: item1,item2

      • targetAgentVersion
        String

        资源。

        示例: value

      • targetAgentRelease
        String

        该资源的目标 `Agent` 发布版本。

        示例: 10

  • capabilities
    List

    资源。

    示例: (nested array)

    • capabilityId
      String

      资源。

      示例: value

    • displayName
      String

      显示名称。用于界面展示。

      示例: value

    • available
      Boolean

      资源。

      示例: true

    • blockedBy
      List

      资源。

      示例: item1,item2

    • bindingId
      String

      不存在能力已持久化绑定。

      示例: value

    • desiredState
      String

      资源。

      示例: value

    • effectiveState
      String

      资源。

      示例: value

    • providerId
      String

      资源。

      示例: value

    • providerRevision
      String

      资源。

      示例: value

    • currentConfigRevision
      String

      资源。

      示例: 10

    • effectiveConfigRevision
      String

      资源。

      示例: 10

    • rowVersion
      String

      资源。

      示例: 10

    • lastObservedAt
      String

      最近一次已观察时间。

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

    • lastErrorReason
      String

      资源。

      示例: value

    • hostMetricContinuitySummary
      Object

      资源。

      • lastHostMetricAt
        String

        最近一次主机指标时间。

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

      • collectionState
        String

        采集状态。

        示例: value

      • deliveryState
        String

        投递状态。

        示例: value

      • queueSize
        Long

        队列大小。

        示例: 0

      • queueCapacity
        Long

        资源。

        示例: 0

      • enqueueFailedMetricPoints
        Long

        资源。

        示例: 0

      • sendFailedMetricPoints
        Long

        资源。

        示例: 0

      • sentMetricPoints
        Long

        资源。

        示例: 0

      • serviceInstanceId
        String

        资源。

        示例: value

      • observedAt
        String

        已观察时间。

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

  • certificates
    List

    资源。

    示例: (nested array)

    • certificateId
      String

      资源。

      示例: value

    • purpose
      String

      资源。

      示例: value

    • status
      String

      状态信息。

      示例: value

    • notBefore
      String

      资源。

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

    • notAfter
      String

      资源。

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

    • activationDeadline
      String

      资源。

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

    • revokedAt
      String

      已撤销时间。

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

    • revokeReason
      String

      资源。

      示例: value

  • activeTasks
    List

    资源。

    示例: (nested array)

    • taskId
      String

      任务ID。

      示例: value

    • type
      String

      类型。

      示例: value

    • state
      String

      当前状态。

      示例: value

    • bindingId
      String

      资源。

      示例: value

    • createdAt
      String

      创建时间。

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

    • startedAt
      String

      开始时间。

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

    • completedAt
      String

      完成时间。

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

    • errorReason
      String

      错误原因。

      示例: value

    • errorMessage
      String

      错误返回消息。

      示例: value

    • availableActions
      List

      可用动作。

      示例: item1,item2

    • waitingReason
      String

      资源。

      示例: value

  • accessRevocationTask
    Object

    原始的成功撤销结果;完整结果请读取任务资源。

    • taskId
      String

      任务ID。

      示例: value

    • type
      String

      类型。

      示例: value

    • state
      String

      当前状态。

      示例: value

    • bindingId
      String

      资源。

      示例: value

    • createdAt
      String

      创建时间。

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

    • startedAt
      String

      开始时间。

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

    • completedAt
      String

      完成时间。

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

    • errorReason
      String

      错误原因。

      示例: value

    • errorMessage
      String

      错误返回消息。

      示例: value

    • availableActions
      List

      可用动作。

      示例: item1,item2

    • waitingReason
      String

      资源。

      示例: value

  • accessRevokingAt
    String

    此资源开始撤销访问的时间。

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

  • accessRevokedAt
    String

    访问已撤销时间。

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

  • accessRevokedBy
    String

    资源。

    示例: value

  • accessRevokeReason
    String

    资源。

    示例: value

  • localUninstallCommand
    String

    本地卸载命令。

    示例: value

  • updateAvailable
    Boolean

    更新可用。

    示例: true

  • createdAt
    String

    创建时间。

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

  • updatedAt
    String

    更新时间。

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

  • agentRelease
    String

    该资源的 `Agent` 发布版本。

    示例: 10

  • 变更时间

    新增响应字段 agentRelease, targetAgentRelease
    查看 API