UNPKG

tencentcloud-sdk-nodejs

Version:
2,079 lines (2,065 loc) 91.8 kB
/** * 集群概览信息。 */ export interface ClusterOverview { /** * 集群ID。 */ ClusterId?: string; /** * 集群状态。取值范围:<li>PENDING:创建中</li><li>INITING:初始化中</li><li>INIT_FAILED:初始化失败</li><li>RUNNING:运行中</li><li>TERMINATING:销毁中</li> */ ClusterStatus?: string; /** * 集群名称。 */ ClusterName?: string; /** * 集群位置信息。 */ Placement?: Placement; /** * 集群创建时间。 */ CreateTime?: string; /** * 集群调度器。 */ SchedulerType?: string; /** * 集群调度器版本。 */ SchedulerVersion?: string; /** * 计算节点数量。 */ ComputeNodeCount?: number; /** * 计算节点概览。 */ ComputeNodeSet?: Array<ComputeNodeOverview>; /** * 管控节点数量。 */ ManagerNodeCount?: number; /** * 管控节点概览。 */ ManagerNodeSet?: Array<ManagerNodeOverview>; /** * 登录节点概览。 */ LoginNodeSet?: Array<LoginNodeOverview>; /** * 登录节点数量。 */ LoginNodeCount?: number; /** * 弹性伸缩类型。 */ AutoScalingType?: string; /** * 集群所属私有网络ID。 */ VpcId?: string; /** * 集群类型 */ ClusterType?: string; /** * 集群销毁保护开关状态,当前支持参数: - ON: 集群销毁保护打开 - OFF: 集群销毁保护关闭 */ DeletionProtection?: string; } /** * ModifyNodeAttribute返回参数结构体 */ export interface ModifyNodeAttributeResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 节点概览信息。 */ export interface NodeOverview { /** * 集群ID */ ClusterId?: string; /** * 节点实例ID。 注意:此字段可能返回 null,表示取不到有效值。 */ InstanceId?: string; /** * 节点所在可用区信息。 注意:此字段可能返回 null,表示取不到有效值。 */ Zone?: string; /** * 节点状态。<li>SUBMITTED:已完成提交。</li><li>CREATING:创建中。</li><li>CREATED:完成创建。</li><li>INITING:初始化中。</li><li>INIT_FAILED:初始化失败。</li><li>RUNNING:运行中。</li><li>DELETING:销毁中。</li> 注意:此字段可能返回 null,表示取不到有效值。 */ NodeState?: string; /** * 镜像ID。 注意:此字段可能返回 null,表示取不到有效值。 */ ImageId?: string; /** * 节点所属队列名称。 注意:此字段可能返回 null,表示取不到有效值。 */ QueueName?: string; /** * 节点角色。<li>Manager:管控节点。</li><li>Compute:计算节点。</li><li>Login:登录节点。</li><li>ManagerBackup:备用管控节点。</li> 注意:此字段可能返回 null,表示取不到有效值。 */ NodeRole?: string; /** * 节点类型。<li>STATIC:静态节点。</li><li>DYNAMIC:弹性节点。</li> 注意:此字段可能返回 null,表示取不到有效值。 */ NodeType?: string; /** * thpc集群节点id 注意:此字段可能返回 null,表示取不到有效值。 */ NodeId?: string; /** * 节点的工作状态 */ NodeAllocateState?: string; /** * 节点的名称 */ NodeName?: string; /** * 节点的创建时间 */ CreateTime?: string; } /** * DescribeInitNodeScripts请求参数结构体 */ export interface DescribeInitNodeScriptsRequest { /** * 集群ID。 */ ClusterId: string; } /** * AddNodes返回参数结构体 */ export interface AddNodesResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 弹性扩容节点配置信息。 */ export interface ExpansionNodeConfig { /** * 扩容实例所在的位置。 */ Placement: Placement; /** * 节点[计费类型](https://cloud.tencent.com/document/product/213/2180)。<br><li>PREPAID:预付费,即包年包月</li><br><li>POSTPAID_BY_HOUR:按小时后付费</li><br><li>SPOTPAID:竞价付费<br>默认值:POSTPAID_BY_HOUR。</li> */ InstanceChargeType?: string; /** * 预付费模式,即包年包月相关参数设置。通过该参数可以指定包年包月节点的购买时长、是否设置自动续费等属性。若指定节点的付费模式为预付费则该参数必传。 */ InstanceChargePrepaid?: InstanceChargePrepaid; /** * 节点机型。不同实例机型指定了不同的资源规格。 <br><li>具体取值可通过调用接口[DescribeInstanceTypeConfigs](https://cloud.tencent.com/document/api/213/15749)来获得最新的规格表或参见[实例规格](https://cloud.tencent.com/document/product/213/11518)描述。</li> */ InstanceType?: string; /** * 私有网络相关信息配置。 */ VirtualPrivateCloud?: VirtualPrivateCloud; /** * 实例所属项目ID。该参数可以通过调用 [DescribeProject](https://cloud.tencent.com/document/api/651/78725) 的返回值中的 projectId 字段来获取。不填为默认项目。 */ ProjectId?: number; } /** * 节点活动信息。 */ export interface NodeActivity { /** * 节点活动所在的实例ID。 注意:此字段可能返回 null,表示取不到有效值。 */ NodeInstanceId?: string; /** * 节点活动状态。取值范围:<br><li>RUNNING:运行中</li><br><li>SUCCESSFUL:活动成功</li><br><li>FAILED:活动失败</li> */ NodeActivityStatus?: string; /** * 节点活动状态码。 注意:此字段可能返回 null,表示取不到有效值。 */ NodeActivityStatusCode?: string; /** * 节点活动状态原因。 注意:此字段可能返回 null,表示取不到有效值。 */ NodeActivityStatusReason?: string; } /** * ModifyClusterDeletionProtection返回参数结构体 */ export interface ModifyClusterDeletionProtectionResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateWorkspaces返回参数结构体 */ export interface CreateWorkspacesResponse { /** * 工作空间ID */ SpaceIdSet?: Array<string>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 描述了工作空间VPC相关信息,包括子网,IP信息等 */ export interface SpaceVirtualPrivateCloud { /** * 私有网络ID */ VpcId: string; /** * 私有网络子网ID */ SubnetId: string; /** * 是否用作公网网关 */ AsVpcGateway?: boolean; /** * 私有网络子网 IP 数组 */ PrivateIpAddresses?: Array<string>; /** * 为弹性网卡指定随机生成 */ Ipv6AddressCount?: number; } /** * 管控节点概览。 */ export interface ManagerNodeOverview { /** * 管控节点ID。 */ NodeId?: string; } /** * DeleteCluster请求参数结构体 */ export interface DeleteClusterRequest { /** * 集群ID。 */ ClusterId: string; } /** * 描述了操作系统所在块设备即系统盘的信息 */ export interface SystemDisk { /** * 系统盘类型。系统盘类型限制详见存储概述。取值范围: CLOUD_BASIC:普通云硬盘 CLOUD_SSD:SSD云硬盘 CLOUD_PREMIUM:高性能云硬盘 默认取值:当前有库存的硬盘类型。 注意:此字段可能返回 null,表示取不到有效值。 */ DiskType?: string; /** * 系统盘大小,单位:GB。默认值为 50 注意:此字段可能返回 null,表示取不到有效值。 */ DiskSize?: number; } /** * 作业任务配置信息。 */ export interface Task { /** * 作业任务的应用环境配置信息。 */ Application: Application; /** * 作业任务名称。 */ TaskName?: string; /** * 作业任务所需的节点数/副本数。 */ TaskInstanceNum?: number; /** * 任务超时时间(单位:秒)。 */ Timeout?: number; } /** * TerminateWorkspaces返回参数结构体 */ export interface TerminateWorkspacesResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyInitNodeScripts请求参数结构体 */ export interface ModifyInitNodeScriptsRequest { /** * 集群ID。 */ ClusterId: string; /** * 节点初始化脚本信息列表。 */ InitNodeScripts?: Array<NodeScript>; } /** * AttachNodes请求参数结构体 */ export interface AttachNodesRequest { /** * <p>集群id</p> */ ClusterId: string; /** * <p>节点的实例id列表</p> */ ResourceSet: Array<string>; /** * <p>队列名称。不指定则为默认队列:<br>SLURM默认队列为:compute。</p> */ QueueName?: string; /** * <p>指定有效的镜像ID,格式形如img-xxx。目前仅支持公有镜像和特定自定义镜像。如不指定,则该字段是默认镜像。</p> */ ImageId?: string; /** * <p>要新增节点的资源类型。<li>CVM:CVM实例类型资源</li><li>WORKSPACE:工作空间类型实例资源</li>默认值:CVM。</p> */ ResourceType?: string; /** * <p>提供给实例使用的用户数据,需要以 base64 方式编码,支持的最大数据大小为 16KB。关于获取此参数的详细介绍,请参阅<a href="https://cloud.tencent.com/document/product/213/17526">Windows</a>和<a href="https://cloud.tencent.com/document/product/213/17525">Linux</a>启动时运行命令。</p> */ UserData?: string; /** * <p>控制实例加入集群是否跳过重装系统</p><p>默认值:False</p> */ SkipResetInstance?: boolean; } /** * 描述了工作空间的计费模式 */ export interface SpaceChargePrepaid { /** * 购买实例的时长,单位:月。取值范围:1, 2, 3, 12, 24, 36。默认取值为1。 注意:此字段可能返回 null,表示取不到有效值。 */ Period?: number; /** * 自动续费标识。取值范围: NOTIFY_AND_AUTO_RENEW:通知过期且自动续费 NOTIFY_AND_MANUAL_RENEW:通知过期不自动续费 DISABLE_NOTIFY_AND_MANUAL_RENEW:不通知过期不自动续费 默认取值:NOTIFY_AND_MANUAL_RENEW。若该参数指定为NOTIFY_AND_AUTO_RENEW,在账户余额充足的情况下,实例到期后将按月自动续费。 注意:此字段可能返回 null,表示取不到有效值。 */ RenewFlag?: string; } /** * DescribeWorkspaces返回参数结构体 */ export interface DescribeWorkspacesResponse { /** * <p>集群概览信息列表</p> */ SpaceSet?: Array<SpaceInfo>; /** * <p>集群数量</p> */ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 标签键值对。 */ export interface Tag { /** * 标签键 */ Key: string; /** * 标签值 */ Value: string; } /** * 描述GooseFS挂载信息 */ export interface GooseFSOption { /** * <p>文件系统本地挂载路径。</p> */ LocalPath: string; /** * <p>文件系统远程挂载路径; 远端路径为GooseFS控制台看到的命名空间的url;命名空间文档参考https://cloud.tencent.com/document/product/1424/117877</p> */ RemotePath: string; /** * <p>文件系统master的ip和端口,此参数和FileSystemId互斥。</p> */ Masters?: Array<string>; /** * <p>GooseFS的文件ID;此参数和Masters 互斥。</p> */ FileSystemId?: string; } /** * 集群存储选项概览信息。 */ export interface StorageOptionOverview { /** * <p>CFS存储选项概览信息列表。</p> */ CFSOptions?: Array<CFSOptionOverview>; /** * <p>GooseFS存储选项概览信息列表。</p> */ GooseFSOptions?: Array<GooseFSOptionOverview>; /** * <p>GooseFSx存储选项概览信息列表。</p> */ GooseFSxOptions?: Array<GooseFSxOptionOverview>; /** * <p>COS存储选项概览信息列表。</p> */ CosOptions?: Array<CosOptionOverview>; } /** * DescribeJobsOverview请求参数结构体 */ export interface DescribeJobsOverviewRequest { /** * 集群ID */ ClusterId: string; } /** * DeleteCluster返回参数结构体 */ export interface DeleteClusterResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeAutoScalingConfiguration返回参数结构体 */ export interface DescribeAutoScalingConfigurationResponse { /** * <p>集群ID。</p> */ ClusterId?: string; /** * <p>任务连续等待时间,队列的任务处于连续等待的时间。单位秒。</p> */ ExpansionBusyTime?: number; /** * <p>节点连续空闲(未运行作业)时间,一个节点连续处于空闲状态时间。</p> */ ShrinkIdleTime?: number; /** * <p>扩容队列配置概览列表。</p> */ QueueConfigs?: Array<QueueConfigOverview>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeClusters请求参数结构体 */ export interface DescribeClustersRequest { /** * 集群ID列表。通过该参数可以指定需要查询信息的集群列表。<br>如果您不指定该参数,则返回Limit数量以内的集群信息。 */ ClusterIds?: Array<string>; /** * 偏移量,默认为0。关于`Offset`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 */ Offset?: number; /** * 返回数量,默认为20,最大值为100。关于`Limit`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 */ Limit?: number; /** * <ul> <li><strong>cluster-type</strong> <p style="padding-left: 30px;">按照【<strong>集群类型</strong>】进行过滤</p> <p style="padding-left: 30px;">类型:String</p> <p style="padding-left: 30px;">必选:否</p> </li> </ul> <p style="padding-left: 30px;">每次请求的`Filters`的上限为10,`Filter.Values`的上限为5。</p> */ Filters?: Array<Filter>; } /** * TerminateJob请求参数结构体 */ export interface TerminateJobRequest { /** * 作业任务ID */ JobId: string; } /** * 创建资源工作空间时同时绑定的标签对说明 */ export interface TagSpecification { /** * 标签绑定的资源类型 */ ResourceType: string; /** * 标签对列表 */ Tags: Array<Tag>; } /** * DeleteNodes返回参数结构体 */ export interface DeleteNodesResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * AddClusterStorageOption返回参数结构体 */ export interface AddClusterStorageOptionResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeWorkspaces请求参数结构体 */ export interface DescribeWorkspacesRequest { /** * <p>集群ID列表。通过该参数可以指定需要查询信息的集群列表。<br>如果您不指定该参数,则返回Limit数量以内的集群信息。</p> */ SpaceIds?: Array<string>; /** * <p>偏移量,默认为0。关于<code>Offset</code>的更进一步介绍请参考 API <a href="https://cloud.tencent.com/document/api/213/15688">简介</a>中的相关小节。</p> */ Offset?: number; /** * <p>返回数量,默认为20,最大值为100。关于<code>Limit</code>的更进一步介绍请参考 API <a href="https://cloud.tencent.com/document/api/213/15688">简介</a>中的相关小节。</p> */ Limit?: number; /** * <ul> <li> <strong>zone</strong> <p style="padding-left: 30px;">按照【<strong>可用区</strong>】进行过滤</p> <p style="padding-left: 30px;">类型:String</p> <p style="padding-left: 30px;">必选:否</p></li> <li> <strong>space-id</strong> <p style="padding-left: 30px;">按照【<strong>工作空间实例ID</strong>】进行过滤</p> <p style="padding-left: 30px;">类型:String</p> <p style="padding-left: 30px;">必选:否</p></li> <li> <strong>cvm-instance-id</strong> <p style="padding-left: 30px;">按照【<strong>CVM实例ID</strong>】进行过滤</p> <p style="padding-left: 30px;">类型:String</p> <p style="padding-left: 30px;">必选:否</p></li> <li> <strong>space-state</strong> <p style="padding-left: 30px;">按照【<strong>工作空间状态</strong>】进行过滤</p> <p style="padding-left: 30px;">类型:String</p> <p style="padding-left: 30px;">必选:否</p></li> <li> <strong>space-name</strong> <p style="padding-left: 30px;">按照【<strong>工作空间别名</strong>】进行过滤</p> <p style="padding-left: 30px;">类型:String</p> <p style="padding-left: 30px;">必选:否</p></li> <li> <strong>space-charge-type</strong> <p style="padding-left: 30px;">按照【<strong>工作空间实例付费模式</strong>】进行过滤</p> <p style="padding-left: 30px;">类型:String</p> <p style="padding-left: 30px;">必选:否</p></li> <li> <strong>tag-key</strong> <p style="padding-left: 30px;">按照【<strong>标签键</strong>】进行过滤</p> <p style="padding-left: 30px;">类型:String</p> <p style="padding-left: 30px;">必选:否</p></li> <li> <strong>tag-value</strong> <p style="padding-left: 30px;">按照【<strong>标签值</strong>】进行过滤</p> <p style="padding-left: 30px;">类型:String</p> <p style="padding-left: 30px;">必选:否</p></li> </ul> <p style="padding-left: 30px;">每次请求的<code>Filters</code>的上限为10,<code>Filter.Values</code>的上限为5。</p> */ Filters?: Array<Filter>; } /** * ModifyNodeAttribute请求参数结构体 */ export interface ModifyNodeAttributeRequest { /** * <p>节点ID,节点ID通过调用接口 <a href="https://cloud.tencent.com/document/api/1527/89569">DescribeNodes</a>获取。</p> */ NodeId: string; /** * <p>节点别名</p> */ NodeName?: string; /** * <p>资源的分配状态: - IDLE: 资源空闲 - ISOLATE: 资源隔离</p> */ NodeAllocateState?: string; /** * <p>目标队列名</p> */ QueueName?: string; } /** * AddQueue请求参数结构体 */ export interface AddQueueRequest { /** * 集群ID。 */ ClusterId: string; /** * 队列名称。<br><li>最多支持32个字符。</li> */ QueueName: string; } /** * 扩容队列配置概览。 */ export interface QueueConfigOverview { /** * 队列名称。 */ QueueName?: string; /** * 队列中弹性节点数量最小值。取值范围0~200。 */ MinSize?: number; /** * 队列中弹性节点数量最大值。取值范围0~200。 */ MaxSize?: number; /** * 是否开启自动扩容。 */ EnableAutoExpansion?: boolean; /** * 是否开启自动缩容。 */ EnableAutoShrink?: boolean; /** * 扩容节点配置信息。 */ ExpansionNodeConfigs?: Array<ExpansionNodeConfigOverview>; /** * 队列中期望的空闲节点数量(包含弹性节点和静态节点)。默认值:0。队列中,处于空闲状态的节点小于此值,集群会扩容弹性节点;处于空闲状态的节点大于此值,集群会缩容弹性节点。 */ DesiredIdleNodeCapacity?: number; /** * 队列中期望的总节点数。 */ DesiredNodeCount?: number; /** * 扩容比例。默认值:100。取值范围:1~100。 如果扩容比例为50,那么每轮只会扩容当前作业负载所需的50%数量的节点。 */ ScaleOutRatio?: number; /** * 比例扩容阈值。默认值:0。取值范围:0~200。 当作业负载需要扩容节点数量大于此值,当前扩容轮次按照ScaleOutRatio配置的的比例进行扩容。当作业负载需要扩容节点数量小于此值,当前扩容轮次扩容当前作业负载所需数量的节点。 此参数配合ScaleOutRatio参数进行使用,用于比例扩容场景下,在作业负载所需节点数量较小时,加快收敛速度。 */ ScaleOutNodeThreshold?: number; /** * 每轮扩容最大节点个数。 */ MaxNodesPerCycle?: number; /** * 扩容过程中,作业的内存在匹配实例机型时增大比例(不会影响作业提交的内存大小,只影响匹配计算过程)。<br/> 针对场景:由于实例机型的总内存会大于实例内部的可用内存,16GB内存规格的实例,实例操作系统内的可用内存只有约14.9GB内存。假设此时提交一个需要15GB内存的作业, - 当ScaleUpMemRatio=0时,会匹配到16GB内存规格的实例,但是由于操作系统内的可用内存为14.9GB小于作业所需的15GB,扩容出来的实例作业无法运行起来。 - 当ScaleUpMemRatio=10时,匹配实例规格会按照15*(1+10%)=16.5GB来进行实例规格匹配,则不会匹配到16GB的实例,而是更大内存规格的实例来保证作业能够被运行起来。 */ ScaleUpMemRatio?: number; } /** * DescribeQueues返回参数结构体 */ export interface DescribeQueuesResponse { /** * 队列概览信息列表。 */ QueueSet?: Array<QueueOverview>; /** * 符合条件的队列数量。 */ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * SubmitJob请求参数结构体 */ export interface SubmitJobRequest { /** * 集群id */ ClusterId: string; /** * 作业任务参数配置 */ Job: Job; /** * 队列名称。不指定则为默认队列: SLURM默认队列为:compute。 SGE默认队列为:all.q。 */ QueueName?: string; } /** * 提交Job作业信息 */ export interface Job { /** * 任务配置信息。 */ Tasks: Array<Task>; /** * 作业名称。 */ JobName?: string; /** * 作业描述。 */ JobDescription?: string; /** * 作业优先级,数值越大,优先级越高,数值范围1~100。 */ Priority?: number; /** * 描述任务的依赖关系,DAG有向无环图。 */ TaskDependencies?: Array<TaskDependence>; } /** * ModifyWorkspacesRenewFlag返回参数结构体 */ export interface ModifyWorkspacesRenewFlagResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 描述了实例的抽象位置 */ export interface Placement { /** * 实例所属的可用区名称。该参数可以通过调用 [DescribeZones](https://cloud.tencent.com/document/product/213/15707) 的返回值中的Zone字段来获取。 注意:此字段可能返回 null,表示取不到有效值。 */ Zone: string; } /** * DescribeNodes返回参数结构体 */ export interface DescribeNodesResponse { /** * 节点概览信息列表。 */ NodeSet?: Array<NodeOverview>; /** * 符合条件的节点数量。 */ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * GooseFS存储选项概览信息。 */ export interface GooseFSOptionOverview { /** * 文件系统本地挂载路径。 */ LocalPath?: string; /** * 文件系统远程挂载路径。 */ RemotePath?: string; /** * 文件系统master的ip和端口。 */ Masters?: Array<string>; } /** * 描述CFS文件系统版本和挂载信息 */ export interface CFSOption { /** * 文件系统本地挂载路径。 */ LocalPath: string; /** * 文件系统远程挂载ip及路径。 */ RemotePath?: string; /** * 文件系统协议类型。 <li>NFS 3.0</li> <li>NFS 4.0</li> <li>TURBO</li> */ Protocol?: string; /** * 文件系统存储类型,默认值SD;其中 SD 为通用标准型标准型存储, HP为通用性能型存储, TB为turbo标准型, TP 为turbo性能型。 */ StorageType?: string; /** * 文件系统挂载挂载命令参数选项。 - NFS 3.0默认值:vers=3,nolock,proto=tcp,noresvport - NFS 4.0默认值:vers=4.0,noresvport - TURBO默认值:user_xattr */ MountOption?: string; /** * 文件系统ID 文件系统ID通过调用接口[DescribeCfsFileSystems](https://cloud.tencent.com/document/product/582/38170)获取。 */ FileSystemId?: string; } /** * COS挂载信息 */ export interface CosOption { /** * <p>文件系统本地挂载路径。</p> */ LocalPath: string; /** * <p>COS桶地址,可以在COS桶详情页查看。</p> */ RemotePath: string; /** * <p>cosfs2挂载工具支持的参数。</p> */ MountParamsOption?: string; } /** * DeleteClusterStorageOption请求参数结构体 */ export interface DeleteClusterStorageOptionRequest { /** * 集群ID。 */ ClusterId: string; /** * 本地挂载路径。 */ LocalPath: string; } /** * 描述了 “腾讯云可观测平台” 服务相关的信息。 */ export interface RunMonitorServiceEnabled { /** * 是否开启[腾讯云可观测平台](/document/product/248)服务。取值范围:<br><li>TRUE:表示开启腾讯云可观测平台服务</li><br><li>FALSE:表示不开启腾讯云可观测平台服务</li><br><br>默认取值:TRUE。 */ Enabled?: boolean; } /** * 扩容节点配置信息概览。 */ export interface ExpansionNodeConfigOverview { /** * 节点机型。 注意:此字段可能返回 null,表示取不到有效值。 */ InstanceType?: string; /** * 扩容实例所在的位置。 注意:此字段可能返回 null,表示取不到有效值。 */ Placement?: Placement; /** * 节点[计费类型](https://cloud.tencent.com/document/product/213/2180)。 注意:此字段可能返回 null,表示取不到有效值。 */ InstanceChargeType?: string; /** * 预付费模式,即包年包月相关参数设置。通过该参数可以指定包年包月节点的购买时长、是否设置自动续费等属性。若指定节点的付费模式为预付费则该参数必传。 注意:此字段可能返回 null,表示取不到有效值。 */ InstanceChargePrepaid?: InstanceChargePrepaid; /** * 私有网络相关信息配置。 注意:此字段可能返回 null,表示取不到有效值。 */ VirtualPrivateCloud?: VirtualPrivateCloud; /** * 指定有效的[镜像](https://cloud.tencent.com/document/product/213/4940)ID,格式形如`img-xxx`。 注意:此字段可能返回 null,表示取不到有效值。 */ ImageId?: string; /** * 公网带宽相关信息设置。 注意:此字段可能返回 null,表示取不到有效值。 */ InternetAccessible?: InternetAccessible; /** * 节点系统盘配置信息。 注意:此字段可能返回 null,表示取不到有效值。 */ SystemDisk?: SystemDisk; /** * 节点数据盘配置信息。 注意:此字段可能返回 null,表示取不到有效值。 */ DataDisks?: Array<DataDisk>; } /** * DeleteJob请求参数结构体 */ export interface DeleteJobRequest { /** * 作业任务ID */ JobId: string; } /** * 工作空间数据盘配置 */ export interface SpaceDataDisk { /** * 数据盘类型。数据盘类型限制详见[存储概述](https://cloud.tencent.com/document/product/213/4952)。取值范围:<br /> <li> LOCAL_BASIC:本地硬盘<br /> <li> LOCAL_SSD:本地SSD硬盘<br /> <li> LOCAL_NVME:本地NVME硬盘,与InstanceType强相关,不支持指定<br /> <li> LOCAL_PRO:本地HDD硬盘,与InstanceType强相关,不支持指定<br /> <li> CLOUD_BASIC:普通云硬盘<br /> <li> CLOUD_PREMIUM:高性能云硬盘<br /> <li> CLOUD_SSD:SSD云硬盘<br /> <li> CLOUD_HSSD:增强型SSD云硬盘<br /> <li> CLOUD_TSSD:极速型SSD云硬盘<br /> <li> CLOUD_BSSD:通用型SSD云硬盘<br /><br />默认取值:LOCAL_BASIC。<br /><br />该参数对`ResizeInstanceDisk`接口无效。 </li> </li> </li> </li> </li> </li> </li> </li> </li> </li> */ DiskType?: string; /** * 数据盘 注意:此字段可能返回 null,表示取不到有效值。 */ DiskId?: string; /** * 数据盘大小,单位:GB。最小调整步长为10G,不同数据盘类型取值范围不同,具体限制详见:[存储概述](https://cloud.tencent.com/document/product/213/4952)。默认值为0,表示不购买数据盘。更多限制详见产品文档。 */ DiskSize?: number; /** * 数据盘是否随子机销毁。取值范围: <li>TRUE:子机销毁时,销毁数据盘,只支持按小时后付费云盘</li> <li> FALSE:子机销毁时,保留数据盘<br /> 默认取值:TRUE<br /> 该参数目前仅用于 `RunInstances` 接口。 </li> 注意:此字段可能返回 null,表示取不到有效值。 */ DeleteWithInstance?: boolean; /** * 数据盘快照ID。选择的数据盘快照大小需小于数据盘大小。 注意:此字段可能返回 null,表示取不到有效值。 */ SnapshotId?: string; /** * 数据盘是加密。取值范围: <li>true:加密</li> <li> false:不加密<br /> 默认取值:false<br /> 该参数目前仅用于 `RunInstances` 接口。 </li> 注意:此字段可能返回 null,表示取不到有效值。 */ Encrypt?: boolean; /** * 自定义CMK对应的ID,取值为UUID或者类似kms-abcd1234。用于加密云盘。 该参数目前仅用于 `CreateWorkspaces` 接口。 注意:此字段可能返回 null,表示取不到有效值。 */ KmsKeyId?: string; /** * 云硬盘性能,单位:MB/s 注意:此字段可能返回 null,表示取不到有效值。 */ ThroughputPerformance?: number; /** * 突发性能 注:内测中。 注意:此字段可能返回 null,表示取不到有效值。 */ BurstPerformance?: boolean; } /** * DetachNodes返回参数结构体 */ export interface DetachNodesResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeClusterStorageOption请求参数结构体 */ export interface DescribeClusterStorageOptionRequest { /** * 集群ID。 */ ClusterId: string; } /** * 描述集群文件系统选项 */ export interface StorageOption { /** * <p>集群挂载CFS文件系统选项。</p> */ CFSOptions?: Array<CFSOption>; /** * <p>集群挂载GooseFS文件系统选项。</p> */ GooseFSOptions?: Array<GooseFSOption>; /** * <p>集群挂载GooseFSx文件系统选项。</p> */ GooseFSxOptions?: Array<GooseFSxOption>; /** * <p>集群挂载COS文件系统选项。</p> */ CosOptions?: Array<CosOption>; } /** * 登录节点概览。 */ export interface LoginNodeOverview { /** * 登录节点ID。 */ NodeId: string; } /** * ModifyWorkspacesAttribute返回参数结构体 */ export interface ModifyWorkspacesAttributeResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeClusters返回参数结构体 */ export interface DescribeClustersResponse { /** * 集群概览信息列表。 */ ClusterSet?: Array<ClusterOverview>; /** * 集群数量。 */ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeClusterActivities返回参数结构体 */ export interface DescribeClusterActivitiesResponse { /** * <p>集群活动历史记录列表。</p> */ ClusterActivitySet?: Array<ClusterActivity>; /** * <p>集群活动历史记录数量。</p> */ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * AddNodes请求参数结构体 */ export interface AddNodesRequest { /** * <p>集群中实例所在的位置。</p> */ Placement: Placement; /** * <p>集群ID。</p> */ ClusterId: string; /** * <p>私有网络相关信息配置。</p> */ VirtualPrivateCloud: VirtualPrivateCloud; /** * <p>添加节点数量。</p> */ Count: number; /** * <p>指定有效的<a href="https://cloud.tencent.com/document/product/213/4940">镜像</a>ID,格式形如<code>img-xxx</code>。目前支持部分公有镜像和自定义镜像。公共镜像请参考<a href="https://cloud.tencent.com/document/product/1527/64818#.E9.95.9C.E5.83.8F">镜像限制</a></p> */ ImageId?: string; /** * <p>节点<a href="https://cloud.tencent.com/document/product/213/2180">计费类型</a>。<br><li>PREPAID:预付费,即包年包月</li><li>POSTPAID_BY_HOUR:按小时后付费</li><li>SPOTPAID:竞价付费</li>默认值:POSTPAID_BY_HOUR。</p> */ InstanceChargeType?: string; /** * <p>预付费模式,即包年包月相关参数设置。通过该参数可以指定包年包月节点的购买时长、是否设置自动续费等属性。若指定节点的付费模式为预付费则该参数必传。</p> */ InstanceChargePrepaid?: InstanceChargePrepaid; /** * <p>节点机型。不同实例机型指定了不同的资源规格。<br><li>具体取值可通过调用接口<a href="https://cloud.tencent.com/document/api/213/15749">DescribeInstanceTypeConfigs</a>来获得最新的规格表或参见<a href="https://cloud.tencent.com/document/product/213/11518">实例规格</a>描述。</li></p> */ InstanceType?: string; /** * <p>节点系统盘配置信息。若不指定该参数,则按照系统默认值进行分配。</p> */ SystemDisk?: SystemDisk; /** * <p>节点数据盘配置信息。若不指定该参数,则默认不购买数据盘。支持购买的时候指定21块数据盘,其中最多包含1块LOCAL_BASIC数据盘或者LOCAL_SSD数据盘,最多包含20块CLOUD_BASIC数据盘、CLOUD_PREMIUM数据盘或者CLOUD_SSD数据盘。</p> */ DataDisks?: Array<DataDisk>; /** * <p>公网带宽相关信息设置。若不指定该参数,则默认公网带宽为0Mbps。</p> */ InternetAccessible?: InternetAccessible; /** * <p>节点显示名称。<br>不指定节点显示名称则默认显示‘未命名’。<br>最多支持60个字符。</p> */ InstanceName?: string; /** * <p>集群登录设置。</p> */ LoginSettings?: LoginSettings; /** * <p>集群中实例所属安全组。该参数可以通过调用 <a href="https://cloud.tencent.com/document/api/215/15808">DescribeSecurityGroups</a> 的返回值中的sgId字段来获取。若不指定该参数,则绑定默认安全组。</p> */ SecurityGroupIds?: Array<string>; /** * <p>用于保证请求幂等性的字符串。该字符串由客户生成,需保证不同请求之间唯一,最大值不超过64个ASCII字符。若不指定该参数,则无法保证请求的幂等性。</p> */ ClientToken?: string; /** * <p>队列名称。不指定则为默认队列。<li>SLURM默认队列为:compute。</li></p> */ QueueName?: string; /** * <p>添加节点角色。默认值:Compute<br><li>Compute:计算节点。</li><li>Login:登录节点。</li></p> */ NodeRole?: string; /** * <p>是否只预检此次请求。<br>true:发送检查请求,不会创建实例。检查项包括是否填写了必需参数,请求格式,业务限制和云服务器库存。<br>如果检查不通过,则返回对应错误码;<br>如果检查通过,则返回RequestId.<br>false(默认):发送正常请求,通过检查后直接创建实例</p> */ DryRun?: boolean; /** * <p>添加节点类型。默认取值:STATIC。<li>STATIC:静态节点,不会参与弹性伸缩流程。</li><li>DYNAMIC:弹性节点,会被弹性缩容的节点。管控节点和登录节点不支持此参数。</li></p> */ NodeType?: string; /** * <p>实例所属项目ID。该参数可以通过调用 <a href="https://cloud.tencent.com/document/api/651/78725">DescribeProject</a> 的返回值中的 projectId 字段来获取。不填为默认项目。</p> */ ProjectId?: number; /** * <p>要新增节点的资源类型。<li>CVM:CVM实例类型资源</li><li>WORKSPACE:工作空间类型实例资源</li>默认值:CVM。</p> */ ResourceType?: string; } /** * DeleteQueue返回参数结构体 */ export interface DeleteQueueResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 描述了数据盘的信息 */ export interface DataDisk { /** * 数据盘大小,单位:GB。最小调整步长为10G,不同数据盘类型取值范围不同,具体限制详见:[存储概述](https://cloud.tencent.com/document/product/213/4952)。默认值为0,表示不购买数据盘。更多限制详见产品文档。 注意:此字段可能返回 null,表示取不到有效值。 */ DiskSize: number; /** * 数据盘类型。数据盘类型限制详见[存储概述](https://cloud.tencent.com/document/product/213/4952)。取值范围:<br><li>LOCAL_NVME:本地NVME硬盘,与InstanceType强相关,不支持指定<br><li>LOCAL_PRO:本地HDD硬盘,与InstanceType强相关,不支持指定<br><li>CLOUD_BASIC:普通云硬盘<br><li>CLOUD_PREMIUM:高性能云硬盘<br><li>CLOUD_SSD:SSD云硬盘<br><li>CLOUD_HSSD:增强型SSD云硬盘<br><li>CLOUD_TSSD:极速型SSD云硬盘<br><li>CLOUD_BSSD:通用型SSD云硬盘 注意:此字段可能返回 null,表示取不到有效值。 */ DiskType?: string; } /** * 队列信息概览。 */ export interface QueueOverview { /** * 队列名称。 */ QueueName?: string; } /** * DeleteJob返回参数结构体 */ export interface DeleteJobResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 描述了实例登录相关配置与信息。 */ export interface LoginSettings { /** * 实例登录密码。不同操作系统类型密码复杂度限制不一样,具体如下:<br><li>Linux实例密码必须8到30位,至少包括两项[a-z],[A-Z]、[0-9] 和 [( ) \` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ' , . ? / ]中的特殊符号。</li><br><li>Windows实例密码必须12到30位,至少包括三项[a-z],[A-Z],[0-9] 和 [( ) \` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ' , . ? /]中的特殊符号。</li><br><br>若不指定该参数,则由系统随机生成密码,并通过站内信方式通知到用户。 */ Password?: string; /** * 实例登录密钥 */ KeyIds?: Array<string>; } /** * 任务的依赖关系。 */ export interface TaskDependence { /** * 依赖关系的起点任务名称。 */ StartTask: string; /** * 依赖关系的终点任务名称。 */ EndTask: string; } /** * 描述了实例的增强服务启用情况与其设置,如云安全,腾讯云可观测平台等实例 Agent */ export interface EnhancedService { /** * 开启云安全服务。若不指定该参数,则默认开启云安全服务。 */ SecurityService?: RunSecurityServiceEnabled; /** * 开启腾讯云可观测平台服务。若不指定该参数,则默认开启腾讯云可观测平台服务。 */ MonitorService?: RunMonitorServiceEnabled; /** * 开启云自动化助手服务(TencentCloud Automation Tools,TAT)。若不指定该参数,默认开启云自动化助手服务。 */ AutomationService?: RunAutomationServiceEnabled; } /** * 描述了 “云自动化助手” 服务相关的信息。 */ export interface RunAutomationServiceEnabled { /** * 是否开启云自动化助手。取值范围:<br><li>TRUE:表示开启云自动化助手服务</li><br><li>FALSE:表示不开启云自动化助手服务</li><br><br>默认取值:TRUE。 */ Enabled?: boolean; } /** * 符合条件的集群活动信息。 */ export interface ClusterActivity { /** * 集群ID。 */ ClusterId?: string; /** * 集群活动ID。 */ ActivityId?: string; /** * 集群活动类型。取值范围:<br><li>CreateAndAddNodes:创建实例并添加进集群</li><br><li>RemoveNodesFromCluster:从集群移除实例</li><br><li>TerminateNodes:销毁实例</li><br><li>MountStorageOption:增加挂载选项并进行挂载</li><br><li>UmountStorageOption:删除集群挂载存储选项并解挂载</li> */ ActivityType?: string; /** * 集群活动状态。取值范围:<br><li>PENDING:等待运行</li><br><li>RUNNING:运行中</li><br><li>SUCCESSFUL:活动成功</li><br><li>PARTIALLY_SUCCESSFUL:活动部分成功</li><br><li>FAILED:活动失败</li> */ ActivityStatus?: string; /** * 集群活动状态码。 */ ActivityStatusCode?: string; /** * 集群活动结果详情。 注意:此字段可能返回 null,表示取不到有效值。 */ ResultDetail?: string; /** * 集群活动起因。 */ Cause?: string; /** * 集群活动描述。 */ Description?: string; /** * 集群活动相关节点活动集合。 */ RelatedNodeActivitySet?: Array<NodeActivity>; /** * 集群活动开始时间。 */ StartTime?: string; /** * 集群活动结束时间。 */ EndTime?: string; } /** * DescribeJobSubmitInfo返回参数结构体 */ export interface DescribeJobSubmitInfoResponse { /** * 集群ID */ ClusterId?: string; /** * 队列名称 */ QueueName?: string; /** * 作业信息 */ Job?: Job; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateCluster返回参数结构体 */ export interface CreateClusterResponse { /** * <p>集群ID。</p> */ ClusterId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 描述了 “云安全” 服务相关的信息。 */ export interface RunSecurityServiceEnabled { /** * 是否开启[云安全](/document/product/296)服务。取值范围:<br><li>TRUE:表示开启云安全服务</li><br><li>FALSE:表示不开启云安全服务</li><br><br>默认取值:TRUE。 */ Enabled?: boolean; } /** * DescribeQueues请求参数结构体 */ export interface DescribeQueuesRequest { /** * 集群ID。 */ ClusterId: string; /** * 偏移量,默认为0。关于`Offset`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 */ Offset?: number; /** * 返回数量,默认为20,最大值为100。关于`Limit`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 */ Limit?: number; } /** * SetAutoScalingConfiguration返回参数结构体 */ export interface SetAutoScalingConfigurationResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateCluster请求参数结构体 */ export interface CreateClusterRequest { /** * <p>集群中实例所在的位置。</p> */ Placement?: Placement; /** * <p>指定管理节点。</p> */ ManagerNode?: ManagerNode; /** * <p>指定管理节点的数量。默认取值:1。取值范围:1~2。</p> */ ManagerNodeCount?: number; /** * <p>指定计算节点。</p> */ ComputeNode?: ComputeNode; /** * <p>指定计算节点的数量。默认取值:0。</p> */ ComputeNodeCount?: number; /** * <p>调度器类型。默认取值:SLURM。<li>SLURM:SLURM调度器。</li></p> */ SchedulerType?: string; /** * <p>创建调度器的版本号,可填写版本号为“latest” 和 各调度器支持的版本号;如果是&quot;latest&quot;, 则代表创建的是平台当前支持的该类型调度器最新版本。如果不填写,默认创建的是“latest”版本调度器<br>各调度器支持的集群版本:</p><li>SLURM:21.08.8、23.11.7</li> */ SchedulerVersion?: string; /** * <p>指定有效的<a href="https://cloud.tencent.com/document/product/213/4940">镜像</a>ID,格式形如<code>img-xxx</code>。目前支持部分公有镜像和自定义镜像。公共镜像请参考<a href="https://cloud.tencent.com/document/product/1527/64818#.E9.95.9C.E5.83.8F">镜像限制</a></p> */ ImageId?: string; /** * <p>私有网络相关信息配置。</p> */ VirtualPrivateCloud?: VirtualPrivateCloud; /** * <p>集群登录设置。</p> */ LoginSettings?: LoginSettings; /** * <p>集群中实例所属安全组。该参数可以通过调用 <a href="https://cloud.tencent.com/document/api/215/15808">DescribeSecurityGroups</a> 的返回值中的sgId字段来获取。若不指定该参数,则绑定默认安全组。</p> */ SecurityGroupIds?: Array<string>; /** * <p>用于保证请求幂等性的字符串。该字符串由客户生成,需保证不同请求之间唯一,最大值不超过64个ASCII字符。若不指定该参数,则无法保证请求的幂等性。</p> */ ClientToken?: string; /** * <p>是否只预检此次请求。<br>true:发送检查请求,不会创建实例。检查项包括是否填写了必需参数,请求格式,业务限制和云服务器库存。<br>如果检查不通过,则返回对应错误码;<br>如果检查通过,则返回RequestId.<br>false(默认):发送正常请求,通过检查后直接创建实例</p> */ DryRun?: boolean; /** * <p>域名字服务类型。默认取值:NIS。</p><li>NIS:NIS域名字服务。</li> */ AccountType?: string; /** * <p>集群显示名称。</p> */ ClusterName?: string; /** * <p>集群存储选项</p> */ StorageOption?: StorageOption; /** * <p>指定登录节点。</p> */ LoginNode?: LoginNode; /** * <p>指定登录节点的数量。默认取值:0。取值范围:0~10。</p> */ LoginNodeCount?: number; /** * <p>创建集群时同时绑定的标签对说明。</p> */ Tags?: Array<Tag>; /** * <p>弹性伸缩类型。默认值:THPC_AS</p> */ AutoScalingType?: string; /** * <p>节点初始化脚本信息列表。</p> */ InitNodeScripts?: Array<NodeScript>; /** * <p>高性能计算集群ID。若创建的实例为高性能计算实例,需指定实例放置的集群,否则不可指定。</p> */ HpcClusterId?: string; } /** * AddQueue返回参数结构体 */ export interface AddQueueResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeClusterStorageOption返回参数结构体 */ export interface DescribeClusterStorageOptionResponse { /** * 集群存储选项信息概览。 */ StorageOption?: StorageOptionOverview; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 描述节点执行脚本信息。 */ export interface NodeScript { /** * 节点执行脚本获取地址。 目前仅支持cos地址。地址最大长度:255。 */ ScriptPath: string; /** * 脚本执行超时时间(包含拉取脚本的时间)。单位秒,默认值:30。取值范围:10~1200。 */ Timeout?: number; } /** * ModifyInitNodeScripts返回参数结构体 */ export interface ModifyInitNodeScriptsResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 任务执行命令脚本。 */ export interface CommandItem { /** * 脚本命令 */ Command: string; } /** * 管控节点信息 */ export interface ManagerNode { /** * <p>节点<a href="https://cloud.tencent.com/document/product/213/2180">计费类型</a>。</p>枚举值:<ul><li> PREPAID: 预付费,即包年包月</li><li> POSTPAID_BY_HOUR: 按小时后付费</li></ul> */ InstanceChargeType?: string; /** * <p>预付费模式,即包年包月相关参数设置。通过该参数可以指定包年包月节点的购买时长、是否设置自动续费等属性。若指定节点的付费模式为预付费则该参数必传。</p> */ InstanceChargePrepaid?: InstanceChargePrepaid; /** * <p>节点机型。不同实例机型指定了不同的资源规格。 <br><li>具体取值可通过调用接口<a href="https://cloud.tencent.com/document/api/213/15749">DescribeInstanceTypeConfigs</a>来获得最新的规格表或参见<a href="https://cloud.tencent.com/document/product/213/11518">实例规格</a>描述。</li> </p> */ InstanceType?: string; /** * <p>节点系统盘配置信息。若不指定该参数,则按照系统默认值进行分配。</p> */ SystemDisk?: SystemDisk; /** * <p>节点数据盘配置信息。若不指定该参数,则默认不购买数据盘。支持购买的时候指定21块数据盘,其中最多包含1块LOCAL_BASIC数据盘或者LOCAL_SSD数据盘,最多包含20块CLOUD_BASIC数据盘、CLOUD_PREMIUM数据盘或者CLOUD_SSD数据盘。</p> */ DataDisks?: Array<DataDisk>; /** * <p>公网带宽相关信息设置。若不指定该参数,则默认公网带宽为0Mbps。</p> */ InternetAccessible?: InternetAccessible; /** * <p>节点显示名称。<br><li> 不指定节点显示名称则默认显示‘未命名’。 </li><li>购买多个节点,如果指定模式串<code>{R:x}</code>,表示生成数字[<code>[x, x+n-1]</code>,其中<code>n</code>表示购买节点的数量,例如<code>server_{R:3}</code>,购买1个时,节点显示名称为<code>server_3</code>;购买2个时,节点显示名称分别为<code>server_3</code>,<code>server_4</code>。支持指定多个模式串<code>{R:x}</code>。 购买多个节点,如果不指定模式串,则在节点显示名称添加后缀<code>1、2...n</code>,其中<code>n</code>表示购买节点的数量,例如<code>server_</code>,购买2个时,节点显示名称分别为<code>server_1</code>,<code>server_2</code>。</li><li> 最多支持60个字符(包含模式串)。</li></p> */ InstanceName?: string; /** * <p>实例所属项目ID。该参数可以通过调用 <a href="https://cloud.tencent.com/document/api/651/78725">DescribeProject</a> 的返回值中的 projectId 字段来获取。不填为默认项目。</p> */ ProjectId?: number; /** * <p>增强服务。通过该参数可以指定是否开启云安全、腾讯云可观测平台等服务。若不指定该参数,则默认开启腾讯云可观测平台、云安全服务、自动化助手服务。</p> */ EnhancedService?: EnhancedService; } /** * DescribeJobSubmitInfo请求参数结构体 */ export interface DescribeJobSubmitInfoRequest { /** * 作业ID */ JobId: string; } /** * 输出重定向配置 */ export interface OutputRedirect { /** * <p>输出driver类型</p><p>枚举值:</p><ul><li>local: 宿主机本地目录</li><li>cos: 远端cos存储</li></ul><p>默认值:local</p> */ Driver?: string; /** * <p>重定向配置参数</p><p>日志重定向路径,用于指定任务日志的输出目标。取值格式与 Driver 类型关联:<br>当 Driver 为 local 时,格式为本地文件路径,如 stdout=/tmp/train_out.log;<br>当 Driver 为 cos 时,格式为 COS 存储桶路径,如 stdout=cos://test-123456.cos.ap-shanghai.myqcloud.com/test/.</p> */ Options?: Array<string>; } /** * ModifyWorkspacesAttribute请求参数结构体 */ export interface ModifyWorkspacesAttributeRequest { /** * 工作空间列表 */ SpaceIds: Array<string>; /** * 修改后的工作空间名称。可任意命名,但不得超过60个字符。 */ SpaceName?: string; } /** * >描述键值对过滤器,用于条件过滤查询。例如过滤ID、名称、状态等 > * 若存在多个`Filter`时,`Filter`间的关系为逻辑与(`AND`)关系。 > * 若同一个`Filter`存在多个`Values`,同一`Filter`下`Values`间的关系为逻辑或(`OR`)关系。 */ export interface Filter { /** * 需要过滤的字段。 */ Name: string; /** * 字段的过滤值。 */ Values: Array<string>; } /** * 容器配置信息。 */ export interface Docker { /** * 容器镜像地址 */ Image: string; /** * 容器运行参数 */ RunArgs?: Array<string>; } /** * 任务的应用环境配置信息。 */ export interface Application { /** * 待执行脚本命令。 */ Commands: Array<CommandItem>; /** * 存储目录挂载配置。 */ StorageMounts?: Array<StorageMount>; /** * 用户自定义环境变量。 */ EnvVars?: Array<EnvVar>; /** * 容器配置信息。 */ Docker?: Docker; /** * 无 */ OutputRedirect?: OutputRedirect; /** * 表示所选训练框架,支持可选参数 - PyTorch:表示提交PyTorch训练作业 - Custom:表示用户自定义作业 默认参数为:Custom * @deprecated */ JobType?: string; /** * 表示所选训练框架,支持可选参数 - PyTorch:表示提交PyTorch训练作业 - Custom:表示用户自定义作业 默认参数为:Custom */ TaskType?: string; } /** * 描述工作空间的信息 */ export interface SpaceInfo { /** * <p>工作空间ID</p> */ SpaceId?: string; /** * <p>工作空间类别</p> */ SpaceClass?: string; /** * <p>工作空间类型</p> */ SpaceFamily?: string; /** * <p>工作空间规格</p> */ SpaceType?: string; /** * <p>工作空间名称</p> */ SpaceName?: string; /** * <p>工作空间状态。取值范围:<br><li>PENDING:表示创建中<br></li><li>LAUNCH_FAILED:表示创建失败<br></li><li>ONLINE:表示运行中<br></li><li>ARREARS:表示隔离中<br></li><li>TERMINATING:表示销毁中。<br></li></p> */ SpaceState?: string; /** * <p>工作空间计费模式</p> */ SpaceChargeType?: string; /** * <p>工作空间对应资源ID</p> */ ResourceId?: string; /** * <p>自动续费标识</p> */ RenewFlag?: string; /** * <p>工作空间关联的工作列表</p> */ Tags?: Array<Tag>; /** * <p>创建时间</p> */ CreatedTime?: string; /** * <p>到期时间</p> */ ExpiredTime?: string; /** * <p>工作空间所在位置</p> */ Placement?: Placement; /** * <p>工作空间的最新操作</p> 注意:此字段可能返回 null,表示取不到有效值。 */ LatestOperation?: string; /** * <p>工作空间的最新操作状态</p> 注意:此字段可能返回 null,表示取不到有效值。 */ LatestOperationState?: string; /** * <p>实例的内网IP</p> */ PrivateIpAddresses?: Array<string>; } /** * TerminateWorkspaces请求参数结构体 */ export interface TerminateWorkspacesRequest { /** * 工作空间ID */ SpaceIds: Array<string>; /** * 释放空间挂载的包年包月数据盘。true表示销毁空间同时释放包年包月数据盘,false表示只销毁空间。 */ ReleasePrepaidDataDisks?: boolean; } /** * 计算节点信息。 */ export interface ComputeNode { /** * 节点[计费类型](https://cloud.tencent.com/document/product/213/2180)。<li>PREPAID:预付费,即包年包月</li><li>POSTPAID_BY_HOUR:按小时后付费</li><li>SPOTPAID:竞价付费</li>默认值:POSTPAID_BY_HOUR。 */ InstanceChargeType?: string; /** * 预付费模式,即包年包月相关参数设置。通过该参数可以指定包年包月节点的购买时长、是否设置自动续费等属性。若指定节点的付费模式为预付费则该参数必传。 */ InstanceChargePrepaid?: InstanceChargePrepaid; /** * 节点机型。不同实例机型指定了不同的资源规格。<li>具体取值可通过调用接口[DescribeInstanceTypeConfigs](https://cloud.tencent.com/document/api/213/15749)来获得最新的规格表或参见[实例规格](https://cloud.tencent.com/document/product/213/11518)描述。</li> */ InstanceType?: string; /** * 节点系统盘配置信息。若不指定该参数,则按照系统默认值进行分配。 */ SystemDisk?: SystemDisk; /** * 节点数据盘配置信息。若不指定该参数,则默认不购买数据盘。支持购买的时候指定21块数据盘,其中最多包含1块LOCAL_BASIC数据盘或者LOCAL_SSD数据盘,最多包含20块CLOUD_BASIC数据盘、CLOUD_PREMIUM数据盘或者CLOUD_SSD数据盘。 */ DataDisks?: Array<DataDisk>; /** * 公网带宽相关信息设置。若不指定该参数,则默认公网带宽为0Mbps。 */ InternetAccessible?: InternetAccessible; /** * 节点显示名称。<li>不指定节点显示名称则默认显示‘未命名’。 最多支持60个字符。</li> */ InstanceName?: string; /** * 实例所属项目ID。该参数可以通过调用 [DescribeProject](https://cloud.tencent.com/document/api/651/78725) 的返回值中的 projectId 字段来获取。不填为默认项目。 */ ProjectId?: number; /** * 实例资源类型,默认是CVM资源 */ ResourceType?: string; } /** * DeleteNodes请求参数结构体 */ export interface DeleteNodesRequest { /** * 集群ID。 */ ClusterId: string; /** * 节点ID。 */ NodeIds: Array<string>; } /** * DeleteClusterStorageOption返回参数结构体 */ export interface DeleteClusterStorageOptionResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * TerminateJob返回参数结构体 */ export interface TerminateJobResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 描述了工作空间的公网可访问性,声明了工作空间的公网使用计费模式,最大带宽等 */ export interface SpaceInternetAccessible { /** * 网络计费类型 注意:此字段可能返回 null,表示取不到有效值。 */ InternetChargeType?: string; /** * 公网出带宽上限,默认为0 注意:此字段可能返回 null,表示取不到有效值。 */ InternetMaxBandwidthOut?: number; /** * 是否分配公网IP 注意:此字段可能返回 null,表示取不到有效值。 */ PublicIpAssigned?: boolean; /** * 带宽包ID 注意:此字段可能返回 null,表示取不到有效值。 */ BandwidthPackageId?: string; } /** * DescribeJobs请求参数结构体 */ export interface DescribeJobsRequest { /** * 作业任务ID列表 */ JobIds?: Array<string>; /** * 过滤列表 */ Filters?: Array<Filter>; /** * 偏移量,默认为0。 关于`Offset`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 */ Offset?: number; /** * 返回数量,默认为20,最大值为100。关于`Limit`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 */ Limit?: number; } /** * GooseFSx存储选项概览信息。 */ export interface GooseFSxOptionOverview { /** * 文件系统master的ip和端口列表。 */ Masters?: Array<string>; /** * 文件系统的本地挂载路径。GooseFSx目前只支持挂载在/goosefsx/{文件系统ID}_proxy/目录下。 */ LocalPath?: string; } /** * COS存储选项概览信息。 */ export interface CosOptionOverview { /** * <p>文件系统本地挂载路径。</p> */ LocalPath?: string; /** * <p>COS桶地址。</p> */ RemotePath?: string; /** * <p>COS挂载参数</p> */ MountOption?: string; } /** * SetAutoScalingConfiguration请求参数结构体 */ export interface SetAutoScalingConfigurationRequest { /** * <p>集群ID。</p> */ ClusterId: string; /** * <p>任务连续等待时间,队列的任务处于连续等待的时间。单位秒。默认值120。</p> */ ExpansionBusyTime?: number; /** * <p>节点连续空闲(未运行作业)时间,一个节点连续处于空闲状态时间。单位秒。默认值300。</p> */ ShrinkIdleTime?: number; /** * <p>扩容队列配置列表。</p> */ QueueConfigs?: Array<QueueConfig>; /** * <p>是否只预检此次请求。<br>true:发送检查请求,不会绑定弹性伸缩组。检查项包括是否填写了必需参数,请求格式,业务限制。<br>如果检查不通过,则返回对应错误码;<br>如果检查通过,则返回RequestId。<br>false(默认):发送正常请求,通过检查后直接绑定弹性伸缩组。</p> */ DryRun?: boolean; } /** * SubmitJob返回参数结构体 */ export interface SubmitJobResponse { /** * 作业任务ID */ JobId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeNodes请求参数结构体 */ export interface DescribeNodesRequest { /** * 集群ID。 */ ClusterId?: string; /** * <ul> <li><strong>queue-name</strong> <p style="padding-left: 30px;">按照【<strong>队列名称</strong>】进行过滤。队列名称形如:compute。</p> <p style="padding-left: 30px;">类型:String</p> <p style="padding-left: 30px;">必选:否</p> </li> <li><strong>node-role</strong> <p style="padding-left: 30px;">按照【<strong>节点角色</strong>】进行过滤。节点角色形如:Manager。(Manager:管控节点。Compute:计算节点。Login:登录节点。ManagerBackup:备用管控节点。)</p> <p style="padding-left: 30px;">类型:String</p> <p style="padding-left: 30px;">必选:否</p> </li> <li><strong>node-type</strong> <p style="padding-left: 30px;">按照【<strong>节点类型</strong>】进行过滤。节点类型形如:STATIC。(STATIC:静态节点。DYNAMIC:弹性节点。)</p> <p style="padding-left: 30px;">类型:String</p> <p style="padding-left: 30px;">必选:否</p> </li> <li><strong>instance-id</strong> <p style="padding-left: 30px;">按照【<strong>CVM实例资源ID</strong>】进行过滤。资源ID名称形如:ins-xxx。</p> <p style="padding-left: 30px;">类型:String</p> <p style="padding-left: 30px;">必选:否</p> </li> </ul><p style="padding-left: 30px;">每次请求的`Filters`的上限为10,`Filter.Values`的上限为100。</p> */ Filters?: Array<Filter>; /** * 偏移量,默认为0。关于`Offset`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 */ Offset?: number; /** * 返回数量,默认为20,最大值为100。关于`Limit`的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。 */ Limit?: number; } /** * DetachNodes请求参数结构体 */ export interface DetachNodesRequest { /** * 集群id */ ClusterId: string; /** * 集群中的节点id */ NodeIds: Array<string>; } /** * AttachNodes返回参数结构体 */ export interface AttachNodesResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 登录节点信息。 */ export interface LoginNode { /** * 节点[计费类型](https://cloud.tencent.com/document/product/213/2180)。<br><li>PREPAID:预付费,即包年包月</li><br><li>POSTPAID_BY_HOUR:按小时后付费</li><br><li>SPOTPAID:竞价付费<br>默认值:POSTPAID_BY_HOUR。</li> */ InstanceChargeType?: string; /** * 预付费模式,即包年包月相关参数设置。通过该参数可以指定包年包月节点的购买时长、是否设置自动续费等属性。若指定节点的付费模式为预付费则该参数必传。 */ InstanceChargePrepaid?: InstanceChargePrepaid; /** * 节点机型。不同实例机型指定了不同的资源规格。 <br><li>具体取值可通过调用接口[DescribeInstanceTypeConfigs](https://cloud.tencent.com/document/api/213/15749)来获得最新的规格表或参见[实例规格](https://cloud.tencent.com/document/product/213/11518)描述。</li> */ InstanceType?: string; /** * 节点系统盘配置信息。若不指定该参数,则按照系统默认值进行分配。 */ SystemDisk?: SystemDisk; /** * 节点数据盘配置信息。若不指定该参数,则默认不购买数据盘。支持购买的时候指定21块数据盘,其中最多包含1块LOCAL_BASIC数据盘或者LOCAL_SSD数据盘,最多包含20块CLOUD_BASIC数据盘、CLOUD_PREMIUM数据盘或者CLOUD_SSD数据盘。 */ DataDisks?: Array<DataDisk>; /** * 公网带宽相关信息设置。若不指定该参数,则默认公网带宽为0Mbps。 */ InternetAccessible?: InternetAccessible; /** * 节点显示名称。<br><li> 不指定节点显示名称则默认显示‘未命名’。 最多支持60个字符。</li> */ In