華為云計(jì)算 云知識(shí) 購(gòu)買(mǎi)自定義網(wǎng)絡(luò)云手機(jī)服務(wù)器CreateNet2CloudPhoneServer
購(gòu)買(mǎi)自定義網(wǎng)絡(luò)云手機(jī)服務(wù)器CreateNet2CloudPhoneServer
時(shí)間: 2023-08-10 10:33:47
猜你想看：
實(shí)時(shí)語(yǔ)音識(shí)別 云服務(wù)器配置 CDN是什么意思 視頻點(diǎn)播加速 什么是云桌面

 

功能介紹

購(gòu)買(mǎi) 云手機(jī) 服務(wù)器，支持您復(fù)用已有的VPC網(wǎng)絡(luò)管理云手機(jī)服務(wù)器，支持云手機(jī)服務(wù)器復(fù)用您已購(gòu)買(mǎi)的共享帶寬等資源。

  • 請(qǐng)確保您已具有 虛擬私有云 資源，創(chuàng)建服務(wù)器需要指定一個(gè)已有的虛擬 私有云 ，否則無(wú)法創(chuàng)建服務(wù)器。

  • 請(qǐng)確保已正確創(chuàng)建委托（委托名稱cph_admin_trust，委托服務(wù)CPH），委托未被刪除， 確保委托包含VPC FullAccess權(quán)限，委托及權(quán)限校驗(yàn)失敗將導(dǎo)致 云服務(wù)器 創(chuàng)建失敗。創(chuàng)建委托時(shí)委托類型選擇“云服務(wù)”，云服務(wù)選擇“CPH”，即允許CPH調(diào)用云服務(wù)。

  • 請(qǐng)確保您使用的賬號(hào)具有Security Administrator權(quán)限或者具備創(chuàng)建委托的細(xì)粒度權(quán)限iam:agencies:createAgency。

  • 請(qǐng)確保您有足夠的服務(wù)器及網(wǎng)絡(luò)配額，配額校驗(yàn)不通過(guò)將導(dǎo)致創(chuàng)建失敗。

調(diào)試

您可以在API Explorer中調(diào)試該接口，支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例，并提供SDK代碼示例調(diào)試功能。

URI

POST /v2/{project_id}/cloud-phone/servers

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

是

String

項(xiàng)目id。

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

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

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

是

String

用戶Token。 通過(guò)調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值）。
表3 請(qǐng)求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

server_name

是

String

云手機(jī)服務(wù)器名稱，不超過(guò)60個(gè)字符，只支持英文字母、數(shù)字、漢字、下劃線和中劃線。批量購(gòu)買(mǎi)會(huì)在服務(wù)器名稱后自動(dòng)添加序號(hào)，比如設(shè)置此參數(shù)為server-1，那么創(chuàng)建的云手機(jī)服務(wù)器名稱會(huì)自動(dòng)按序增加數(shù)字后綴，比如為server-1-0001。

server_model_name

是

String

云手機(jī)服務(wù)器規(guī)格，不超過(guò)64個(gè)字節(jié)。

phone_model_name

是

String

云手機(jī)規(guī)格，不超過(guò)64個(gè)字節(jié)。

image_id

是

String

云手機(jī) 鏡像 ID，不超過(guò)32個(gè)字節(jié)。

count

是

Integer

購(gòu)買(mǎi)的云手機(jī)服務(wù)器個(gè)數(shù)，最多可購(gòu)買(mǎi)10臺(tái)。

keypair_name

否

String

密鑰對(duì)名稱，不超過(guò)64個(gè)字節(jié)，用于云手機(jī)ADB登錄。

ports

否

Array of Port objects

云手機(jī)啟用的應(yīng)用端口，云手機(jī)服務(wù)會(huì)做端口轉(zhuǎn)發(fā)。

extend_param

是

extend_param object

計(jì)費(fèi)模式參數(shù)。

tenant_vpc_id

是

String

租戶自定義的VPC ID，為待創(chuàng)建的云服務(wù)器所屬的虛擬私有云（簡(jiǎn)稱VPC），需要指定已創(chuàng)建VPC的ID，UUID格式。

nics

是

Array of Nic objects

租戶自定義的網(wǎng)卡的結(jié)構(gòu)體，為待創(chuàng)建的云服務(wù)器的網(wǎng)卡信息。

public_ip

是

public_ip object

租戶自定義的 彈性公網(wǎng)IP 結(jié)構(gòu)體。

配置云服務(wù)器的彈性IP信息的方式，

自動(dòng)分配，需要指定新創(chuàng)建彈性IP的信息； 使用已有，需要指定已經(jīng)購(gòu)買(mǎi)的EIP ID。

phone_count_per_ip

否

Integer

多少個(gè)手機(jī)共用一個(gè)vip。默認(rèn)為手機(jī)開(kāi)數(shù)，表示所有手機(jī)共享1個(gè)vip。取值范圍：1到手機(jī)規(guī)格開(kāi)數(shù)。

phone_data_volume

否

phone_data_volume object

手機(jī)磁盤(pán)結(jié)構(gòu)體，2.0規(guī)格必選。

server_share_data_volume

否

server_share_data_volume object

共享存儲(chǔ)磁盤(pán)結(jié)構(gòu)體，2.0規(guī)格可選。

band_width

是

band_width object

云手機(jī)使用的帶寬信息。

availability_zone

否

String

待創(chuàng)建云服務(wù)器所在的可用區(qū)，需要指定可用區(qū)（AZ）的名稱。
表4 Port

參數(shù)

是否必選

參數(shù)類型

描述

name

是

String

應(yīng)用端口名稱，不超過(guò)16個(gè)字節(jié)，系統(tǒng)關(guān)鍵服務(wù)名稱不能使用"adb"和"vnc"。

listen_port

是

Integer

端口號(hào)，大于等于10000，小于等于50000。

internet_accessible

是

String

為"true"則映射出公網(wǎng)訪問(wèn)（忽略大小寫(xiě)）。 為其他則不映射。
表5 extend_param

參數(shù)

是否必選

參數(shù)類型

描述

charging_mode

是

Integer

計(jì)費(fèi)類型。

  • 0：包周期

period_type

是

Integer

訂購(gòu)周期類型。

  • 2：月

  • 3：年

period_num

是

Integer

訂購(gòu)周期數(shù)。 當(dāng)訂購(gòu)周期為月時(shí)，取值范圍[1, 9]。 當(dāng)訂購(gòu)周期為年時(shí)，取值范圍[1,10]。

is_auto_pay

否

Integer

是否自動(dòng)付款。默認(rèn)不自動(dòng)付款。

  • 1：自動(dòng)付款

  • 0：不自動(dòng)付款

is_auto_renew

否

Integer

是否自動(dòng)續(xù)訂。默認(rèn)不自動(dòng)續(xù)訂。

  • 1：自動(dòng)續(xù)訂

  • 0：不自動(dòng)續(xù)訂

enterprise_project_id

否

String

企業(yè)項(xiàng)目ID。 該字段不傳（或傳為字符串“0”），則將資源綁定給默認(rèn)企業(yè)項(xiàng)目。
表6 Nic

參數(shù)

是否必選

參數(shù)類型

描述

subnet_id

是

String

租戶自定義的子網(wǎng) ID，為待創(chuàng)建的云服務(wù)器所屬的子網(wǎng)。

需要指定tenant_vpc_id對(duì)應(yīng)VPC下已創(chuàng)建的子網(wǎng)（subnet）的網(wǎng)絡(luò)ID，UUID格式。

ipv6_enable

否

Boolean

是否支持ipv6。

取值為true時(shí)，標(biāo)識(shí)此網(wǎng)卡支持ipv6。

ipv6_bandwidth

否

ipv6_bandwidth object

綁定的共享帶寬信息，詳情請(qǐng)參見(jiàn) ipv6_bandwidth數(shù)據(jù)結(jié)構(gòu)說(shuō)明。
表7 ipv6_bandwidth

參數(shù)

是否必選

參數(shù)類型

描述

band_width_id

是

String

ipv6綁定的共享帶寬ID。
表8 public_ip

參數(shù)

是否必選

參數(shù)類型

描述

ids

否

Array of strings

指定已有的EIP進(jìn)行服務(wù)器創(chuàng)建，當(dāng)前只支持傳入一個(gè)已有的EIP ID。

eip

否

eip object

配置服務(wù)器自動(dòng)分配彈性IP時(shí)，創(chuàng)建彈性IP的配置參數(shù)，詳情見(jiàn) eip 結(jié)構(gòu)體。

count

否

Integer

Eip數(shù)量。默認(rèn)為1，不需要Eip可設(shè)置為0，取值范圍為0到手機(jī)IP數(shù)。
表9 eip

參數(shù)

是否必選

參數(shù)類型

描述

type

是

String

彈性 公網(wǎng)IP 的類型。

  • 5_telcom：電信

  • 5_union：聯(lián)通

  • 5_bgp：全動(dòng)態(tài)BGP

  • 5_sbgp：靜態(tài)BGP
表10 phone_data_volume

參數(shù)

是否必選

參數(shù)類型

描述

volume_type

是

String

磁盤(pán)類型，只支持如下類型：

  • SSD

  • GPSSD

size

是

Integer

磁盤(pán)大小，單位GB，取值范圍[0，32768]。
表11 server_share_data_volume

參數(shù)

是否必選

參數(shù)類型

描述

volume_type

是

String

磁盤(pán)類型，只支持如下類型：

  • SSD

  • GPSSD

size

是

Integer

磁盤(pán)大小，單位GB，取值范圍[0，32768]。
表12 band_width

參數(shù)

是否必選

參數(shù)類型

描述

band_width_id

否

String

云手機(jī)服務(wù)器的帶寬唯一標(biāo)識(shí)。

band_width_size

否

Integer

云手機(jī)服務(wù)器的帶寬大小。

band_width_charge_mode

是

Integer

云手機(jī)服務(wù)器帶寬的計(jì)費(fèi)方式。

  • 0：bandwidth, 按帶寬計(jì)費(fèi)

  • 1：traffic, 按流量計(jì)費(fèi)

band_width_share_type

是

Integer

云手機(jī)服務(wù)器的帶寬類型。

  • 0：per，獨(dú)享帶寬

  • 1：whole，共享帶寬

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

狀態(tài)碼： 200

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

參數(shù)

參數(shù)類型

描述

request_id

String

請(qǐng)求的唯一標(biāo)識(shí)ID。

order_id

String

訂單ID，不超過(guò)64個(gè)字節(jié)。

product_id

String

產(chǎn)品ID，不超過(guò)64個(gè)字節(jié)。

server_ids

Array of strings

服務(wù)器ID列表。

請(qǐng)求示例

購(gòu)買(mǎi)自定義網(wǎng)絡(luò)服務(wù)器

POST https://{CPH Endpoint}/v2/{project_id}/cloud-phone/servers

{
  "server_name" : "cph-kertus-1110",
  "server_model_name" : "physical.kg1.4xlarge.cp",
  "phone_model_name" : "kg1.cp.c20.d64SSD.e1v1",
  "image_id" : "20060220200717f201120a2300000e91",
  "count" : 1,
  "keypair_name" : "keypair",
  "ports" : [ {
    "name" : "myServer1",
    "listen_port" : 20000,
    "internet_accessible" : "false"
  }, {
    "name" : "myServer2",
    "listen_port" : 20001,
    "internet_accessible" : "true"
  } ],
  "extend_param" : {
    "charging_mode" : 0,
    "period_type" : 2,
    "period_num" : 1,
    "is_auto_pay" : 0
  },
  "tenant_vpc_id" : "fca063f6-b942-42a8-9004-e5545f58d6a2",
  "nics" : [ {
    "subnet_id" : "f1cbfc37-eb42-4357-a0ec-9e4f11950908"
  } ],
  "public_ip" : {
    "eip" : {
      "type" : "5_bgp"
    }
  },
  "band_width" : {
    "band_width_share_type" : 0,
    "band_width_size" : 300,
    "band_width_charge_mode" : 1
  }
}

響應(yīng)示例

狀態(tài)碼： 200

OK

{
  "request_id" : "1564567b8bab40f34711234cb80d8574",
  "order_id" : "CS1710111105S8IPB",
  "product_id" : "00301-25217-0--0",
  "server_ids" : [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ]
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

錯(cuò)誤碼

請(qǐng)參見(jiàn)錯(cuò)誤碼。

 

購(gòu)買(mǎi)自定義網(wǎng)絡(luò)云手機(jī)服務(wù)器CreateNet2CloudPhoneServer

意見(jiàn)反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會(huì)繼續(xù)努力做到更好 反饋提交失??！請(qǐng)稍后重試！