将智能体信息同步至观测页面 - CreateOpsAgentObservation
功能介绍
通过此接口可以在观测页面查看该智能体上报的数据信息。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts::createOpsAgentObservation | Write | - | - | - | - |
URI
POST /v1/ops/observation/agents
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Content-Type | 是 | String | 参数解释: 消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。 约束限制: 不涉及。 取值范围: application/json。 默认取值: application/json。 |
| Authorization | 是 | String | 参数解释: 签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: SDK自动填充,格式为SDK-HMAC-SHA256。 取值范围: 符合签名规范的字符串。 默认取值: 不涉及。 |
| X-Sdk-Date | 是 | String | 参数解释: 请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 符合ISO 8601格式。 取值范围: 格式为YYYYMMDDTHHMMSSZ,如20240416T095341Z。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| resource_id | 是 | String | 参数解释: 智能体ID,用于唯一标识智能体,可在智能体管理页面或通过查询智能体列表接口(ListOpsAgentObservation)获取。 约束限制: 长度限制1-64位。 取值范围: 不涉及。 默认取值: 不涉及。 |
| resource_name | 是 | String | 参数解释: 智能体名称,用于标识智能体的显示名称。 约束限制: 长度限制1-128位。 取值范围: 不涉及。 默认取值: 不涉及。 |
| resource_type | 是 | String | 参数解释: 智能体类型。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| status | 否 | String | 参数解释: 状态。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| create_by | 否 | String | 参数解释: 创建人ID,用于标识智能体的创建者,可从用户认证信息或IAM服务获取。 约束限制: 长度限制1-64位。 取值范围: 不涉及。 默认取值: 不涉及。 |
| create_time | 否 | Integer | 参数解释: 创建时间,13位毫秒级时间戳(ms)。 约束限制: 由数字组成,必须为13位毫秒级时间戳。 取值范围: 不涉及。 默认取值: 不涉及。 |
| update_by | 否 | String | 参数解释: 更新人ID,用于标识智能体的最后更新者,可从用户认证信息或IAM服务获取。 约束限制: 长度限制1-64位。 取值范围: 不涉及。 默认取值: 不涉及。 |
| updated_time | 否 | Integer | 参数解释: 更新时间,13位毫秒级时间戳(ms)。 约束限制: 由数字组成。13位毫秒级时间戳。 取值范围: 不涉及。 默认取值: 不涉及。 |
| version | 否 | String | 参数解释: 智能体版本。 约束限制: 长度限制1-64位。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:201
同步响应
无
请求示例
POST https://*.com/v1/ops/observation/agents
Content-Type:application/json
X-Sdk-Date:20240416T095341Z
Authorization:SDK-HMAC-SHA256 Access=****************, SignedHeaders=content-type;host;x-sdk-date, Signature=****************
{
"resource_id": "a04413fa-883a-4346-93df-34f49ee85e0c",
"resource_name": "test2",
"resource_type": "agent",
"status": "draft",
"create_by": "319c74a30677464db04f25ffd55ae3c8",
"create_time": "1775701216815",
"update_by": "319c74a30677464db04f25ffd55ae3c8",
"updated_time": "1775701216815",
"version": "0.0.1"
} 响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 201 | 同步响应 |
错误码
请参见错误码。