华为云首页用户手册

智能边缘云 IEC-创建边缘实例:请求参数

智能边缘云 IEC-创建边缘实例:请求参数

时间：2024-01-02 15:48:16

智能边缘云 IEC 边缘实例

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

表2 请求Body参数
参数	是否必选	参数类型	描述
server	是	CreateInstanceOption object	待创建的边缘实例。

表3 CreateInstanceOption
参数	是否必选	参数类型	描述
name	是	String	边缘资源名称，与边缘实例一一对应。取值范围：只能由中文字符、大小写英文字母、数字及中划线、下划线组成，且长度为[1-48]个字符。
with_prefix	否	Boolean	是否自动添加前缀。 with_prefix为false时不拼接IEC前缀 with_prefix不传或者传true时拼自动IEC前缀以name为iec为例：不添加前缀时实例名称为：iec 自动添加前缀实例名称为：IEC-ZS01-iec 缺省值：true
image_ref	是	String	边缘实例的系统镜像，需要指定已创建镜像的ID，ID格式为通用唯一识别码（Universally Unique Identifier，简称UUID）。镜像的ID可以从控制台或者参考本文档的“查询边镜像列表”的章节获取。
flavor_ref	是	Integer	边缘实例的系统规格的ID。已上线的规格请使用接口 “查询边缘实例规格列表“ 进行查询。
admin_pass	否	String	如果需要使用密码方式登录边缘实例，可使用adminPass字段指定边缘实例管理员帐户初始登录密码。其中，Linux管理员帐户为root，Windows管理员帐户为Administrator。密码复杂度要求：长度为8-26位。密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%^-_=+[{}]:,./?）中的三种。密码不能包含用户名或用户名的逆序。 Windows系统密码不能包含用户名或用户名的逆序，不能包含用户名中超过两个连续字符的部分。说明目前边缘实例不支持创建后设置密码，不设置此参数会导致实例创建后无法登录。
key_name	否	String	密钥对名称。
net_config	是	NetConfigInstance object	实例的边缘网络配置。包含了边缘网络的网段信息和子网数目信息。
bandwidth	否	BandwidthConfigInstance object	实例的带宽参数。IEC服务现在提供共享带宽服务，暂不不支持其他类型带宽。
root_volume	是	RootVolume object	边缘实例对应系统盘相关配置。
data_volumes	否	Array of DataVolume objects	边缘实例对应数据盘相关配置。每一个数据结构代表一块待创建的数据盘。约束：目前边缘实例最多可挂载2块数据盘
count	是	Integer	边缘实例数量。最小值：1 最大值：50
security_groups	否	Array of SecurityGroupOption objects	边缘业务对应安全组信息。
user_data	否	String	创建边缘实例过程中注入用户数据。支持注入文本、文本文件或gzip文件。更多关于待注入用户数据的信息，请参见《弹性云服务器用户指南》的“用户数据注入”章节。
coverage	是	CoverageInstance object	边缘业务覆盖策略。

表4 NetConfigInstance
参数	是否必选	参数类型	描述
vpc_id	是	String	边缘网络ID。
subnets	是	Array of SubnetConfig objects	待创建边缘实例子网信息。需要指定vpcid对应VPC下已创建的子网（subnet）的网络ID，UUID格式。

表5 SubnetConfig
参数	是否必选	参数类型	描述
id	是	String	边缘子网ID。
ipv6_enable	否	Boolean	创建实例是否开启IPv6能力。缺省值：false
ipv6_bandwidth_enable	否	Boolean	是否使用IPv6带宽。约束： ipv6_enable=true时，有效；使用IPv6带宽后，优先根据ipv6_bandwidth中配置的带宽，如果ipv6_bandwidth未设置，则使用使用IPv6子网所在Ipv6池的带宽,如果当前IPv6所在池子下面没有带宽，则自动创建带宽
ipv6_bandwidth	否	Ipv6Bandwidth object	绑定的共享带宽信息
allowed_address_pairs	否	Array of AllowedAddressPair objects	功能说明：IP/Mac对列表约束： IP地址不允许为 “0.0.0.0/0” 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。如果allowed_address_pairs为“1.1.1.1/0”，表示关闭源目地址检查开关

表6 Ipv6Bandwidth
参数	是否必选	参数类型	描述
id	否	String	IPv6带宽的ID。
bandwidth_type	否	String	带宽类型。指定带宽ID，则该参数不生效。不指定带宽的情况下，如果当前带宽类型下没有带宽，自动在该带宽类型下创建带宽，有则使用最近创建的带宽。约束：指定的bandwidth_type必须在对应弹性公网IP类型的allow_share_bandwidth_types中才能使用

表7 AllowedAddressPair
参数	是否必选	参数类型	描述
ip_address	是	String	功能说明：IP地址约束： IP地址不支持“0.0.0.0/0” 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。如果allowed_address_pairs的IP地址为“1.1.1.1/0”，表示关闭源目地址检查开关。被绑定的边缘实例网卡allowed_address_pairs的IP地址填“1.1.1.1/0”。
mac_address	否	String	MAC地址

表8 BandwidthConfigInstance
参数	是否必选	参数类型	描述
sharetype	是	String	带宽类型，现支持WHOLE类型，即共享带宽，其他类型不支持。
size	否	Integer	带宽（Mbit/s）。
ids	否	Array of strings	指定带宽创建虚拟机, 约束：指定的带宽数量必须与demand中pool_ids中线路的数量一致
bandwidth_types	否	Array of strings	带宽类型。指定带宽ID，则该参数不生效。不指定带宽的情况下，如果当前带宽类型下没有带宽，自动在该带宽类型下创建带宽，有则使用最近创建的带宽。约束：指定的bandwidth_type必须在对应弹性公网IP类型的allow_share_bandwidth_types中才能使用指定的共享带宽类型数量必须与demand中pool_ids中线路的数量一致

表9 RootVolume
参数	是否必选	参数类型	描述
size	是	Integer	系统盘大小，容量单位为GB，输入大小范围为[40,100]。最小值：40 最大值：100
volume_type	是	String	边缘实例系统盘对应的磁盘类型，需要与站点所提供的磁盘类型相匹配。

**表10** DataVolume
参数	是否必选	参数类型	描述
size	是	Integer	数据盘大小，容量单位为GB，输入大小范围为[1,500]。最小值：1 最大值：500
volume_type	是	String	边缘实例数据盘对应的磁盘类型，需要与站点所提供的磁盘类型相匹配。

**表11** SecurityGroupOption
参数	是否必选	参数类型	描述
id	否	String	边缘实例的安全组，会对边缘实例中配置的网卡生效。需要指定已有安全组的ID。不填写时选择默认安全组

**表12** CoverageInstance
参数	是否必选	参数类型	描述
coverage_policy	是	String	区域调度策略，只支持centralize。 centralize：代表城市集中策略，指定该策略，边缘业务创建时会保证将所有实例都发放在同一个站点。
coverage_level	是	String	区域分布层级，只支持site。 site:站点级别。约束： coverage_sites中'site'字段仅支持使用ID(站点ID，通过“查询边缘站点列表”获取)，不支持name。
coverage_sites	是	Array of CoverageSiteInstance objects	区域及购买数量列表。

**表13** CoverageSiteInstance
参数	是否必选	参数类型	描述
site	是	String	站点ID。具体信息可通过调用“查询边缘站点列表”来查询。
demands	是	Array of DemandInstance objects	租户需求数量列表数组长度：1 - 1

**表14** DemandInstance
参数	是否必选	参数类型	描述
pool_id	否	String	弹性公网IP池。多线路场景下，将在该弹性公网IP池下创建弹性公网IP。说明：覆盖规则为省级/大区时不支持指定线路ID创建边缘业务。
pool_ids	否	Array of strings	线路ID集合。指定pool_ids的情况下，pool_id参数不生效多线路场景下，将在各线路下创建弹性公网IP 约束：线路ID必须小于等于网卡数

上一篇：智能边缘云 IEC-创建边缘实例:请求示例

下一篇：智能边缘云 IEC-创建子网:请求示例

华为云11.11 2核1G 2M 云服务器

29元/年

立即注册领万元上云礼券

抽奖赢11111元免单

续费同价 L实例 2核2G 4M

98元/年

热门域名 1元随心购

1元/年

智能边缘云 IEC-创建边缘实例:请求参数

意见反馈

0/200

提交成功！非常感谢您的反馈，我们会继续努力做到更好反馈提交失败！请稍后重试！

推荐文章

解决方案
相关专题