文档修订记录

2023-09-13

第五十二次正式发布。文档内容更新为：

新增章节流量镜像会话、流量镜像筛选条件、流量镜像筛选规则。

2023-08-21

第五十一次正式发布。文档内容更新为：

新增V3版本的网络ACL接口，章节所在网络ACL。

2023-06-16

第五十次正式发布。文档内容更新为：

API接口请求示例添加说明。

2023-05-30

第四十九次正式发布。文档内容更新为：

修改路由表中更新路由表的请求方法UPDATE -> PUT。

2023-05-16

第四十八次正式发布。文档内容更新为：

• 更新创建VPC，新增tags请求参数。
• 更新创建子网，新增tags请求参数。
• 更新IP地址组，开放max_capacity、status、status_message参数

2023-04-17

第四十七次正式发布。文档内容更新为：

VPC云探示例正确性问题修复：

• 更新创建子网，删除示例中的注释
• 更新查询子网列表，删除示例中的注释
• 更新更新安全组，删除响应示例中的参数"port_range_min"、"port_range_max"
• 更新查询VPC资源实例、查询子网资源实例，修复参数resource_detail的名称拼写错误
• 更新更新辅助弹性网卡，添加响应参数sub_network_interface
• 更新查询租户下辅助弹性网卡数目，修改响应示例中的sub-network-interfaces为sub_network_interfaces
• 更新添加VPC扩展网段、移除VPC扩展网段，修复响应示例中的参数resource_type、resource_count拼写错误

2023-03-14

第四十六次正式发布。文档内容更新为：

• 更新VPC，更新tenant_id字段的说明为项目ID
• 更新子网，更新tenant_id字段的说明为项目ID

2023-01-12

第四十五次正式发布。文档内容更新为：

在“错误码”章节，新增流日志对应错误码。

2022-12-15

第四十四次正式发布。文档内容更新为：

• 更新创建VPC，新增tenant_id、created_at、updated_at参数。
• 更新查询VPC，新增tenant_id、created_at、updated_at参数。
• 更新查询VPC列表，新增tenant_id、created_at、updated_at参数。
• 更新更新VPC，新增tenant_id、created_at、updated_at参数。
• 更新创建子网，新增tenant_id、created_at、updated_at参数。
• 更新查询子网，新增tenant_id、created_at、updated_at参数。
• 更新查询子网列表，新增tenant_id、created_at、updated_at参数。
• 更新查询路由表列表，新增created_at、updated_at参数。
• 更新查询路由表，新增created_at、updated_at参数。
• 更新创建路由表，新增created_at、updated_at参数。
• 更新更新路由表，新增created_at、updated_at参数。
• 更新关联路由表与子网，新增created_at、updated_at参数。
• 更新解关联路由表与子网，新增created_at、updated_at参数。

2022-12-01

第四十三次正式发布。

本次更新说明如下：

新增流日志章节。

2022-11-15

第四十二次正式发布。

本次更新说明如下：

• 在查询VPC列表章节，接口上线的区域信息，新增Region。
• 在查询VPC详情章节，接口上线的区域信息，新增Region。
• 在添加VPC扩展网段章节，接口上线的区域信息，新增Region。
• 在移除VPC扩展网段章节，接口上线的区域信息，新增Region。

2022-08-17

第四十一次正式发布。

本次更新说明如下：

在API V3章节，增加各接口上线的区域信息。

2021-12-23

第四十次正式发布。

本次更新说明如下：

新增VPC路由和路由表章节。

2021-11-12

第三十九次正式发布。

本次更新说明如下：

新增API V3。

2021-08-11

第三十八次正式发布。

本次更新说明如下：

新增路由表。

2021-07-09

第三十七次正式发布。

本次更新说明如下：

• 全文优化“marker”和“limit”参数。
• 全文增加“API Explorer”的链接。

2021-6-30

第三十六次正式发布。

本次更新说明如下：

• 在子网、私有IP、端口、子网资源标签管理、查询网络IP使用情况章节，修改“subnet_id”参数描述。
• 在查询网络IP使用情况章节，修改接口功能介绍。

2021-06-21

第三十五次正式发布。

本次更新说明如下：

• 在创建子网、查询子网、查询子网列表章节，补充响应参数“scope”。
• 在创建端口、查询端口、查询端口列表、更新端口章节，补充响应参数“zone_id”。

2021-03-11

第三十四次正式发布。

本次更新说明如下：

在错误码章节，新增端口相关错误码。

2020-12-17

第三十三次正式发布。

本次更新说明如下：

• 新增示例四：配置云服务器高可用的IPv6虚拟IP功能章节。
• 删除“虚拟IP接口操作指导”章节。

2020-08-06

第三十二次正式发布。

本次更新说明如下：

调整文档结构，新增历史API章节。

2020-07-13

第三十一次正式发布。

本次更新说明如下：

• 在子网章节，修改“status”参数描述。
• 在端口章节，“network_id ”增加网络ID获取方式。

2020-06-24

第三十次正式发布。

本次更新说明如下：

• 删除“快速入门”章节。
• 新增应用示例。

2020-06-02

第二十九次正式发布。

本次更新说明如下：

• 在权限和授权项章节，调整表格。
• 在错误码章节，错误码说明补充API网关错误码说明。

2020-05-12

第二十八次正式发布。

本次更新说明如下：

• 删除弹性公网IP相关内容。
• 在更新VPC章节，增加“routes”字段。
• 在创建端口章节，增加“device_owner”字段。
• 在端口章节，新增或修改“ports_links”、“binding:profile”、“binding:vif_details”字段。
• 在网络章节，新增“networks_links”字段。
• 在子网章节，新增“subnets_links”字段。
• 在路由器章节，新增“routers_links”、“enable_snat”字段。
• 在网络ACL章节，新增或修改“firewall_rules_links”、“firewall_policies”字段。
• 在创建端口章节，新增“device_owner”字段。
• 在更新端口章节，补充“allow_address_pair”和“extra_dhcp_opt”字段是否必选信息。
• 在查询安全组规则、删除安全组规则章节，修改URI。
• 在创建安全组、查询安全组规则章节，增加“tenant_id”字段。
• 在端口章节增加“binding:vif_details”、“binding:profile”、“instance_id”、“instance_type”、“port_security_enabled”字段。
• 在查询对等连接列表章节，增加“peerings_link”对象。
• 在查询VPC路由列表章节，增加“routes_link”对象。
• 在创建端口章节，增加“fixed_ip”字段。
• 在查询所有网络ACL策略章节，增加“firewall_policies_link”对象。
• 在插入网络ACL规则、移除网络ACL规则章节，增加“project_id”字段。
• 在查询所有网络ACL组、查询特定网络ACL组详情、创建网络ACL组、更新网络ACL组章节，增加“created_at”和“updated_at”字段。
• 在查询所有网络ACL组章节，增加“firewall_groups_link”对象。
• 调整权限和授权项章节位置。

2020-04-24

第二十七次正式发布。

本次更新说明如下：

• 在查询安全组规则、删除安全组规则章节修改URI参数字段。
• 在创建对等连接章节，修改“tenant_id”字段说明。
• 在查询网络IP使用情况章节，修改“network_ip_availability”参数类型。
• 在查询网络列表章节，修改“networks”参数类型。
• 在路由器添加接口、路由器删除接口章节响应参数新增“project_id”。

2020-04-15

第二十六次正式发布。

本次更新说明如下：

在端口（废弃）、6.14-端口、端口章节新增“dns_assignment对象”表格。

2020-03-25

第二十五次正式发布。

本次更新说明如下：

• 在创建安全组规则章节，修改“security_group_rule”字段内参数说明。
• 在端口、网络、查询子网列表、查询路由器列表、网络ACL、安全组补充URI参数说明。

2020-02-24

第二十四次正式发布。

本次更新说明如下：

• 新增VPC资源标签管理、子网资源标签管理、弹性公网IP资源标签管理。
• 在“错误码”章节，新增资源标签相关错误码。

2020-01-20

第二十三次正式发布。

本次更新说明如下：

修改“策略及授权项说明”章节内容。

2019-12-25

第二十二次正式发布。

本次更新说明如下：

新增VPC标签、子网标签、弹性公网IP标签。

2019-09-29

第二十一次正式发布。

本次更新说明如下：

在“子网”章节，新增“ipv6_enable”、“cidr_v6”、“gateway_ip_v6”、“extra_dhcp_opts”字段。

2019-06-04

第二十次正式发布。

本次更新说明如下：

• 新增策略及授权项说明。
• 切换API最新模板。
• 优化内容：增加链接、优化参数说明、优化OpenStack Neutron API的请求参数和响应参数等。

2018-09-30

第十九次正式发布。

本次更新说明如下：

• 新增使用前必读，删除原有接口调用方法、公共消息头等章节。
• 新增API、API（OpenStack Neutron V2.0 原生）章节，将VPC API和原生OpenStack API分类展示。
• 在端口、网络、子网、路由器、浮动IP、网络ACL、安全组章节中新增“project_id”、“created_at”和“updated_at”字段，同时修改对应的请求样例和响应样例。
• 在更新网络ACL规则章节中，删除“Reject”规则描述。
• 统一接口格式。
• 统一“tenant_id”和“project_id”字段描述。
• 在创建VPC、查询VPC、查询VPC列表、更新VPC中新增“routes”字段。

2018-08-30

第十八次正式发布。

本次更新说明如下：

• 在VPC、安全组和权限和授权项中增加多项目管理内容。
• 在弹性公网IP、带宽和带宽（V2.0）中新增IPv6相关字段。
• 在权限和授权项中新增带宽（2.0）、安全组规则和删除安全组的接口。
• 在错误码中新增多项目管理错误码、带宽异常操作码等。

2018-06-30

第十七次正式发布。

本次更新说明如下：

• 新增带宽（V2.0）。

2018-05-30

第十六次正式发布。

本次更新说明如下：

• 在弹性公网IP和带宽中增加多项目管理内容。
• 在安全组中新增安全组规则的描述字段。

2018-05-23

第十五次正式发布。

本次更新说明如下：

• 新增权限和授权项。

2018-04-28

第十四次正式发布。

本次更新说明如下：

• 修改弹性IP为弹性公网IP。

2018-03-30

第十三次正式发布。

本次更新说明如下：

• 新增查询API版本信息列表。
• 新增查询网络IP使用情况。
• 修改bindingprofile属性的说明。

2018-02-28

第十二次正式发布。

本次更新说明如下：

• 修改接受对等连接请求响应参数及参数样例。
• 修改拒绝对等连接请求响应参数及参数样例。

2018-01-30

第十一正式发布。

本次更新说明如下：

• 在“端口”章节的“port字段说明”表格中新增“dns_name”和“dns_assignment”参数。
• 在“端口（原生OpenStack接口）”章节的“port对象”参数表格中新增“dns_name”和“dns_assignment”参数。
• 在“网络（原生OpenStack接口）>简介”中“network对象”表格中新增“dns_domain”参数。
• 开放“网络ACL（原生OpenStack接口）”。
• 在“弹性IP > 查询弹性IP”和“弹性IP > 查询弹性IP列表”小节的响应部分“IPpublicip字段说明”中新增“profile”参数。
• 在“带宽 > 查询带宽列表”和“带宽 > 更新带宽”小节响应部分“bandwidths字段说明”中增加“billing_info”参数。

2017-11-30

第十次正式发布。

本次更新说明如下：

• 新增“对等连接”章节。
• 新增“VPC路由”章节。

• “创建子网接口”新增参数“port_security_enable”。
• 修改“弹性IP”章节的“更新（绑定/解绑）弹性IP”接口中publicip字段中“port_id”参数说明。
• 在“端口（原生OpenStack接口）>简介”章节的“port对象”表格中，刷新device_owner参数说明。
• “查询配额”接口的响应resources字段新增“min”参数。

2017-09-30

第九次正式发布。

本次更新说明如下：

• 刷新“网络（原生OpenStack接口）> 更新网络”。
• 在“浮动IP（原生OpenStakck接口）”章节中删除floatingip对象、请求参数、响应体中的“ip_version”字段。
• 对于原生OpenStack查询类接口，单次查询最多返回2000条数据，超过2000后会返回分页标记。
• 在“查询端口列表”、“查询VPC路由列表”接口的格式中的URI中增加过滤字段。

2017-08-20

第八次正式发布。

本次在以下章节新增接口格式说明“单次查询最多返回5000条数据，超过5000后会返回分页标记。”：

• 查询端口列表
• 查询网络列表
• 查询子网列表
• 查询路由器列表
• 查询浮动IP列表
• 查询安全组列表
• 查询安全组
• 查询安全组规则

2017-07-30

第七次正式发布。

本次更新说明如下：

• “子网 > 创建子网”和“子网（原生OpenStack）> 简介”章节的“subnet对象”中“cidr”说明的掩码长度改为不能大于28。
• “查询弹性IP”和“查询弹性IP列表”接口新增“bandwidth_name”返回参数。

2017-05-30

第六次正式发布。

本次新增以下章节：

• 网络（原生OpenStakc接口）
• 路由器（原生OpenStack接口）
• 浮动IP（原生OpenStack接口）
• 安全组（原生OpenStack接口）

2017-04-28

第五次正式发布。

本次更新说明如下：

• 新增监控指标“up_stream”和“down_stream”。
• 在“创建子网”、“查询子网”、“查询子网列表”和“更新子网”接口中新增字段“dnsList”。

2016-10-29

第四次正式发布。

本次变更说明如下：

• 申请弹性IP中，增加ip_address字段，用户可用指定ip来创建弹性IP

2016-05-31

第三次正式发布。

本次变更说明如下：

• 补充“端口”章节。包括“创建端口”、“查询端口详情”、“查询端口列表”、“更新端口”、“删除端口接口”内容。
• 创建安全组规则中ethertype字段，修改为非必选。

2016-01-25

第二次正式发布。

本次变更说明如下：

• 修改“请求签名流程”，更新了SDK jar包和签名过程。
• 修改“示例代码”，优化代码。
• 修改“公共请求消息头”，新增消息头，部分消息头更改为非必选。
• “附录”章节新增监控指标说明。
• 创建子网和查询子网的子网网关字段gateway_ip修改为必选，并且修改网关字段描述。
• 申请弹性IP，查询弹性IP，弹性IP的状态字段status修改为FREEZED，BIND_ERROR，BINDING，PENDING_DELETE，PENDING_CREATE，NOTIFYING，NOTIFY_DELETE，PENDING_UPDATE，DOWN ，ACTIVE，ELB，ERROR
• 修改安全组和安全组规则中port_range_min和port_range_max字段描述。
• 增加安全组规则icmp协议名称对应关系表和VPC服务监控指标说明。

2015-10-15

第一次正式发布。