DescribeJVSInstance - 查询JVS实例信息

更新时间:
复制 MD 格式

查询JVS实例信息

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

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

限额大小。

枚举值:

  • 0 :

    不可使用

  • >0 :

    按照数字配置限额

  • -1 :

    不限额

-1

LimitPeriod

string

限额周期。

枚举值:

  • total :

    使用总上限

  • month :

    月,按照资源开通时间为一个周期清空

  • day :

    天,0 点清空

day

UsedCredit

array<object>

已经使用的 Credit。

object

Credit

integer

Credit 数量。

5

LimitPeriod

string

当前 Credit 所在的维度。

枚举值:

  • total :

    使用总上限

  • month :

    月,按照资源开通时间为一个周期清空

  • day :

    天,0 点清空

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
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。