调用CreateGlobalAccelerationInstance创建全球加速实例。
API描述
本接口只支持创建后付费的全球加速实例。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | CreateGlobalAccelerationInstance | 要执行的操作，取值：CreateGlobalAccelerationInstance。 |
| Bandwidth | String | 是 | 10 | 全球加速实例的带宽峰值，单位为Mbps，取值：10。 |
| RegionId | String | 是 | cn-hangzhou | 全球加速实例所在的地域。 您可以通过调用DescribeRegions接口获取地域ID。 |
| ServiceLocation | String | 是 | china-mainland | 被加速的服务的所属区域，取值：
|
| BandwidthType | String | 否 | Exclusive | 实例带宽类型，取值：
|
| Name | String | 否 | GA-1 | 全球加速实例的名称。 长度为2~128个字符，必须以字母或中文开头，可包含数字、点号（.）、下划线（_）和短横线（-），但不能以 |
| Description | String | 否 | My GA | 全球加速实例的描述信息。 长度为2~256个字符，必须以字母或中文开头，但不能以 |
| ClientToken | String | 否 | 02fb3da4-130e-11e9-8e44-0016e04115b | 客户端token，用于保证请求的幂等性。 由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过64个ASCII字符。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| GlobalAccelerationInstanceId | String | ga-bp1fi6sq7npnicmjj**** | 全球加速实例的ID。 |
| IpAddress | String | 12.xx.xx.78 | 全球加速实例的公网IP地址。 如果BandwidthType取值为Sharing，则不返回该参数。 |
| RequestId | String | 4EC47282-1B74-4534-BD0E-403F3EE64CAF | 请求ID。 |
示例
请求示例
https://vpc.aliyuncs.com/?Action=CreateGlobalAccelerationInstance &Bandwidth=10 &RegionId=cn-hangzhou &ServiceLocation=china-mainland &<公共请求参数>
正常返回示例
XML 格式
<CreateGlobalAccelerationInstanceResponse> <GlobalAccelerationInstanceId>ga-t4nluhu****</GlobalAccelerationInstanceId> <IpAddress>12.34.56.78</IpAddress> <RequestId>4EC47282-1B74-4534-BD0E-403F3EE64CAF</RequestId> </CreateGlobalAccelerationInstanceResponse>
JSON 格式
{
"GlobalAccelerationInstanceId": "ga-bp1fi6sq7npnicmjj****",
"IpAddress": "12.xx.xx.78",
"RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF "
}
错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidServiceLocation.ValueNotSupported | The specified ServiceLocation is not supported. | 指定的服务区域不支持。 |
| 400 | InvalidGlobalAccelerationInstanceName.Malformed | The specified Name is not valid. | 名称格式不正确。 |
| 400 | InvalidGlobalAccelerationInstanceDescription.Malformed | The specified Description is not valid. | 描述格式不正确。 |
访问错误中心查看更多错误码。
