云服务器内容精选

  • 响应示例 响应示例请参见 响应(批量操作类)所示。 { "response": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19" }, { "id": "516fb98f-46ca-475e-917e-2563e5a8cd12" } ] }
  • 请求消息 请求参数如表2所示。 表2 请求参数 参数 参数类型 是否必选 描述 name String 是 弹性云服务器修改后的名称。 规则如下: 只能由中文字符、英文字母、数字及“_”、“-”、“.”组成,且长度为[1-128]个英文字符或[1-64]个中文字符。 批量修改弹性云服务器名称时,名不会自动按序增加数字尾缀。例如: 三个ECS的名称为test_0001,test_0002,test_0003,批量修改弹性云服务器名称为develop,则修改后3个弹性云服务器名称为develop,develop,develop。 dry_run Boolean 否 是否只预检此次请求。 true:发送检查请求,不会修改云服务器名称。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过,则返回对应错误。如果检查通过,则返回正常响应信息。 响应结构请参见 7.5.1 响应 所示。 false:发送正常请求,通过检查后并且执行修改云服务器名称的请求。 默认值:false servers Array of objects 是 待修改的弹性云服务器ID信息,详情请参见 表3。 表3 servers字段数据结构说明 参数 参数类型 是否必选 描述 id String 是 弹性云服务器ID。
  • 请求示例 批量修改ID为“260a0917-f7df-4b25-93ac-950da6c6b5d6”和“f6d8df1a-e257-48e2-b617-1dd92ced8c20”的云服务器的名称为“new-server-name”。 PUT https://{endpoint}/v1/{project_id}/cloudservers/server-name { "name": "new-server-name", "dry_run": false, "servers": [ { "id":"260a0917-f7df-4b25-93ac-950da6c6b5d6" }, { "id":"f6d8df1a-e257-48e2-b617-1dd92ced8c20" } ] }
  • 请求示例 批量重置ID为“1bd0eb17-4466-4c15-a9ce-87727ad311b5”和“fd6b6e9d-64a1-40fa-b7dc-f491be42fdd2”的云服务器的密码,建议将密码在配置文件或者环境变量中密文存放,使用时解密,确保安全。 PUT https://{endpoint}/v1/{project_id}/cloudservers/os-reset-passwords { "new_password": "$ADMIN_PASS", "dry_run": true, "servers": [ { "id":"1bd0eb17-4466-4c15-a9ce-87727ad311b5" }, { "id":"fd6b6e9d-64a1-40fa-b7dc-f491be42fdd2" } ] }
  • 响应示例 响应示例请参见响应(批量操作类)所示。 { "response": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19" }, { "id": "516fb98f-46ca-475e-917e-2563e5a8cd12" } ] }
  • 请求消息 请求参数如表2所示。 表2 请求参数 参数 参数类型 是否必选 描述 new_password String 是 新密码。 当dry_run字段为true时,该字段为非必填字段,否则为必填字段。 新密码的校验规则: 长度为8-26位。 密码至少必须包含大写字母(A-Z)、小写字母(a-z)、数字(0-9)和特殊字符(!@%-_=+[]:./?)中的三种。 密码不能包含用户名或用户名的逆序。 Windows系统密码不能包含用户名或用户名的逆序,不能包含用户名中超过两个连续字符的部分。 dry_run Boolean 否 是否只预检此次请求。 true:发送检查请求,不会重置密码。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过,则返回对应错误。如果检查通过,则返回响应结果。 false:发送正常请求,通过检查后并且进行重置密码请求。 默认值:false servers Array of objects 是 待批量重置密码的弹性云服务器ID信息,详情参见 表3。 表3 servers字段数据结构说明 参数 参数类型 是否必选 描述 id String 是 弹性云服务器ID。
  • 请求示例 批量挂载共享数据盘到ID为“a26887c6-c47b-4654-abb5-dfadf7d3f803”和“a26887c6-c47b-4654-abb5-dfadf7d3fa05”的云服务器。 POST https://{endpoint}/v1/{project_id}/batchaction/attachvolumes/{volume_id} { "serverinfo": [ { "server_id": "a26887c6-c47b-4654-abb5-dfadf7d3f803", "device": "/dev/sdb" }, { "server_id": "a26887c6-c47b-4654-abb5-dfadf7d3fa05", "device": "/dev/sdb" } ] }
  • 请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 serverinfo 是 Array of objects 共享磁盘需要挂载的弹性云服务器列表。详细请参见表3。 表3 serverinfo 列表数据结构说明 参数 是否必选 参数类型 描述 server_id 是 String 共享磁盘需要挂载的弹性云服务器ID。 device 否 String 磁盘挂载点。 说明: 新增加的磁盘挂载点不能和已有的磁盘挂载点相同。 对于采用XEN虚拟化类型的弹性云服务器,device为必选参数;系统盘挂载点请指定/dev/sda;数据盘挂载点请按英文字母顺序依次指定,如/dev/sdb,/dev/sdc,如果指定了以“/dev/vd”开头的挂载点,系统默认改为“/dev/sd”。 对于采用KVM虚拟化类型的弹性云服务器,系统盘挂载点请指定/dev/vda;数据盘挂载点可不用指定,也可按英文字母顺序依次指定,如/dev/vdb,/dev/vdc,如果指定了以“/dev/sd”开头的挂载点,系统默认改为“/dev/vd”。 对于仅支持SCSI类型磁盘的弹性云服务器,数据盘的挂载点请按英文字母顺序依次指定,如/dev/sdb,/dev/sdc,系统不会修改默认挂载点。
  • 请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 reboot 是 Object 标记为重启云服务器操作,详情请参见表3。 表3 reboot字段数据结构说明 参数 是否必选 参数类型 描述 type 是 String 重启类型: SOFT:普通重启。 HARD:强制重启。 servers 是 Array of objects 云服务器ID列表,详情请参见表4。 表4 servers字段数据结构说明 参数 是否必选 参数类型 描述 id 是 String 云服务器ID。
  • 请求示例 批量重启ID为“616fb98f-46ca-475e-917e-2563e5a8cd19”和“726fb98f-46ca-475e-917e-2563e5a8cd20”的云服务器,请求参数必须以”reboot”字段下发。 POST https://{endpoint}/v1/{project_id}/cloudservers/action { "reboot": { "type":"SOFT", "servers": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19" }, { "id": "726fb98f-46ca-475e-917e-2563e5a8cd20" } ] } }
  • 请求示例 批量创建2个弹性公网IP,带宽为按宽带计费、5M大小的独享带宽。 POST /v2/{project_id}/batchpublicips{ "bandwidth" : { "name" : "", "size" : 5, "charge_mode" : "bandwidth", "share_type" : "PER" }, "publicip" : { "type" : "5_bgp", "tags" : [ ] }, "publicip_number" : 2, "enterprise_project_id" : 0}
  • 状态码 状态码 描述 200 OK 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found 405 Method Not Allowed 406 Not Acceptable 407 Proxy Authentication Required 408 Request Timeout 409 Conflict 500 Internal Server Error 501 Not Implemented 502 Bad Gateway 503 Service Unavailable 504 Gateway Timeout
  • 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 bandwidth 是 BatchBandwidth object 带宽信息 publicip 是 BatchPublicIp object 弹性公网IP信息 publicip_number 是 Integer 批量创建EIP的个数 enterprise_project_id 是 String 企业项目id 表3 BatchBandwidth 参数 是否必选 参数类型 描述 charge_mode 否 String 功能说明:按流量计费还是按带宽计费。其中IPv6国外默认是bandwidth,国内默认是traffic。取值为traffic,表示流量计费。 枚举值: bandwidth traffic name 否 String 功能说明:带宽名称 取值范围:1-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点) 约束:如果share_type是PER,该参数必须带,如果share_type是WHOLE并且id有值,该参数会忽略。 最小长度:1 最大长度:64 share_type 否 String 功能说明:带宽类型 取值范围:PER,WHOLE。其中IPv6暂不支持WHOLE类型带宽。 枚举值: PER WHOLE size 是 Integer 功能说明:带宽大小 取值范围:默认1Mbit/s~2000Mbit/s(具体范围以各区域配置为准,请参见控制台对应页面显示)。 约束:share_type是PER,该参数必须带,如果share_type是WHOLE并且id有值,该参数会忽略。 注意:调整带宽时的最小单位会根据带宽范围不同存在差异。 小于等于300Mbit/s:默认最小单位为1Mbit/s。 300Mbit/s~1000Mbit/s:默认最小单位为50Mbit/s。 大于1000Mbit/s:默认最小单位为500Mbit/s。 id 否 String 功能说明:带宽ID,创建WHOLE类型带宽的弹性公网IP时可以指定之前的共享带宽创建 取值范围:WHOLE类型的带宽ID 表4 BatchPublicIp 参数 是否必选 参数类型 描述 id 否 String 指定id创建EIP type 是 String 公网ip类型 枚举值: 5_bgp 5_union 5_sbgp ip_version 否 String 公网EIP的版本,例如ipv4,ipv6,默认为ipv4 enterprise_project_id 否 String 企业项目id tags 否 Array of strings 公网EIP标签 profile 否 BatchProfile object 订单信息 表5 BatchProfile 参数 是否必选 参数类型 描述 user_id 否 String 租户id product_id 否 String 产品id region_id 否 String 局点id order_id 否 String 订单id