开通桌面上网功能 - ApplyDesktopsInternet
功能介绍
开通桌面上网功能。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
POST /v2/{project_id}/eips
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目ID。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
desktop_ids | 否 | Array of strings | 需要开通上网功能的桌面id列表。 |
eip_type | 是 | String | 支持的类型请参考EIP服务支持的类型。可通过调用如下链接的接口查询，https://support.huaweicloud.com/api-eip/ShowPublicIpType.html。 |
eip_charge_mode | 是 | String | eip带宽计费模式 |
bandwidth_size | 是 | Integer | 带宽大小，单位Mbit/s。默认1Mbit/s~2000Mbit/s（具体范围以各区域配置为准，请参见控制台对应页面显示）。 |
enterprise_project_id | 否 | String | 企业项目ID，默认"0。" |
count | 否 | Integer | 需要购买EIP的数量，当desktop_ids为空时需要填，兼容单独购买EIP场景。 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
job_id | String | 任务id。 |
状态码：default
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码，失败时返回。 |
error_msg | String | 错误描述。 |
error_detail | String | 错误详情。 |
encoded_authorization_message | String | 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 |
请求示例
/v2/0e69423d4400f4a82f67c0059a1e4cc8/eips
{
"desktop_ids" : [ "90f05916-bc71-4e26-a534-d036188d96e3" ],
"eip_charge_mode" : "string",
"bandwidth_size" : 1,
"eip_type" : "5_bgp"
} 响应示例
状态码：200
开通上网功能响应。
{
"job_id" : "fa9e41e1-1221-47c3-a43c-67a1271e2093"
} 状态码
状态码 | 描述 |
|---|---|
200 | 开通上网功能响应。 |
default | 默认响应。 |
错误码
请参见错误码。
