创建GlobalSSH实例 - CreateGlobalSSHInstance
简介
创建GlobalSSH实例
ℹ️ 单一项目下入门版本的GlobalSSH实例有配额限制。
定义
公共参数
参数名 | 类型 | 描述信息 | 必填 |
---|---|---|---|
Action | string | 对应的 API 指令名称,当前 API 为 CreateGlobalSSHInstance | Yes |
PublicKey | string | 用户公钥,可从 控制台 获取 | Yes |
Signature | string | 根据公钥及 API 指令生成的用户签名,参见 签名算法 | Yes |
请求参数
参数名 | 类型 | 描述信息 | 必填 |
---|---|---|---|
ProjectId | string | 项目ID,如org-xxxx。请参考GetProjectList接口 | Yes |
Area | string | 填写支持SSH访问IP的地区名称,如“洛杉矶”,“新加坡”,“香港”,“东京”,“华盛顿”,“法兰克福”,“首尔”。Area和AreaCode两者必填一个 | Yes |
TargetIP | string | 被SSH访问的源站IP,仅支持IPv4地址。 | Yes |
Port | int | 源站服务器监听的SSH端口,可取范围[1-65535],不能使用80,443, 65123端口。如果InstanceType=Free,取值范围缩小为[22,3389],linux系统选择22,windows系统自动选3389。 | Yes |
AreaCode | string | AreaCode, 区域航空港国际通用代码。Area和AreaCode两者必填一个 | Yes |
Remark | string | 备注信息 | No |
ChargeType | string | 支付方式,如按月:Month、 按年:Year、按时:Dynamic | No |
Quantity | int | 购买数量 按月购买至月底请传0 | No |
InstanceType | string | 枚举值:[“Ultimate”,“Enterprise”,“Basic”,“Primary”], 分别代表旗舰版,企业版,基础版,入门版 | No |
BandwidthPackage | int | Ultimate版本带宽包大小,枚举值:[0,20,40]。单位MB | No |
ForwardRegion | string | InstanceType等于Basic时可以在[“cn-bj2”,“cn-sh2”,“cn-gd”]中选择1个作为转发机房,其他付费版默认配置三个转发机房 | No |
CouponId | string | 使用代金券可冲抵部分费用 | No |
响应字段
字段名 | 类型 | 描述信息 | 必填 |
---|---|---|---|
RetCode | int | 返回状态码,为 0 则为成功返回,非 0 为失败 | Yes |
Action | string | 操作指令名称 | Yes |
Message | string | 返回错误消息,当 RetCode 非 0 时提供详细的描述信息 | No |
InstanceId | string | 实例ID,资源唯一标识 | Yes |
AcceleratingDomain | string | 加速域名,访问该域名可就近接入 | No |
示例
请求示例
https://api.tnqacloud.com/?Action=CreateGlobalSSHInstance
&ProjectId=org-xxxx
&Remark=备注
&Area=洛杉矶
&TargetIP=1.1.2.2
&Port=22
&CouponId=coupon-123
&ChargeType=Year
&Quantity=1
&AreaCode=LAX
&InstanceType=Basic
&BandwidthPackage=5
&ForwardRegion=UKclgoRu
响应示例
{
"AcceleratingDomain": "1.1.2.2.ipssh.net",
"Action": "CreateGlobalSSHInstanceResponse",
"InstanceId": "uga-xxxx",
"Message": "",
"RetCode": 0
}