tencentcloud-sdk-nodejs-ags 4.1.344 → 4.1.346

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -39,6 +39,9 @@ export class Client extends TencentCloudCommon.AbstractClient {
39
39
  async CreateAPIKey(req, cb) {
40
40
  return this.request("CreateAPIKey", req, cb);
41
41
  }
42
+ async DescribeGPUResourceSpecs(req, cb) {
43
+ return this.request("DescribeGPUResourceSpecs", req, cb);
44
+ }
42
45
  async UpdateRegistry(req, cb) {
43
46
  return this.request("UpdateRegistry", req, cb);
44
47
  }
@@ -54,6 +57,9 @@ export class Client extends TencentCloudCommon.AbstractClient {
54
57
  async DescribeDeployment(req, cb) {
55
58
  return this.request("DescribeDeployment", req, cb);
56
59
  }
60
+ async ModifySessionSpace(req, cb) {
61
+ return this.request("ModifySessionSpace", req, cb);
62
+ }
57
63
  async DescribeRegistryRecordVersionList(req, cb) {
58
64
  return this.request("DescribeRegistryRecordVersionList", req, cb);
59
65
  }
@@ -102,8 +108,8 @@ export class Client extends TencentCloudCommon.AbstractClient {
102
108
  async DescribeRegistryRecord(req, cb) {
103
109
  return this.request("DescribeRegistryRecord", req, cb);
104
110
  }
105
- async ModifySessionSpace(req, cb) {
106
- return this.request("ModifySessionSpace", req, cb);
111
+ async DescribeGPUResources(req, cb) {
112
+ return this.request("DescribeGPUResources", req, cb);
107
113
  }
108
114
  async DeleteRegistryRecord(req, cb) {
109
115
  return this.request("DeleteRegistryRecord", req, cb);
@@ -114,14 +120,17 @@ export class Client extends TencentCloudCommon.AbstractClient {
114
120
  async DescribeSandboxInstanceList(req, cb) {
115
121
  return this.request("DescribeSandboxInstanceList", req, cb);
116
122
  }
117
- async DescribeSandboxToolList(req, cb) {
118
- return this.request("DescribeSandboxToolList", req, cb);
123
+ async RejectRegistryRecord(req, cb) {
124
+ return this.request("RejectRegistryRecord", req, cb);
125
+ }
126
+ async DescribeGPUResourceGroups(req, cb) {
127
+ return this.request("DescribeGPUResourceGroups", req, cb);
119
128
  }
120
129
  async GetSkillPackageDownloadURL(req, cb) {
121
130
  return this.request("GetSkillPackageDownloadURL", req, cb);
122
131
  }
123
- async RejectRegistryRecord(req, cb) {
124
- return this.request("RejectRegistryRecord", req, cb);
132
+ async DescribeSandboxToolList(req, cb) {
133
+ return this.request("DescribeSandboxToolList", req, cb);
125
134
  }
126
135
  async DescribeAPIKeyList(req, cb) {
127
136
  return this.request("DescribeAPIKeyList", req, cb);
@@ -135,6 +144,9 @@ export class Client extends TencentCloudCommon.AbstractClient {
135
144
  async PauseSandboxInstance(req, cb) {
136
145
  return this.request("PauseSandboxInstance", req, cb);
137
146
  }
147
+ async DeleteGPUResourceGroup(req, cb) {
148
+ return this.request("DeleteGPUResourceGroup", req, cb);
149
+ }
138
150
  async CreateSession(req, cb) {
139
151
  return this.request("CreateSession", req, cb);
140
152
  }
@@ -171,6 +183,9 @@ export class Client extends TencentCloudCommon.AbstractClient {
171
183
  async DescribeSession(req, cb) {
172
184
  return this.request("DescribeSession", req, cb);
173
185
  }
186
+ async ModifyGPUResourceGroup(req, cb) {
187
+ return this.request("ModifyGPUResourceGroup", req, cb);
188
+ }
174
189
  async DescribeEventCenterEvents(req, cb) {
175
190
  return this.request("DescribeEventCenterEvents", req, cb);
176
191
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tencentcloud-sdk-nodejs-ags",
3
- "version": "4.1.344",
3
+ "version": "4.1.346",
4
4
  "description": "腾讯云 API NODEJS SDK",
5
5
  "main": "./tencentcloud/index.js",
6
6
  "module": "./es/index.js",
@@ -1,5 +1,5 @@
1
1
  import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common";
2
- import { DeleteSessionSpaceResponse, ApproveRegistryRecordRequest, AppendEventResponse, DescribeRegistryRecordResponse, DescribeQuotaOverviewRequest, CreatePreCacheImageTaskResponse, ResumeSandboxInstanceRequest, ModifySessionSpaceResponse, DescribePreCacheImageTaskRequest, DescribeDeploymentResponse, RejectRegistryRecordResponse, DescribeRegistryRecordListRequest, UpdateRegistryResponse, ApproveRegistryRecordResponse, DeleteSessionRequest, ResumeSandboxInstanceResponse, AcquireSandboxInstanceTokenRequest, DescribeAPIKeyListResponse, PreviewRegistryRecordResponse, CreateSessionRequest, DescribeDeploymentRequest, DescribeSandboxSnapshotListRequest, DescribeSessionSpaceResponse, CreateSandboxToolResponse, CreateRegistryResponse, DeleteAPIKeyRequest, DeleteDeploymentRequest, GetSkillPackageUploadURLRequest, UpdateSandboxToolRequest, DescribeSessionSpacesResponse, DescribeRegistryRecordVersionListResponse, DeleteSandboxSnapshotResponse, DescribePreCacheImageListRequest, DescribeRegistryRecordVersionListRequest, RejectRegistryRecordRequest, CreateDeploymentRequest, StopSandboxInstanceRequest, GetSkillPackageDownloadURLRequest, DescribeSandboxToolListResponse, CreateSandboxSnapshotResponse, DescribeQuotaOverviewResponse, UpdateSandboxToolResponse, DescribeRegistryRecordRequest, CancelRegistryRecordRequest, DescribeSandboxToolListRequest, DeleteSandboxToolRequest, CreateAPIKeyRequest, DeleteSandboxToolResponse, DeleteSandboxSnapshotRequest, CreateRegistryRecordResponse, DescribePreCacheImageListResponse, UpdateSandboxInstanceRequest, ModifySessionRequest, SyncRegistryRecordRequest, DescribeRegistryRequest, DeleteRegistryResponse, DescribeAPIKeyListRequest, DescribeSandboxInstanceListResponse, GetSkillPackageUploadURLResponse, CreateSessionSpaceResponse, UpdateRegistryRequest, DescribeSessionsResponse, DescribeDeploymentListRequest, DescribeRegistryAuditLogListRequest, PauseSandboxInstanceRequest, DescribeRegistryRecordListResponse, UpdateRegistryRecordRequest, DeletePreCacheImageResponse, CreateAPIKeyResponse, DescribeSessionRequest, AcquireDeploymentTokenRequest, DescribeEventsResponse, DescribeDeploymentListResponse, DescribeRegistryResponse, ModifySessionSpaceRequest, CreateSessionSpaceRequest, DeleteAPIKeyResponse, DescribeRegistryListRequest, CreateDeploymentResponse, DeleteRegistryRequest, GetSkillPackageDownloadURLResponse, CreateSessionResponse, StartSandboxInstanceResponse, DescribeSessionSpaceRequest, DescribeSandboxInstanceListRequest, ModifyDeploymentRequest, DescribeRegistryAuditLogListResponse, AcquireSandboxInstanceTokenResponse, DeletePreCacheImageRequest, DescribeSandboxSnapshotListResponse, PauseSandboxInstanceResponse, DescribeSandboxInstancesRequest, StartSandboxInstanceRequest, CancelRegistryRecordResponse, DescribeSessionSpacesRequest, DescribeRegistryListResponse, UpdateRegistryRecordResponse, DeleteSessionSpaceRequest, AcquireDeploymentTokenResponse, DescribeSessionsRequest, CreateSandboxToolRequest, DescribePreCacheImageTaskResponse, DeleteRegistryRecordResponse, CreateRegistryRecordRequest, DescribeEventCenterEventsResponse, ModifySessionResponse, UpdateSandboxInstanceResponse, DeleteDeploymentResponse, SyncRegistryRecordResponse, DescribeSessionResponse, DeleteRegistryRecordRequest, DescribeEventCenterEventsRequest, StopSandboxInstanceResponse, CreateSandboxSnapshotRequest, AppendEventRequest, DeleteSessionResponse, PreviewRegistryRecordRequest, DescribeEventsRequest, DescribeSandboxInstancesResponse, CreateRegistryRequest, ModifyDeploymentResponse, CreatePreCacheImageTaskRequest } from "./ags_models";
2
+ import { DeleteSessionSpaceResponse, ApproveRegistryRecordRequest, AppendEventResponse, DescribeRegistryRecordResponse, DescribeQuotaOverviewRequest, CreatePreCacheImageTaskResponse, ResumeSandboxInstanceRequest, ModifySessionSpaceResponse, DescribePreCacheImageTaskRequest, DescribeDeploymentResponse, RejectRegistryRecordResponse, DescribeRegistryRecordListRequest, UpdateRegistryResponse, ApproveRegistryRecordResponse, DeleteSessionRequest, ResumeSandboxInstanceResponse, AcquireSandboxInstanceTokenRequest, ModifyGPUResourceGroupResponse, DescribeAPIKeyListResponse, PreviewRegistryRecordResponse, CreateSessionRequest, DescribeDeploymentRequest, DescribeSandboxSnapshotListRequest, DescribeSessionSpaceResponse, CreateSandboxToolResponse, CreateRegistryResponse, DeleteAPIKeyRequest, DeleteDeploymentRequest, GetSkillPackageUploadURLRequest, UpdateSandboxToolRequest, DescribeSessionSpacesResponse, DescribeRegistryRecordVersionListResponse, DeleteSandboxSnapshotResponse, DescribePreCacheImageListRequest, DescribeRegistryRecordVersionListRequest, RejectRegistryRecordRequest, CreateDeploymentRequest, DescribeGPUResourceSpecsResponse, StopSandboxInstanceRequest, GetSkillPackageDownloadURLRequest, DescribeSandboxToolListResponse, DescribeGPUResourceSpecsRequest, CreateSandboxSnapshotResponse, DescribeGPUResourceGroupsResponse, DescribeQuotaOverviewResponse, UpdateSandboxToolResponse, DescribeRegistryRecordRequest, CancelRegistryRecordRequest, DescribeSandboxToolListRequest, DeleteSandboxToolRequest, CreateAPIKeyRequest, DeleteSandboxToolResponse, DeleteSandboxSnapshotRequest, CreateRegistryRecordResponse, DescribePreCacheImageListResponse, ModifySessionRequest, ModifyGPUResourceGroupRequest, DescribeRegistryRequest, DeleteRegistryResponse, DescribeAPIKeyListRequest, UpdateSandboxInstanceRequest, DescribeSandboxInstanceListResponse, GetSkillPackageUploadURLResponse, CreateSessionSpaceResponse, DescribeGPUResourcesRequest, UpdateRegistryRequest, SyncRegistryRecordRequest, DescribeSessionsResponse, DescribeDeploymentListRequest, DescribeRegistryAuditLogListRequest, PauseSandboxInstanceRequest, DescribeRegistryRecordListResponse, UpdateRegistryRecordRequest, DeletePreCacheImageResponse, CreateAPIKeyResponse, DescribeSessionRequest, AcquireDeploymentTokenRequest, DescribeEventsResponse, DescribeDeploymentListResponse, DescribeRegistryResponse, ModifySessionSpaceRequest, CreateSessionSpaceRequest, DeleteAPIKeyResponse, DescribeRegistryListRequest, CreateDeploymentResponse, DeleteRegistryRequest, GetSkillPackageDownloadURLResponse, DescribeGPUResourcesResponse, CreateSessionResponse, StartSandboxInstanceResponse, DescribeGPUResourceGroupsRequest, DescribeSessionSpaceRequest, DescribeSandboxInstanceListRequest, ModifyDeploymentRequest, DescribeRegistryAuditLogListResponse, AcquireSandboxInstanceTokenResponse, DeletePreCacheImageRequest, DescribeSandboxSnapshotListResponse, PauseSandboxInstanceResponse, DescribeSandboxInstancesRequest, StartSandboxInstanceRequest, CancelRegistryRecordResponse, DescribeSessionSpacesRequest, DescribeRegistryListResponse, UpdateRegistryRecordResponse, DeleteSessionSpaceRequest, AcquireDeploymentTokenResponse, DescribeSessionsRequest, CreateSandboxToolRequest, DescribePreCacheImageTaskResponse, DeleteRegistryRecordResponse, CreateRegistryRecordRequest, DescribeEventCenterEventsResponse, ModifySessionResponse, UpdateSandboxInstanceResponse, DeleteDeploymentResponse, SyncRegistryRecordResponse, DescribeSessionResponse, DeleteRegistryRecordRequest, DescribeEventCenterEventsRequest, StopSandboxInstanceResponse, CreateSandboxSnapshotRequest, AppendEventRequest, DeleteSessionResponse, DeleteGPUResourceGroupResponse, PreviewRegistryRecordRequest, DescribeEventsRequest, DescribeSandboxInstancesResponse, CreateRegistryRequest, DeleteGPUResourceGroupRequest, ModifyDeploymentResponse, CreatePreCacheImageTaskRequest } from "./ags_models";
3
3
  /**
4
4
  * ags client
5
5
  * @class
@@ -59,6 +59,10 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
59
59
  * 创建新的API密钥,用于调用Agent Sandbox接口。相较于腾讯云Secret ID Secret Key支持调用所有接口使用,仅有部分接口支持使用API密钥调用。
60
60
  */
61
61
  CreateAPIKey(req: CreateAPIKeyRequest, cb?: (error: string, rep: CreateAPIKeyResponse) => void): Promise<CreateAPIKeyResponse>;
62
+ /**
63
+ * 查询当前地域可售 GPU 规格与当前租户可购买额度。GPUType、CPU、Memory、GPUNum 必须同时提供或同时省略;精确过滤时按四项匹配。不返回底层机型、资源池或计费标签。总显存为单台全部 GPU 的显存之和。
64
+ */
65
+ DescribeGPUResourceSpecs(req: DescribeGPUResourceSpecsRequest, cb?: (error: string, rep: DescribeGPUResourceSpecsResponse) => void): Promise<DescribeGPUResourceSpecsResponse>;
62
66
  /**
63
67
  * 更新 Registry 的可变元数据。
64
68
  */
@@ -81,6 +85,11 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
81
85
  * 查询 Deployment 信息
82
86
  */
83
87
  DescribeDeployment(req: DescribeDeploymentRequest, cb?: (error: string, rep: DescribeDeploymentResponse) => void): Promise<DescribeDeploymentResponse>;
88
+ /**
89
+ * 修改会话空间。
90
+ 修改指定会话空间的名称和描述,修改成功后返回更新后的会话空间信息。默认会话空间允许修改名称和描述。
91
+ */
92
+ ModifySessionSpace(req: ModifySessionSpaceRequest, cb?: (error: string, rep: ModifySessionSpaceResponse) => void): Promise<ModifySessionSpaceResponse>;
84
93
  /**
85
94
  * RegistryId 必填。大写常量 MARKETPLACE 表示服务端主 YAML marketplace.registry_ids 配置的工具市场;真实 reg-xxx 表示具体 Registry。省略、空字符串、null 或其他大小写均拒绝。市场读取要求已认证身份,只返回配置来源内未删除、已审批的可读版本,文件还须 READY 和有效制品;不回退私有目录。 RecordId 市场可选、普通必填。固定版本查询用 DescribeRegistryRecord;record_id/version_id Filters 已删除。Filters 不扩大权限;市场默认浏览传 label=stable。普通模式保留 AppID 与 CAM,市场版本显式投影公开字段。
86
95
  */
@@ -90,7 +99,7 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
90
99
  */
91
100
  ApproveRegistryRecord(req: ApproveRegistryRecordRequest, cb?: (error: string, rep: ApproveRegistryRecordResponse) => void): Promise<ApproveRegistryRecordResponse>;
92
101
  /**
93
- * 分页查询 Registry 下的 Record 列表。list 类接口不接入 CAM 转发鉴权;业务侧按 CAM 二次过滤。
102
+ * RegistryId 必填。大写常量 MARKETPLACE 表示服务端主 YAML marketplace.registry_ids 配置的工具市场;真实 reg-xxx 表示具体 Registry。省略、空字符串、null 或其他大小写均拒绝。市场读取要求已认证身份,只返回配置来源内未删除、已审批的可读版本,文件还须 READY 和有效制品;不回退私有目录。 返回至少有一个市场可读版本的 Record;去重、过滤、计数后分页,VersionCount/LabelSet 只反映市场可读版本,隐藏租户及创建者信息。真实 RegistryId 保留原 AppID/CAM 资源过滤,接口由后端自行鉴权。
94
103
  */
95
104
  DescribeRegistryRecordList(req: DescribeRegistryRecordListRequest, cb?: (error: string, rep: DescribeRegistryRecordListResponse) => void): Promise<DescribeRegistryRecordListResponse>;
96
105
  /**
@@ -106,7 +115,7 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
106
115
  */
107
116
  DescribeSessions(req: DescribeSessionsRequest, cb?: (error: string, rep: DescribeSessionsResponse) => void): Promise<DescribeSessionsResponse>;
108
117
  /**
109
- * 统一创建 Registry Record(含 revision 1)。请求通过 DescriptorType 与严格内容输入 Union 选择底层类型:MCPSource / AgentSource / SkillSource / CustomDescriptors 四选一,必须与 DescriptorType 对应。不接受 RecordId 或 ChangeLog;同名 Record 返回冲突,不隐式追加 Version。追加 Version 请使用 UpdateRegistryRecord。
118
+ * 统一创建 Registry Record(含 revision 1)。MCPSource / AgentSource / SkillSource / CustomDescriptors / FileSource 五选一,必须与 DescriptorType 对应。PLUGIN 使用 FileSource.Type=FILE 上传通用文件,Registry 不校验插件内容格式和语义,运行端负责解析和加载。SupportedHarnessVersions 为该版本支持的 HarnessVersionReference 对象列表,每项同时包含 HarnessEngine 和 HarnessEngineVersion,原样使用 DescribeHarnessEngineList 返回的选项;Metadata 为 Name/Value 字符串数组,Name 非空、小写且唯一,服务内部保存 map[string]string;两项属性省略时均保存空列表,不继承其他版本。不接受 RecordId 或 ChangeLog;同名 Record 返回冲突,不隐式追加 Version。追加 Version 请使用 UpdateRegistryRecord。
110
119
  */
111
120
  CreateRegistryRecord(req: CreateRegistryRecordRequest, cb?: (error: string, rep: CreateRegistryRecordResponse) => void): Promise<CreateRegistryRecordResponse>;
112
121
  /**
@@ -144,14 +153,13 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
144
153
  */
145
154
  GetSkillPackageUploadURL(req: GetSkillPackageUploadURLRequest, cb?: (error: string, rep: GetSkillPackageUploadURLResponse) => void): Promise<GetSkillPackageUploadURLResponse>;
146
155
  /**
147
- * 查询 Record 详情和其中一个 Version。请求可通过互斥的 VersionId 或 Label 选择 Version;均省略时默认 Label=stable。取代原 DescribeRegistryRecordVersion。
156
+ * RegistryId 必填。大写常量 MARKETPLACE 表示服务端主 YAML marketplace.registry_ids 配置的工具市场;真实 reg-xxx 表示具体 Registry。省略、空字符串、null 或其他大小写均拒绝。市场读取要求已认证身份,只返回配置来源内未删除、已审批的可读版本,文件还须 READY 和有效制品;不回退私有目录。 RecordId 必填,VersionId/Label 互斥,均省略解析 stable;市场无可读 stable 返回 ResourceNotFound,不回退 latest。市场 Record/Version 使用公开字段投影,隐藏创建者、租户、审批动作和 SourceConfig。普通模式保留原 AppID/归属,由后端执行 Record 级 CAM batch 检查。
148
157
  */
149
158
  DescribeRegistryRecord(req: DescribeRegistryRecordRequest, cb?: (error: string, rep: DescribeRegistryRecordResponse) => void): Promise<DescribeRegistryRecordResponse>;
150
159
  /**
151
- * 修改会话空间。
152
- 修改指定会话空间的名称和描述,修改成功后返回更新后的会话空间信息。默认会话空间允许修改名称和描述。
153
- */
154
- ModifySessionSpace(req: ModifySessionSpaceRequest, cb?: (error: string, rep: ModifySessionSpaceResponse) => void): Promise<ModifySessionSpaceResponse>;
160
+ * 查询当前地域、当前租户的逐台 GPU 商业资源及占用状态。仅展示当前资源,不展示已销毁或补偿完成的失败资源;先筛选(含占用状态)再统计和分页。
161
+ */
162
+ DescribeGPUResources(req: DescribeGPUResourcesRequest, cb?: (error: string, rep: DescribeGPUResourcesResponse) => void): Promise<DescribeGPUResourcesResponse>;
155
163
  /**
156
164
  * 删除 Registry Record 或指定 Version。省略 VersionId 时对整个 Record 进行软删除;传入 VersionId 时只删除指定 Version(Stable 指向的 Version 不允许删除;仅剩一个 Approved Version 时不允许删除)。取代原 DeleteRegistryRecordVersion。
157
165
  */
@@ -165,23 +173,27 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
165
173
  */
166
174
  DescribeSandboxInstanceList(req: DescribeSandboxInstanceListRequest, cb?: (error: string, rep: DescribeSandboxInstanceListResponse) => void): Promise<DescribeSandboxInstanceListResponse>;
167
175
  /**
168
- * 查询沙箱工具列表
176
+ * 驳回 Version 审批:PENDING_APPROVAL → REJECTED。Comment 必填。
169
177
  */
170
- DescribeSandboxToolList(req: DescribeSandboxToolListRequest, cb?: (error: string, rep: DescribeSandboxToolListResponse) => void): Promise<DescribeSandboxToolListResponse>;
178
+ RejectRegistryRecord(req: RejectRegistryRecordRequest, cb?: (error: string, rep: RejectRegistryRecordResponse) => void): Promise<RejectRegistryRecordResponse>;
179
+ /**
180
+ * 查询当前地域、当前租户的 GPU 资源组及统计。通过 resource-group-id 精确过滤可查询组详情,仍返回数组;无匹配项返回空数组。资源组可以为空,商业期限和续费标记逐台保存。
181
+ */
182
+ DescribeGPUResourceGroups(req: DescribeGPUResourceGroupsRequest, cb?: (error: string, rep: DescribeGPUResourceGroupsResponse) => void): Promise<DescribeGPUResourceGroupsResponse>;
171
183
  /**
172
184
  * 获取 Skill 包下载 URL。VersionId 与 Label 互斥;均省略时使用 Stable。响应包含 ResolvedVersionId,便于调用方回填。
173
185
  */
174
186
  GetSkillPackageDownloadURL(req: GetSkillPackageDownloadURLRequest, cb?: (error: string, rep: GetSkillPackageDownloadURLResponse) => void): Promise<GetSkillPackageDownloadURLResponse>;
175
187
  /**
176
- * 驳回 Version 审批:PENDING_APPROVAL → REJECTED。Comment 必填。
188
+ * 查询沙箱工具列表
177
189
  */
178
- RejectRegistryRecord(req: RejectRegistryRecordRequest, cb?: (error: string, rep: RejectRegistryRecordResponse) => void): Promise<RejectRegistryRecordResponse>;
190
+ DescribeSandboxToolList(req: DescribeSandboxToolListRequest, cb?: (error: string, rep: DescribeSandboxToolListResponse) => void): Promise<DescribeSandboxToolListResponse>;
179
191
  /**
180
192
  * 获取API密钥列表,包含API密钥简略信息,包含名称、创建时间等。
181
193
  */
182
194
  DescribeAPIKeyList(req?: DescribeAPIKeyListRequest, cb?: (error: string, rep: DescribeAPIKeyListResponse) => void): Promise<DescribeAPIKeyListResponse>;
183
195
  /**
184
- * 更新 Registry Record。两种互斥模式:①Record 更新模式:不提交任何 Source / CustomDescriptors,可通过 Description、LabelMutations 修改元数据与 Label(至少提交一项);②Version 创建模式:提交且仅提交一种与现有 DescriptorType 匹配的内容输入,可选 VersionName / ChangeLog,禁止 Description / LabelMutations,服务端在 Record 下创建下一个 Revision。取代原 ChangeRegistryRecordStableVersion / RollbackRegistryRecordVersion / Create*RegistryRecordVersion。
196
+ * 更新 Registry Record。两种互斥模式:①Record 更新模式:不提交任何 Source / CustomDescriptors,可通过 Description、LabelMutations 修改元数据与 Label(至少提交一项);②Version 创建模式:提交且仅提交一种与现有 DescriptorType 匹配的内容输入,可选 VersionName / ChangeLog / SupportedHarnessVersions / Metadata,禁止 Description / LabelMutations,服务端创建下一个 Revision。PLUGIN 使用 FileSource.Type=FILE 上传原始文件;FileSource.Type=VERSION 可为 Skill 或 Plugin 复用同一 Record 下未删除且 READY 的文件版本,填写 SourceVersionId,不复制来源版本的 Metadata 或 SupportedHarnessVersions。Metadata 以 Name/Value 字符串数组传输,所有层级 key 必须小写;两项版本属性省略时分别为空对象和空列表,不继承上一版本。取代原 ChangeRegistryRecordStableVersion / RollbackRegistryRecordVersion / Create*RegistryRecordVersion。
185
197
  */
186
198
  UpdateRegistryRecord(req: UpdateRegistryRecordRequest, cb?: (error: string, rep: UpdateRegistryRecordResponse) => void): Promise<UpdateRegistryRecordResponse>;
187
199
  /**
@@ -192,6 +204,10 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
192
204
  * 暂停沙箱实例
193
205
  */
194
206
  PauseSandboxInstance(req: PauseSandboxInstanceRequest, cb?: (error: string, rep: PauseSandboxInstanceResponse) => void): Promise<PauseSandboxInstanceResponse>;
207
+ /**
208
+ * 同步删除当前租户的空 GPU 资源组。资源组内不能存在交付中、已生效、已隔离、销毁中或其他未完成清理的 GPU 实例,也不能有剩余占用绑定或未删除的关联沙箱工具,否则返回 ResourceInUse。已销毁或补偿清理完成的历史记录不阻止删除。同租户重复删除已删除的资源组返回成功;资源组不存在或不属于当前租户时返回 ResourceNotFound。本接口仅软删除资源组,不执行退订退款、停止沙箱或释放底层 VM,历史计费记录保留。
209
+ */
210
+ DeleteGPUResourceGroup(req: DeleteGPUResourceGroupRequest, cb?: (error: string, rep: DeleteGPUResourceGroupResponse) => void): Promise<DeleteGPUResourceGroupResponse>;
195
211
  /**
196
212
  * 创建会话。
197
213
 
@@ -245,6 +261,10 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
245
261
  查询指定会话的信息。
246
262
  */
247
263
  DescribeSession(req: DescribeSessionRequest, cb?: (error: string, rep: DescribeSessionResponse) => void): Promise<DescribeSessionResponse>;
264
+ /**
265
+ * 仅同步修改当前租户 GPU 资源组的名称,允许重名、同名重试;不修改规格、数量、计费期限或续费标记。不存在或不属于当前租户的资源组返回 ResourceNotFound。
266
+ */
267
+ ModifyGPUResourceGroup(req: ModifyGPUResourceGroupRequest, cb?: (error: string, rep: ModifyGPUResourceGroupResponse) => void): Promise<ModifyGPUResourceGroupResponse>;
248
268
  /**
249
269
  * 本接口用于查询当前账号在指定地域的事件列表,支持按事件来源、资源对象、事件类型、事件级别及时间范围等条件筛选,并支持分页和时间排序。默认查询最近 1 小时的事件,支持查询最近 7 天内的事件。
250
270
  */
@@ -105,6 +105,12 @@ class Client extends TencentCloudCommon.AbstractClient {
105
105
  async CreateAPIKey(req, cb) {
106
106
  return this.request("CreateAPIKey", req, cb);
107
107
  }
108
+ /**
109
+ * 查询当前地域可售 GPU 规格与当前租户可购买额度。GPUType、CPU、Memory、GPUNum 必须同时提供或同时省略;精确过滤时按四项匹配。不返回底层机型、资源池或计费标签。总显存为单台全部 GPU 的显存之和。
110
+ */
111
+ async DescribeGPUResourceSpecs(req, cb) {
112
+ return this.request("DescribeGPUResourceSpecs", req, cb);
113
+ }
108
114
  /**
109
115
  * 更新 Registry 的可变元数据。
110
116
  */
@@ -137,6 +143,13 @@ class Client extends TencentCloudCommon.AbstractClient {
137
143
  async DescribeDeployment(req, cb) {
138
144
  return this.request("DescribeDeployment", req, cb);
139
145
  }
146
+ /**
147
+ * 修改会话空间。
148
+ 修改指定会话空间的名称和描述,修改成功后返回更新后的会话空间信息。默认会话空间允许修改名称和描述。
149
+ */
150
+ async ModifySessionSpace(req, cb) {
151
+ return this.request("ModifySessionSpace", req, cb);
152
+ }
140
153
  /**
141
154
  * RegistryId 必填。大写常量 MARKETPLACE 表示服务端主 YAML marketplace.registry_ids 配置的工具市场;真实 reg-xxx 表示具体 Registry。省略、空字符串、null 或其他大小写均拒绝。市场读取要求已认证身份,只返回配置来源内未删除、已审批的可读版本,文件还须 READY 和有效制品;不回退私有目录。 RecordId 市场可选、普通必填。固定版本查询用 DescribeRegistryRecord;record_id/version_id Filters 已删除。Filters 不扩大权限;市场默认浏览传 label=stable。普通模式保留 AppID 与 CAM,市场版本显式投影公开字段。
142
155
  */
@@ -150,7 +163,7 @@ class Client extends TencentCloudCommon.AbstractClient {
150
163
  return this.request("ApproveRegistryRecord", req, cb);
151
164
  }
152
165
  /**
153
- * 分页查询 Registry 下的 Record 列表。list 类接口不接入 CAM 转发鉴权;业务侧按 CAM 二次过滤。
166
+ * RegistryId 必填。大写常量 MARKETPLACE 表示服务端主 YAML marketplace.registry_ids 配置的工具市场;真实 reg-xxx 表示具体 Registry。省略、空字符串、null 或其他大小写均拒绝。市场读取要求已认证身份,只返回配置来源内未删除、已审批的可读版本,文件还须 READY 和有效制品;不回退私有目录。 返回至少有一个市场可读版本的 Record;去重、过滤、计数后分页,VersionCount/LabelSet 只反映市场可读版本,隐藏租户及创建者信息。真实 RegistryId 保留原 AppID/CAM 资源过滤,接口由后端自行鉴权。
154
167
  */
155
168
  async DescribeRegistryRecordList(req, cb) {
156
169
  return this.request("DescribeRegistryRecordList", req, cb);
@@ -174,7 +187,7 @@ class Client extends TencentCloudCommon.AbstractClient {
174
187
  return this.request("DescribeSessions", req, cb);
175
188
  }
176
189
  /**
177
- * 统一创建 Registry Record(含 revision 1)。请求通过 DescriptorType 与严格内容输入 Union 选择底层类型:MCPSource / AgentSource / SkillSource / CustomDescriptors 四选一,必须与 DescriptorType 对应。不接受 RecordId 或 ChangeLog;同名 Record 返回冲突,不隐式追加 Version。追加 Version 请使用 UpdateRegistryRecord。
190
+ * 统一创建 Registry Record(含 revision 1)。MCPSource / AgentSource / SkillSource / CustomDescriptors / FileSource 五选一,必须与 DescriptorType 对应。PLUGIN 使用 FileSource.Type=FILE 上传通用文件,Registry 不校验插件内容格式和语义,运行端负责解析和加载。SupportedHarnessVersions 为该版本支持的 HarnessVersionReference 对象列表,每项同时包含 HarnessEngine 和 HarnessEngineVersion,原样使用 DescribeHarnessEngineList 返回的选项;Metadata 为 Name/Value 字符串数组,Name 非空、小写且唯一,服务内部保存 map[string]string;两项属性省略时均保存空列表,不继承其他版本。不接受 RecordId 或 ChangeLog;同名 Record 返回冲突,不隐式追加 Version。追加 Version 请使用 UpdateRegistryRecord。
178
191
  */
179
192
  async CreateRegistryRecord(req, cb) {
180
193
  return this.request("CreateRegistryRecord", req, cb);
@@ -230,17 +243,16 @@ class Client extends TencentCloudCommon.AbstractClient {
230
243
  return this.request("GetSkillPackageUploadURL", req, cb);
231
244
  }
232
245
  /**
233
- * 查询 Record 详情和其中一个 Version。请求可通过互斥的 VersionId 或 Label 选择 Version;均省略时默认 Label=stable。取代原 DescribeRegistryRecordVersion。
246
+ * RegistryId 必填。大写常量 MARKETPLACE 表示服务端主 YAML marketplace.registry_ids 配置的工具市场;真实 reg-xxx 表示具体 Registry。省略、空字符串、null 或其他大小写均拒绝。市场读取要求已认证身份,只返回配置来源内未删除、已审批的可读版本,文件还须 READY 和有效制品;不回退私有目录。 RecordId 必填,VersionId/Label 互斥,均省略解析 stable;市场无可读 stable 返回 ResourceNotFound,不回退 latest。市场 Record/Version 使用公开字段投影,隐藏创建者、租户、审批动作和 SourceConfig。普通模式保留原 AppID/归属,由后端执行 Record 级 CAM batch 检查。
234
247
  */
235
248
  async DescribeRegistryRecord(req, cb) {
236
249
  return this.request("DescribeRegistryRecord", req, cb);
237
250
  }
238
251
  /**
239
- * 修改会话空间。
240
- 修改指定会话空间的名称和描述,修改成功后返回更新后的会话空间信息。默认会话空间允许修改名称和描述。
241
- */
242
- async ModifySessionSpace(req, cb) {
243
- return this.request("ModifySessionSpace", req, cb);
252
+ * 查询当前地域、当前租户的逐台 GPU 商业资源及占用状态。仅展示当前资源,不展示已销毁或补偿完成的失败资源;先筛选(含占用状态)再统计和分页。
253
+ */
254
+ async DescribeGPUResources(req, cb) {
255
+ return this.request("DescribeGPUResources", req, cb);
244
256
  }
245
257
  /**
246
258
  * 删除 Registry Record 或指定 Version。省略 VersionId 时对整个 Record 进行软删除;传入 VersionId 时只删除指定 Version(Stable 指向的 Version 不允许删除;仅剩一个 Approved Version 时不允许删除)。取代原 DeleteRegistryRecordVersion。
@@ -261,10 +273,16 @@ class Client extends TencentCloudCommon.AbstractClient {
261
273
  return this.request("DescribeSandboxInstanceList", req, cb);
262
274
  }
263
275
  /**
264
- * 查询沙箱工具列表
276
+ * 驳回 Version 审批:PENDING_APPROVAL → REJECTED。Comment 必填。
265
277
  */
266
- async DescribeSandboxToolList(req, cb) {
267
- return this.request("DescribeSandboxToolList", req, cb);
278
+ async RejectRegistryRecord(req, cb) {
279
+ return this.request("RejectRegistryRecord", req, cb);
280
+ }
281
+ /**
282
+ * 查询当前地域、当前租户的 GPU 资源组及统计。通过 resource-group-id 精确过滤可查询组详情,仍返回数组;无匹配项返回空数组。资源组可以为空,商业期限和续费标记逐台保存。
283
+ */
284
+ async DescribeGPUResourceGroups(req, cb) {
285
+ return this.request("DescribeGPUResourceGroups", req, cb);
268
286
  }
269
287
  /**
270
288
  * 获取 Skill 包下载 URL。VersionId 与 Label 互斥;均省略时使用 Stable。响应包含 ResolvedVersionId,便于调用方回填。
@@ -273,10 +291,10 @@ class Client extends TencentCloudCommon.AbstractClient {
273
291
  return this.request("GetSkillPackageDownloadURL", req, cb);
274
292
  }
275
293
  /**
276
- * 驳回 Version 审批:PENDING_APPROVAL → REJECTED。Comment 必填。
294
+ * 查询沙箱工具列表
277
295
  */
278
- async RejectRegistryRecord(req, cb) {
279
- return this.request("RejectRegistryRecord", req, cb);
296
+ async DescribeSandboxToolList(req, cb) {
297
+ return this.request("DescribeSandboxToolList", req, cb);
280
298
  }
281
299
  /**
282
300
  * 获取API密钥列表,包含API密钥简略信息,包含名称、创建时间等。
@@ -285,7 +303,7 @@ class Client extends TencentCloudCommon.AbstractClient {
285
303
  return this.request("DescribeAPIKeyList", req, cb);
286
304
  }
287
305
  /**
288
- * 更新 Registry Record。两种互斥模式:①Record 更新模式:不提交任何 Source / CustomDescriptors,可通过 Description、LabelMutations 修改元数据与 Label(至少提交一项);②Version 创建模式:提交且仅提交一种与现有 DescriptorType 匹配的内容输入,可选 VersionName / ChangeLog,禁止 Description / LabelMutations,服务端在 Record 下创建下一个 Revision。取代原 ChangeRegistryRecordStableVersion / RollbackRegistryRecordVersion / Create*RegistryRecordVersion。
306
+ * 更新 Registry Record。两种互斥模式:①Record 更新模式:不提交任何 Source / CustomDescriptors,可通过 Description、LabelMutations 修改元数据与 Label(至少提交一项);②Version 创建模式:提交且仅提交一种与现有 DescriptorType 匹配的内容输入,可选 VersionName / ChangeLog / SupportedHarnessVersions / Metadata,禁止 Description / LabelMutations,服务端创建下一个 Revision。PLUGIN 使用 FileSource.Type=FILE 上传原始文件;FileSource.Type=VERSION 可为 Skill 或 Plugin 复用同一 Record 下未删除且 READY 的文件版本,填写 SourceVersionId,不复制来源版本的 Metadata 或 SupportedHarnessVersions。Metadata 以 Name/Value 字符串数组传输,所有层级 key 必须小写;两项版本属性省略时分别为空对象和空列表,不继承上一版本。取代原 ChangeRegistryRecordStableVersion / RollbackRegistryRecordVersion / Create*RegistryRecordVersion。
289
307
  */
290
308
  async UpdateRegistryRecord(req, cb) {
291
309
  return this.request("UpdateRegistryRecord", req, cb);
@@ -302,6 +320,12 @@ class Client extends TencentCloudCommon.AbstractClient {
302
320
  async PauseSandboxInstance(req, cb) {
303
321
  return this.request("PauseSandboxInstance", req, cb);
304
322
  }
323
+ /**
324
+ * 同步删除当前租户的空 GPU 资源组。资源组内不能存在交付中、已生效、已隔离、销毁中或其他未完成清理的 GPU 实例,也不能有剩余占用绑定或未删除的关联沙箱工具,否则返回 ResourceInUse。已销毁或补偿清理完成的历史记录不阻止删除。同租户重复删除已删除的资源组返回成功;资源组不存在或不属于当前租户时返回 ResourceNotFound。本接口仅软删除资源组,不执行退订退款、停止沙箱或释放底层 VM,历史计费记录保留。
325
+ */
326
+ async DeleteGPUResourceGroup(req, cb) {
327
+ return this.request("DeleteGPUResourceGroup", req, cb);
328
+ }
305
329
  /**
306
330
  * 创建会话。
307
331
 
@@ -379,6 +403,12 @@ class Client extends TencentCloudCommon.AbstractClient {
379
403
  async DescribeSession(req, cb) {
380
404
  return this.request("DescribeSession", req, cb);
381
405
  }
406
+ /**
407
+ * 仅同步修改当前租户 GPU 资源组的名称,允许重名、同名重试;不修改规格、数量、计费期限或续费标记。不存在或不属于当前租户的资源组返回 ResourceNotFound。
408
+ */
409
+ async ModifyGPUResourceGroup(req, cb) {
410
+ return this.request("ModifyGPUResourceGroup", req, cb);
411
+ }
382
412
  /**
383
413
  * 本接口用于查询当前账号在指定地域的事件列表,支持按事件来源、资源对象、事件类型、事件级别及时间范围等条件筛选,并支持分页和时间排序。默认查询最近 1 小时的事件,支持查询最近 7 天内的事件。
384
414
  */
@@ -7,6 +7,47 @@ export interface DeleteSessionSpaceResponse {
7
7
  */
8
8
  RequestId?: string;
9
9
  }
10
+ /**
11
+ * 已购买GPU资源详细信息
12
+ */
13
+ export interface GPUResource {
14
+ /**
15
+ * <p>GPU 资源 ID,与沙箱 InstanceId、底层 VM ID 不同。</p>
16
+ */
17
+ ResourceId?: string;
18
+ /**
19
+ * <p>所属 GPU 资源组 ID。</p>
20
+ */
21
+ ResourceGroupId?: string;
22
+ /**
23
+ * <p>GPU资源状态,大小写敏感:Delivering(准备中)、Active(已生效)、Isolated(已隔离)、Destroying(释放中)。不返回 Destroyed 和补偿完成的 Failed。</p>
24
+ */
25
+ State?: string;
26
+ /**
27
+ * <p>占用状态,大小写敏感:Idle(可领取)、Allocating(领取中)、InUse(使用中)、Returning(归还中)、Unavailable(暂不可用)。不能根据 InstanceId 是否存在判断是否空闲。</p>
28
+ */
29
+ AllocationState?: string;
30
+ /**
31
+ * <p>已绑定的最终 AGS 沙箱实例 ID;尚未绑定或未占用时可能不返回。</p>
32
+ */
33
+ InstanceId?: string;
34
+ /**
35
+ * <p>生效时间,未生效时可能不返回。</p>
36
+ */
37
+ ActiveAt?: string;
38
+ /**
39
+ * <p>到期时间,未生效时可能不返回。</p>
40
+ */
41
+ ExpireAt?: string;
42
+ /**
43
+ * <p>续费标记:0 不自动续费,1 自动续费,2 不再续费。</p>
44
+ */
45
+ RenewFlag?: number;
46
+ /**
47
+ * <p>安全的状态原因标识;空串表示无额外原因,PhysicalUnavailable 表示物理状态不可用,BindingPending 表示绑定身份尚待确认。未知值应作状态确认中处理。</p>
48
+ */
49
+ StatusReason?: string;
50
+ }
10
51
  /**
11
52
  * Deployment 对 Sandbox Instance 的亲和配置。
12
53
  */
@@ -82,6 +123,27 @@ export interface DescribeRegistryRecordResponse {
82
123
  */
83
124
  RequestId?: string;
84
125
  }
126
+ /**
127
+ * 资源状态计数;四项之和为组内 TotalCount,不含已销毁和补偿完成的失败资源。
128
+ */
129
+ export interface GPUResourceStateCount {
130
+ /**
131
+ * <p>准备中的资源数量,单位台。</p>
132
+ */
133
+ Delivering?: number;
134
+ /**
135
+ * <p>已生效的资源数量,单位台;不等于当前可领取数量。</p>
136
+ */
137
+ Active?: number;
138
+ /**
139
+ * <p>已隔离的资源数量,单位台。</p>
140
+ */
141
+ Isolated?: number;
142
+ /**
143
+ * <p>正在释放的资源数量,单位台。</p>
144
+ */
145
+ Destroying?: number;
146
+ }
85
147
  /**
86
148
  * DescribeQuotaOverview请求参数结构体
87
149
  */
@@ -163,6 +225,10 @@ export interface QuotaResourceInfo {
163
225
  * <p>内存配额或当前用量</p><p>单位:GiB</p>
164
226
  */
165
227
  MemoryGiB?: number;
228
+ /**
229
+ * <p>最大镜像预热并发处理数量</p><p>单位:个</p>
230
+ */
231
+ PreCacheImageConcurrency?: number;
166
232
  }
167
233
  /**
168
234
  * ResumeSandboxInstance请求参数结构体
@@ -228,6 +294,35 @@ export interface HarnessVersionReference {
228
294
  */
229
295
  HarnessEngineVersion: string;
230
296
  }
297
+ /**
298
+ * 已购买 GPU 资源组的固定规格及展示元数据。
299
+ */
300
+ export interface GPUResourceGroupSpec {
301
+ /**
302
+ * <p>GPU 类型标识,例如 5090d。</p>
303
+ */
304
+ GPUType?: string;
305
+ /**
306
+ * <p>GPU 类型展示名称;为空时使用 GPUType 展示。</p>
307
+ */
308
+ GPUTypeAlias?: string;
309
+ /**
310
+ * <p>单台实例全部 GPU 的总显存,单位 GiB;不需要再乘 GPUNum。0 表示展示元数据未维护。</p>
311
+ */
312
+ GPUMemoryGiB?: number;
313
+ /**
314
+ * <p>单台实例 CPU 核数。</p>
315
+ */
316
+ CPU?: number;
317
+ /**
318
+ * <p>单台实例主机内存,单位 GiB;不是 GPU 显存。</p>
319
+ */
320
+ Memory?: number;
321
+ /**
322
+ * <p>单台实例的 GPU 卡数。</p>
323
+ */
324
+ GPUNum?: number;
325
+ }
231
326
  /**
232
327
  * Registry Record 对象。Record 只保存元数据;协议描述符与内容状态请通过 Version 相关接口获取。
233
328
  */
@@ -263,37 +358,37 @@ export interface CloudRecord {
263
358
  */
264
359
  LifecycleStatus: string;
265
360
  /**
266
- * <p>所属租户 AppId。</p>
361
+ * <p>创建时间,ISO 8601 UTC。</p>
267
362
  注意:此字段可能返回 null,表示取不到有效值。
268
363
  */
269
- AppId: number;
364
+ CreateTime: string;
270
365
  /**
271
- * <p>创建者主账号 UIN。</p>
366
+ * <p>最近一次更新时间。</p>
272
367
  注意:此字段可能返回 null,表示取不到有效值。
273
368
  */
274
- CreatorUin: string;
369
+ UpdateTime: string;
275
370
  /**
276
- * <p>创建者子账号 UIN;主账号直接创建时为空。</p>
371
+ * <p>所属租户 AppId。</p><p>普通模式返回,MARKETPLACE 模式不返回。</p>
277
372
  注意:此字段可能返回 null,表示取不到有效值。
278
373
  */
279
- CreatorSubAccountUin: string;
374
+ AppId?: number;
280
375
  /**
281
- * <p>创建时间,ISO 8601 UTC。</p>
376
+ * <p>创建者主账号 UIN。</p><p>普通模式返回,MARKETPLACE 模式不返回。</p>
282
377
  注意:此字段可能返回 null,表示取不到有效值。
283
378
  */
284
- CreateTime: string;
379
+ CreatorUin?: string;
285
380
  /**
286
- * <p>最近一次更新时间。</p>
381
+ * <p>创建者子账号 UIN;主账号直接创建时为空。</p><p>普通模式返回,MARKETPLACE 模式不返回。</p>
287
382
  注意:此字段可能返回 null,表示取不到有效值。
288
383
  */
289
- UpdateTime: string;
384
+ CreatorSubAccountUin?: string;
290
385
  /**
291
- * <p>Record 下未删除 Version 数量。</p>
386
+ * <p>Record 下未删除 Version 数量。</p><p>MARKETPLACE 模式仅统计市场可读版本。</p>
292
387
  注意:此字段可能返回 null,表示取不到有效值。
293
388
  */
294
389
  VersionCount?: number;
295
390
  /**
296
- * <p>Record 下所有 Label Name(含未绑定 Label),包括系统 Label(stable / latest)和自定义 Label。仅名称,不含 VersionId、更新时间或操作者。</p>
391
+ * <p>Record 下所有 Label Name(含未绑定 Label),包括系统 Label(stable / latest)和自定义 Label。仅名称,不含 VersionId、更新时间或操作者。</p><p>MARKETPLACE 模式仅统计市场可读版本。</p>
297
392
  注意:此字段可能返回 null,表示取不到有效值。
298
393
  */
299
394
  LabelSet?: Array<string>;
@@ -374,7 +469,7 @@ export interface DNSConfig {
374
469
  */
375
470
  export interface DescribeRegistryRecordListRequest {
376
471
  /**
377
- * <p>父 Registry ID。</p>
472
+ * <p>RegistryId 必填。大写常量 MARKETPLACE 表示服务端主 YAML marketplace.registry_ids 配置的工具市场;真实 reg-xxx 表示具体 Registry。省略、空字符串、null 或其他大小写均拒绝。市场读取要求已认证身份,只返回配置来源内未删除、已审批的可读版本,文件还须 READY 和有效制品;不回退私有目录。</p>
378
473
  */
379
474
  RegistryId: string;
380
475
  /**
@@ -571,6 +666,15 @@ export interface AcquireSandboxInstanceTokenRequest {
571
666
  */
572
667
  InstanceId: string;
573
668
  }
669
+ /**
670
+ * ModifyGPUResourceGroup返回参数结构体
671
+ */
672
+ export interface ModifyGPUResourceGroupResponse {
673
+ /**
674
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
675
+ */
676
+ RequestId?: string;
677
+ }
574
678
  /**
575
679
  * Record 的版本信息,包含不可变描述符、来源配置与审批状态。DescribeRegistryRecordVersionList 另返回所属 Record 当前的 Name、Description、DescriptorType 展示投影;这些展示字段不属于版本快照,其他接口可不返回。
576
680
  */
@@ -1180,6 +1284,23 @@ export interface CfsStorageSource {
1180
1284
  */
1181
1285
  Path?: string;
1182
1286
  }
1287
+ /**
1288
+ * DescribeGPUResourceSpecs返回参数结构体
1289
+ */
1290
+ export interface DescribeGPUResourceSpecsResponse {
1291
+ /**
1292
+ * <p>可售规格与额度列表;无可售规格时为 []。</p>
1293
+ */
1294
+ GPUResourceSpecSet?: Array<GPUResourceSpec>;
1295
+ /**
1296
+ * <p>筛选后、分页前的总数。</p>
1297
+ */
1298
+ TotalCount?: number;
1299
+ /**
1300
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1301
+ */
1302
+ RequestId?: string;
1303
+ }
1183
1304
  /**
1184
1305
  * 对 VolumeTemplate 的引用
1185
1306
  */
@@ -1243,50 +1364,33 @@ export interface DescribeSandboxToolListResponse {
1243
1364
  RequestId?: string;
1244
1365
  }
1245
1366
  /**
1246
- * 会话信息
1367
+ * DescribeGPUResourceSpecs请求参数结构体
1247
1368
  */
1248
- export interface SessionInfo {
1249
- /**
1250
- * <p>会话 ID。</p>
1251
- */
1252
- SessionId?: string;
1369
+ export interface DescribeGPUResourceSpecsRequest {
1253
1370
  /**
1254
- * <p>会话所属空间 ID。</p>
1371
+ * <p>GPU 类型标识,例如 5090d;指定时必须同时提供 CPU、Memory、GPUNum。</p>
1255
1372
  */
1256
- SpaceId?: string;
1373
+ GPUType?: string;
1257
1374
  /**
1258
- * <p>Session 快照状态</p>
1375
+ * <p>CPU 核数,必须为正数;与 GPUType、Memory、GPUNum 同时提供。</p>
1259
1376
  */
1260
- State?: SessionState;
1377
+ CPU?: number;
1261
1378
  /**
1262
- * <p>会话元数据,以键值对数组形式表示。每个元素包含 Metadata 名称和对应值,最多支持 64 项。</p>
1379
+ * <p>主机内存 GiB,必须为正数;与 GPUType、CPU、GPUNum 同时提供。</p>
1263
1380
  */
1264
- Metadata?: Array<MetadataVar>;
1381
+ Memory?: number;
1265
1382
  /**
1266
- * <p>Agent ID。</p>
1267
- * @deprecated
1383
+ * <p>单台 GPU 卡数,必须为正整数;与 GPUType、CPU、Memory 同时提供。</p>
1268
1384
  */
1269
- AgentId?: string;
1385
+ GPUNum?: number;
1270
1386
  /**
1271
- * <p>用户 ID。</p>
1272
- */
1273
- UserId?: string;
1274
- /**
1275
- * <p>会话标题。</p>
1276
- */
1277
- Title?: string;
1278
- /**
1279
- * <p>事件数量。</p>
1280
- */
1281
- EventCount?: number;
1282
- /**
1283
- * <p>创建时间。</p>
1387
+ * <p>分页偏移量,默认为 0,必须大于等于 0。</p>
1284
1388
  */
1285
- CreateTime?: string;
1389
+ Offset?: number;
1286
1390
  /**
1287
- * <p>更新时间。</p>
1391
+ * <p>每页条数,省略或传 0 时取 100;非零取值范围 1–500。</p>
1288
1392
  */
1289
- UpdateTime?: string;
1393
+ Limit?: number;
1290
1394
  }
1291
1395
  /**
1292
1396
  * CreateSandboxSnapshot返回参数结构体
@@ -1301,6 +1405,23 @@ export interface CreateSandboxSnapshotResponse {
1301
1405
  */
1302
1406
  RequestId?: string;
1303
1407
  }
1408
+ /**
1409
+ * DescribeGPUResourceGroups返回参数结构体
1410
+ */
1411
+ export interface DescribeGPUResourceGroupsResponse {
1412
+ /**
1413
+ * 匹配的资源组列表;无匹配时为 []。
1414
+ */
1415
+ ResourceGroups?: Array<GPUResourceGroup>;
1416
+ /**
1417
+ * 匹配的资源组总数,分页前计算。
1418
+ */
1419
+ TotalCount?: number;
1420
+ /**
1421
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1422
+ */
1423
+ RequestId?: string;
1424
+ }
1304
1425
  /**
1305
1426
  * DescribeQuotaOverview返回参数结构体
1306
1427
  */
@@ -1355,7 +1476,7 @@ export interface InlineDataInfo {
1355
1476
  */
1356
1477
  export interface DescribeRegistryRecordRequest {
1357
1478
  /**
1358
- * <p>父 Registry ID。</p>
1479
+ * <p>RegistryId 必填。大写常量 MARKETPLACE 表示服务端主 YAML marketplace.registry_ids 配置的工具市场;真实 reg-xxx 表示具体 Registry。省略、空字符串、null 或其他大小写均拒绝。市场读取要求已认证身份,只返回配置来源内未删除、已审批的可读版本,文件还须 READY 和有效制品;不回退私有目录。</p>
1359
1480
  */
1360
1481
  RegistryId: string;
1361
1482
  /**
@@ -1586,17 +1707,17 @@ export interface CreateRegistryRecordResponse {
1586
1707
  */
1587
1708
  Version?: CloudRecordVersion;
1588
1709
  /**
1589
- * <p>SkillSource.Type=TAR_PACKAGE 时返回:TAR 包上传预签名 URL。</p>
1710
+ * <p>文件上传预签名 URL。使用文件上传方式创建 Skill 或 Plugin 版本时返回;Plugin 文件使用 application/octet-stream 上传。</p>
1590
1711
  注意:此字段可能返回 null,表示取不到有效值。
1591
1712
  */
1592
1713
  UploadURL?: string;
1593
1714
  /**
1594
- * <p>SkillSource.Type=TAR_PACKAGE 时返回:UploadURL 过期时间,ISO 8601 UTC。</p>
1715
+ * <p>文件上传链接的过期时间,使用文件上传方式创建 Skill 或 Plugin 版本时返回。</p><p>参数格式:ISO 8601 UTC,例如 2026-10-21T15:30:08Z。</p>
1595
1716
  注意:此字段可能返回 null,表示取不到有效值。
1596
1717
  */
1597
1718
  ExpireTime?: string;
1598
1719
  /**
1599
- * <p>SkillSource.Type=TAR_PACKAGE 时返回:Version 内容当前状态(UPLOADING 等)。</p>
1720
+ * <p>文件版本的内容状态,使用文件上传方式创建 Skill 或 Plugin 版本时返回。创建上传会话后通常为 UPLOADING;文件处理完成后为 READY,失败为 FAILED。</p>
1600
1721
  注意:此字段可能返回 null,表示取不到有效值。
1601
1722
  */
1602
1723
  ContentStatus?: string;
@@ -1660,21 +1781,50 @@ export interface DescribePreCacheImageListResponse {
1660
1781
  RequestId?: string;
1661
1782
  }
1662
1783
  /**
1663
- * UpdateSandboxInstance请求参数结构体
1784
+ * 会话信息
1664
1785
  */
1665
- export interface UpdateSandboxInstanceRequest {
1786
+ export interface SessionInfo {
1666
1787
  /**
1667
- * <p>沙箱实例ID</p>
1788
+ * <p>会话 ID。</p>
1668
1789
  */
1669
- InstanceId: string;
1790
+ SessionId?: string;
1670
1791
  /**
1671
- * 手动设置实例还需运行多久,如 5m、300s、1h。未传入时保持原设置;传入后从本次设置开始重新计时。仅正在运行、且未设置为永久运行的实例可修改。修改时不会缩短已获得的自动续期时间。
1792
+ * <p>会话所属空间 ID。</p>
1672
1793
  */
1673
- Timeout?: string;
1794
+ SpaceId?: string;
1674
1795
  /**
1675
- * 实例元数据。
1796
+ * <p>Session 快照状态</p>
1797
+ */
1798
+ State?: SessionState;
1799
+ /**
1800
+ * <p>会话元数据,以键值对数组形式表示。每个元素包含 Metadata 名称和对应值,最多支持 64 项。</p>
1676
1801
  */
1677
1802
  Metadata?: Array<MetadataVar>;
1803
+ /**
1804
+ * <p>Agent ID。</p>
1805
+ * @deprecated
1806
+ */
1807
+ AgentId?: string;
1808
+ /**
1809
+ * <p>用户 ID。</p>
1810
+ */
1811
+ UserId?: string;
1812
+ /**
1813
+ * <p>会话标题。</p>
1814
+ */
1815
+ Title?: string;
1816
+ /**
1817
+ * <p>事件数量。</p>
1818
+ */
1819
+ EventCount?: number;
1820
+ /**
1821
+ * <p>创建时间。</p>
1822
+ */
1823
+ CreateTime?: string;
1824
+ /**
1825
+ * <p>更新时间。</p>
1826
+ */
1827
+ UpdateTime?: string;
1678
1828
  }
1679
1829
  /**
1680
1830
  * ModifySession请求参数结构体
@@ -1747,29 +1897,25 @@ export interface CustomConfiguration {
1747
1897
  SecurityContext?: SecurityContext;
1748
1898
  }
1749
1899
  /**
1750
- * SyncRegistryRecord请求参数结构体
1900
+ * GPU 资源组元数据及统计;资源组是管理集合,期限和续费标记逐台保存。
1751
1901
  */
1752
- export interface SyncRegistryRecordRequest {
1753
- /**
1754
- * <p>父 Registry ID。</p>
1755
- */
1756
- RegistryId: string;
1902
+ export interface GPUResourceGroup {
1757
1903
  /**
1758
- * <p>Record ID。</p>
1904
+ * GPU 资源组 ID。
1759
1905
  */
1760
- RecordId: string;
1906
+ ResourceGroupId?: string;
1761
1907
  /**
1762
- * <p>可选。指定要同步的目标 Version;与 Label 互斥;均省略时使用 Stable。</p>
1908
+ * 资源组名称。
1763
1909
  */
1764
- VersionId?: string;
1910
+ Name?: string;
1765
1911
  /**
1766
- * <p>可选。指定要同步的目标 Label;与 VersionId 互斥;均省略时使用 Stable。Label 在请求开始时只解析一次。</p>
1912
+ * 资源组固定规格;已下架规格的已购组仍可查询。
1767
1913
  */
1768
- Label?: string;
1914
+ Spec?: GPUResourceGroupSpec;
1769
1915
  /**
1770
- * <p>可选,最大 4096 字符。若同步创建新 Version,将写入新 Version 的 ChangeLog;省略时保存为空。</p>
1916
+ * 当前资源统计。
1771
1917
  */
1772
- ChangeLog?: string;
1918
+ Statistics?: GPUResourceGroupStatistics;
1773
1919
  }
1774
1920
  /**
1775
1921
  * 日志源配置
@@ -1781,6 +1927,19 @@ export interface LogSources {
1781
1927
  */
1782
1928
  Files?: Array<string>;
1783
1929
  }
1930
+ /**
1931
+ * ModifyGPUResourceGroup请求参数结构体
1932
+ */
1933
+ export interface ModifyGPUResourceGroupRequest {
1934
+ /**
1935
+ * GPU 资源组 ID,必填、非空,最多 64 字节。
1936
+ */
1937
+ ResourceGroupId: string;
1938
+ /**
1939
+ * 新的资源组名称;去除首尾空白后不能为空,最多 128 字节,UTF-8 中文通常占 3 字节。
1940
+ */
1941
+ Name: string;
1942
+ }
1784
1943
  /**
1785
1944
  * DescribeRegistry请求参数结构体
1786
1945
  */
@@ -1803,6 +1962,23 @@ export interface DeleteRegistryResponse {
1803
1962
  * DescribeAPIKeyList请求参数结构体
1804
1963
  */
1805
1964
  export type DescribeAPIKeyListRequest = null;
1965
+ /**
1966
+ * UpdateSandboxInstance请求参数结构体
1967
+ */
1968
+ export interface UpdateSandboxInstanceRequest {
1969
+ /**
1970
+ * <p>沙箱实例ID</p>
1971
+ */
1972
+ InstanceId: string;
1973
+ /**
1974
+ * 手动设置实例还需运行多久,如 5m、300s、1h。未传入时保持原设置;传入后从本次设置开始重新计时。仅正在运行、且未设置为永久运行的实例可修改。修改时不会缩短已获得的自动续期时间。
1975
+ */
1976
+ Timeout?: string;
1977
+ /**
1978
+ * 实例元数据。
1979
+ */
1980
+ Metadata?: Array<MetadataVar>;
1981
+ }
1806
1982
  /**
1807
1983
  * DescribeSandboxInstanceList返回参数结构体
1808
1984
  */
@@ -1916,6 +2092,35 @@ export interface CreateSessionSpaceResponse {
1916
2092
  */
1917
2093
  RequestId?: string;
1918
2094
  }
2095
+ /**
2096
+ * DescribeGPUResources请求参数结构体
2097
+ */
2098
+ export interface DescribeGPUResourcesRequest {
2099
+ /**
2100
+ * <p>按资源组 ID 过滤,可省略,最多 64 字节。</p>
2101
+ */
2102
+ ResourceGroupId?: string;
2103
+ /**
2104
+ * <p>按GPU资源 ID 过滤,最多 500 个,每个为非空字符串且最多 64 字节;值之间为 OR,与其他条件为 AND。</p>
2105
+ */
2106
+ ResourceIds?: Array<string>;
2107
+ /**
2108
+ * <p>按GPU状态过滤,可省略。大小写敏感:Delivering、Active、Isolated、Destroying。</p>
2109
+ */
2110
+ State?: string;
2111
+ /**
2112
+ * <p>按占用状态过滤,可省略。大小写敏感:Idle、Allocating、InUse、Returning、Unavailable。</p>
2113
+ */
2114
+ AllocationState?: string;
2115
+ /**
2116
+ * <p>分页偏移量,默认为 0,必须大于等于 0。</p>
2117
+ */
2118
+ Offset?: number;
2119
+ /**
2120
+ * <p>每页条数,省略或传 0 时取 100;非零取值范围 1–500。</p>
2121
+ */
2122
+ Limit?: number;
2123
+ }
1919
2124
  /**
1920
2125
  * 沙箱工具日志推送CLS相关配置
1921
2126
  */
@@ -1938,6 +2143,31 @@ export interface UpdateRegistryRequest {
1938
2143
  */
1939
2144
  Description: string;
1940
2145
  }
2146
+ /**
2147
+ * SyncRegistryRecord请求参数结构体
2148
+ */
2149
+ export interface SyncRegistryRecordRequest {
2150
+ /**
2151
+ * <p>父 Registry ID。</p>
2152
+ */
2153
+ RegistryId: string;
2154
+ /**
2155
+ * <p>Record ID。</p>
2156
+ */
2157
+ RecordId: string;
2158
+ /**
2159
+ * <p>可选。指定要同步的目标 Version;与 Label 互斥;均省略时使用 Stable。</p>
2160
+ */
2161
+ VersionId?: string;
2162
+ /**
2163
+ * <p>可选。指定要同步的目标 Label;与 VersionId 互斥;均省略时使用 Stable。Label 在请求开始时只解析一次。</p>
2164
+ */
2165
+ Label?: string;
2166
+ /**
2167
+ * <p>可选,最大 4096 字符。若同步创建新 Version,将写入新 Version 的 ChangeLog;省略时保存为空。</p>
2168
+ */
2169
+ ChangeLog?: string;
2170
+ }
1941
2171
  /**
1942
2172
  * DescribeSessions返回参数结构体
1943
2173
  */
@@ -2189,6 +2419,18 @@ export interface UpdateRegistryRecordRequest {
2189
2419
  * <p>Record 更新模式:Label 变更列表,最多 32 条,同一次请求中 Label Name 不可重复。</p>
2190
2420
  */
2191
2421
  LabelMutations?: Array<CloudRecordLabelMutation>;
2422
+ /**
2423
+ * <p>Skill 或 Plugin 后续版本的文件来源。PLUGIN 可使用 FILE 上传新文件,或使用 VERSION 复用同一 Record 的 READY 制品;Skill 仅通过 VERSION 复用现有文件。与其他内容来源互斥。</p><p>VERSION 只提交 Type、SourceVersionId;Metadata 和 SupportedHarnessVersions 由本次请求单独声明,不继承来源版本。</p>
2424
+ */
2425
+ FileSource?: CloudFileSourceInput;
2426
+ /**
2427
+ * <p>资产版本支持的 Harness 引擎与具体版本列表。每个元素同时包含 HarnessEngine 和 HarnessEngineVersion,取值原样使用 DescribeHarnessEngineList 返回的选项。</p><p>入参限制:最多 128 个元素;两个字段均必填,长度 1~128,区分大小写,不允许空白、通配符或版本范围。按完整配对去重;不接受字符串数组或 null。</p><p>省略或空数组表示未声明兼容性,不表示兼容全部。仅随新 Version 写入,后续修改需创建新 Version。筛选时 supported_harness_engine 与 supported_harness_version 必须同时传入,并在同一元素中精确匹配。</p>
2428
+ */
2429
+ SupportedHarnessVersions?: Array<HarnessVersionReference>;
2430
+ /**
2431
+ * <p>版本元数据的 Name/Value 对象数组。</p><p>参数格式:每项仅包含必填的 Name、Value 两个字符串字段。Name 非空、小写且数组内唯一,不自动转换;重复 Name 即使 Value 相同也返回 InvalidParameter。Value 允许空字符串,保留大小写;不接受嵌套对象、数组或非字符串值。</p><p>默认值:空数组 []。创建新版本时省略或 [] 均为空,不继承;null、JSON 字符串和原生对象非法。响应按 Name 升序返回,旧 SQL NULL 归一为 []。服务内部使用 map[string]string,数据库 JSON 列保存对象。publisher 表示发布者展示名称;metadata.&lt;key&gt; 按完整小写名称精确筛选,规则不变。</p>
2432
+ */
2433
+ Metadata?: Array<MetadataEntry>;
2192
2434
  }
2193
2435
  /**
2194
2436
  * DeletePreCacheImage返回参数结构体
@@ -2308,6 +2550,27 @@ export interface DescribeDeploymentListResponse {
2308
2550
  */
2309
2551
  RequestId?: string;
2310
2552
  }
2553
+ /**
2554
+ * 组内当前资源统计。可用/占用是额外维度,不能与 StateCounts 相加。
2555
+ */
2556
+ export interface GPUResourceGroupStatistics {
2557
+ /**
2558
+ * <p>组内当前资源总数,单位台;不含已销毁和补偿完成的失败资源。</p>
2559
+ */
2560
+ TotalCount?: number;
2561
+ /**
2562
+ * <p>Active、无占用且物理状态当前可领取的资源数量,单位台。</p>
2563
+ */
2564
+ AvailableCount?: number;
2565
+ /**
2566
+ * <p>仍被占用或绑定的资源数量,含领取中、使用中及归还未完成,单位台。</p>
2567
+ */
2568
+ AllocatedCount?: number;
2569
+ /**
2570
+ * <p>资源状态计数,四项之和等于本组 TotalCount。</p>
2571
+ */
2572
+ StateCounts?: GPUResourceStateCount;
2573
+ }
2311
2574
  /**
2312
2575
  * DescribeRegistry返回参数结构体
2313
2576
  */
@@ -2522,6 +2785,23 @@ export interface PreCacheImage {
2522
2785
  */
2523
2786
  LastUsedTime?: string;
2524
2787
  }
2788
+ /**
2789
+ * DescribeGPUResources返回参数结构体
2790
+ */
2791
+ export interface DescribeGPUResourcesResponse {
2792
+ /**
2793
+ * <p>GPU 资源列表;每台一条,无匹配时为 []。</p>
2794
+ */
2795
+ Resources?: Array<GPUResource>;
2796
+ /**
2797
+ * <p>筛选后、分页前的总数。</p>
2798
+ */
2799
+ TotalCount?: number;
2800
+ /**
2801
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2802
+ */
2803
+ RequestId?: string;
2804
+ }
2525
2805
  /**
2526
2806
  * Session 快照状态
2527
2807
  */
@@ -2578,6 +2858,23 @@ export interface StartSandboxInstanceResponse {
2578
2858
  */
2579
2859
  RequestId?: string;
2580
2860
  }
2861
+ /**
2862
+ * DescribeGPUResourceGroups请求参数结构体
2863
+ */
2864
+ export interface DescribeGPUResourceGroupsRequest {
2865
+ /**
2866
+ * 过滤条件,最多 10 项,Name 不可重复,每项 Values 为 1–10 个值。不同 Name 为 AND、同一 Values 为 OR。支持 resource-group-id(精确 ID)、resource-group-name(精确名称)、resource-group-name-like(普通文本子串,% 和 _ 不作为通配符)、gpu-type、gpu-num、cpu、memory。ID/GPUType 最多 64 字节,名称最多 128 字节;gpu-num 为正整数字符串,cpu/memory 为正数字符串,单位核/GiB。
2867
+ */
2868
+ Filters?: Array<Filter>;
2869
+ /**
2870
+ * 分页偏移量,默认为 0,必须大于等于 0。
2871
+ */
2872
+ Offset?: number;
2873
+ /**
2874
+ * 每页条数,省略或传 0 时取 100;非零取值范围 1–500。
2875
+ */
2876
+ Limit?: number;
2877
+ }
2581
2878
  /**
2582
2879
  * DescribeSessionSpace请求参数结构体
2583
2880
  */
@@ -3368,7 +3665,7 @@ export interface CreateRegistryRecordRequest {
3368
3665
  */
3369
3666
  Name: string;
3370
3667
  /**
3371
- * <p>协议描述符类型。MCP / A2A / AGUI / CUSTOM / AGENT_SKILLS。Record 创建后不可修改。</p>
3668
+ * <p>资产类型。取值包括 MCP、A2A、AGUI、CUSTOM、AGENT_SKILLS 和 PLUGIN。Record 创建后不可修改。PLUGIN 按通用文件资产保存,由运行端解析和加载。</p>
3372
3669
  */
3373
3670
  DescriptorType: string;
3374
3671
  /**
@@ -3395,6 +3692,18 @@ export interface CreateRegistryRecordRequest {
3395
3692
  * <p>DescriptorType=CUSTOM 时必填,其他类型禁止。内容必须是 JSON object 字符串;服务端解析后写入 CloudRecordVersion.Descriptors,Version 的 SourceType 固定为 MANUAL、SourceConfig 固定为空对象。</p>
3396
3693
  */
3397
3694
  CustomDescriptors?: string;
3695
+ /**
3696
+ * <p>Plugin 通用文件来源。DescriptorType=PLUGIN 时必填,其他类型禁止。</p><p>入参限制:Create 仅支持 Type=FILE;声明 SizeBytes 为 1..54525952 字节,可选 SHA256 为 64 位小写十六进制摘要。</p><p>Registry 保存原始文件,不校验插件内容格式或语义;由运行端解析和加载。Skill 继续使用原 SkillSource。</p>
3697
+ */
3698
+ FileSource?: CloudFileSourceInput;
3699
+ /**
3700
+ * <p>本版本支持的 HarnessVersionReference 对象列表;每项包含 HarnessEngine 和 HarnessEngineVersion,原样使用 DescribeHarnessEngineList 返回的选项。</p><p>入参限制:两个字段均必填,各为 1 至 128 字符的精确值,区分大小写,不含空白、通配符或版本范围;最多 128 项,按引擎与版本二元组去重。不接受旧字符串数组、null、缺少字段或额外字段。</p><p>省略或空数组表示未声明,不继承前一版本,不代表支持所有 Harness。兼容性按同一对象的引擎与版本共同判断。修改兼容声明需创建新 Version,文件资产可通过 FileSource.Type=VERSION 复用制品。</p>
3701
+ */
3702
+ SupportedHarnessVersions?: Array<HarnessVersionReference>;
3703
+ /**
3704
+ * <p>版本元数据的 Name/Value 对象数组。</p><p>参数格式:每项仅包含必填的 Name、Value 两个字符串字段。Name 非空、小写且数组内唯一,不自动转换;重复 Name 即使 Value 相同也返回 InvalidParameter。Value 允许空字符串,保留大小写;不接受嵌套对象、数组或非字符串值。</p><p>默认值:空数组 []。创建新版本时省略或 [] 均为空,不继承;null、JSON 字符串和原生对象非法。响应按 Name 升序返回,旧 SQL NULL 归一为 []。服务内部使用 map[string]string,数据库 JSON 列保存对象。publisher 表示发布者展示名称;metadata.&lt;key&gt; 按完整小写名称精确筛选,规则不变。</p>
3705
+ */
3706
+ Metadata?: Array<MetadataEntry>;
3398
3707
  }
3399
3708
  /**
3400
3709
  * DescribeEventCenterEvents返回参数结构体
@@ -3438,6 +3747,40 @@ export interface ModifySessionResponse {
3438
3747
  */
3439
3748
  RequestId?: string;
3440
3749
  }
3750
+ /**
3751
+ * 当前地域可售 GPU 规格与当前租户可购买额度。
3752
+ */
3753
+ export interface GPUResourceSpec {
3754
+ /**
3755
+ * <p>GPU 类型标识,例如 5090d。</p>
3756
+ */
3757
+ GPUType?: string;
3758
+ /**
3759
+ * <p>GPU 类型展示名称;为空时使用 GPUType 展示。</p>
3760
+ */
3761
+ GPUTypeAlias?: string;
3762
+ /**
3763
+ * <p>单台实例全部 GPU 的总显存,单位 GiB;不需要再乘 GPUNum。0 表示展示元数据未维护。</p>
3764
+ */
3765
+ GPUMemoryGiB?: number;
3766
+ /**
3767
+ * <p>单台实例 CPU 核数。</p>
3768
+ */
3769
+ CPU?: number;
3770
+ /**
3771
+ * <p>单台实例主机内存,单位 GiB;不是 GPU 显存。</p>
3772
+ */
3773
+ Memory?: number;
3774
+ /**
3775
+ * <p>单台实例的 GPU 卡数。</p>
3776
+ */
3777
+ GPUNum?: number;
3778
+ /**
3779
+ * <p>当前可购买数量,单位台,不是卡数;0 表示确认无额度,null 表示额度未知。实际购买时仍会重新校验。</p>
3780
+ 注意:此字段可能返回 null,表示取不到有效值。
3781
+ */
3782
+ AvailableCount?: number;
3783
+ }
3441
3784
  /**
3442
3785
  * UpdateSandboxInstance返回参数结构体
3443
3786
  */
@@ -3785,6 +4128,15 @@ export interface LifecycleConfiguration {
3785
4128
  */
3786
4129
  IdleAction?: string;
3787
4130
  }
4131
+ /**
4132
+ * DeleteGPUResourceGroup返回参数结构体
4133
+ */
4134
+ export interface DeleteGPUResourceGroupResponse {
4135
+ /**
4136
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
4137
+ */
4138
+ RequestId?: string;
4139
+ }
3788
4140
  /**
3789
4141
  * PreviewRegistryRecord请求参数结构体
3790
4142
  */
@@ -3917,6 +4269,27 @@ export interface DescribeSandboxInstancesResponse {
3917
4269
  */
3918
4270
  RequestId?: string;
3919
4271
  }
4272
+ /**
4273
+ * 通用文件来源。FILE 用于 Plugin 原始文件上传,SizeBytes 必填,SHA256 可选;VERSION 仅用于 UpdateRegistryRecord 复用同一 Record 的 READY 文件版本,仅填写 SourceVersionId。与其他来源互斥,不校验插件格式或语义。
4274
+ */
4275
+ export interface CloudFileSourceInput {
4276
+ /**
4277
+ * <p>通用文件来源类型,区分大小写。</p><p>枚举值:</p><ul><li>FILE: 创建 Plugin 文件版本,必须填写 SizeBytes,SHA256 可选;随后通过预签名 PUT 链接上传原始文件。</li><li>VERSION: 仅 UpdateRegistryRecord 支持,复用同一 Skill 或 Plugin Record 的 READY 文件版本,仅填写 SourceVersionId。</li></ul><p>Registry 不做 Plugin 文件内容格式或语义校验,由运行端解析加载。VERSION 不继承来源版本的 Metadata 和 SupportedHarnessVersions。</p>
4278
+ */
4279
+ Type: string;
4280
+ /**
4281
+ * <p>待上传 Plugin 文件的原始字节数。FILE 时必填,VERSION 时禁止填写。</p><p>取值范围:[1, 54525952]</p><p>单位:字节</p><p>上限 52 MiB,服务端校验实际上传文件的字节数;不推断文件格式。</p>
4282
+ */
4283
+ SizeBytes?: number;
4284
+ /**
4285
+ * <p>期望的文件 SHA-256 摘要。FILE 时可选,VERSION 时禁止填写。</p><p>参数格式:64 位小写十六进制字符串。</p><p>提供时服务端计算实际文件摘要并比对;省略时仍计算摘要并在 READY 版本的 ContentSHA256 中返回。</p>
4286
+ */
4287
+ SHA256?: string;
4288
+ /**
4289
+ * <p>用于复用文件内容的来源 Version ID。</p><p>参数格式:rv- 前缀的 Version ID。</p><p>入参限制:VERSION 时必填,FILE 时禁止填写。只能在 UpdateRegistryRecord 中引用同一 Record 下未删除、内容 READY 且存在可用制品的 Skill 或 Plugin 文件版本。</p><p>只复用文件,不继承来源版本的 Metadata 和 SupportedHarnessVersions;不能跨 Record 或跨 Registry 复用。</p>
4290
+ */
4291
+ SourceVersionId?: string;
4292
+ }
3920
4293
  /**
3921
4294
  * CreateRegistry请求参数结构体
3922
4295
  */
@@ -3938,6 +4311,15 @@ export interface CreateRegistryRequest {
3938
4311
  */
3939
4312
  Tags?: Array<CloudTag>;
3940
4313
  }
4314
+ /**
4315
+ * DeleteGPUResourceGroup请求参数结构体
4316
+ */
4317
+ export interface DeleteGPUResourceGroupRequest {
4318
+ /**
4319
+ * 待删除的 GPU 资源组 ID,必填、非空,最多 64 字节。资源组必须属于当前租户,且已清空有效 GPU 实例、占用绑定和关联沙箱工具。
4320
+ */
4321
+ ResourceGroupId: string;
4322
+ }
3941
4323
  /**
3942
4324
  * ModifyDeployment返回参数结构体
3943
4325
  */
@@ -3963,6 +4345,10 @@ export interface CreatePreCacheImageTaskRequest {
3963
4345
  * <p>镜像仓库类型:<code>enterprise</code>、<code>personal</code>、<code>custom</code></p><p>枚举值:</p><ul><li>enterprise: tcr 企业容器镜像服务</li><li>personal: ccr 个人容器镜像服务</li></ul>
3964
4346
  */
3965
4347
  ImageRegistryType: string;
4348
+ /**
4349
+ * <p>镜像预热类型</p><p>枚举值:</p><ul><li>image: 镜像预热</li><li>image_volume: 镜像卷预热</li></ul><p>默认值:image</p>
4350
+ */
4351
+ PreCacheType?: string;
3966
4352
  }
3967
4353
  /**
3968
4354
  * 沙箱工具日志采集相关配置