华为云计算 云知识 按需转包接口ChangePublicipToPeriod
按需转包接口ChangePublicipToPeriod

 

功能介绍

该接口用于将按需计费模式的EIP转为包年/包月计费模式的EIP。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v2.0/{project_id}/publicips/change-to-period

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目 ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

publicip_ids

Array

待按需转包IP列表

extendParam

CreatePrePaidPublicipExtendParamOption object

按需转包周期参数

表3 CreatePrePaidPublicipExtendParamOption

参数

是否必选

参数类型

描述

charge_mode

String

  • 功能说明:付费方式(预付费、按需付费;预付费,即包周期付费)

  • 取值范围:

    • prePaid -预付费,即包年包月;

    • postPaid-后付费,即按需付费;

  • 后付费的场景下,extendParam的其他字段都会被忽略。

缺省值:postPaid

枚举值:

  • prePaid

  • postPaid

period_type

String

  • 功能说明:订购资源的周期类型(包年、包月等)

  • 取值范围:

    • month-月

    • year-年

  • 约束:如果用包周期共享带宽创建时(即携带共享带宽id创建EIP)此字段可不填。付费方式是预付费且不是使用共享带宽创建IP时,该字段必选; 使用共享带宽创建IP时,带宽资源到期时间与IP的到期时间相同。

枚举值:

  • month

  • year

period_num

Integer

  • 功能说明:订购周期数

  • 取值范围:(后续会随运营策略变化)

    • period_type为month时,为[1,9]

    • period_type为year时,为[1,3]

  • 约束:同period_type约束。

最小值:1

最大值:9

is_auto_renew

Boolean

  • 功能说明:是否自动续订

  • 取值范围: false:不自动续订 true:自动续订

  • 约束:到期后,默认自动续订1个月(自动续订时间后续可能会变化),详情可联系客服咨询。

缺省值:false

is_auto_pay

Boolean

  • 功能说明:下单订购后,是否自动从客户的账户中支付

  • 取值范围:

    • true:自动支付,从账户余额自动扣费

    • false:只提交订单不支付,需要客户手动去支付

  • 约束:自动支付时,只能使用账户的现金支付;如果要使用代金券,请选择不自动支付,然后在用户费用中心,选择代金券支付。

缺省值:false

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

publicip_ids

Array

转包IP列表

order_id

String

订单ID

request_id

String

请求ID

请求示例

将ID为fe2a11c7-c880-49f7-b1e0-e151df2cc836的按需 弹性公网IP 转为包周期弹性 公网IP ,订购周期为1个月,不自动续费。

{
  "publicip_ids" : [ "fe2a11c7-c880-49f7-b1e0-e151df2cc836" ],
  "extendParam" : {
    "charge_mode" : "prePaid",
    "period_type" : "month",
    "period_num" : 1,
    "is_auto_renew" : false,
    "is_auto_pay" : true
  }
}

响应示例

状态码: 200

请求成功

{
  "publicip_ids" : [ "2c3b404b-d595-4ab5-a333-69f3ff937dc2" ],
  "order_id" : "CS2212141730K2FGR",
  "request_id" : "9d5bc34c-810f-48f2-95c4-9c48d02f2a33"
}

状态码

状态码

描述

200

请求成功

错误码

请参见错误码

 

上一篇:阿帕WMS仓储管理入库操作 下一篇:迪柯尼的数字神经系统

华为云开发者中心为开发者提供所有云服务的API及API手册、各产品的SDK、可服务的节点区域和各服务的终端节点EndPoint和在使用华为云产品时需要用到的CLI工具、业务工具等的下载及使用说明。