:original_name: vpc_api_0012.html .. _vpc_api_0012: Change History ============== +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Released On | Description | +===================================+=============================================================================================================================================================================================================================================================================================================================================================================================================+ | 2022-06-25 | This release incorporates the following changes: | | | | | | - Modified the load balancer types applicable to the **5_gray** type in :ref:`Assigning an EIP `, :ref:`Querying an EIP `, :ref:`Querying EIPs `, and :ref:`Updating an EIP `. | | | - Modified the load balancer types applicable to the **5_gray** type in :ref:`Querying a Bandwidth `, :ref:`Querying Bandwidths `, and :ref:`Updating a Bandwidth `. | | | - Modified the load balancer types applicable to the **5_gray** type in :ref:`Assigning a Shared Bandwidth ` and :ref:`Adding an EIP to a Shared Bandwidth `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2022-03-03 | This release incorporates the following changes: | | | | | | Added descriptions of parameters **private_ip_address** and **port_id** in :ref:`Querying an EIP `, :ref:`Querying EIPs `, and :ref:`Updating an EIP `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2022-02-15 | This release incorporates the following changes: | | | | | | - Added **5_gray** to the value range of parameter **type** in sections :ref:`Assigning an EIP `, :ref:`Querying an EIP `, :ref:`Querying EIPs `, and :ref:`Updating an EIP `. | | | - Added **5_gray** to the value range of parameter **publicip_type** and **gray** for parameter **bandwidth_type** in sections :ref:`Querying a Bandwidth ` and :ref:`Querying Bandwidths `. | | | - Added **5_gray** to the value range of parameter **publicip_type** in sections :ref:`Updating a Bandwidth `, :ref:`Assigning a Shared Bandwidth `, and :ref:`Adding an EIP to a Shared Bandwidth `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2021-08-25 | This release incorporates the following changes: | | | | | | - Modified the description about parameter **updated_at** and added parameters **billing_info** and **enterprise_project_id** in :ref:`Bandwidth ` and :ref:`Bandwidth (V2.0) `. | | | - Changed the value range of **type** in :ref:`Querying Quotas `. | | | - Added parameter **remote_address_group_id** to sections :ref:`Security Group ` and :ref:`Security Group `. | | | - Deleted parameters **ipv6_address_mode** and **ipv6_ra_mode** from :ref:`Subnet `. | | | - Added parameter **enterprise_project_id** to section :ref:`Elastic IP `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2021-06-22 | This release incorporates the following changes: | | | | | | - Added parameter **profile** to sections :ref:`Querying an EIP `, :ref:`Querying EIPs `, and :ref:`Updating an EIP `. | | | - Changed the value range of the **size** parameter to 1 Mbit/s to 1000 Mbit/s in :ref:`Querying Bandwidths `, :ref:`Updating a Bandwidth `, and :ref:`Removing an EIP from a Shared Bandwidth `. | | | - Changed the value range of the **size** parameter to 5 Mbit/s to 1000 Mbit/s in :ref:`Assigning a Shared Bandwidth ` and :ref:`Adding an EIP to a Shared Bandwidth `. | | | - Updated response examples in sections :ref:`Querying a Bandwidth `, :ref:`Querying Bandwidths `, :ref:`Updating a Bandwidth `, :ref:`Assigning a Shared Bandwidth `, and :ref:`Adding an EIP to a Shared Bandwidth `. | | | - Changed the parameter of **binding:vif_details** to **primary_interface** in sections :ref:`Querying Ports `, :ref:`Querying a Port `, :ref:`Creating a Port `, and :ref:`Updating a Port `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2021-05-25 | This release incorporates the following changes: | | | | | | - Added parameter **id** to the **bandwidth** field in section :ref:`Assigning an EIP `. | | | - Added parameter **ip_version** to sections :ref:`Elastic IP `, :ref:`Bandwidth `, and :ref:`Bandwidth (V2.0) `. | | | - Added parameter **bandwidth_name** to section :ref:`Elastic IP `. | | | - Deleted description about IP address version conversion from section :ref:`Updating an EIP `. | | | - Added parameters **created_at**, **updated_at**, **enable_bandwidth_rules**, **rule_quota**, and **bandwidth_rules** in sections :ref:`Bandwidth ` and :ref:`Assigning a Shared Bandwidth `. | | | - Added value **share** to the value range of parameter **bandwidth_type** in section :ref:`Bandwidth `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2021-05-10 | This release incorporates the following changes: | | | | | | - Added description that the IP addresses reserved by the system cannot be obtained using APIs in :ref:`Querying Private IP Address Details `. | | | - Moved :ref:`Error Codes ` and :ref:`Status Codes ` to :ref:`Appendix `. | | | - Added a value for the **type** parameter of the **publicip** field in section :ref:`Elastic IP ` and :ref:`Bandwidth `. | | | - Added **WHOLE** to the value range of parameter **share_type** in section :ref:`Bandwidth `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2021-03-16 | This release incorporates the following changes: | | | | | | Added description that leaving parameter **port_id** blank cannot be used to unbind an EIP from a dedicated load balancer in sections :ref:`Updating an EIP ` and :ref:`Updating a Floating IP Address `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2020-12-16 | This release incorporates the following changes: | | | | | | - Modified the value range of **cidr** in section :ref:`Virtual Private Cloud `. | | | - Changed the maximum number of tags in sections :ref:`Querying VPCs by Tag ` and :ref:`Querying Subnets by Tag `. | | | - Added fields **port_security_enabled**, **dns_name**, and **dns_assignment** to section :ref:`Port `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2020-06-30 | This release incorporates the following changes: | | | | | | - Added the **routes** field in section :ref:`Updating VPC Information `. | | | - Added field **index_enabled** in section :ref:`VPC Flow Log `. | | | - Modified URI parameters in sections :ref:`Querying Security Group Rule Details ` and :ref:`Deleting a Security Group Rule `. | | | - Modified description of the **tenant_id** field in section :ref:`Creating a VPC Peering Connection `. | | | - Modified the **network_ip_availability** parameter type in section :ref:`Querying IP Address Usage on a Specified Network `. | | | - Modified the **networks** parameter type in section :ref:`Querying Networks `. | | | - Added response parameter **project_id** in sections :ref:`Adding an Interface to a Router ` and :ref:`Removing an Interface from a Router `. | | | - Added the **device_owner** field in section :ref:`Creating a Port `. | | | - Added information about whether the **allow_address_pair** and **extra_dhcp_opt** fields are mandatory in section :ref:`Updating a Port `. | | | - Added or modified the **ports_links**, **binding:profile**, and **binding:vif_details** fields in section :ref:`Port `. | | | - Added the **networks_links** field in section :ref:`Network `. | | | - Added the **subnets_links** field in section :ref:`Subnet `. | | | - Added the **routers_links** field in section :ref:`Router `. | | | - Added or modified the **firewall_rules_links** and **firewall_policies** fields in section :ref:`Firewall `. | | | - Modified the URI in sections :ref:`Querying a Security Group Rule ` and :ref:`Deleting a Security Group Rule `. | | | - Added the **tenant_id** field in sections :ref:`Creating a Security Group ` and :ref:`Querying Security Group Rule Details `. | | | - Added the **peerings_link** object in section :ref:`Querying VPC Peering Connections `. | | | - Added the **routes_link** object in section :ref:`Querying VPC Routes `. | | | - Added the **fixed_ip** field in section :ref:`Creating a Port `. | | | - Added the **firewall_policies_link** object in section :ref:`Querying Firewall Policies `. | | | - Added the **project_id** field in sections :ref:`Inserting a Firewall Rule ` and :ref:`Removing a Firewall Rule `. | | | - Added the **created_at** and **updated_at** fields in sections :ref:`Querying Firewall Groups `, :ref:`Querying a Firewall Group `, :ref:`Creating a Firewall Group `, and :ref:`Updating a Firewall Group `. | | | - Added the **firewall_groups_link** object in section :ref:`Querying Firewall Groups `. | | | - Changed the position of the section :ref:`Permissions Policies and Supported Actions ` and adjusted the table. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2020-04-13 | This release incorporates the following changes: | | | | | | - Modified description of parameters in the **security_group_rule** field in section :ref:`Creating a Security Group Rule `. | | | - Added URI parameter description in :ref:`Port `, :ref:`Network `, :ref:`Querying Subnets `, :ref:`Querying Routers `, :ref:`Firewall `, and :ref:`Security Group `. | | | - Added description of discarding **vpc_id** in section :ref:`Creating a Security Group `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2020-03-20 | This release incorporates the following changes: | | | | | | Added the value of **5_mailbgp** for parameters **type** and **publicip_type** | | | | | | in sections :ref:`Assigning an EIP `, :ref:`Bandwidth `, and :ref:`Bandwidth (V2.0) `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2020-02-25 | This release incorporates the following changes: | | | | | | - Added section :ref:`Bandwidth (V2.0) `. | | | - Added :ref:`Bandwidth (V2.0) ` in section :ref:`Permissions Policies and Supported Actions `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2019-09-10 | This release incorporates the following changes: | | | | | | - Added APIs described in section :ref:`VPC Flow Log ` and VPC flow log error codes to section :ref:`Error Codes `. | | | - Modified the description of the **charge_mode** field and its value in the response example in :ref:`Bandwidth `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2018-11-30 | This release incorporates the following changes: | | | | | | - Added the **extra_dhcp_opts** field in sections :ref:`Creating a Subnet `, :ref:`Querying Subnet Details `, :ref:`Querying Subnets `, and :ref:`Updating Subnet Information `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2018-10-22 | This release incorporates the following changes: | | | | | | - Added sections :ref:`APIs ` and :ref:`Native OpenStack Neutron APIs (V2.0) ` and categorized VPC APIs and native OpenStack APIs. | | | - Deleted description about the **Reject** rule from section :ref:`Updating a Firewall Rule `. | | | - Added the **project_id**, **created_at**, and **updated_at** fields to and modified the example request and response in sections :ref:`Port `, :ref:`Network `, :ref:`Subnet `, :ref:`Router `, :ref:`Floating IP Address `, :ref:`Firewall `, and :ref:`Security Group `. | | | - Modified the API format to ensure consistency. | | | - Modified description about the **tenant_id** and **project_id** fields to ensure consistency. | | | - Added section :ref:`VPC Peering Connection ` under **API Permissions**. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2018-10-12 | This release incorporates the following changes: | | | | | | - Added section :ref:`Querying a Specified API Version `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2018-09-04 | This release incorporates the following changes: | | | | | | - Modified the response example in section :ref:`Associating Multiple NIC Ports to or Disassociating Them from a Security Group at a Time `. | | | - Added error messages for associating multiple NIC ports to or disassociating them from a security group at a time in section :ref:`Error Codes `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2018-08-30 | This release incorporates the following changes: | | | | | | - Added section :ref:`Associating Multiple NIC Ports to or Disassociating Them from a Security Group at a Time `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2018-07-30 | This release incorporates the following changes: | | | | | | - Added section :ref:`Permissions Policies and Supported Actions `. | | | - Deleted sections related to VPNs. An independent VPN API reference will be provided. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2018-06-11 | This release incorporates the following changes: | | | | | | - Modified VPC tagging description in section :ref:`Querying VPC Tags in a Specified Project `. | | | - Modified subnet tagging description in section :ref:`Querying Subnet Tags in a Specified Project `. | | | - Modified EIP tagging description in section :ref:`Querying EIP Tags in a Specified Project `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2018-04-28 | This release incorporates the following changes: | | | | | | - Opened APIs described in section :ref:`Floating IP Address (IPv6) `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2018-03-30 | This release incorporates the following changes: | | | | | | - Added section :ref:`Querying API Versions `. | | | - Modified the content in section :ref:`VPC Tag Management `. | | | - Added section :ref:`Subnet Tag Management `. | | | - Added section :ref:`EIP Tag Management `. | | | - Added metrics **Upstream Traffic** and **Downstream Traffic** in section :ref:`VPC Monitoring Metrics `. | | | - Modified the content in section :ref:`API Usage Guidelines `. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2018-02-28 | This release incorporates the following changes: | | | | | | - Modified the URI and description in the API format in section :ref:`Querying VPC Peering Connections `. | | | - Modified the URI and description in the API format in section :ref:`Querying VPC Routes `. | | | - Modified the response parameters and parameter examples in section :ref:`Accepting a VPC Peering Connection `. | | | - Modified the response parameters and parameter examples in section :ref:`Refusing a VPC Peering Connection `. | | | - Provided the address for downloading the sample code in section **Sample Code**. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2018-02-14 | This release incorporates the following changes: | | | | | | - Modified the title of section **VPN (Native OpenStack API)**. | | | - Linked the error codes in subsections of **VPN (Native OpenStack API)** to **Error Codes**. | | | - Linked the error codes in subsection :ref:`Subnet Pool ` to :ref:`Status Codes `. | | | - Linked the error codes in the tag management sections. | | | - Adjusted the sequence of subsections under :ref:`Subnet Pool `. | | | - Modified the description of parameters **share_type** and **charge_mode** in the **bandwidth** field in section :ref:`Assigning an EIP `. | | | - Added the example request in section **Creating a VPN Service**. | | | - Added the example request and example response in section **Querying VPN Endpoint Groups**. | | | - Added the example request in section **Querying Details About a VPN Service**. | | | - Modified the example response in section **Deleting an IKE Policy**. | | | - Added the example request in section **Deleting a VPN Service**. | | | - Added the example request in section **Querying Details About an IKE Policy**. | | | - Added the example response in section **Querying Details About a VPN Endpoint Group**. | | | - Added the example response in section **Querying Details About a VPN Service**. | | | - Added the example response in section **Updating an IPsec Policy**. | | | - Added the example response in section **Updating a VPN Service**. | | | - Modified the example request and example response in section **Updating an IPsec VPN Connection**. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2018-01-30 | This release incorporates the following changes: | | | | | | - Deleted the section **Port**. | | | - Added section **VPN (Native OpenStack API)**. | | | - Added section **Subnet Pool (Native OpenStack API)**. | | | - Added parameters **dns_name** and **dns_domain** in the floating IP address object table in section **Floating IP Address (Native OpenStack API)**. | | | - Added parameters **dns_name** and **dns_assignment** in the **port object** table in section **Port (Native OpenStack API)** > **Overview**. | | | - Added the parameter **dns_domain** in the **network object** table in section **Network (Native OpenStack API)** > **Overview**. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2017-11-30 | This release incorporates the following changes: | | | | | | - Added parameter **port_security_enable** in section **Creating a Subnet**. | | | - Modified the **port_id** parameter description in the **publicip** fields in section **Binding or Unbinding an EIP** under **Elastic IP Address**. | | | - Updated the **device_owner** parameter description in the **port object** table in section **Port (Native OpenStack API)** > **Overview**. | | | - Added the **min** parameter to the **resources** field in the response in section **Querying Quotas**. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2017-09-30 | This release incorporates the following changes: | | | | | | - Deleted the **ip_version** field from the **floatingip** object, request parameter, and response parameter in section **Floating IP Address (Native OpenStack API)**. | | | - Added section **VPC Peering Connection**. | | | - Added section **VPC Route**. | | | - Added a filter field to the URI of the APIs in sections **Querying Ports** and **Querying VPC Routes**. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2017-08-30 | This release incorporates the following changes: | | | | | | Updated description in section **Updating a Network** under **Network (Native OpenStack API)**. | | | | | | - Added section **Elastic IP Address V2.0 (Extended OpenStack API)**. | | | - Deleted the **ip_version** field from the **floatingip** object, request parameter, and response parameter in section **Floating IP Address (Native OpenStack API)**. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2017-07-30 | This release incorporates the following changes: | | | | | | - Changed the allowed maximum subnet mask value to 28 for CIDR blocks in the **subnet** object in section **Overview** under **Subnet (Native OpenStack API)**. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2017-06-30 | This release incorporates the following changes: | | | | | | - Changed the **CRUD** value of parameter **router_id** to **R** for the **Floating IP address** object in section **Overview** under **Floating IP Address (Native OpenStack API)**. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2017-05-30 | Added the following sections: | | | | | | - Network (Native OpenStack API) | | | - Router (Native OpenStack API) | | | - Floating IP Address (Native OpenStack API) | | | - firewall (Native OpenStack API) | | | - Security Group (Native OpenStack API) | | | - Modified the request URI in section **Security Group**. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2017-04-28 | This release incorporates the following changes: | | | | | | - Added monitoring metrics **up_stream** and **down_stream**. | | | - Added field **dnsList** for APIs used to create a subnet, query a subnet, query subnets, and update a subnet. | | | - Changed the bandwidth size value to 1 Mbit/s to 500 Mbit/s in sections **Elastic IP Address** and **Bandwidth**. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2016-10-29 | This release incorporates the following changes: | | | | | | - Added the **ip_address** field to enable users to obtain a specified EIP. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2016-06-02 | This release incorporates the following changes: | | | | | | Changed the **ethertype** field for creating a security group rule to an optional field. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2016-04-14 | This release incorporates the following changes: | | | | | | - Modified the URL parameter description in section **Service Usage**. | | | - Modified the procedure for making API calls for token authentication. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 2016-03-09 | This issue is the first official release. | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+