云服务器内容精选

  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用 IAM 服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 表3 请求Body参数 参数 是否必选 参数类型 描述 cid 否 String 容器ID 最大长度:256 network_switch_policy_id 是 Long 网络切换策略标识
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 work_order_id Long 业务受理单号 状态码: 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码: 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述
  • 请求示例 切换三网卡策略 POST https://{endpoint}/v1/sim-cards/{sim_card_id}/network-switch-policy/set { "network_switch_policy_id" : 1 } 使用cid切换三网卡策略 POST https://{endpoint}/v1/sim-cards/0/network-switch-policy/set { "network_switch_policy_id" : 1, "cid" : "888888888888888881" }
  • 响应示例 状态码: 200 OK { "work_order_id" : 1000001 } 状态码: 400 Parameter Invalid { "error_code" : "GSL.00010004", "error_msg" : "参数异常" } 状态码: 500 Internal Server Error { "error_code" : "GSL.00010003", "error_msg" : "系统繁忙,请稍后重试。" }
  • 功能介绍 虚拟IP地址用于为网卡提供第二个IP地址,同时支持与多个弹性云服务器的网卡绑定,从而实现多个弹性云服务器之间的高可用性。 该接口用于给云服务器网卡配置虚拟IP地址: 当指定的IP地址是一个不存在的虚拟IP地址时,系统会创建该虚拟IP,并绑定至对应网卡。 当指定的IP地址是一个已经创建好的虚拟IP时,系统会将指定的网卡和虚拟IP绑定。如果该IP的device_owner为空,则仅支持VPC内二三层通信;如果该IP的device_owner为neutron:VIP_PORT,则支持VPC内二三层通信、VPC之间对等连接访问,以及弹性公网IP、VPN、云专线等Internet接入。 了解更多请参考虚拟IP简介。
  • 请求示例 PUT https://{endpoint}/v1/{project_id}/cloudservers/nics/{nic_id} { "nic": { "subnet_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23", "ip_address": "192.168.0.7", "reverse_binding": true } }
  • 请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 nic 是 Object 需要配置私有IP的网卡参数列表。更多信息请参见表3。 表3 nic字段数据结构说明 参数 是否必选 参数类型 描述 subnet_id 是 String 云服务器添加网卡的信息。 需要指定云服务器所属虚拟私有云下已创建的网络(network)的ID,UUID格式。 ip_address 是 String 网卡即将配置的虚拟IP的地址。 reverse_binding 否 Boolean 虚拟IP的allowed_address_pairs属性是否添加网卡的IP/Mac对。 说明: 添加IP/Mac对后才能在网卡详情页面正常展示虚拟IP的地址。
  • 控制台服务 卡管理 支持对卡进行激活、查询、充值、停复机管理。具体操作请参见SIM卡管理。 网络切换策略管理 支持在控制台配置网络切换策略,实现在用网络之间的智能切换,让终端选择最优网络,从而提升设备的在线率和在线时长。具体操作请参见三网卡策略管理。 定向网络管理 支持在控制台配置定向流量的访问地址。具体操作请参见定向流量。 自动化规则管理 支持创建自动化规则,监控SIM卡状态或者流量使用情况,触发规则时发送通知。具体操作请参见自动化规则。
  • URI DELETE /v2.1/{project_id}/servers/{server_id}/os-interface/{port_id} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方法请参见获取项目ID。 server_id 是 云服务器ID。 port_id 是 网卡Port ID。 说明: 当该ID为云服务器主网卡ID,将返回403。
  • 功能介绍 云服务器切换虚拟私有云。 本接口为异步接口,当前云服务器切换虚拟私有云请求下发成功后会返回job_id,此时云服务器切换虚拟私有云并没有立即完成,需要通过调用查询任务的执行状态查询job状态,当Job状态为 SUC CES S 时代表云服务器虚拟私有云切换成功。 切换虚拟私有云会卸载当前主网卡,用新指定的虚拟私有云创建主网卡。 若原主网卡绑定有弹性IP,则会将弹性IP绑定到新创建的主网卡上。 切换虚拟私有云会导致云服务器网络中断,同时更改云服务器子网、IP地址、MAC地址。 虚拟私有云切换完成后,与网络配置相关的应用软件需要重新配置。与网络相关的服务也需要重新配置,例如ELB、VPN、NAT、DNS等。 切换虚拟私有云过程中,请勿操作云服务器的弹性IP,或对云服务器做其他操作。
  • 请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 vpc_id 是 String 虚拟机私有云ID ,UUID格式。 nic 是 Object 需要添加的网卡参数列表,详情请参见表3。 表3 nic字段数据结构说明 参数 是否必选 参数类型 描述 port_id 否 String 网卡ID,UUID格式。 当该字段不为空时,表示挂载指定的网卡。 说明: port_id和subnet_id不能同时为空。 网卡ID可以通过虚拟私有云的“查询端口列表”接口查询。 约束: 网卡必须带有安全组。 网卡状态必须为DOWN。 网卡的vpcid必须和传入的vpcid一致。 当port_id和subnet_id同时存在的时候,优先使用port_id。 当选择port_id不为空时,代表此时使用的是弹性网卡,此时security_groups和ip_address等参数不生效。 subnet_id 否 String 云服务器添加网卡的信息。 需要指定云服务器所属虚拟私有云下已创建的网络(network)的ID,UUID格式。 security_groups 否 Array of objects 添加网卡的安全组信息,详情请参见表4。 ip_address 否 String IP地址,无该参数表示自动分配IP地址。 表4 security_groups字段数据结构说明 参数 是否必选 参数类型 描述 id 是 String 安全组ID。
  • 请求示例 为云服务器切换VPC,添加网卡、安全组并指定IP地址。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/changevpc { "vpc_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23", "nic": { "subnet_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23", "security_groups": [ { "id": "f0ac4394-7e4a-4409-9701-ba8be283dbc3" } ], "ip_address": "192.168.255.1" } }
  • URI PUT /v1/{project_id}/baremetalservers/{server_id}/os-interface/{port_id} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方式请参见获取项目ID。 server_id 是 裸金属服务器ID。 可以从裸金属服务器控制台查询,或者通过调用查询裸金属服务器列表(OpenStack原生)获取。 port_id 是 裸金属服务器绑定的网卡ID。
  • 登录E CS 配置虚拟IP地址 当为一个ECS绑定一个虚拟IP或者多个虚拟IP时,在控制台执行完绑定虚拟IP的操作后,您还需要参考以下章节,登录弹性云服务器手工配置虚拟IP地址。 本文提供以下操作系统的配置示例,其他操作系统,请您参考对应官网帮助文档进行配置。 Linux系统:CentOS 7.2 64bit、Ubuntu 22.04 server 64bit Windows系统:Windows Server
  • 相关操作 当不再使用虚拟IP时,可以删除虚拟IP地址,详细内容,请参考删除虚拟IP地址。 弹性云服务器的网卡解绑并删除虚拟IP地址后,需要在弹性云服务器上手工删除虚拟IP地址。 Linux系统(本文以“CentOS 7.2 64bit”为例,其他规格请参考对应官网帮助文档) 执行以下命令,查看并记录需要删除虚拟IP的网卡及对应连接。 nmcli connection 回显类似如下信息: 本示例的回显信息说明如下: DEVICE列的eth0为需要删除虚拟IP的网卡。 NAME列的Wired connection 1为网卡对应的连接。 执行以下命令,在目标连接中删除虚拟IP。 nmcli connection delete "CONNECTION" ipv4.addresses VIP 参数说明如下: CONNECTION:为步骤1中查到的网卡对应的连接。 VIP:待删除的虚拟IP地址。 执行以下命令,使配置生效。 nmcli connection up "CONNECTION" 命令示例: nmcli connection up "Wired connection 1" 执行以下命令,检查虚拟IP配置是否成功。 ip a 可以看到eth0网卡下已经不存在添加的虚拟IP地址。