创建弹性伸缩配置CreateScalingConfig_弹性伸缩配置

华为云计算云知识创建弹性伸缩配置CreateScalingConfig

普惠上云 2核2G2M云服务器

38元/年

云服务器秒杀 X实例-4核8G5M

338元/年

Flexus L实例 2核2G3M云服务器

68元/年

网站搭建买3年送2年

1元/天

创建弹性伸缩配置CreateScalingConfig

时间: 2023-07-31 14:52:03

API网关云服务器云主机云计算弹性伸缩

猜你想看：

实时语音识别云服务器配置 CDN是什么意思视频点播加速什么是云桌面

功能介绍

创建弹性伸缩配置。

伸缩配置是伸缩组内实例（弹性云服务器）的模板，定义了伸缩组内待添加的实例的规格数据。
伸缩配置与伸缩组是解耦的，同一伸缩配置可以被多个伸缩组使用。
默认最多可以创建100个伸缩配置。

调试

您可以在API Explorer中调试该接口。

URI

POST /autoscaling-api/v1/{project_id}/scaling_configuration

表1 参数说明
参数	是否必选	参数类型	描述
project_id	是	String	项目ID

请求参数

表2 请求参数
参数	是否必选	参数类型	描述
scaling_configuration_name	是	String	伸缩配置名称(1-64个字符)，只能包含中文、字母、数字、下划线或中划线。
instance_config	是	Object	实例配置信息，具体请参考表 instance_config字段数据结构说明。

表3 instance_config字段数据结构说明
参数	是否必选	参数类型
instance_id	否	String
flavorRef	否	String
imageRef	否	String
disk	否	Array of disk objects
key_name	否	String
personality	否	Array of personality objects
public_ip	否	public_ip object
user_data	否	String
metadata	否	metadata object
security_groups	否	Array of security_groups objects
server_group_id	否	String
tenancy	否	String
dedicated_host_id	否	String
multi_flavor_priority_policy	否	String
market_type	否	String

对于Linux弹性云服务器，如果需要注入密码，只能使用userdata进行注入；对于Windows弹性云服务器，如果需要注入密码，只能通过元数据admin_pass进行注入。

表4 disk字段数据结构说明
参数	是否必选	参数类型	描述
size	是	Integer	磁盘大小，容量单位为GB。系统盘输入大小范围为1~1024，且不小于镜像中系统盘的最小(min_disk属性)值。数据盘输入大小范围为10~32768。
volume_type	是	String	云服务器系统盘对应的磁盘类型，需要与系统所提供的磁盘类型相匹配。目前支持“SATA”，“SAS”，“GPSSD”，“SSD”，“ESSD”。 “SATA”为普通IO 云硬盘（已售罄） “SAS”为高IO云硬盘 “GPSSD”为通用型SSD云硬盘 “SSD”为超高IO云硬盘 “ESSD”为极速IO云硬盘当指定的云硬盘类型在avaliability_zone内不存在时，则创建云硬盘失败。说明：不同云服务器规格支持的磁盘类型不同，本文仅供参考，具体支持的磁盘类型请以控制台界面显示为准。说明：了解不同磁盘类型的详细信息，请参见磁盘类型及性能介绍。
disk_type	是	String	标识系统盘还是数据盘，枚举值如下： DATA：数据盘。 SYS：系统盘。说明：系统盘不支持加密。
dedicated_storage_id	否	String	云服务器的磁盘可指定创建在用户的专属存储中，需要指定专属存储ID。说明：同一个伸缩配置中的磁盘需统一指定或统一不指定专属存储，不支持混用；当指定专属存储时，所有专属存储需要属于同一个可用区，且每个磁盘选择的专属存储支持的磁盘类型都需要和参数volume_type保持一致。
data_disk_image_id	否	String	指定特定ID的数据盘镜像，用以导出云服务器的数据盘。
snapshot_id	否	String	当选择使用整机镜像时，云服务器的系统盘及数据盘将通过整机备份恢复，需要指定磁盘备份的快照ID。说明：磁盘备份的快照ID可通过镜像的整机备份ID在CSBS查询单个备份中获得；一个伸缩配置中的每一个disk需要通过snapshot_id和整机备份中的磁盘备份一一对应。
metadata	否	metadata object	创建磁盘的元数据，详情见表5。

表5 创建磁盘的metadata字段数据结构说明
参数	是否必选	参数类型	描述
__system__encrypted	否	String	metadata中的表示加密功能的字段，0代表不加密，1代表加密。该字段不存在时，云硬盘默认为不加密。说明：系统盘不支持加密。
__system__cmkid	否	String	用户主密钥ID，是metadata中的表示加密功能的字段，与__system__encrypted配合使用。说明：系统盘不支持加密。请参考查询密钥列表，通过HTTPS请求获取密钥ID。

表6 personality字段数据结构说明
参数	是否必选	参数类型	描述
path	是	String	注入文件路径信息。 Linux系统请输入注入文件保存路径，例如 “/etc/foo.txt”。 Windows系统注入文件自动保存在C盘根目录，只需要输入保存文件名，例如 “foo”，文件名只能包含字母（a~zA~Z）和数字（0~9）。
content	是	String	注入文件内容。该值应指定为注入文件的内容进行base64格式编码后的信息。

表7 public_ip字段数据结构说明
参数	是否必选	参数类型	描述
eip	是	eip object	配置云服务器自动分配弹性IP时，创建弹性IP的配置参数。详情请参考表 eip字段数据结构说明。

表8 eip字段数据结构说明
参数	是否必选	参数类型	描述
ip_type	是	String	弹性IP地址类型。类型枚举值： 5_bgp：全动态BGP 5_sbgp：静态BGP 详情请参见《虚拟私有云接口参考》“申请弹性公网IP ”章节的“publicip”字段说明。
bandwidth	是	bandwidth object	IP地址带宽参数，详情请参考表 bandwidth字段数据结构说明。

表9 bandwidth字段数据结构说明
参数	是否必选	参数类型	描述
size	否	Integer	带宽（Mbit/s），按带宽分配取值范围为[1,2000]，按流量分配取值范围为[1,300]。说明：若share_type是PER，该参数为必选项。若share_type是WHOLE，会忽略该参数。具体范围以各区域配置为准，请参见控制台对应页面显示。创建带宽时的最小单位会根据带宽取值范围不同存在差异。小于等于300Mbit/s：默认最小单位为1Mbit/s。 300Mbit/s~1000Mbit/s：默认最小单位为50Mbit/s。大于1000Mbit/s：默认最小单位为500Mbit/s。
share_type	是	String	带宽的共享类型。共享类型枚举： PER：独享型。 WHOLE：共享型。
charging_mode	否	String	带宽的计费类型。计费类型枚举： bandwidth：按带宽计费。 traffic：按流量计费。若字段为其它值，会导致创建云服务器失败。说明：如果share_type是PER，该参数为必选项。如果share_type是WHOLE，会忽略该参数。
id	否	String	带宽ID，使用共享型带宽时，可以选择之前创建的共享带宽来创建弹性IP，详情请见查询带宽列表。说明：如果share_type是PER，会忽略该参数。如果share_type是WHOLE，该参数为必选项。

**表10** metadata字段数据结构说明
参数	是否必选	参数类型	描述
admin_pass	否	String	如果需要使用密码方式登录云服务器，可使用adminPass字段指定云服务器管理员帐户初始登录密码。其中，Linux管理员帐户为root，Windows管理员帐户为Administrator。密码复杂度要求：长度为8-26位。密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%^-_=+[{}]:,./?）中的三种。密码不能包含用户名或用户名的逆序。 Windows系统密码不能包含用户名或用户名的逆序，不能包含用户名中超过两个连续字符的部分。

**表11** security_groups字段数据结构说明
参数	是否必选	参数类型	描述
id	是	String	安全组ID。

请求示例

创建一个名称为as-config-tlzp，镜像ID为627a1223-2ca3-46a7-8d5f-7aef22c74ee6，规格ID为s3.xlarge.4，系统盘为40G的SATA盘，且SSH密钥名称为100vm_key的伸缩配置。

POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_configuration

{ 
    "scaling_configuration_name": "as-config-tlzq", 
    "instance_config": { 
        "flavorRef": "s3.xlarge.4", 
        "imageRef": "627a1223-2ca3-46a7-8d5f-7aef22c74ee6", 
        "disk": [ 
            { 
                "size": 40, 
                "volume_type": "SATA", 
                "disk_type": "SYS" 
            } 
        ], 
        "key_name": "100vm_key" ,
	"security_groups": [{
		"id": "6c22a6c0-b5d2-4a84-ac56-51090dcc33be"
	}], 
        "multi_flavor_priority_policy": "PICK_FIRST"
    } 
}

响应参数

**表12** 响应参数
参数	参数类型	描述
scaling_configuration_id	String	伸缩配置ID。

响应示例

{
    "scaling_configuration_id": "f8327883-6a07-4497-9a61-68c03e8e72a2"
}

返回值

正常
 200

异常

返回值	说明
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	网关超时。

错误码

请参考错误码。

上一篇：GaussDB(DWS)的逻辑架构下一篇：什么是视频接入服务

功能介绍

调试

URI

请求参数

请求示例

响应参数

响应示例

返回值

错误码

弹性伸缩 AS

最新文章

更多内容

7*24

备案

专业服务

退订

建议反馈

售前咨询热线