華為云計(jì)算 云知識(shí) 創(chuàng)建全球加速器CreateAccelerator
創(chuàng)建全球加速器CreateAccelerator

 

功能介紹

創(chuàng)建 全球加速 器。

調(diào)用方法

請(qǐng)參見如何調(diào)用API。

URI

POST /v1/accelerators

請(qǐng)求參數(shù)

表1 請(qǐng)求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值)。

表2 請(qǐng)求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

accelerator

CreateAcceleratorOption object

創(chuàng)建全球加速器實(shí)例的詳細(xì)信息。

表3 CreateAcceleratorOption

參數(shù)

是否必選

參數(shù)類型

描述

name

String

全球加速器名稱,取值范圍:1~64個(gè)字符之間,只能由數(shù)字、字母、中劃線和中文組成。

最小長度:1

最大長度:64

description

String

全球加速器描述信息,取值范圍:0~255個(gè)字符之間,禁止輸入字符:<>。

最小長度:0

最大長度:255

ip_sets

Array of ip_sets objects

全球加速器IP列表。

數(shù)組長度:1 - 1

enterprise_project_id

String

租戶的企業(yè)項(xiàng)目ID,最大長度36個(gè)字符,帶"-"連字符的UUID格式,或者是字符串"0"。"0"表示默認(rèn)企業(yè)項(xiàng)目。

最小長度:0

最大長度:36

tags

Array of ResourceTag objects

標(biāo)簽列表。

數(shù)組長度:1 - 20

表4 ip_sets

參數(shù)

是否必選

參數(shù)類型

描述

ip_type

String

IP地址類型,取值:IPV4

枚舉值:

  • IPV4

area

String

地區(qū),取值:

  • OUTOFCM:中國大陸以外

  • CM:中國大陸

枚舉值:

  • OUTOFCM

  • CM

表5 ResourceTag

參數(shù)

是否必選

參數(shù)類型

描述

key

String

標(biāo)簽鍵,規(guī)則:

  • 1.key不能為空,長度1~128個(gè)字符(中文也可以輸入128個(gè)字符)。

  • 2.可用 UTF-8 格式表示的字母(包含中文)、數(shù)字和空格,以及以下字符_ . : = + - @。

  • 3._sys_開頭屬于系統(tǒng)標(biāo)簽,租戶不能輸入。

最小長度:1

最大長度:128

value

String

標(biāo)簽值,規(guī)則:

  • 1.長度0~255個(gè)字符(中文也可以輸入255個(gè)字符)。

  • 2.可用 UTF-8 格式表示的字母(包含中文)、數(shù)字和空格,以及以下字符_ . : / = + - @。

  • 3.資源標(biāo)簽值可以為空(empty or null)。

最小長度:0

最大長度:255

響應(yīng)參數(shù)

狀態(tài)碼: 201

表6 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

accelerator

AcceleratorDetail object

全球加速器實(shí)例。

request_id

String

請(qǐng)求ID。

表7 AcceleratorDetail

參數(shù)

參數(shù)類型

描述

id

String

全球加速器ID。

name

String

全球加速器名稱,取值范圍:1~64個(gè)字符之間,只能由數(shù)字、字母、中劃線和中文組成。

最小長度:1

最大長度:64

description

String

全球加速器描述信息,取值范圍:0~255個(gè)字符之間,禁止輸入字符:<>。

最小長度:0

最大長度:255

status

String

配置狀態(tài),取值:

  • ACTIVE:運(yùn)行中

  • PENDING:待定

  • ERROR:錯(cuò)誤

  • DELETING:正在刪除

枚舉值:

  • ACTIVE

  • PENDING

  • ERROR

  • DELETING

ip_sets

Array of AccelerateIp objects

全球加速器IP列表。

數(shù)組長度:1 - 1

created_at

String

創(chuàng)建時(shí)間。

updated_at

String

更新時(shí)間。

domain_id

String

租戶ID。

enterprise_project_id

String

租戶的企業(yè)項(xiàng)目ID。

flavor_id

String

規(guī)格ID。

frozen_info

FrozenInfo object

云服務(wù)或資源實(shí)例凍結(jié)信息。

tags

Array of ResourceTag objects

標(biāo)簽列表。

表8 AccelerateIp

參數(shù)

參數(shù)類型

描述

ip_type

String

IP地址類型。

枚舉值:

  • IPV4

ip_address

String

IP地址。

area

String

地區(qū),取值:

  • OUTOFCM:中國大陸以外

  • CM:中國大陸

枚舉值:

  • OUTOFCM

  • CM

表9 FrozenInfo

參數(shù)

參數(shù)類型

描述

status

Integer

云服務(wù)或資源實(shí)例狀態(tài),取值:

  • 0:解凍/正常(云服務(wù)恢復(fù)正常)。

  • 1:凍結(jié)(資源和數(shù)據(jù)會(huì)保留,但租戶無法再正常使用云服務(wù))。

  • 2:刪除/終止(資源和數(shù)據(jù)將清除)。

最小值:0

最大值:2

effect

Integer

在凍結(jié)/解凍操作下,取值:

  • 1(默認(rèn)值):凍結(jié)可釋放。

  • 2:凍結(jié)不可釋放。

  • 3:凍結(jié)后不可續(xù)費(fèi)。

最小值:1

最大值:3

缺省值:1

scene

Array of strings

更新云服務(wù)狀態(tài)的業(yè)務(wù)場(chǎng)景列表,取值:

  • ARREAR(默認(rèn)值):欠費(fèi)場(chǎng)景。為正常的運(yùn)營業(yè)務(wù)場(chǎng)景,包括包周期資源到期、按需資源扣費(fèi)失敗。

  • POLICE:公安凍結(jié)場(chǎng)景。

  • ILLEGAL:違規(guī)凍結(jié)場(chǎng)景。

  • VERIFY:客戶未實(shí)名認(rèn)證凍結(jié)場(chǎng)景。

  • PARTNER:合作伙伴凍結(jié)(合作伙伴凍結(jié)子客戶資源)。

最大長度:16

表10 ResourceTag

參數(shù)

參數(shù)類型

描述

key

String

標(biāo)簽鍵,規(guī)則:

  • 1.key不能為空,長度1~128個(gè)字符(中文也可以輸入128個(gè)字符)。

  • 2.可用 UTF-8 格式表示的字母(包含中文)、數(shù)字和空格,以及以下字符_ . : = + - @。

  • 3._sys_開頭屬于系統(tǒng)標(biāo)簽,租戶不能輸入。

最小長度:1

最大長度:128

value

String

標(biāo)簽值,規(guī)則:

  • 1.長度0~255個(gè)字符(中文也可以輸入255個(gè)字符)。

  • 2.可用 UTF-8 格式表示的字母(包含中文)、數(shù)字和空格,以及以下字符_ . : / = + - @。

  • 3.資源標(biāo)簽值可以為空(empty or null)。

最小長度:0

最大長度:255

請(qǐng)求示例

創(chuàng)建一個(gè)中國大陸以外的全球加速器,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"
    } ]
  }
}

響應(yīng)示例

狀態(tài)碼: 201

創(chuàng)建成功

{
  "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"
}

狀態(tài)碼

狀態(tài)碼

描述

201

創(chuàng)建成功

錯(cuò)誤碼

請(qǐng)參見錯(cuò)誤碼