华为云用户手册

请求示例 导入密钥对，密钥对名称为PK并导入公钥信息 POST https://{endpoint}/v1/os-keypairs { "name" : "PK", "public_key" : "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC4uGmCeHNac9ToRtbaGIB02iCakFNk76XYsTiHDtRdIVBobTFxCE9Up9RqRAFtgpzSNBeZT6U6u3PoAV3VMjE0ZNg1Uex10lXLVU3PWfORzQG4M3lXnpqjwojlhqIg+Q88iPeyrgMawiR5If2kQ6xAkPI+4Yyc2JQn2HqV2LxE/rV42JpYEXpilveHW4urfDl9azDe3v9fmAOXq7dXzdGDCTiNMWzxj7B0jnuBiTkGxd9yTErip019O87bAdzrpSD5AZgmeHmW7LAG8GpE820xiiTIGrNONfojGdVzicc88OF/Y4r/GhCBpLC79jKa6dxnwHs4a8+u/ynuafZxvBrH Generated-by-Nova\n" }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表2 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 密钥对名称。 新创建的密钥名称不能和已有密钥名称相同。 最小长度：1 最大长度：64 public_key 否 String 导入的公钥信息。 建议导入的公钥长度不大于1024字节。 说明： 长度超过1024字节会导致边缘实例注入该密钥失败。

响应示例 状态码： 200 OK { "routetable" : { "id" : "b96df94c-7d3b-4e5f-8852-16646a27ef95", "name" : "test1", "subnets" : [ { "id" : "4c2a7e40-0f23-42d7-8f1c-aa6396d12a29" } ], "vpc_id" : "af5b7439-5969-11eb-acfa-fa16408859a1", "domain_id" : "2b76febbe5d34eac85d26435c1f15809", "description" : "this is a test", "default" : false } }

响应示例 状态码： 200 OK { "id" : "27101e92-49a7-11eb-8a8a-fa1640495574", "name" : "edgecloud1", "stacks" : { "name" : "stack-fo09-xi_a-001", "resources" : [ { "name" : "edgeinstance1", "image_ref" : "00000000-0000-0000-0000-000000000002", "flavor_ref" : "c6.large.2", "user_data" : "IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiQzOEVORTckaTJ6Li9ibzZMUGlUT3VFVE5KbmxNdC9yMmJSNlhyOC81S3BndWtNU0xhLmhiVlFJNkY3T25sUS5ucVM0SXpmVEhSU0ZHN3lBeHBiakxlNkUwYjE1YjEnIHwgY2hwYXNzd2QgLWU7", "admin_pass" : "******", "net_config" : { "vpc_id" : "4a6d9663-475f-11eb-aa7c-fa16406a65c4", "nic_num" : 1 }, "count" : 1, "root_volume" : { "volume_type" : "SATA", "size" : 100 }, "security_groups" : [ { "id" : "153133f5-2b16-11eb-a594-fa16408859a1" } ] } ] }, "coverage" : { "coverage_policy" : "centralize", "coverage_level" : "city", "coverage_sites" : [ { "site" : "xi'an", "i18n_site" : "西安市", "demands" : [ { "demand_count" : 1 } ] } ] }, "success_num" : 0, "failed_num" : 1, "status" : "failed", "edge_regions" : 1, "create_at" : "2020-12-29T07:26:22.866644Z", "update_at" : "2020-12-29T07:26:24.728957Z" }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 id String 边缘业务ID。 name String 边缘业务名称。 stacks Array of Stack objects 边缘业务资源组。 coverage CoverageResp object 边缘业务覆盖策略。 success_num Integer 边缘业务成功创建的虚拟机数量。 failed_num Integer 边缘业务创建失败的虚拟机数量。 status String 边缘业务状态。 fail_reason FailReason object 边缘业务失败的原因。 edge_regions Integer 边缘业务支持的边缘区域数目，等同于边缘业务下所有实例的区域数目总和 description String 描述。 create_at String 创建时间。 update_at String 修改时间。 表4 Stack 参数 参数类型 描述 name String 边缘资源组名称。 取值范围：只能由中文字符、大小写英文字母、数字及中划线、下划线组成，且长度为[1-48]个字符。 最小长度：1 最大长度：48 resources Array of Resource objects 边缘业务的堆栈，即为资源组。 表5 Resource 参数 参数类型 描述 name String 边缘实例名称。 取值范围： 只能由中文字符、英文字母 (大小写)、数字及“_”、“-”、“.” 组成。 创建的边缘实例数量（count字段对应的值）大于1时，为区分不同边缘实例，创建过程中系统会自动在名称后加“-000x”的类似标记。 说明： 华为云边缘实例内部主机名 （hostname）命名规则遵循RFC 952和RFC 1123命名规范，建议使用a-zA-z或0-9以及中划线'-'组成的名称命名，' _' 将在边缘实例内部默认转化为'-'。 最小长度：1 最大长度：48 with_prefix Boolean 是否自动添加名称前缀。 with_prefix为false时不拼接IEC前缀 with_prefix不传或者传true时拼自动IEC前缀 以name为iec为例： 不添加前缀时实例名称为：iec-0001 自动添加前缀实例名称为：IEC-ZS01-iec-0001 0001为创建边缘业务时根据实例个数自动添加的编号 缺省值：true image_ref String 待发放边缘实例的系统镜像，需要指定已创建镜像的ID。 说明： 镜像的ID可以从控制台或者参考本文档的“查询边镜像列表”的章节获取。 flavor_ref String 边缘实例的系统规格的ID。 admin_pass String 如果需要使用密码方式登录边缘实例，可使用admin_pass字段指定边缘实例管理员帐户初始登录密码。其中，Linux管理员帐户为root，Windows管理员帐户为Administrator。 密码复杂度要求： 长度为8-26位。 密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%^-_=+[{}]:,./?）中的三种。 密码不能包含用户名或用户名的逆序。 Windows系统密码不能包含用户名或用户名的逆序，不能包含用户名中超过两个连续字符的部分。 说明： 目前边缘实例不支持创建后设置密码，不设置此参数会导致实例无法登录。 最小长度：8 最大长度：26 key_name String 密钥对名称。 net_config NetConfig object 实例的边缘网络配置。 包含了边缘网络的网段信息和子网数目信息。 bandwidth BandwidthConfig object 实例的带宽参数。 IEC服务现在提供共享带宽服务，暂不支持其他类型带宽。 说明： 创建边缘业务时指定实例同步创建EIP则需通过此参数指定。 root_volume RootVolume object 边缘实例对应系统盘相关配置。 data_volumes Array of DataVolume objects 边缘实例对应数据盘相关配置。每一个数据结构代表一块待创建的数据盘。 约束：目前边缘实例最多可挂载2块数据盘 count Integer 边缘实例数量。 不传该字段时默认取值为1。 security_groups Array of SecurityGroupOption objects 边缘业务对应安全组信息。 user_data String 创建边缘实例过程中注入用户数据。支持注入文本、文本文件或gzip文件。 更多关于待注入用户数据的信息，请参见《弹性云服务器用户指南 》的“用户数据注入”章节。 表6 NetConfig 参数 参数类型 描述 vpc_id String 边缘网络ID。 约束： 创建边缘业务仅支持使用系统规划的虚拟私有云。 nic_num Integer 边缘实例绑定的网卡数量。 约束：一台边缘实例最少绑定一张网卡，最多绑定8张网卡。 最小值：1 最大值：8 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”，表示关闭源目地址检查开关 表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 BandwidthConfig 参数 参数类型 描述 sharetype String 带宽类型，现支持WHOLE类型，即共享带宽，其他类型不支持。 size Integer 带宽（Mbit/s）。 表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 CoverageResp 参数 参数类型 描述 coverage_policy String 区域调度策略，只支持centralize/discrete。 centralize：代表城市集中策略，指定该策略，边缘业务创建时会保证将所有实例都发放在同一个站点。 discrete：代表城市分散，指定该策略，边缘业务创建时，尽量保证所有实例都分散发放在不同站点。 coverage_level String 区域分布层级，只支持area/prov/city/site。 area:大区，用户的资源会在指定大区下发放。 prov:省份，用户的资源会在指定省份下发放。 city:城市，用户的资源会在指定城市下发放。 site:站点级别。 约束： 站点层级，coverage_policy上仅支持'centralize'，coverage_sites中'site'字段仅支持使用ID(站点ID，通过“查询边缘站点列表”获取)，不支持name。 coverage_sites Array of CoverageSiteResp objects 区域及购买数量列表。 表13 CoverageSiteResp 参数 参数类型 描述 site String 站点名称。 具体信息可通过调用“查询边缘站点列表”来查询(注意：本字段区分大小写)。 demands Array of DemandResp objects 租户需求数量列表。表示租户发放资源站点的运营商和发放的资源组的数量。 i18n_site String 覆盖区域的国际化信息。 表14 DemandResp 参数 参数类型 描述 demand_count Integer 站点需要发放的资源(组)总数。 说明： 实际发放实例数量为count*demand_count。 最小值：1 最大值：10 pool_id_v6 String 指定IPv6线路，使用该线路下的子网分配IPv6端口。 如果该线路下没有关联启用IPv6的子网，则创建新的子网。 ipv6_bandwidth_enable Boolean 使用IPv6带宽。 边缘实例是否开启IPv6公网访问能力。如果该IPv6线路下没有带宽，则创建新的带宽。 表15 FailReason 参数 参数类型 描述 fail_code String 错误码 fail_message String 边缘云失败原因列表。包含所边缘云的失败原因。

响应示例 状态码： 200 OK { "count" : 1, "edgeclouds" : [ { "id" : "27101e92-49a7-11eb-8a8a-fa1640495574", "name" : "edgecloud1", "coverage" : { "coverage_policy" : "centralize", "coverage_level" : "city", "coverage_sites" : [ { "site" : "xi'an", "i18n_site" : "西安市", "demands" : [ { "demand_count" : 1 } ] } ] }, "success_num" : 0, "failed_num" : 1, "status" : "failed", "edge_regions" : 1 } ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 count Integer 边缘业务数量。 edgeclouds Array of EdgeCloud objects 边缘业务列表。 表4 EdgeCloud 参数 参数类型 描述 id String 边缘业务ID。 name String 边缘业务名称。 取值范围：只能由中文字符、大小写英文字母、数字及中划线、下划线组成，且长度为[1-32]个字符。 description String 边缘业务描述。最大支持255字节。 coverage CoverageResp object 边缘业务覆盖策略 failed_num Integer 创建失败的虚拟机 status String 边缘业务状态，现存状态有： creating/scheduling/updating：部署中 inService：运行中 failed：创建失败 deleting：删除中 delFailed：删除失败 success_num Integer 成功创建的虚拟机 edge_regions Integer 边缘业务支持的边缘区域数目。 表5 CoverageResp 参数 参数类型 描述 coverage_policy String 区域调度策略，只支持centralize/discrete。 centralize：代表城市集中策略，指定该策略，边缘业务创建时会保证将所有实例都发放在同一个站点。 discrete：代表城市分散，指定该策略，边缘业务创建时，尽量保证所有实例都分散发放在不同站点。 coverage_level String 区域分布层级，只支持area/prov/city/site。 area:大区，用户的资源会在指定大区下发放。 prov:省份，用户的资源会在指定省份下发放。 city:城市，用户的资源会在指定城市下发放。 site:站点级别。 约束： 站点层级，coverage_policy上仅支持'centralize'，coverage_sites中'site'字段仅支持使用ID(站点ID，通过“查询边缘站点列表”获取)，不支持name。 coverage_sites Array of CoverageSiteResp objects 区域及购买数量列表。 表6 CoverageSiteResp 参数 参数类型 描述 site String 站点名称。 具体信息可通过调用“查询边缘站点列表”来查询(注意：本字段区分大小写)。 demands Array of DemandResp objects 租户需求数量列表。表示租户发放资源站点的运营商和发放的资源组的数量。 i18n_site String 覆盖区域的国际化信息。 表7 DemandResp 参数 参数类型 描述 demand_count Integer 站点需要发放的资源(组)总数。 说明： 实际发放实例数量为count*demand_count。 最小值：1 最大值：10 pool_id_v6 String 指定IPv6线路，使用该线路下的子网分配IPv6端口。 如果该线路下没有关联启用IPv6的子网，则创建新的子网。 ipv6_bandwidth_enable Boolean 使用IPv6带宽。 边缘实例是否开启IPv6公网访问能力。如果该IPv6线路下没有带宽，则创建新的带宽。

响应示例 状态码： 200 OK { "ports" : [ { "id" : "0ea06f5f-40dc-4136-aae9-08a0cf8fc356", "name" : "671ff701-3dea-4a15-8aeb-58eb179af4b7", "status" : "DOWN", "admin_state_up" : true, "fixed_ips" : [ { "subnet_id" : "671ff701-3dea-4a15-8aeb-58eb179af4b7", "ip_address" : "172.16.0.1" } ], "mac_address" : "fa:16:3e:af:fc:8d", "network_id" : "eef408da-0f0e-4a09-a5f2-9e9c301c0157", "device_id" : "cf47d861-f407-4cd9-aa56-11d97201539d", "device_owner" : "network:router_interface_distributed", "security_groups" : null, "extra_dhcp_opts" : [ ], "allowed_address_pairs" : [ ], "site_id" : "74a75ed3-cfb9-11ea-a0c3-fa1640495574", "dns_assignment" : [ ], "dns_name" : "" } ], "count" : 1 }

URI GET /v1/ports 表1 Query参数 参数 是否必选 参数类型 描述 admin_state_up 否 Boolean 按照admin_state_up进行过滤 约束：只支持true device_id 否 String 根据设备ID查询端口。 device_owner 否 String 根据设备主查询端口。 fixed_ips 否 Array 根据绑定的IP查询端口。按照fixed_ips=ip_address或者fixed_ips=subnet_id过滤查询，示例：fixed_ips=ip_address=xxx&fixed_ips=subnet_id=xxxx id 否 String 按照端口ID过滤查询 limit 否 Integer 查询返回端口列表数量。取值范围：0~1000。 最小值：0 最大值：1000 缺省值：1000 mac_address 否 String 根据网卡的mac地址查询端口。 name 否 String 按照name过滤查询 取值范围：最大长度不超过255 network_id 否 String 子网的neutron的network的ID。 offset 否 Integer 查询的偏移量。 security_groups 否 String 根据安全组信息ID查询端口。 status 否 String 按照status过滤查询 取值范围：ACTIVE、BUILD、DOWN

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 ports Array of Port objects 端口对象。 count Integer 端口数目。 表4 Port 参数 参数类型 描述 id String 端口唯一标识 name String 端口名称 取值：默认为空，最大长度不超过255 status String 端口状态，Hana硬直通虚拟机端口状态总为DOWN 取值范围：ACTIVE、BUILD、DOWN admin_state_up Boolean 管理状态 约束：只支持true，默认为true fixed_ips Array of FixedIp objects 端口IP。 约束：一个端口只支持一个fixed_ip，且不支持更新。 mac_address String 端口MAC地址 约束：由系统分配，不支持指定 network_id String 端口所属网络的ID 约束：必须是存在的网络ID device_id String 端口所属设备ID 约束：不支持设置和更新，由系统自动维护 device_owner String 设备所属（DHCP/Router/ lb/Nova） 约束：不支持设置和更新，由系统自动维护 security_groups Array of strings 安全组的UUID(扩展属性) extra_dhcp_opts Array of ExtraDhcpOption objects DHCP的扩展属性。 allowed_address_pairs Array of AllowedAddressPair objects 功能说明：IP/Mac对列表。 约束： IP地址不允许为 “0.0.0.0/0” 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。 如果allowed_address_pairs的IP地址为“1.1.1.1/0”，表示关闭源目地址检查开关。 site_id String 站点ID dns_assignment Array of DnsAssignment objects 主网卡默认内网域名信息 约束：不支持设置和更新，由系统自动维护 dns_name String 主网卡默认内网DNS名称 约束：不支持设置和更新，由系统自动维护 ipv6_bandwidth_id String IPv6带宽ID binding:profile Object 功能说明：提供用户设置自定义信息(扩展属性) 表5 FixedIp 参数 参数类型 描述 subnet_id String 所属子网ID ip_address String 端口IP地址 表6 ExtraDhcpOption 参数 参数类型 描述 opt_name String Option名称 opt_value String Option值 表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 DnsAssignment 参数 参数类型 描述 fqdn String 端口内网fqdn hostname String 端口hostname ip_address String 端口IP地址

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 bandwidths Array of Bandwidth objects 带宽列表对象。 count Integer 带宽数量。 表4 Bandwidth 参数 参数类型 描述 bandwidth_type String 带宽类型。 charge_mode String 计费模式，当前只支持峰值95计费。 取值范围： 95peak_plus：峰值95计费 create_time String 创建时间。 id String 带宽ID。 name String 带宽名称。 最小长度：1 最大长度：64 operator Operator object 运营商信息。 publicip_info Array of PublicipInfo objects 弹性公网IP信息。 share_type String 共享带宽类型，标识是否是共享带宽。 取值范围： WHOLE：共享带宽 site_id String 边缘站点ID。 site_info String 站点信息。 size Integer 带宽大小。 最小值：300 最大值：2000 status String 带宽的状态。 取值范围： FREEZED：冻结 NORMAL：正常 update_time String 更新时间。 pool_id String 线路ID。 表5 Operator 参数 参数类型 描述 id String 运营商ID。 name String 运营商名称。 取值范围： chinamobile：中国移动； chinaunicom：中国联通； chinatelecom：中国电信。 i18n_name String 运营商国际化名称。 sa String 运营商的简写。 表6 PublicipInfo 参数 参数类型 描述 ip_version Integer IP版本的信息 publicip_address String 弹性公网IP publicip_id String 弹性公网IP的ID。 publicip_type String 功能说明：弹性公网IP的类型

响应示例 状态码： 200 OK { "bandwidths" : [ { "id" : "f123b229-8755-4a9d-a050-7d30ee63afab", "name" : "bandwidth-3bvf", "size" : 500, "share_type" : "WHOLE", "publicip_info" : [ { "publicip_id" : "6aa7c090-d111-40e2-ba2a-2985c833e859", "publicip_address" : "122.xxx.xxx.xxx", "publicip_type" : "5_bgp_site3", "ip_version" : 4 } ], "bandwidth_type" : "share", "charge_mode" : "95peak_plus", "site_id" : "6813be76-7322-11ea-9ce0-286ed488d287", "status" : "NORMAL", "create_time" : "2021-01-19T02:21:17.213934Z", "site_info" : "中国/华南地区/广东/中山市", "operator" : { "id" : "2", "i18n_name" : "中国联通", "sa" : "CUCC" }, "pool_id" : "5_bgp_site3", "update_time" : "2021-03-30T01:22:01.679039Z" } ], "count" : 12 }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 security_group_rules Array of SecurityGroupRule objects 安全组规则列表对象。 count Integer 安全组规则数目。 表4 SecurityGroupRule 参数 参数类型 描述 id String 安全组规则的ID。 description String 安全组规则描述信息。 最小长度：0 最大长度：64 security_group_id String 安全组ID。 direction String 出入控制方向。 取值范围： egress：出方向 ingress：入方向 ethertype String IP协议类型。 取值范围：IPv4，IPv6 约束：不填默认值为IPv4 protocol String 协议类型。 取值范围：icmp、tcp、udp、icmpv6等 约束：为空表示支持所有协议 port_range_min String 起始端口值。 取值范围：1~65535 约束：取值不能大于port_range_max的值，为空表示所有端口 port_range_max String 结束端口值。 取值范围：1~65535 约束：取值不能小于port_range_min的值，为空表示所有端口。 remote_group_id String 对端安全组ID。 约束：和remote_ip_prefix互斥 ，remote_group_id与remote_ip_prefix必须存在一个 remote_ip_prefix String 远端IP地址，当direction是egress时为虚拟机访问端的地址，当direction是ingress时为访问虚拟机的地址。 取值范围：IP地址，或者cidr格式 约束：和remote_group_id互斥 action String 安全组规则生效策略 取值范围：allow 允许，deny 拒绝 约束：默认值为allow 缺省值：allow priority Integer 规则在安全组中的优先级 取值范围：1~100，1代表最高优先级 约束：默认值为1

响应示例 状态码： 200 OK { "security_group_rules" : [ { "description" : "for test", "direction" : "egress", "ethertype" : "IPv4", "id" : "99d9d709-8478-4b46-9f3f-2206b1023fd3", "protocol" : "TCP", "port_range_max" : 300, "port_range_min" : 30, "remote_group_id" : null, "remote_ip_prefix" : null, "security_group_id" : null } ] }

响应示例 状态码： 200 OK { "server" : { "status" : "ACTIVE", "updated" : "2020-12-29T03:46:26Z", "hostId" : "11145fe342232beffd5e161599261a4ca047d6b7d138648959fe432b", "addresses" : { "4a6d9663-475f-11eb-aa7c-fa16406a65c4" : [ { "version" : "4", "addr" : "172.16.0.204", "OS-EXT-IPS-MAC:mac_addr" : "fa:16:3e:4e:dd:c9", "OS-EXT-IPS:port_id" : "1b1377d5-f74d-478c-9970-68d8b7b6d894", "OS-EXT-IPS:type" : "fixed" }, { "version" : "4", "addr" : "188.181.56.44", "OS-EXT-IPS-MAC:mac_addr" : "fa:16:3e:4e:dd:c9", "OS-EXT-IPS:port_id" : "1b1377d5-f74d-478c-9970-68d8b7b6d894", "OS-EXT-IPS:type" : "floating" } ] }, "id" : "d10f846a-d7a4-4ee7-9552-19f656d898e6", "name" : "IEC-ZS01-res-ga2n-0001", "created" : "2020-12-29T03:45:56Z", "tags" : [ "__type_iec=__type_iec", "area=south", "city=zhongshan", "edgecloud=528cb435-4988-11eb-8603-fa1640aee23e", "operator=chinaunicom", "province=guangdong", "resourceID=5403ddae-4988-11eb-8603-fa1640aee23e" ], "description" : "", "locked" : false, "tenant_id" : "", "sys_tags" : [ { "key" : "_sys_enterprise_project_id", "value" : "0" } ], "flavor" : { "disk" : "0", "vcpus" : "2", "ram" : "4096", "id" : "kc1.large.2", "name" : "kc1.large.2" }, "metadata" : { "charging_mode" : "0", "vpc_id" : "4a6d9663-475f-11eb-aa7c-fa16406a65c4", "EcmResStatus" : "", "image_name" : "CentOS 7.0 64bit", "os_bit" : "64", "lock_check_endpoint" : "", "lock_source" : "", "lock_source_id" : "", "lock_scene" : "", "eip_type" : "" }, "security_groups" : [ { "name" : "stock_sg_changsha568" } ], "key_name" : "", "progress" : 0, "OS-EXT-STS:power_state" : 1, "OS-EXT-STS:vm_state" : "active", "OS-EXT-STS:task_state" : "", "OS-DCF:diskConfig" : "MANUAL", "OS-EXT-AZ:availability_zone" : "edgecloud-site3", "OS-SRV-USG:launched_at" : "2020-12-29T03:46:10.000000", "OS-SRV-USG:terminated_at" : "", "OS-EXT-SRV-ATTR:root_device_name" : "/dev/vda", "OS-EXT-SRV-ATTR:ramdisk_id" : "", "OS-EXT-SRV-ATTR:kernel_id" : "", "OS-EXT-SRV-ATTR:launch_index" : 0, "OS-EXT-SRV-ATTR:reservation_id" : "r-cm8o05kr", "OS-EXT-SRV-ATTR:hostname" : "iec-zs01-res-ga2n-0001", "OS-EXT-SRV-ATTR:user_data" : "IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiR1RnFESEIkdXV1THhibEIuNjRtMGVWS3lvbzAuUjdhNExuNmYxdDU1dTJZcHViM2ZZVExyUHRhNG5DNUk3RTVtdGtyUFQwMkNMbmtPS1FrTHM4ZmhycUFqcmZISjEnIHwgY2hwYXNzd2QgLWU7", "OS-EXT-SRV-ATTR:host" : "11145fe342232beffd5e161599261a4ca047d6b7d138648959fe432b", "OS-EXT-SRV-ATTR:instance_name" : "instance-0000afd6", "OS-EXT-SRV-ATTR:hypervisor_hostname" : "11145fe342232beffd5e161599261a4ca047d6b7d138648959fe432b", "os-extended-volumes:volumes_attached" : [ { "id" : "80230eb5-55ef-4d82-aa0a-e0c5bdc1c627", "delete_on_termination" : "true", "bootIndex" : "0", "device" : "/dev/vda" } ], "edgecloud_id" : "528cb435-4988-11eb-8603-fa1640aee23e", "edgecloud_name" : "iec-nazt", "geolocation" : { "id" : "6813be76-7322-11ea-9ce0-286ed488d287", "city" : "zhongshan", "i18n_city" : "中山市", "province" : "guangdong", "i18n_province" : "广东", "area" : "south", "i18n_area" : "华南地区", "country" : "china", "i18n_country" : "中国" }, "domain_id" : "2b76febbe5d34eac85d26435c1f15809" } }

响应示例 状态码： 200 OK { "routetable" : { "id" : "b96df94c-7d3b-4e5f-8852-16646a27ef95", "name" : "test1", "vpc_id" : "af5b7439-5969-11eb-acfa-fa16408859a1", "domain_id" : "2b76febbe5d34eac85d26435c1f15809", "default" : false } }

请求示例 https://{{endpoint}}/v1/firewalls/c2c5234b-67ff-11ea-a41a-00e04c9bd2a3/firewall-rules { "firewall" : { "ingress_firewall_policy" : { "id" : "9ea9351c-bf23-4c7a-8a92-bc6bfa6b7725", "firewall_rules" : [ { "name" : "", "description" : "", "enabled" : true, "action" : "allow", "protocol" : "any", "ip_version" : 4, "destination_ip_address" : "0.0.0.0/0", "destination_port" : "", "source_ip_address" : "0.0.0.0/0", "source_port" : "", "operate_type" : "add" } ] } } }

响应示例 状态码： 200 OK { "firewall" : { "id" : "c2c5234b-67ff-11ea-a41a-00e04c9bd2a3", "status" : "INACTIVE", "ingress_firewall_policy" : { "id" : "dd1b46d8-bff8-41d5-b79d-b96c300371d7", "firewall_rules" : [ { "id" : "438b8821-69a9-11ea-bec0-00e04c9bd2a3", "name" : "test", "description" : "test", "enabled" : true, "action" : "allow", "protocol" : "tcp", "ip_version" : 4, "destination_ip_address" : "0.0.0.0/12", "destination_port" : "443", "source_ip_address" : "0.0.0.0/24", "source_port" : "35" } ] }, "egress_firewall_policy" : { } } }

响应参数 状态码： 200 表7 响应Body参数 参数 参数类型 描述 firewall UpdateFirewallRuleResp object 更新网络ACL返回体，当更新操作为delete时，返回体中的policy策略中不再包含任何firewall_rule，只包含策略ID。 表8 UpdateFirewallRuleResp 参数 参数类型 描述 id String 网络ACL ID status String 网络ACL状态。 egress_firewall_policy FirewallPolicyResp object 出方向网络ACL策略返回体，当该返回体有值时，则ingress_firewall_policy为{} ingress_firewall_policy FirewallPolicyResp object 入方向网络ACL策略返回体，当该返回体有值时，则egress_firewall_policy为{} 表9 FirewallPolicyResp 参数 参数类型 描述 id String 网络ACL策略ID。 name String 网络ACL策略名称。 最小长度：0 最大长度：64 firewall_rules Array of FirewallRuleResp objects 网络ACL规则列表对象。 数组长度：0 - 1 insert_after String ACL规则ID，表示在此ACL规则之后添加ACL规则 insert_before String ACL规则ID，表示在此ACL规则之前添加ACL规则 表10 FirewallRuleResp 参数 参数类型 描述 action String 策略是否允许 取值范围：allow，deny，reject description String 网络ACL规则描述。 最小长度：0 最大长度：64 destination_ip_address String 目的地IP地址，IPv4或IPv6的CIDR格式 destination_port String 目的地端口范围 取值范围：整数，比如80，或者以"-"隔开的范围，比如80-90 enabled Boolean 网络ACL规则使能开关。 取值范围：true，false 缺省值：true id String 网络ACL规则ID。 进行更新规则时，如果operate_type为add，则该值为空。 ip_version Integer IP协议版本 取值范围：4, 表示ipv4；6, 表示ipv6 name String 网络ACL规则名称。 最小长度：0 最大长度：64 operate_type String 网络ACL规则操作状态，作为请求时取值为"add"/"modify"/"delete"，作为返回值时为"normal"。 当请求更新规则时，本参数值为delete时，除id之外，本请求体其他参数均可为空。 protocol String IP协议，为any时代表所有协议 取值范围： icmp，tcp，udp，icmpv6，any source_ip_address String 源IP地址，IPv4或IPv6的CIDR格式 source_port String 源地端口范围 取值范围：整数，比如80，或者以"-"隔开的范围，比如80-90

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 firewall 否 UpdateFirewallRuleOption object 防火墙 表4 UpdateFirewallRuleOption 参数 是否必选 参数类型 描述 egress_firewall_policy 是 FirewallPolicy object 出方向防火墙策略，不能与ingress_firewall_policy同时存在 ingress_firewall_policy 是 FirewallPolicy object 入方向防火墙策略，不能与egress_firewall_policy同时存在 表5 FirewallPolicy 参数 是否必选 参数类型 描述 id 是 String 网络ACL策略ID。 name 否 String 网络ACL策略名称。 最小长度：0 最大长度：64 firewall_rules 是 Array of FirewallRule objects 网络ACL规则列表对象。 数组长度：0 - 1 insert_after 否 String ACL规则ID，表示在此ACL规则之后添加ACL规则 insert_before 否 String ACL规则ID，表示在此ACL规则之前添加ACL规则 表6 FirewallRule 参数 是否必选 参数类型 描述 action 是 String 策略是否允许 取值范围：allow，deny，reject description 否 String 网络ACL规则描述。 最小长度：0 最大长度：64 destination_ip_address 是 String 目的地IP地址，IPv4或IPv6的CIDR格式 destination_port 是 String 目的地端口范围 取值范围：整数，比如80，或者以"-"隔开的范围，比如80-90 enabled 是 Boolean 网络ACL规则使能开关。 取值范围：true，false 缺省值：true id 是 String 网络ACL规则ID。 进行更新规则时，如果operate_type为add，则该值为空。 ip_version 是 Integer IP协议版本 取值范围：4, 表示ipv4；6, 表示ipv6 name 是 String 网络ACL规则名称。 最小长度：0 最大长度：64 operate_type 是 String 网络ACL规则操作状态，作为请求时取值为"add"/"modify"/"delete"，作为返回值时为"normal"。 当请求更新规则时，本参数值为delete时，除id之外，本请求体其他参数均可为空。 protocol 是 String IP协议，为any时代表所有协议 取值范围： icmp，tcp，udp，icmpv6，any source_ip_address 是 String 源IP地址，IPv4或IPv6的CIDR格式 source_port 是 String 源地端口范围 取值范围：整数，比如80，或者以"-"隔开的范围，比如80-90

响应示例 状态码： 200 OK { "routetable" : { "id" : "b96df94c-7d3b-4e5f-8852-16646a27ef95", "name" : "test1", "vpc_id" : "af5b7439-5969-11eb-acfa-fa16408859a1", "domain_id" : "2b76febbe5d34eac85d26435c1f15809", "description" : "this is a test", "default" : false } }

响应示例 状态码： 200 OK { "count" : 1, "deployments" : [ { "id" : "87b9a88c-499d-11eb-8a8a-fa1640495574", "edgecloud" : { "name" : "edgecloud1", "stacks" : { "name" : "stack-fo09", "resources" : [ { "name" : "edgeinstance1", "image_ref" : "00000000-0000-0000-0000-000000000002", "flavor_ref" : "c6.large.2", "user_data" : "IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiQzOEVORTckaTJ6Li9ibzZMUGlUT3VFVE5KbmxNdC9yMmJSNlhyOC81S3BndWtNU0xhLmhiVlFJNkY3T25sUS5ucVM0SXpmVEhSU0ZHN3lBeHBiakxlNkUwYjE1YjEnIHwgY2hwYXNzd2QgLWU7", "net_config" : { "vpc_id" : "4a6d9663-475f-11eb-aa7c-fa16406a65c4", "nic_num" : 1 }, "count" : 1, "root_volume" : { "volume_type" : "SATA", "size" : 100 }, "security_groups" : [ { "id" : "153133f5-2b16-11eb-a594-fa16408859a1" } ] } ] }, "coverage" : { "coverage_policy" : "centralize", "coverage_level" : "city", "coverage_sites" : [ { "site" : "xi'an", "demands" : [ { "operator" : "", "pool_id" : "", "demand_count" : 1 } ] } ] } }, "distribution" : [ { "site_id" : "74a75ed3-cfb9-11ea-a0c3-fa1640495574", "area" : "north", "province" : "shaanxi", "city" : "xi'an", "operator" : "bgp", "pool_id" : "5_bgp_edgecloud-site4_0", "stack_count" : 1, "city_short_name" : "" } ] } ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 count Integer 部署计划列表的总和。 deployments Array of Deployment objects 部署计划列表。 表4 Deployment 参数 参数类型 描述 id String 部署计划ID。 distribution Array of Distribution objects 部署位置信息列表 edgecloud DeploymentEdgecloud object 待部署的边缘业务。 表5 Distribution 参数 参数类型 描述 area String 所在大区名称。 city String 所在城市名称。 operator String 所属运营商名称。 province String 所属省份名称。 site_id String 站点ID。 pool_id String 线路ID。多线路场景下，将在该线路下创建弹性公网IP。 stack_count Integer 资源组配置模板数目 city_short_name String 城市简称。 ipv6_enable Boolean 创建边缘实例是否开启IPv6。 ipv6_bandwidth_enable Boolean 创建IPv6边缘实例是否支持公网访问。 pool_id_v6 String IPv6线路ID。IPv6场景下，使用该线路下的子网分配IPv6端口。 表6 DeploymentEdgecloud 参数 参数类型 描述 id String 边缘业务ID。 name String 边缘业务名称。 stacks Stack object 边缘业务资源组。 description String 边缘业务描述，最大支持255字节。 coverage Coverage object 边缘业务覆盖策略。 表7 Stack 参数 参数类型 描述 name String 边缘资源组名称。 取值范围：只能由中文字符、大小写英文字母、数字及中划线、下划线组成，且长度为[1-48]个字符。 最小长度：1 最大长度：48 resources Array of Resource objects 边缘业务的堆栈，即为资源组。 表8 Resource 参数 参数类型 描述 name String 边缘实例名称。 取值范围： 只能由中文字符、英文字母 (大小写)、数字及“_”、“-”、“.” 组成。 创建的边缘实例数量（count字段对应的值）大于1时，为区分不同边缘实例，创建过程中系统会自动在名称后加“-000x”的类似标记。 说明： 华为云边缘实例内部主机名 （hostname）命名规则遵循RFC 952和RFC 1123命名规范，建议使用a-zA-z或0-9以及中划线'-'组成的名称命名，' _' 将在边缘实例内部默认转化为'-'。 最小长度：1 最大长度：48 with_prefix Boolean 是否自动添加名称前缀。 with_prefix为false时不拼接IEC前缀 with_prefix不传或者传true时拼自动IEC前缀 以name为iec为例： 不添加前缀时实例名称为：iec-0001 自动添加前缀实例名称为：IEC-ZS01-iec-0001 0001为创建边缘业务时根据实例个数自动添加的编号 缺省值：true image_ref String 待发放边缘实例的系统镜像，需要指定已创建镜像的ID。 说明： 镜像的ID可以从控制台或者参考本文档的“查询边镜像列表”的章节获取。 flavor_ref String 边缘实例的系统规格的ID。 admin_pass String 如果需要使用密码方式登录边缘实例，可使用admin_pass字段指定边缘实例管理员帐户初始登录密码。其中，Linux管理员帐户为root，Windows管理员帐户为Administrator。 密码复杂度要求： 长度为8-26位。 密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%^-_=+[{}]:,./?）中的三种。 密码不能包含用户名或用户名的逆序。 Windows系统密码不能包含用户名或用户名的逆序，不能包含用户名中超过两个连续字符的部分。 说明： 目前边缘实例不支持创建后设置密码，不设置此参数会导致实例无法登录。 最小长度：8 最大长度：26 key_name String 密钥对名称。 net_config NetConfig object 实例的边缘网络配置。 包含了边缘网络的网段信息和子网数目信息。 bandwidth BandwidthConfig object 实例的带宽参数。 IEC服务现在提供共享带宽服务，暂不支持其他类型带宽。 说明： 创建边缘业务时指定实例同步创建EIP则需通过此参数指定。 root_volume RootVolume object 边缘实例对应系统盘相关配置。 data_volumes Array of DataVolume objects 边缘实例对应数据盘相关配置。每一个数据结构代表一块待创建的数据盘。 约束：目前边缘实例最多可挂载2块数据盘 count Integer 边缘实例数量。 不传该字段时默认取值为1。 security_groups Array of SecurityGroupOption objects 边缘业务对应安全组信息。 user_data String 创建边缘实例过程中注入用户数据。支持注入文本、文本文件或gzip文件。 更多关于待注入用户数据的信息，请参见《弹性云服务器用户指南 》的“用户数据注入”章节。 表9 NetConfig 参数 参数类型 描述 vpc_id String 边缘网络ID。 约束： 创建边缘业务仅支持使用系统规划的虚拟私有云。 nic_num Integer 边缘实例绑定的网卡数量。 约束：一台边缘实例最少绑定一张网卡，最多绑定8张网卡。 最小值：1 最大值：8 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”，表示关闭源目地址检查开关 表10 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地址 表11 BandwidthConfig 参数 参数类型 描述 sharetype String 带宽类型，现支持WHOLE类型，即共享带宽，其他类型不支持。 size Integer 带宽（Mbit/s）。 表12 RootVolume 参数 参数类型 描述 size Integer 系统盘大小，容量单位为GB，输入大小范围为[40,100]。 最小值：40 最大值：100 volume_type String 边缘实例系统盘对应的磁盘类型，需要与站点所提供的磁盘类型相匹配。 表13 DataVolume 参数 参数类型 描述 size Integer 数据盘大小，容量单位为GB，输入大小范围为[1,500]。 最小值：1 最大值：500 volume_type String 边缘实例数据盘对应的磁盘类型，需要与站点所提供的磁盘类型相匹配。 表14 SecurityGroupOption 参数 参数类型 描述 id String 边缘实例的安全组，会对边缘实例中配置的网卡生效。需要指定已有安全组的ID。不填写时选择默认安全组 表15 Coverage 参数 参数类型 描述 coverage_policy String 区域调度策略，只支持centralize/discrete。 centralize：代表城市集中策略，指定该策略，边缘业务创建时会保证将所有实例都发放在同一个站点。 discrete：代表城市分散，指定该策略，边缘业务创建时，尽量保证所有实例都分散发放在不同站点。 coverage_level String 区域分布层级，只支持area/prov/city/site。 area:大区，用户的资源会在指定大区下发放。 prov:省份，用户的资源会在指定省份下发放。 city:城市，用户的资源会在指定城市下发放。 site:站点级别。 约束： 站点层级，coverage_policy上仅支持'centralize'，coverage_sites中'site'字段仅支持使用ID(站点ID，通过“查询边缘站点列表”获取)，不支持name。 coverage_sites Array of CoverageSite objects 区域及购买数量列表。 表16 CoverageSite 参数 参数类型 描述 site String 站点名称。 具体信息可通过调用“查询边缘站点列表”来查询(注意：本字段区分大小写)。 demands Array of Demand objects 租户需求数量列表。表示租户发放资源站点的运营商和发放的资源组的数量。 表17 Demand 参数 参数类型 描述 operator String 所属运营商。 demand_count Integer 站点需要发放的资源(组)总数。 说明： 实际发放实例数量为count*demand_count。 最小值：1 最大值：10 pool_id String 弹性公网IP池。 多线路场景下，将在该弹性公网IP池下创建弹性公网IP。 说明： 覆盖规则为省级/大区时不支持指定线路ID创建边缘业务。 bandwidth_type String 带宽类型。 如果当前带宽类型下没有带宽，自动在该带宽类型下创建带宽 pool_id_v6 String 指定IPv6线路，使用该线路下的子网分配IPv6端口。 如果该线路下没有关联启用IPv6的子网，则创建新的子网。 ipv6_bandwidth_enable Boolean 使用IPv6带宽。 边缘实例是否开启IPv6公网访问能力。如果该IPv6线路没有可用的带宽，则创建新的带宽。 ipv6_bandwidth_type String 带宽类型。 边缘实例开启IPv6访问公网能力后，如果当前带宽类型下没有带宽，自动在该带宽类型下创建带宽

URI GET /v1/deployments 表1 Query参数 参数 是否必选 参数类型 描述 edgecloud_id 否 String 查询条件，边缘业务ID。 id 否 String 查询条件，部署计划ID。 limit 否 Integer 查询返回部署计划列表当前页面的数量。 最小值：0 最大值：1000 offset 否 Integer 偏移量。 当前偏移量，默认为0。 status 否 String 查询条件，部署计划状态，现只包含如下值： open:部署计划处于未执行状态，可执行部署计划进行部署 closed:部署计划已关闭，不可部署。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 subnets Array of Subnet objects 子网数组。 count Integer 子网数目。 表4 Subnet 参数 参数类型 描述 id String 子网的ID。 name String 子网名称 取值范围：1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点） cidr String 子网的网段 取值范围：必须在vpc对应cidr范围内 约束：必须是cidr格式。掩码长度不能大于28 dnsList Array of strings 子网dns服务器地址列表 gateway_ip String 子网的网关 取值范围：子网网段中的IP地址 约束：必须是ip格式 dhcp_enable Boolean 子网是否开启dhcp功能 primary_dns String 子网dns服务器地址1 secondary_dns String 子网dns服务器地址2 status String 子网的状态 取值范围： ACTIVE：表示子网已挂载到ROUTER上 UNKNOWN：表示子网还未挂载到ROUTER上 ERROR：表示子网状态故障 vpc_id String 虚拟私有云ID。 site_id String 子网所属的站点ID。 site_info String 子网所属的站点信息。 neutron_network_id String 对应网络（OpenStack Neutron接口） id。 neutron_subnet_id String 对应子网（OpenStack Neutron接口） id。 cidr_v6 String IPv6子网的网段，如果子网为IPv4子网，则不返回此参数 ipv6_enable Boolean 是否是IPv6子网 取值范围：true，false pool_id String IPv6线路ID，如果子网为IPv4子网，则不返回此参数。 neutron_subnet_id_v6 String 对应IPv6子网（OpenStack Neutron接口）id，如果子网为IPv4子网，则不返回此参数。 gateway_ip_v6 String IPv6子网的网关，如果子网为IPv4子网，则不返回此参数。

响应示例 状态码： 200 OK { "subnets" : [ { "id" : "99d9d709-8478-4b46-9f3f-2206b1023fd3", "name" : "dc1_subnet_001", "cidr" : "172.168.1.0/24", "dnsList" : [ "10.2.3.21", "10.32.54.2" ], "gateway_ip" : "172.168.1.1", "dhcp_enable" : true, "primary_dns" : null, "secondary_dns" : null, "status" : "ACTIVE", "vpc_id" : "4a532e51-0649-41b1-b120-49c60c6b0638", "site_id" : "e3b52316-05be-11ea-bc35-286ed488d287", "site_info" : "中国/华中地区/湖北/武汉市", "neutron_network_id" : "e3b52316-05be-11ea-bc35-286ed488d287", "neutron_subnet_id" : "e3b52316-05be-11ea-bc35-286ed488d287" } ], "count" : 1 }

请求示例 在vpc id为af5b7439-5969-11eb-acfa-fa16408859a1的vpc下创建名为test1的自定义路由表 POST https://{{endpoint}}/v1/routetables { "routetable" : { "vpc_id" : "af5b7439-5969-11eb-acfa-fa16408859a1", "name" : "test1" } }

响应示例 状态码： 200 OK { "routetable" : { "id" : "b96df94c-7d3b-4e5f-8852-16646a27ef95", "name" : "test1", "vpc_id" : "af5b7439-5969-11eb-acfa-fa16408859a1", "domain_id" : "2b76febbe5d34eac85d26435c1f15809", "default" : false } }

请求示例 批量关闭边缘实例，请求参数必须以"os-stop"字段下发 POST https://{endpoint}/v1/cloudservers/action { "os-stop" : { "type" : "HARD", "servers" : [ { "id" : "cedd5deb-9386-4605-b2e3-2de387c39a80" }, { "id" : "28fddce3-3797-4a26-8145-abeb335c0abb" } ] } }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表2 请求Body参数 参数 是否必选 参数类型 描述 os-stop 否 BatchStop object 标记为关闭边缘实例操作。 表3 BatchStop 参数 是否必选 参数类型 描述 servers 是 Array of BaseId objects 待停止的边缘实例列表。 type 否 String 关机类型，默认为SOFT。 取值范围： SOFT：普通关机。 HARD：强制关机。 表4 BaseId 参数 是否必选 参数类型 描述 id 是 String 对象ID，uuid。