查询JVS实例信息
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /anonymous/jvs/instance/describe HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InstanceIds |
array |
否 |
实例 ID 列表 |
|
|
string |
否 |
实例 ID。 |
acp-5hh431emkt6u***** |
|
| MaxResults |
integer |
否 |
分页大小 |
10 |
| NextToken |
string |
否 |
分页游标 |
AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
ListResult |
||
| RequestId |
string |
请求 ID。 |
425F351C-3F8E-5218-A520-B6311D0D**** |
| MaxResults |
integer |
本次读取的最大数据量。 |
10 |
| NextToken |
string |
用来表示当前开始读取的位置。置空表示从头开始。 |
AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc**** |
| TotalCount |
integer |
总条目数。 |
30 |
| Data |
array<object> |
返回结果对象。 |
|
|
array<object> |
返回数据。 |
||
| InstanceId |
string |
实例 ID。 |
acp-uto81vfd8t8z**** |
| InstanceName |
string |
实例名称。 |
InstanceName |
| DisplayConfig |
object |
该节点已保存的完整显示配置。修改后未重启时返回最新已保存值,不代表当前运行值;历史值如实返回。VM(实例组)形态的 Dpi 不落库,故为空。 |
{\"Dpi\":320,\"ResolutionHeight\":1280,\"ResolutionWidth\":720} |
| ResolutionWidth |
integer |
该节点已保存的分辨率宽度,单位像素。从未指定过显示配置的历史节点为 null(表示无已保存值,不代表当前运行值)。 |
720 |
| ResolutionHeight |
integer |
该节点已保存的分辨率高度,单位像素。从未指定过显示配置的历史节点为 null。 |
1280 |
| Dpi |
integer |
该节点已保存的显示密度,单位 dpi。实例组(VM)形态不保存显示密度,恒为 null;矩阵(CPS)形态未指定过时为 null。 |
480 |
| CreditConfig |
array<object> |
Credit 限额配置。多次下发后续配额配置会覆盖之前配置。 |
|
|
object |
Credit 限额配置对象。 |
||
| CreditLimit |
integer |
限额大小。 枚举值:
|
-1 |
| LimitPeriod |
string |
限额周期。 枚举值:
|
day |
| UsedCredit |
array<object> |
已经使用的 Credit。 |
|
|
object |
|||
| Credit |
integer |
Credit 数量。 |
5 |
| LimitPeriod |
string |
当前 Credit 所在的维度。 枚举值:
|
day |
| JvsPackageId |
string |
暂不支持该参数。 |
null |
| Status |
string |
实例状态。 |
RUNNNING |
| CreateTime |
string |
创建时间。时间采用 ISO 8601 格式的 UTC 时间。 |
2026-04-10T01:31:32Z |
| ModifyTime |
string |
修改时间。时间采用 ISO 8601 格式的 UTC 时间。 |
2026-04-10T01:31:32Z |
| ExpireTime |
string |
过期时间。时间采用 ISO 8601 格式的 UTC 时间。 |
2026-04-10T01:31:32Z |
| AgentVersion |
object |
AI Engine 版本及升级状态信息。 |
|
| Version |
string |
AI Engine 版本号。 |
2607W1 |
| UpgradeStatus |
string |
AI Engine 版本升级状态。 |
SUCCESS |
| InstalledSkills |
array<object> |
实例已安装的技能列表。 |
|
|
object |
|||
| SkillId |
string |
技能 ID。 |
s-04zzrgosj6xd1**** |
| SkillName |
string |
技能名称。 |
weather |
| SkillType |
string |
技能类型。 |
System |
| Description |
string |
技能描述。 |
Current weather and forecasts with wttr.in via curl for locations, rain, temperature, travel planning. |
| InstalledAt |
string |
技能安装时间。 |
2026-10-22 13:45:18 |
| IconUrl |
string |
技能图标地址。 |
https://www.example.com/icon.png |
| PendingUpgradeCount |
integer |
待升级数量。 |
0 |
示例
正常返回示例
JSON格式
{
"RequestId": "425F351C-3F8E-5218-A520-B6311D0D****",
"MaxResults": 10,
"NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****",
"TotalCount": 30,
"Data": [
{
"InstanceId": "acp-uto81vfd8t8z****",
"InstanceName": "InstanceName",
"DisplayConfig": {
"ResolutionWidth": 720,
"ResolutionHeight": 1280,
"Dpi": 480
},
"CreditConfig": [
{
"CreditLimit": -1,
"LimitPeriod": "day"
}
],
"UsedCredit": [
{
"Credit": 5,
"LimitPeriod": "day"
}
],
"JvsPackageId": "null",
"Status": "RUNNNING",
"CreateTime": "2026-04-10T01:31:32Z",
"ModifyTime": "2026-04-10T01:31:32Z",
"ExpireTime": "2026-04-10T01:31:32Z",
"AgentVersion": {
"Version": "2607W1",
"UpgradeStatus": "SUCCESS"
},
"InstalledSkills": [
{
"SkillId": "s-04zzrgosj6xd1****",
"SkillName": "weather",
"SkillType": "System",
"Description": "Current weather and forecasts with wttr.in via curl for locations, rain, temperature, travel planning.",
"InstalledAt": "2026-10-22 13:45:18",
"IconUrl": "https://www.example.com/icon.png"
}
]
}
],
"PendingUpgradeCount": 0
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。