功能介绍
创建 全球加速 器。
调用方法
请参见如何调用API。
URI
POST /v1/accelerators
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
全球加速器名称,取值范围:1~64个字符之间,只能由数字、字母、中划线和中文组成。 最小长度:1 最大长度:64 |
description |
否 |
String |
全球加速器描述信息,取值范围:0~255个字符之间,禁止输入字符:<>。 最小长度:0 最大长度:255 |
ip_sets |
是 |
全球加速器IP列表。 数组长度:1 - 1 |
|
ent erp rise_project_id |
是 |
String |
租户的企业项目ID,最大长度36个字符,带"-"连字符的UUID格式,或者是字符串"0"。"0"表示默认企业项目。 最小长度:0 最大长度:36 |
tags |
否 |
标签列表。 数组长度:1 - 20 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
ip_type |
是 |
String |
IP地址类型,取值:IPV4 枚举值:
|
area |
是 |
String |
地区,取值:
枚举值:
|
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
key |
是 |
String |
标签键,规则:
最小长度:1 最大长度:128 |
value |
是 |
String |
标签值,规则:
最小长度:0 最大长度:255 |
响应参数
状态码: 201
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
全球加速器ID。 |
name |
String |
全球加速器名称,取值范围:1~64个字符之间,只能由数字、字母、中划线和中文组成。 最小长度:1 最大长度:64 |
description |
String |
全球加速器描述信息,取值范围:0~255个字符之间,禁止输入字符:<>。 最小长度:0 最大长度:255 |
status |
String |
配置状态,取值:
枚举值:
|
ip_sets |
全球加速器IP列表。 数组长度:1 - 1 |
|
created_at |
String |
创建时间。 |
updated_at |
String |
更新时间。 |
domain_id |
String |
租户ID。 |
enterprise_project_id |
String |
租户的企业项目ID。 |
flavor_id |
String |
规格ID。 |
frozen_info |
云服务 或资源实例冻结信息。 |
|
tags |
标签列表。 |
参数 |
参数类型 |
描述 |
---|---|---|
ip_type |
String |
IP地址类型。 枚举值:
|
ip_address |
String |
IP地址。 |
area |
String |
地区,取值:
枚举值:
|
参数 |
参数类型 |
描述 |
---|---|---|
status |
Integer |
云服务或资源实例状态,取值:
最小值:0 最大值:2 |
effect |
Integer |
在冻结/解冻操作下,取值:
最小值:1 最大值:3 缺省值:1 |
scene |
Array of strings |
更新云服务状态的业务场景列表,取值:
最大长度:16 |
参数 |
参数类型 |
描述 |
---|---|---|
key |
String |
标签键,规则:
最小长度:1 最大长度:128 |
value |
String |
标签值,规则:
最小长度:0 最大长度:255 |
请求示例
创建一个中国大陆以外的全球加速器,IP地址类型为IPV4。
POST https://{ga_endpoint}/v1/accelerators { "accelerator" : { "name" : "acceleratorName", "description" : "accelerator description", "ip_sets" : [ { "ip_type" : "IPV4", "area" : "OUTOFCM" } ], "enterprise_project_id" : "0aad99bc-f5f6-4f78-8404-c598d76b0ed2", "tags" : [ { "key" : "tagKey", "value" : "tagValue" } ] } }
响应示例
状态码: 201
创建成功
{ "accelerator" : { "id" : "ac1bf54f-6a23-4074-af77-800648d25bc8", "name" : "acceleratorName", "description" : "accelerator description", "status" : "ACTIVE", "ip_sets" : [ { "ip_type" : "IPV4", "ip_address" : "208.188.100.1", "area" : "OUTOFCM" } ], "created_at" : "2019-01-08T01:21:37.151Z", "updated_at" : "2019-01-08T01:21:37.151Z", "domain_id" : "99a3fff0d03c428eac3678da6a7d0f24", "enterprise_project_id" : "0aad99bc-f5f6-4f78-8404-c598d76b0ed2", "flavor_id" : "00000000-0000-0000-0000-000000000000", "frozen_info" : { "status" : 2, "effect" : 1, "scene" : [ "ARREAR", "POLICE" ] }, "tags" : [ { "key" : "tagKey", "value" : "tagValue" } ] }, "request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9" }
状态码
状态码 |
描述 |
---|---|
201 |
创建成功 |
错误码
请参见错误码。