- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
- 用户指南
- 最佳实践
- API参考
- SDK参考
- 场景代码示例
- 常见问题
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
按需转包年/包月弹性公网IP
功能介绍
该接口用于将按需计费模式的弹性公网IP转为包年/包月计费模式的弹性公网IP。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。
URI
POST /v2.0/{project_id}/publicips/change-to-period
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取项目ID请参见获取项目ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
publicip_ids |
是 |
Array of strings |
待按需转包IP列表 |
extendParam |
是 |
按需转包周期参数 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
charge_mode |
否 |
String |
缺省值:postPaid |
period_type |
否 |
String |
|
period_num |
否 |
Integer |
最小值:1 最大值:9 |
is_auto_renew |
否 |
Boolean |
缺省值:false |
is_auto_pay |
否 |
Boolean |
缺省值:false |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
publicip_ids |
Array of strings |
转包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 |
请求成功 |
错误码
请参见错误码。