获取受管代理
使用 `agent.read` 权限在 `Agent` 已保存的作用域内读取详情,包括操作可用性、能力和证书摘要以及任务引用。指标查询失败时,连续性为 `unknown`,不改变 `Agent` 健康状态或任务。访问权限已撤销不代表已在本地卸载。
/api/v1/lifecycle/managed-agent/agents/{id}操作 ID
GetManagedAgent起始版本
1.3.0执行模式
同步认证信息
需要认证认证信息
调用该 API 时需要在请求头中携带以下认证信息。
Authorizationstring必填Bearer 令牌
X-Tenant-IDstringX-Tenant-ID
请求参数
路径参数
idString必填资源ID。
响应状态
200 OK该 API 成功时返回以下响应结构。
agentIdString代理ID。
示例: value
displayNameString显示名称。用于界面展示。
示例: value
scopeObject作用范围。
platformUuidString平台UUID。
示例: value
regionUuidString资源。
示例: value
agentVersionString代理版本。
示例: value
accessStateString资源。
示例: value
healthStatusString资源。
示例: value
runtimeStateString资源。
示例: value
primaryStatusString资源。
示例: value
agentLifecycleAlertDestinationString资源。
示例: value
effectiveConfigRevisionString资源。
示例: 10
lastHeartbeatAtString最近一次心跳时间。
示例: 2026-01-15T08:00:00Z
lastStatusChangedAtString最近一次状态变更时间。
示例: 2026-01-15T08:00:00Z
rowVersionString资源。
示例: 10
technicalDetailsObject资源。
agentKindString资源。
示例: value
managementOwnerString资源。
示例: value
operationsObject资源。
restartObject资源。
availableBoolean资源。
示例: true
blockedByList资源。
示例: item1,item2
targetAgentVersionString资源。
示例: value
targetAgentReleaseString该资源的目标 `Agent` 发布版本。
示例: 10
upgradeObject资源。
availableBoolean资源。
示例: true
blockedByList资源。
示例: item1,item2
targetAgentVersionString资源。
示例: value
targetAgentReleaseString该资源的目标 `Agent` 发布版本。
示例: 10
revokeAccessObject资源。
availableBoolean资源。
示例: true
blockedByList资源。
示例: item1,item2
targetAgentVersionString资源。
示例: value
targetAgentReleaseString该资源的目标 `Agent` 发布版本。
示例: 10
capabilitiesList资源。
示例: (nested array)
capabilityIdString资源。
示例: value
displayNameString显示名称。用于界面展示。
示例: value
availableBoolean资源。
示例: true
blockedByList资源。
示例: item1,item2
bindingIdString不存在能力已持久化绑定。
示例: value
desiredStateString资源。
示例: value
effectiveStateString资源。
示例: value
providerIdString资源。
示例: value
providerRevisionString资源。
示例: value
currentConfigRevisionString资源。
示例: 10
effectiveConfigRevisionString资源。
示例: 10
rowVersionString资源。
示例: 10
lastObservedAtString最近一次已观察时间。
示例: 2026-01-15T08:00:00Z
lastErrorReasonString资源。
示例: value
hostMetricContinuitySummaryObject资源。
lastHostMetricAtString最近一次主机指标时间。
示例: 2026-01-15T08:00:00Z
collectionStateString采集状态。
示例: value
deliveryStateString投递状态。
示例: value
queueSizeLong队列大小。
示例: 0
queueCapacityLong资源。
示例: 0
enqueueFailedMetricPointsLong资源。
示例: 0
sendFailedMetricPointsLong资源。
示例: 0
sentMetricPointsLong资源。
示例: 0
serviceInstanceIdString资源。
示例: value
observedAtString已观察时间。
示例: 2026-01-15T08:00:00Z
certificatesList资源。
示例: (nested array)
certificateIdString资源。
示例: value
purposeString资源。
示例: value
statusString状态信息。
示例: value
notBeforeString资源。
示例: 2026-01-15T08:00:00Z
notAfterString资源。
示例: 2026-01-15T08:00:00Z
activationDeadlineString资源。
示例: 2026-01-15T08:00:00Z
revokedAtString已撤销时间。
示例: 2026-01-15T08:00:00Z
revokeReasonString资源。
示例: value
activeTasksList资源。
示例: (nested array)
taskIdString任务ID。
示例: value
typeString类型。
示例: value
stateString当前状态。
示例: value
bindingIdString资源。
示例: value
createdAtString创建时间。
示例: 2026-01-15T08:00:00Z
startedAtString开始时间。
示例: 2026-01-15T08:00:00Z
completedAtString完成时间。
示例: 2026-01-15T08:00:00Z
errorReasonString错误原因。
示例: value
errorMessageString错误返回消息。
示例: value
availableActionsList可用动作。
示例: item1,item2
waitingReasonString资源。
示例: value
accessRevocationTaskObject原始的成功撤销结果;完整结果请读取任务资源。
taskIdString任务ID。
示例: value
typeString类型。
示例: value
stateString当前状态。
示例: value
bindingIdString资源。
示例: value
createdAtString创建时间。
示例: 2026-01-15T08:00:00Z
startedAtString开始时间。
示例: 2026-01-15T08:00:00Z
completedAtString完成时间。
示例: 2026-01-15T08:00:00Z
errorReasonString错误原因。
示例: value
errorMessageString错误返回消息。
示例: value
availableActionsList可用动作。
示例: item1,item2
waitingReasonString资源。
示例: value
accessRevokingAtString此资源开始撤销访问的时间。
示例: 2026-01-15T08:00:00Z
accessRevokedAtString访问已撤销时间。
示例: 2026-01-15T08:00:00Z
accessRevokedByString资源。
示例: value
accessRevokeReasonString资源。
示例: value
localUninstallCommandString本地卸载命令。
示例: value
updateAvailableBoolean更新可用。
示例: true
createdAtString创建时间。
示例: 2026-01-15T08:00:00Z
updatedAtString更新时间。
示例: 2026-01-15T08:00:00Z
agentReleaseString该资源的 `Agent` 发布版本。
示例: 10
