# 获取GlobalSSH升级价格 - GetGlobalSSHUpdatePrice

## 简介

获取GlobalSSH升级价格





## 定义

### 公共参数

| 参数名 | 类型 | 描述信息 | 必填 |
|:---|:---|:---|:---|
| **Action**     | string  | 对应的 API 指令名称，当前 API 为 `GetGlobalSSHUpdatePrice`                        | **Yes** |
| **PublicKey**  | string  | 用户公钥，可从 [控制台](https://console.genesissai.com/uaccount/api_manage) 获取                                             | **Yes** |
| **Signature**  | string  | 根据公钥及 API 指令生成的用户签名，参见 [签名算法](/docs/api/summary/signature.md)  | **Yes** |

### 请求参数

| 参数名 | 类型 | 描述信息 | 必填 |
|:---|:---|:---|:---|
| **ProjectId** | string | 项目ID,如org-xxxx。请参考[GetProjectList接口](api/summary/get_project_list) |**Yes**|
| **InstanceType** | string | 升级后的实例类型。枚举值，Enterprise:企业版；Basic:基础版。 |**Yes**|
| **InstanceId** | string | 实例ID，唯一资源标识。从免费版升级到付费版可不填，其他情况必填。 |No|
| **Quantity** | int | 购买周期，如果ChargeType为Month，Quantity可以不填默认为0；其他情况必须为正整数。 |No|
| **ChargeType** | string | 计费类型：Dynamic，Month，Year。从免费版升级到付费版必须传，其他情况不需要传 |No|

### 响应字段

| 字段名 | 类型 | 描述信息 | 必填 |
|:---|:---|:---|:---|
| **RetCode** | int | 返回状态码，为 0 则为成功返回，非 0 为失败 |**Yes**|
| **Action** | string | 操作指令名称 |**Yes**|
| **Message** | string | 返回错误消息，当 `RetCode` 非 0 时提供详细的描述信息 |No|
| **Price** | float | 价格,返回单位为元。正数表示付费升级，负数表示降级退费。 |No|




## 示例

### 请求示例
    
```
https://api.genesissai.com/?Action=GetGlobalSSHUpdatePrice
&ProjectId=org-xxxx
&InstanceType=Basic
&InstanceId=uga-xxxx
```

### 响应示例
    
```json
{
  "Action": "GetGlobalSSHUpdatePriceResponse",
  "Price": 5.15987,
  "RetCode": 0
}
```