UNPKG

tencentcloud-sdk-nodejs

Version:
552 lines (549 loc) 20.2 kB
/** * 集群概览信息。 */ export interface ClusterOverview { /** * 集群ID。 */ ClusterId?: string; /** * 集群状态。取值范围:<br><li>PENDING:创建中</li><br><li>INITING:初始化中</li><br><li>INIT_FAILED:初始化失败</li><br><li>RUNNING:运行中</li><br><li>TERMINATING:销毁中</li> */ ClusterStatus?: string; /** * 集群名称。 */ ClusterName?: string; /** * 集群位置信息。 */ Placement?: Placement; /** * 集群创建时间。 */ CreateTime?: string; /** * 集群调度器。 */ SchedulerType?: string; /** * 计算节点数量。 */ ComputeNodeCount?: number; /** * 计算节点概览。 */ ComputeNodeSet?: Array<ComputeNodeOverview>; /** * 管控节点数量。 */ ManagerNodeCount?: number; /** * 管控节点概览。 */ ManagerNodeSet?: Array<ManagerNodeOverview>; /** * 登录节点概览。 */ LoginNodeSet?: Array<LoginNodeOverview>; /** * 登录节点数量。 */ LoginNodeCount?: number; } /** * 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; } /** * 描述了实例登录相关配置与信息。 */ 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; } /** * DeleteCluster返回参数结构体 */ export interface DeleteClusterResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 描述了实例的公网可访问性,声明了实例的公网使用计费模式,最大带宽等 */ export interface InternetAccessible { /** * 网络计费类型。取值范围: BANDWIDTH_PREPAID:预付费按带宽结算 TRAFFIC_POSTPAID_BY_HOUR:流量按小时后付费 BANDWIDTH_POSTPAID_BY_HOUR:带宽按小时后付费 BANDWIDTH_PACKAGE:带宽包用户 默认取值:非带宽包用户默认与子机付费类型保持一致。 */ InternetChargeType?: string; /** * 公网出带宽上限,单位:Mbps。默认值:0Mbps。不同机型带宽上限范围不一致,具体限制详见购买网络带宽。 */ InternetMaxBandwidthOut?: number; } /** * 描述CFS文件系统版本和挂载信息 */ export interface CFSOption { /** * 文件系统本地挂载路径 */ LocalPath: string; /** * 文件系统远程挂载ip及路径 */ RemotePath: string; /** * 文件系统协议类型,默认值NFS 3.0。 <li>NFS 3.0。 <li>NFS 4.0。 <li>TURBO。 */ Protocol?: string; /** * 文件系统存储类型,默认值SD;其中 SD 为通用标准型标准型存储, HP为通用性能型存储, TB为turbo标准型, TP 为turbo性能型。 */ StorageType?: 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?: Array<SystemDisk>; /** * 节点数据盘配置信息。若不指定该参数,则默认不购买数据盘。支持购买的时候指定21块数据盘,其中最多包含1块LOCAL_BASIC数据盘或者LOCAL_SSD数据盘,最多包含20块CLOUD_BASIC数据盘、CLOUD_PREMIUM数据盘或者CLOUD_SSD数据盘。 */ DataDisks?: Array<DataDisk>; /** * 公网带宽相关信息设置。若不指定该参数,则默认公网带宽为0Mbps。 */ InternetAccessible?: Array<InternetAccessible>; /** * 节点显示名称。<br><li> 不指定节点显示名称则默认显示‘未命名’。 最多支持60个字符。</li> */ InstanceName?: string; } /** * CreateCluster请求参数结构体 */ export interface CreateClusterRequest { /** * 集群中实例所在的位置。 */ Placement: Placement; /** * 指定管理节点。 */ ManagerNode?: ManagerNode; /** * 指定管理节点的数量。默认取值:1。取值范围:1~2。 */ ManagerNodeCount?: number; /** * 指定计算节点。 */ ComputeNode?: ComputeNode; /** * 指定计算节点的数量。默认取值:0。 */ ComputeNodeCount?: number; /** * 调度器类型。<br><li>SGE:SGE调度器。</li><br><li>SLURM:SLURM调度器。</li> */ SchedulerType?: string; /** * 指定有效的[镜像](https://cloud.tencent.com/document/product/213/4940)ID,格式形如`img-xxx`。目前仅支持公有镜像。 */ ImageId?: string; /** * 私有网络相关信息配置。 */ VirtualPrivateCloud?: VirtualPrivateCloud; /** * 集群登录设置。 */ LoginSettings?: LoginSettings; /** * 集群中实例所属安全组。该参数可以通过调用 [DescribeSecurityGroups](https://cloud.tencent.com/document/api/215/15808) 的返回值中的sgId字段来获取。若不指定该参数,则绑定默认安全组。 */ SecurityGroupIds?: Array<string>; /** * 用于保证请求幂等性的字符串。该字符串由客户生成,需保证不同请求之间唯一,最大值不超过64个ASCII字符。若不指定该参数,则无法保证请求的幂等性。 */ ClientToken?: string; /** * 是否只预检此次请求。 true:发送检查请求,不会创建实例。检查项包括是否填写了必需参数,请求格式,业务限制和云服务器库存。 如果检查不通过,则返回对应错误码; 如果检查通过,则返回RequestId. false(默认):发送正常请求,通过检查后直接创建实例 */ DryRun?: boolean; /** * 域名字服务类型。默认值:NIS<li>NIS:NIS域名字服务。</li> */ AccountType?: string; /** * 集群显示名称。 */ ClusterName?: string; /** * 集群存储选项 */ StorageOption?: StorageOption; /** * 已废弃。 指定登录节点。 */ LoginNode?: Array<LoginNode>; /** * 已废弃。 指定登录节点的数量。默认取值:0。取值范围:0~10。 */ LoginNodeCount?: number; /** * 创建集群时同时绑定的标签对说明。 */ Tags?: Array<Tag>; } /** * 标签键值对。 */ export interface Tag { /** * 标签键 */ Key: string; /** * 标签值 */ Value: string; } /** * CreateCluster返回参数结构体 */ export interface CreateClusterResponse { /** * 集群ID。 */ ClusterId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * BindAutoScalingGroup返回参数结构体 */ export interface BindAutoScalingGroupResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 管控节点概览。 */ export interface ManagerNodeOverview { /** * 管控节点ID。 */ NodeId?: string; } /** * 管控节点信息 */ export interface ManagerNode { /** * 节点[计费类型](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> 不指定节点显示名称则默认显示‘未命名’。 </li><li>购买多个节点,如果指定模式串`{R:x}`,表示生成数字[`[x, x+n-1]`,其中`n`表示购买节点的数量,例如`server_{R:3}`,购买1个时,节点显示名称为`server_3`;购买2个时,节点显示名称分别为`server_3`,`server_4`。支持指定多个模式串`{R:x}`。 购买多个节点,如果不指定模式串,则在节点显示名称添加后缀`1、2...n`,其中`n`表示购买节点的数量,例如`server_`,购买2个时,节点显示名称分别为`server_1`,`server_2`。</li><li> 最多支持60个字符(包含模式串)。</li> */ InstanceName?: string; } /** * DeleteCluster请求参数结构体 */ export interface DeleteClusterRequest { /** * 集群ID。 */ ClusterId: string; } /** * 计算节点概览。 */ export interface ComputeNodeOverview { /** * 计算节点ID。 */ NodeId?: string; } /** * 描述了操作系统所在块设备即系统盘的信息 */ export interface SystemDisk { /** * 系统盘类型。系统盘类型限制详见存储概述。取值范围: LOCAL_BASIC:本地硬盘 LOCAL_SSD:本地SSD硬盘 CLOUD_BASIC:普通云硬盘 CLOUD_SSD:SSD云硬盘 CLOUD_PREMIUM:高性能云硬盘 默认取值:当前有库存的硬盘类型。 */ DiskType?: string; /** * 系统盘大小,单位:GB。默认值为 50 */ DiskSize?: number; } /** * 描述了实例的抽象位置 */ export interface Placement { /** * 实例所属的可用区名称。该参数可以通过调用 [DescribeZones](https://cloud.tencent.com/document/product/213/15707) 的返回值中的Zone字段来获取。 */ Zone: string; } /** * BindAutoScalingGroup请求参数结构体 */ export interface BindAutoScalingGroupRequest { /** * 集群ID。 */ ClusterId: string; /** * 弹性伸缩启动配置ID。 */ LaunchConfigurationId: string; /** * 弹性伸缩组ID。 */ AutoScalingGroupId: string; /** * 队列名称。 */ QueueName?: string; /** * 任务连续等待时间,队列的任务处于连续等待的时间。单位秒。默认值120。 */ ExpansionBusyTime?: number; /** * 节点连续空闲(未运行作业)时间,一个节点连续处于空闲状态时间。单位秒。默认值300。 */ ShrinkIdleTime?: number; /** * 是否开启自动扩容,默认值true。 */ EnableAutoExpansion?: boolean; /** * 是否开启自动缩容,默认值true。 */ EnableAutoShrink?: boolean; /** * 是否只预检此次请求。 true:发送检查请求,不会绑定弹性伸缩组。检查项包括是否填写了必需参数,请求格式,业务限制。 如果检查不通过,则返回对应错误码; 如果检查通过,则返回RequestId。 false(默认):发送正常请求,通过检查后直接绑定弹性伸缩组。 */ DryRun?: boolean; } /** * 描述了VPC相关信息 */ export interface VirtualPrivateCloud { /** * 私有网络ID,形如`vpc-xxx`。有效的VpcId可通过登录[控制台](https://console.cloud.tencent.com/vpc/vpc?rid=1)查询;也可以调用接口 [DescribeVpcEx](/document/api/215/1372) ,从接口返回中的`unVpcId`字段获取。若在创建子机时VpcId与SubnetId同时传入`DEFAULT`,则强制使用默认vpc网络。 */ VpcId: string; /** * 私有网络子网ID,形如`subnet-xxx`。有效的私有网络子网ID可通过登录[控制台](https://console.cloud.tencent.com/vpc/subnet?rid=1)查询;也可以调用接口 [DescribeSubnets](/document/api/215/15784) ,从接口返回中的`unSubnetId`字段获取。若在创建子机时SubnetId与VpcId同时传入`DEFAULT`,则强制使用默认vpc网络。 */ SubnetId: string; } /** * 描述集群文件系统选项 */ export interface StorageOption { /** * 集群挂载CFS文件系统选项 */ CFSOptions?: Array<CFSOption>; /** * 集群挂在GooseFS文件系统选项 */ GooseFSOptions?: Array<GooseFSOption>; } /** * 登录节点概览。 */ export interface LoginNodeOverview { /** * 登录节点ID。 */ NodeId: string; } /** * 计算节点信息。 */ export interface ComputeNode { /** * 节点[计费类型](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> */ InstanceName?: string; } /** * DescribeClusters返回参数结构体 */ export interface DescribeClustersResponse { /** * 集群概览信息列表。 */ ClusterSet?: Array<ClusterOverview>; /** * 集群数量。 */ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 描述GooseFS挂载信息 */ export interface GooseFSOption { /** * 文件系统本地挂载路径 */ LocalPath: string; /** * 文件系统远程挂载路径 */ RemotePath: string; /** * 文件系统master的ip和端口 */ Masters: Array<string>; } /** * 描述了实例的计费模式 */ export interface InstanceChargePrepaid { /** * 购买实例的时长,单位:月。取值范围:1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 24, 36, 48, 60。 */ Period: number; /** * 自动续费标识。取值范围: NOTIFY_AND_AUTO_RENEW:通知过期且自动续费 NOTIFY_AND_MANUAL_RENEW:通知过期不自动续费 DISABLE_NOTIFY_AND_MANUAL_RENEW:不通知过期不自动续费 默认取值:NOTIFY_AND_MANUAL_RENEW。若该参数指定为NOTIFY_AND_AUTO_RENEW,在账户余额充足的情况下,实例到期后将按月自动续费。 */ RenewFlag?: string; } /** * 描述了数据盘的信息 */ export interface DataDisk { /** * 数据盘大小,单位:GB。最小调整步长为10G,不同数据盘类型取值范围不同,具体限制详见:[存储概述](https://cloud.tencent.com/document/product/213/4952)。默认值为0,表示不购买数据盘。更多限制详见产品文档。 */ DiskSize: number; /** * 数据盘类型。数据盘类型限制详见[存储概述](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><br>默认取值:LOCAL_BASIC。 */ DiskType?: string; }