Compare commits

..

1 Commits

Author SHA1 Message Date
01ca9f3d12 Update tox.ini && conf.py file
Performed-by: gitea/infra/otc-metadata/tools/generate_doc_confpy.py
2023-01-06 18:51:24 +01:00
819 changed files with 17959 additions and 23292 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 28 KiB

View File

@ -1,14 +0,0 @@
:original_name: eip_apiv3_0300.html
.. _eip_apiv3_0300:
Common Pools
============
- :ref:`Querying Common Pools <listcommonpools>`
.. toctree::
:maxdepth: 1
:hidden:
querying_common_pools

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -1,20 +0,0 @@
:original_name: eip_apiv3_0100.html
.. _eip_apiv3_0100:
EIPs
====
- :ref:`Querying All EIPs <listpublicipsv3>`
- :ref:`Querying EIP Details <showpublicipv3>`
- :ref:`Unbinding an EIP <disassociatepublicips>`
- :ref:`Binding an EIP <associatepublicips>`
.. toctree::
:maxdepth: 1
:hidden:
querying_all_eips
querying_eip_details
unbinding_an_eip
binding_an_eip

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -1,16 +0,0 @@
:original_name: vpc_apiv3_0000.html
.. _vpc_apiv3_0000:
API V3
======
- :ref:`EIPs <eip_apiv3_0100>`
- :ref:`Common Pools <eip_apiv3_0300>`
.. toctree::
:maxdepth: 1
:hidden:
eips/index
common_pools/index

View File

@ -95,6 +95,10 @@ Response Message
| enterprise_project_id | String | - Specifies the enterprise project ID. The value is **0** or a string that contains a maximum of 36 characters in UUID format with hyphens (-). |
| | | - When creating a bandwidth, associate the enterprise project ID with the bandwidth. |
| | | - If this parameter is not specified, the default value is **0**, which indicates that the default enterprise project is used. |
| | | |
| | | .. note:: |
| | | |
| | | This parameter is unsupported. Do not use it. |
+-----------------------+---------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| status | String | - Specifies the bandwidth status. |
| | | - Possible values are as follows: |
@ -113,26 +117,26 @@ Response Message
.. table:: **Table 4** **publicip_info** object
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| Name | Type | Description |
+=======================+=======================+=================================================================================================================+
+=======================+=======================+=======================================================================================================================================+
| publicip_id | String | Specifies the ID of the EIP that uses the bandwidth. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| publicip_address | String | Specifies the obtained EIP if only IPv4 EIPs are available. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| ip_version | Integer | - Specifies the IP address version. |
| | | - Possible values are as follows: |
| | | |
| | | - **4**: IPv4 |
| | | - **6**: IPv6 (IPv6 is not supported currently.) |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| publicip_type | String | - Specifies the EIP type. |
| | | - The value can be **5_bgp** (Dynamic BGP), **5_mailbgp** (Mail BGP), or **5_gray** (Dedicated Load Balancer). |
| | | - The value can be **5_bgp** (Dynamic BGP), **5_mailbgp** (Mail BGP), or **5_gray** (Dedicated load balancer, shared load balancer). |
| | | - Constraints: |
| | | |
| | | - The configured value must be supported by the system. |
| | | - **publicip_id** is an IPv4 port. If **publicip_type** is not specified, the default value is **5_bgp**. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
- Example response

File diff suppressed because it is too large Load Diff

View File

@ -128,6 +128,10 @@ Response Message
+-----------------------+---------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| enterprise_project_id | String | - Specifies the enterprise project ID. The value is **0** or a string that contains a maximum of 36 characters in UUID format with hyphens (-). Value **0** indicates the default enterprise project. To obtain the bandwidth bound to all enterprise projects of the user, set **all_granted_eps**. |
| | | - When creating a bandwidth, associate the enterprise project ID with the bandwidth. |
| | | |
| | | .. note:: |
| | | |
| | | This parameter is unsupported. Do not use it. |
+-----------------------+---------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| status | String | - Specifies the bandwidth status. |
| | | - Possible values are as follows: |
@ -146,20 +150,26 @@ Response Message
.. table:: **Table 6** **publicip_info** objects
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| Name | Type | Description |
+=======================+=======================+=================================================================================================================+
+=======================+=======================+=======================================================================================================================================+
| publicip_id | String | Specifies the ID of the EIP that uses the bandwidth. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| publicip_address | String | Specifies the obtained EIP if only IPv4 EIPs are available. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| ip_version | Integer | - Specifies the IP address version. |
| | | - Possible values are as follows: |
| | | |
| | | - **4**: IPv4 |
| | | - **6**: IPv6 (IPv6 is not supported currently.) |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| publicip_type | String | - Specifies the EIP type. |
| | | - The value can be **5_bgp** (Dynamic BGP), **5_mailbgp** (Mail BGP), or **5_gray** (Dedicated Load Balancer). |
| | | - The value can be **5_bgp** (Dynamic BGP), **5_mailbgp** (Mail BGP), or **5_gray** (Dedicated load balancer, shared load balancer). |
| | | - Constraints: |
| | | |
| | | - The configured value must be supported by the system. |
| | | - **publicip_id** is an IPv4 port. If **publicip_type** is not specified, the default value is **5_bgp**. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
- Example response

View File

@ -57,18 +57,18 @@ Request Message
.. table:: **Table 4** **publicip_info** object
+-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------+
| Name | Mandatory | Type | Description |
+=================+=================+=================+=================================================================================================================+
+=================+=================+=================+=======================================================================================================================================+
| publicip_id | Yes | String | Specifies the ID of the EIP that uses the bandwidth. |
+-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------+
| publicip_type | No | String | - Specifies the EIP type. |
| | | | - The value can be **5_bgp** (Dynamic BGP), **5_mailbgp** (Mail BGP), or **5_gray** (Dedicated Load Balancer). |
| | | | - The value can be **5_bgp** (Dynamic BGP), **5_mailbgp** (Mail BGP), or **5_gray** (Dedicated load balancer, shared load balancer). |
| | | | - Constraints: |
| | | | |
| | | | - The configured value must be supported by the system. |
| | | | - **publicip_id** is an IPv4 port. If **publicip_type** is not specified, the default value is **5_bgp**. |
+-----------------+-----------------+-----------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------+
- Example request
@ -111,7 +111,7 @@ Response Message
| | | - The value can contain 1 to 64 characters, including letters, digits, underscores (_), hyphens (-), and periods (.). |
+-----------------------+--------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| size | Integer | - Specifies the bandwidth size. |
| | | - The value ranges from 1 Mbit/s to 1000 Mbit/s by default. (The specific range may vary depending on the configuration in each region. You can see the available bandwidth range on the management console.) |
| | | - The value ranges from 5 Mbit/s to 1000 Mbit/s by default. (The specific range may vary depending on the configuration in each region. You can see the available bandwidth range on the management console.) |
+-----------------------+--------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| id | String | Specifies the bandwidth ID, which uniquely identifies the bandwidth. |
+-----------------------+--------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@ -153,26 +153,26 @@ Response Message
.. table:: **Table 7** **publicip_info** objects
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| Name | Type | Description |
+=======================+=======================+=================================================================================================================+
+=======================+=======================+=======================================================================================================================================+
| publicip_id | String | Specifies the ID of the EIP that uses the bandwidth. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| publicip_address | String | Specifies the obtained EIP if only IPv4 EIPs are available. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| ip_version | Integer | - Specifies the IP address version. |
| | | - Possible values are as follows: |
| | | |
| | | - **4**: IPv4 |
| | | - **6**: IPv6 (IPv6 is not supported currently.) |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| publicip_type | String | - Specifies the EIP type. |
| | | - The value can be **5_bgp** (Dynamic BGP), **5_mailbgp** (Mail BGP), or **5_gray** (Dedicated Load Balancer). |
| | | - The value can be **5_bgp** (Dynamic BGP), **5_mailbgp** (Mail BGP), or **5_gray** (Dedicated load balancer, shared load balancer). |
| | | - Constraints: |
| | | |
| | | - The configured value must be supported by the system. |
| | | - **publicip_id** is an IPv4 port. If **publicip_type** is not specified, the default value is **5_bgp**. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
- Example response

View File

@ -47,11 +47,12 @@ Request Message
+-----------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Name | Mandatory | Type | Description |
+=======================+=================+=================+================================================================================================================================================================================================================+
| name | Yes | String | - Specifies the bandwidth name. |
| | | | - The value can contain 1 to 64 characters, including letters, digits, underscores (_), hyphens (-), and periods (.). |
| name | Yes | String | Specifies the bandwidth name. |
| | | | |
| | | | The value can contain 1 to 64 characters, including letters, digits, underscores (_), hyphens (-), and periods (.). |
+-----------------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| size | Yes | Integer | - Specifies the bandwidth size. The shared bandwidth has a minimum limit, which may vary depending on sites. The default minimum value is 5 Mbit/s. |
| | | | - The value ranges from 1 Mbit/s to 1000 Mbit/s by default. (The specific range may vary depending on the configuration in each region. You can see the available bandwidth range on the management console.) |
| | | | - The value ranges from 5 Mbit/s to 1000 Mbit/s by default. (The specific range may vary depending on the configuration in each region. You can see the available bandwidth range on the management console.) |
| | | | - If a decimal fraction (for example **10.2**) or a character string (for example **"10"**) is specified, the specified value will be automatically converted to an integer. |
| | | | - The minimum increment for bandwidth adjustment varies depending on the bandwidth range. The details are as follows: |
| | | | |
@ -105,7 +106,7 @@ Response Message
| | | - The value can contain 1 to 64 characters, including letters, digits, underscores (_), hyphens (-), and periods (.). |
+-----------------------+--------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| size | Integer | - Specifies the bandwidth size. |
| | | - The value ranges from 1 Mbit/s to 1000 Mbit/s by default. (The specific range may vary depending on the configuration in each region. You can see the available bandwidth range on the management console.) |
| | | - The value ranges from 5 Mbit/s to 1000 Mbit/s by default. (The specific range may vary depending on the configuration in each region. You can see the available bandwidth range on the management console.) |
+-----------------------+--------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| id | String | Specifies the bandwidth ID, which uniquely identifies the bandwidth. |
+-----------------------+--------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@ -153,20 +154,20 @@ Response Message
.. table:: **Table 6** **publicip_info** object
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| Name | Type | Description |
+=======================+=======================+=================================================================================================================+
+=======================+=======================+=======================================================================================================================================+
| publicip_id | String | Specifies the ID of the EIP that uses the bandwidth. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| publicip_address | String | Specifies the obtained EIP if only IPv4 EIPs are available. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
| publicip_type | String | - Specifies the EIP type. |
| | | - The value can be **5_bgp** (Dynamic BGP), **5_mailbgp** (Mail BGP), or **5_gray** (Dedicated Load Balancer). |
| | | - The value can be **5_bgp** (Dynamic BGP), **5_mailbgp** (Mail BGP), or **5_gray** (Dedicated load balancer, shared load balancer). |
| | | - Constraints: |
| | | |
| | | - The configured value must be supported by the system. |
| | | - **publicip_id** is an IPv4 port. If **publicip_type** is not specified, the default value is **5_bgp**. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------+
- Example response

View File

@ -1,86 +0,0 @@
:original_name: vpc_eip_0005.html
.. _vpc_eip_0005:
Releasing an EIP
================
Function
--------
This API is used to release an EIP.
.. note::
Note the following when you use EIPs of the Dedicated Load Balancer (**5_gray**) type:
- In **eu-de**, EIPs of the Dedicated Load Balancer (**5_gray**) type cannot be assigned anymore. You can assign EIPs of the BGP (**5_bgp**) type.
- Existing EIPs of the Dedicated Load Balancer (**5_gray**) type can be bound to dedicated or shared load balancers.
- The EIP console cannot be used to bind EIPs to or unbind them from dedicated load balancers.
- You can use APIs to bind EIPs to or unbind them from dedicated load balancers. For details, see `Binding an EIP <https://docs.otc.t-systems.com/elastic-ip/api-ref/api_v3/eips/binding_an_eip.html>`__ and `Unbinding an EIP <https://docs.otc.t-systems.com/elastic-ip/api-ref/api_v3/eips/unbinding_an_eip.html>`__.
- EIPs of this type can be bound to or unbound from shared load balancers using the EIP console or APIs.
- You are advised to bind BGP EIPs to or unbind them from dedicated load balancers.
- Do not add EIPs of the dedicated load balancer type (**5_gray**) and other types to the same shared bandwidth. Otherwise, the bandwidth limit policy will not take effect.
URI
---
DELETE /v1/{project_id}/publicips/{publicip_id}
:ref:`Table 1 <vpc_eip_0005__table45251091>` describes the parameters.
.. _vpc_eip_0005__table45251091:
.. table:: **Table 1** Parameter description
=========== ========= ==========================================
Name Mandatory Description
=========== ========= ==========================================
project_id Yes Specifies the project ID.
publicip_id Yes Specifies the unique identifier of an EIP.
=========== ========= ==========================================
Request Message
---------------
- Request parameter
None
- Example request
.. code-block:: text
DELETE https://{Endpoint}/v1/{project_id}/publicips/{publicip_id}
Response Message
----------------
- Response parameter
None
- Example response
None
Or
.. code-block::
{
"code":"xxx",
"message":"xxxxx"
}
Status Code
-----------
See :ref:`Status Codes <vpc_api_0002>`.
Error Code
----------
See :ref:`Error Codes <vpc_api_0003>`.

View File

@ -15,9 +15,9 @@ URI
DELETE /v2.0/{project_id}/publicips/{publicip_id}/tags/{key}
:ref:`Table 1 <eip_tag_0003__table5716115334>` describes the parameters.
:ref:`Table 1 <eip_tag_0003__table27380479>` describes the parameters.
.. _eip_tag_0003__table5716115334:
.. _eip_tag_0003__table27380479:
.. table:: **Table 1** Parameter description

View File

@ -15,9 +15,9 @@ URI
GET /v2.0/{project_id}/publicips/{publicip_id}/tags
:ref:`Table 1 <eip_tag_0002__table450964213214>` describes the parameters.
:ref:`Table 1 <eip_tag_0002__table27380479>` describes the parameters.
.. _eip_tag_0002__table450964213214:
.. _eip_tag_0002__table27380479:
.. table:: **Table 1** Parameter description

View File

@ -63,7 +63,7 @@ Response Message
| key | String | Specifies the tag key. |
| | | |
| | | - Cannot be left blank. |
| | | - Contain up to 128 characters (36 characters on the console). |
| | | - Can contain a maximum of 36 characters. |
| | | - Can contain only the following character types: |
| | | |
| | | - Uppercase letters |
@ -73,7 +73,7 @@ Response Message
+-----------------------+-----------------------+---------------------------------------------------------------------+
| values | Array of strings | Specifies the tag value list. |
| | | |
| | | - Contain up to 255 characters (43 characters on the console). |
| | | - Can contain a maximum of 43 characters. |
| | | - Can contain only the following character types: |
| | | |
| | | - Uppercase letters |

View File

@ -2,8 +2,8 @@
.. _vpc_eip_0000:
EIP
===
Elastic IP
==========
- :ref:`Assigning an EIP <en-us_topic_0020090596>`
- :ref:`Querying an EIP <vpc_eip_0002>`

View File

@ -10,20 +10,6 @@ Function
This API is used to query a specific EIP.
.. note::
Note the following when you use EIPs of the Dedicated Load Balancer (**5_gray**) type:
- In **eu-de**, EIPs of the Dedicated Load Balancer (**5_gray**) type cannot be assigned anymore. You can assign EIPs of the BGP (**5_bgp**) type.
- Existing EIPs of the Dedicated Load Balancer (**5_gray**) type can be bound to dedicated or shared load balancers.
- The EIP console cannot be used to bind EIPs to or unbind them from dedicated load balancers.
- You can use APIs to bind EIPs to or unbind them from dedicated load balancers. For details, see `Binding an EIP <https://docs.otc.t-systems.com/elastic-ip/api-ref/api_v3/eips/binding_an_eip.html>`__ and `Unbinding an EIP <https://docs.otc.t-systems.com/elastic-ip/api-ref/api_v3/eips/unbinding_an_eip.html>`__.
- EIPs of this type can be bound to or unbound from shared load balancers using the EIP console or APIs.
- You are advised to bind BGP EIPs to or unbind them from dedicated load balancers.
- Do not add EIPs of the dedicated load balancer type (**5_gray**) and other types to the same shared bandwidth. Otherwise, the bandwidth limit policy will not take effect.
URI
---
@ -86,20 +72,15 @@ Response Message
| | | - **PENDING_DELETE** (Releasing) |
| | | - **PENDING_CREATE** (Assigning) |
| | | - **PENDING_UPDATE** (Updating) |
| | | - **NOTIFYING** (Assigning) |
| | | - **NOTIFY_DELETE** (Releasing) |
| | | - **DOWN** (Unbound) |
| | | - **ACTIVE** (Bound) |
| | | - **ELB** (Bound to a load balancer) |
| | | - **VPN** (Bound to a VPN) |
| | | - **ERROR** (Exceptions) |
+-----------------------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| profile | :ref:`profile <vpc_eip_0002__table66651219193417>` object | Specifies the additional parameters, including the order ID and product ID. For details, see :ref:`Table 4 <vpc_eip_0002__table66651219193417>`. |
| | | |
| | | This parameter is not supported currently. |
+-----------------------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| type | String | - Specifies the EIP type. |
| | | - The value can be **5_bgp** (Dynamic BGP), **5_mailbgp** (Mail BGP), or **5_gray** (Dedicated Load Balancer). |
| | | - The value can be **5_bgp** (Dynamic BGP), **5_mailbgp** (Mail BGP), or **5_gray** (Dedicated load balancer, shared load balancer). |
| | | - Constraints: |
| | | |
| | | - The configured value must be supported by the system. |
@ -117,20 +98,18 @@ Response Message
| | | |
| | | .. note:: |
| | | |
| | | This parameter is not displayed if the EIP is bound to a dedicated load balancer. This parameter is displayed if the EIP is bound to an ECS. |
| | | The value of **private_ip_address** is **null** if the EIP is bound to a dedicated load balancer. |
+-----------------------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| port_id | String | - Specifies the port ID. |
| | | - This parameter is returned only when a port is associated with the EIP. |
| | | |
| | | .. note:: |
| | | |
| | | This parameter is not displayed if the EIP is bound to a dedicated load balancer. This parameter is displayed if the EIP is bound to an ECS. |
| | | The value of **port_id** is null if the EIP is bound to a dedicated load balancer. |
+-----------------------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| tenant_id | String | Specifies the project ID. |
+-----------------------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| create_time | String | Specifies the time (UTC) when the EIP is assigned. |
| | | |
| | | Format: *yyyy-MM-dd HH:mm:ss* |
+-----------------------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| bandwidth_id | String | Specifies the ID of the EIP bandwidth. |
+-----------------------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@ -144,8 +123,6 @@ Response Message
+-----------------------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| bandwidth_name | String | Specifies the bandwidth name. |
+-----------------------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| alias | String | Specifies the EIP name. |
+-----------------------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| enterprise_project_id | String | - Specifies the enterprise project ID. The value is **0** or a string that contains a maximum of 36 characters in UUID format with hyphens (-). |
| | | - When assigning an EIP, you need to associate an enterprise project ID with the EIP. |
| | | - If this parameter is not specified, the default value is **0**, which indicates that the default enterprise project is used. |
@ -154,15 +131,6 @@ Response Message
| | | |
| | | This parameter is unsupported. Do not use it. |
+-----------------------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| public_border_group | String | Specifies whether it is in a central site or an edge site. |
| | | |
| | | The value can be: |
| | | |
| | | - center |
| | | - *Edge site name* |
| | | |
| | | An EIP can only be bound to a resource of the same region. |
+-----------------------+-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. _vpc_eip_0002__table66651219193417:
@ -185,7 +153,6 @@ Response Message
"publicip": {
"id": "2ec9b78d-9368-46f3-8f29-d1a95622a568",
"status": "DOWN",
"alias": "tom",
"profile": {},
"type": "5_bgp",
"public_ip_address": "161.xx.xx.12",

View File

@ -10,20 +10,6 @@ Function
This API is used to query EIPs.
.. note::
Note the following when you use EIPs of the Dedicated Load Balancer (**5_gray**) type:
- In **eu-de**, EIPs of the Dedicated Load Balancer (**5_gray**) type cannot be assigned anymore. You can assign EIPs of the BGP (**5_bgp**) type.
- Existing EIPs of the Dedicated Load Balancer (**5_gray**) type can be bound to dedicated or shared load balancers.
- The EIP console cannot be used to bind EIPs to or unbind them from dedicated load balancers.
- You can use APIs to bind EIPs to or unbind them from dedicated load balancers. For details, see `Binding an EIP <https://docs.otc.t-systems.com/elastic-ip/api-ref/api_v3/eips/binding_an_eip.html>`__ and `Unbinding an EIP <https://docs.otc.t-systems.com/elastic-ip/api-ref/api_v3/eips/unbinding_an_eip.html>`__.
- EIPs of this type can be bound to or unbound from shared load balancers using the EIP console or APIs.
- You are advised to bind BGP EIPs to or unbind them from dedicated load balancers.
- Do not add EIPs of the dedicated load balancer type (**5_gray**) and other types to the same shared bandwidth. Otherwise, the bandwidth limit policy will not take effect.
URI
---
@ -44,12 +30,12 @@ GET /v1/{project_id}/publicips
| | | | |
| | | | This parameter can work together with the parameter **limit**. |
| | | | |
| | | | - If parameters **marker** and **limit** are not passed, resource records on the first page will be returned. |
| | | | - If parameters **marker** and **limit** are not passed, all resource records will be returned. |
| | | | - If the parameter **marker** is not passed and the value of parameter **limit** is set to **10**, the first 10 resource records will be returned. |
| | | | - If the value of the parameter **marker** is set to the resource ID of the 10th record and the value of parameter **limit** is set to **10**, the 11th to 20th resource records will be returned. |
| | | | - If the value of the parameter **marker** is set to the resource ID of the 10th record and the parameter **limit** is not passed, resource records starting from the 11th records (including 11th) will be returned. |
+-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| limit | No | Integer | Specifies the number of records that will be returned on each page. The value is from 0 to intmax (2^31-1). The default value is 2000. |
| limit | No | Integer | Specifies the number of records that will be returned on each page. The value is from 0 to intmax. |
| | | | |
| | | | **limit** can be used together with **marker**. For details, see the parameter description of **marker**. |
+-----------------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@ -111,11 +97,9 @@ Response Message
| | | - **ERROR** (Exceptions) |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| profile | Object | Specifies the additional parameters, including the order ID and product ID. For details, see :ref:`Table 4 <vpc_eip_0003__table66651219193417>`. |
| | | |
| | | This parameter is not supported currently. |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| type | String | - Specifies the EIP type. |
| | | - The value can be **5_bgp** (Dynamic BGP), **5_mailbgp** (Mail BGP), or **5_gray** (Dedicated Load Balancer). |
| | | - The value can be **5_bgp** (Dynamic BGP), **5_mailbgp** (Mail BGP), or **5_gray** (Dedicated load balancer, shared load balancer). |
| | | - Constraints: |
| | | |
| | | - The configured value must be supported by the system. |
@ -133,20 +117,18 @@ Response Message
| | | |
| | | .. note:: |
| | | |
| | | This parameter is not displayed if the EIP is bound to a dedicated load balancer. This parameter is displayed if the EIP is bound to an ECS. |
| | | The value of **private_ip_address** is **null** if the EIP is bound to a dedicated load balancer. |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| port_id | String | - Specifies the port ID. |
| | | - This parameter is returned only when a port is associated with the EIP. |
| | | |
| | | .. note:: |
| | | |
| | | This parameter is not displayed if the EIP is bound to a dedicated load balancer. This parameter is displayed if the EIP is bound to an ECS. |
| | | The value of **port_id** is null if the EIP is bound to a dedicated load balancer. |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| tenant_id | String | Specifies the project ID. |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| create_time | String | Specifies the time (UTC) when the EIP is assigned. |
| | | |
| | | Format: *yyyy-MM-dd HH:mm:ss* |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| bandwidth_id | String | Specifies the ID of the EIP bandwidth. |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
@ -160,8 +142,6 @@ Response Message
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| bandwidth_name | String | Specifies the bandwidth name. |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| alias | String | Specifies the EIP name. |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| enterprise_project_id | String | - Specifies the enterprise project ID. The value is **0** or a string that contains a maximum of 36 characters in UUID format with hyphens (-). |
| | | - When assigning an EIP, you need to associate an enterprise project ID with the EIP. |
| | | - If this parameter is not specified, the default value is **0**, which indicates that the default enterprise project is used. |
@ -170,15 +150,6 @@ Response Message
| | | |
| | | This parameter is unsupported. Do not use it. |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| public_border_group | String | Specifies whether it is in a central site or an edge site. |
| | | |
| | | The value can be: |
| | | |
| | | - center |
| | | - *Edge site name* |
| | | |
| | | An EIP can only be bound to a resource of the same region. |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
.. _vpc_eip_0003__table66651219193417:
@ -202,7 +173,6 @@ Response Message
{
"id": "6285e7be-fd9f-497c-bc2d-dd0bdea6efe0",
"status": "DOWN",
"alias": "tom",
"profile": {},
"type": "5_bgp",
"public_ip_address": "161.xx.xx.9",

View File

@ -0,0 +1,72 @@
:original_name: vpc_eip_0005.html
.. _vpc_eip_0005:
Releasing an EIP
================
Function
--------
This API is used to release an EIP.
URI
---
DELETE /v1/{project_id}/publicips/{publicip_id}
:ref:`Table 1 <vpc_eip_0005__table45251091>` describes the parameters.
.. _vpc_eip_0005__table45251091:
.. table:: **Table 1** Parameter description
=========== ========= ==========================================
Name Mandatory Description
=========== ========= ==========================================
project_id Yes Specifies the project ID.
publicip_id Yes Specifies the unique identifier of an EIP.
=========== ========= ==========================================
Request Message
---------------
- Request parameter
None
- Example request
.. code-block:: text
DELETE https://{Endpoint}/v1/{project_id}/publicips
Response Message
----------------
- Response parameter
None
- Example response
None
Or
.. code-block::
{
"code":"xxx",
"message":"xxxxx"
}
Status Code
-----------
See :ref:`Status Codes <vpc_api_0002>`.
Error Code
----------
See :ref:`Error Codes <vpc_api_0003>`.

View File

@ -127,7 +127,7 @@ Response Message
],
"floatingips_links": [
{
"href": "https://vpc.region.otctest.t-systems.com/v2.0/floatingips_v6?marker=861a4c5b-b17b-4a1d-b653-f3e95dcb3345&page_reverse=true&page_reverse=True",
"href": "https://network.region.cn-southwest-2.hwclouds.com/v2.0/floatingips_v6?marker=861a4c5b-b17b-4a1d-b653-f3e95dcb3345&page_reverse=true&page_reverse=True",
"rel": "previous"
}
]

View File

@ -7,7 +7,7 @@ APIs
- :ref:`Virtual Private Cloud <vpc_api01_0000>`
- :ref:`Subnet <vpc_subnet01_0000>`
- :ref:`EIP <vpc_eip_0000>`
- :ref:`Elastic IP <vpc_eip_0000>`
- :ref:`Floating IP Address (IPv6) <vpc_ipv6_0000>`
- :ref:`Bandwidth <vpc_bandwidth_0000>`
- :ref:`Bandwidth (V2.0) <vpc_sharebandwidth_0000>`
@ -16,7 +16,6 @@ APIs
- :ref:`Security Group <vpc_sg01_0000>`
- :ref:`VPC Peering Connection <vpc_peering_0000>`
- :ref:`VPC Route <vpc_route_0000>`
- :ref:`Route Table <vpc_apiroutetab_0000>`
- :ref:`VPC Tag Management <vpc_tag_0000>`
- :ref:`Subnet Tag Management <subnet_tag_0000>`
- :ref:`EIP Tag Management <eip_tag_0000>`
@ -29,7 +28,7 @@ APIs
virtual_private_cloud/index
subnet/index
eip/index
elastic_ip/index
floating_ip_address_ipv6/index
bandwidth/index
bandwidth_v2.0/index
@ -38,7 +37,6 @@ APIs
security_group/index
vpc_peering_connection/index
vpc_route/index
route_table/index
vpc_tag_management/index
subnet_tag_management/index
eip_tag_management/index

View File

@ -27,8 +27,10 @@ POST /v1/{project_id}/privateips
project_id Yes Specifies the project ID.
========== ========= =========================
Request Parameters
------------------
Request Message
---------------
- Request parameter
.. table:: **Table 2** Request parameter
@ -53,10 +55,7 @@ Request Parameters
| | | | - The value can be an available IP address in the subnet. If it is not specified, the system automatically assigns an IP address. |
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------+
Example Request
---------------
- Assign two private IP addresses from the subnet whose ID is 531dec0f-3116-411b-a21b-e612e42349fd. One IP address is automatically assigned, and the other is specified to 192.168.1.17.
- Example request
.. code-block:: text
@ -75,8 +74,10 @@ Example Request
]
}
Response Parameters
-------------------
Response Message
----------------
- Response parameter
.. table:: **Table 4** Response parameter
@ -90,50 +91,31 @@ Response Parameters
.. table:: **Table 5** Description of the **privateip** field
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Name | Type | Description |
+=======================+=======================+=======================================================================================================================================================================================+
+=======================+=======================+========================================================================================================================================================================================================================================================================================================+
| status | String | - Specifies the status of the private IP address. |
| | | - Possible values are as follows: |
| | | |
| | | - **ACTIVE** |
| | | - **DOWN** |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| id | String | Specifies the ID of the private IP address, which uniquely identifies the private IP address. |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| subnet_id | String | Specifies the ID of the subnet from which IP addresses are assigned. |
| | | |
| | | If you use the management console, the value of this parameter is the **Network ID** value. |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| tenant_id | String | Specifies the project ID. |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| device_owner | String | - Specifies the resource using the private IP address. The parameter is left blank if it is not used. |
| | | |
| | | - The value can be: |
| | | |
| | | **network:dhcp**: DHCP service IP address |
| | | |
| | | **network:router_interface_distributed**: Gateway IP address |
| | | |
| | | **compute:**\ *xxx* (*xxx* indicates the AZ name. For example, **compute:aa-bb-cc** indicates that the IP address is used by an ECS in the AZ aa-bb-cc.): IP address of an ECS NIC |
| | | |
| | | **neutron:VIP_PORT**: Virtual IP address |
| | | |
| | | **neutron:LOADBALANCERV2**: IP address of a shared load balancer |
| | | |
| | | **neutron:LOADBALANCERV3**: IP address of a dedicated load balancer |
| | | |
| | | **network:endpoint_interface**: IP address of a VPC endpoint |
| | | |
| | | **network:nat_gateway**: IP address used by a NAT gateway |
| | | |
| | | - The value can be **network:dhcp**, **network:router_interface_distributed**, **compute:xxx**, or **neutron:VIP_PORT**. (In value **compute:xxx**, **xxx** specifies the AZ name, for example, **compute:aa-bb-cc** indicates that the private IP address is used by an ECS in the **aa-bb-cc** AZ). |
| | | - The value range specifies only the type of private IP addresses supported by the current service. |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ip_address | String | Specifies the assigned private IP address. |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Example Response
----------------
- Example response
.. code-block::

View File

@ -29,25 +29,29 @@ DELETE /v1/{project_id}/privateips/{privateip_id}
| privateip_id | Yes | Specifies the ID of the private IP address, which uniquely identifies the private IP address. |
+--------------+-----------+-----------------------------------------------------------------------------------------------+
Request Parameters
------------------
Request Message
---------------
- Request parameter
None
Example Request
---------------
- Example request
.. code-block:: text
DELETE https://{Endpoint}/v1/{project_id}/privateips/4779ab1c-7c1a-44b1-a02e-93dfc361b32d
Response Parameters
-------------------
Response Message
----------------
- Request parameter
None
Example Response
----------------
- Example response
.. code-block:: text
None

View File

@ -29,20 +29,23 @@ GET /v1/{project_id}/privateips/{privateip_id}
| privateip_id | Yes | Specifies the ID of the private IP address, which uniquely identifies the private IP address. |
+--------------+-----------+-----------------------------------------------------------------------------------------------+
Request Parameters
------------------
Request Message
---------------
- Request parameter
None
Example Request
---------------
- Example request
.. code-block:: text
GET https://{Endpoint}/v1/{project_id}/privateips/d600542a-b231-45ed-af05-e9930cb14f78
Response Parameters
-------------------
Response
--------
- Response parameter
.. table:: **Table 2** Response parameter
@ -56,50 +59,31 @@ Response Parameters
.. table:: **Table 3** Description of the **privateip** field
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Name | Type | Description |
+=======================+=======================+=======================================================================================================================================================================================+
+=======================+=======================+========================================================================================================================================================================================================================================================================================================+
| status | String | - Specifies the status of the private IP address. |
| | | - Possible values are as follows: |
| | | |
| | | - **ACTIVE** |
| | | - **DOWN** |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| id | String | Specifies the ID of the private IP address, which uniquely identifies the private IP address. |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| subnet_id | String | Specifies the ID of the subnet from which IP addresses are assigned. |
| | | |
| | | If you use the management console, the value of this parameter is the **Network ID** value. |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| tenant_id | String | Specifies the project ID. |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| device_owner | String | - Specifies the resource using the private IP address. The parameter is left blank if it is not used. |
| | | |
| | | - The value can be: |
| | | |
| | | **network:dhcp**: DHCP service IP address |
| | | |
| | | **network:router_interface_distributed**: Gateway IP address |
| | | |
| | | **compute:**\ *xxx* (*xxx* indicates the AZ name. For example, **compute:aa-bb-cc** indicates that the IP address is used by an ECS in the AZ aa-bb-cc.): IP address of an ECS NIC |
| | | |
| | | **neutron:VIP_PORT**: Virtual IP address |
| | | |
| | | **neutron:LOADBALANCERV2**: IP address of a shared load balancer |
| | | |
| | | **neutron:LOADBALANCERV3**: IP address of a dedicated load balancer |
| | | |
| | | **network:endpoint_interface**: IP address of a VPC endpoint |
| | | |
| | | **network:nat_gateway**: IP address used by a NAT gateway |
| | | |
| | | - The value can be **network:dhcp**, **network:router_interface_distributed**, **compute:xxx**, or **neutron:VIP_PORT**. (In value **compute:xxx**, **xxx** specifies the AZ name, for example, **compute:aa-bb-cc** indicates that the private IP address is used by an ECS in the **aa-bb-cc** AZ). |
| | | - The value range specifies only the type of private IP addresses supported by the current service. |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ip_address | String | Specifies the assigned private IP address. |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Example Response
----------------
- Example response
.. code-block::

View File

@ -35,20 +35,23 @@ GET /v2.0/network-ip-availabilities/{network_id}
network_id String Yes Specifies the network ID.
========== ====== ========= =========================
Request Parameters
------------------
Request Message
---------------
- Request parameter
None
Example Request
---------------
- Example request
.. code-block:: text
GET https://{Endpoint}/v2.0/network-ip-availabilities/6b50d967-779c-40c9-a157-de1df3c17043
Response Parameters
-------------------
Response Message
----------------
- Response parameter
.. table:: **Table 2** Response parameter
@ -100,8 +103,7 @@ Response Parameters
| total_ips | Integer | Specifies the total number of IP addresses on a subnet. (System reserved IP addresses are not included.) |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------+
Example Response
----------------
- Example response
.. code-block::

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -1,66 +0,0 @@
:original_name: vpc_apiroutetab_0006.html
.. _vpc_apiroutetab_0006:
Deleting a Route Table
======================
Function
--------
This API is used to delete a custom route table.
Constraints:
Only custom route tables can be deleted. If a custom route table has subnets associated, disassociate the subnets with the route table and then delete the route table.
URI
---
DELETE /v1/{project_id}/routetables/{routetable_id}
:ref:`Table 1 <vpc_apiroutetab_0006__table13893430173220>` describes the parameters.
.. _vpc_apiroutetab_0006__table13893430173220:
.. table:: **Table 1** Parameter description
+---------------+-----------+--------+------------------------------------------------------------------------+
| Name | Mandatory | Type | Description |
+===============+===========+========+========================================================================+
| project_id | Yes | String | Specifies the project ID. |
+---------------+-----------+--------+------------------------------------------------------------------------+
| routetable_id | Yes | String | Specifies the route table ID, which uniquely identifies a route table. |
+---------------+-----------+--------+------------------------------------------------------------------------+
Request Parameters
------------------
None
Example Request
---------------
.. code-block:: text
DELETE https://{Endpoint}/v1/{project_id}/routetables/3d42a0d4-a980-4613-ae76-a2cddecff054
Response Parameters
-------------------
None
Example Response
----------------
None
Status Code
-----------
See :ref:`Status Codes <vpc_api_0002>`.
Error Code
----------
See :ref:`Error Codes <vpc_api_0003>`.

View File

@ -1,26 +0,0 @@
:original_name: vpc_apiroutetab_0000.html
.. _vpc_apiroutetab_0000:
Route Table
===========
- :ref:`Querying Route Tables <vpc_apiroutetab_0001>`
- :ref:`Querying a Route Table <vpc_apiroutetab_0002>`
- :ref:`Creating a Route Table <vpc_apiroutetab_0003>`
- :ref:`Updating a Route Table <vpc_apiroutetab_0004>`
- :ref:`Associating Subnets with a Route Table <vpc_apiroutetab_0005>`
- :ref:`Disassociating Subnets from a Route Table <vpc_apiroutetab_0007>`
- :ref:`Deleting a Route Table <vpc_apiroutetab_0006>`
.. toctree::
:maxdepth: 1
:hidden:
querying_route_tables
querying_a_route_table
creating_a_route_table
updating_a_route_table
associating_subnets_with_a_route_table
disassociating_subnets_from_a_route_table
deleting_a_route_table

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -29,25 +29,27 @@ DELETE /v1/{project_id}/security-groups/{security_group_id}
| project_id | No | Specifies the project ID. |
+-------------------+-----------+--------------------------------------------------------------------------------+
Request Parameters
------------------
Request Message
---------------
- Request parameter
None
Example Request
---------------
- Example request
.. code-block:: text
DELETE https://{Endpoint}/v1/{project_id}/security-groups/0c4a2336-b036-4fa2-bc3c-1a291ed4c431
Response Parameters
-------------------
Response Message
----------------
- Response parameter
None
Example Response
----------------
- Example response
None

View File

@ -29,25 +29,27 @@ DELETE /v1/{project_id}/security-group-rules/{security_group_rule_id}
| project_id | Yes | Specifies the project ID. |
+------------------------+-----------+------------------------------------------------------------------------------------------+
Request Parameters
------------------
Request Message
---------------
- Request parameter
None
Example Request
---------------
- Example request
.. code-block:: text
DELETE https://{Endpoint}/v1/{project_id}/security-group-rules/2bc0accf-312e-429a-956e-e4407625eb62
Response Parameters
-------------------
Response Message
----------------
- Response parameter
None
Example Response
----------------
- Example response
None

View File

@ -29,20 +29,23 @@ GET /v1/{project_id}/security-group-rules/{security_group_rule_id}
| security_group_rule_id | Yes | Specifies the security group rule ID, which uniquely identifies the security group rule. |
+------------------------+-----------+------------------------------------------------------------------------------------------+
Request Parameters
------------------
Request Message
---------------
- Request parameter
None
Example Request
---------------
- Example request
.. code-block:: text
GET https://{Endpoint}/v1/{project_id}/security-group-rules/2bc0accf-312e-429a-956e-e4407625eb62
Response Parameters
-------------------
Response Message
----------------
- Response parameter
.. table:: **Table 2** Response parameter
@ -76,7 +79,7 @@ Response Parameters
| | | - The value can be **IPv4** or **IPv6**. |
+-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| protocol | String | - Specifies the protocol type. |
| | | - The value can be **icmp**, **tcp**, **udp**, or an IP protocol number (0 to 255, for example, 47 for GRE) |
| | | - The value can be **icmp**, **tcp**, or **udp**. |
| | | - If the parameter is left blank, all protocols are supported. |
+-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| port_range_min | Integer | - Specifies the start port number. |
@ -89,19 +92,18 @@ Response Parameters
+-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| remote_ip_prefix | String | - Specifies the remote IP address. If the access control direction is set to **egress**, the parameter specifies the source IP address. If the access control direction is set to **ingress**, the parameter specifies the destination IP address. |
| | | - The value can be in the CIDR format or IP addresses. |
| | | - The parameter is mutually exclusive with parameter **remote_group_id**. |
| | | - The parameter is exclusive with parameter **remote_group_id**. |
+-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| remote_group_id | String | - Specifies the ID of the peer security group. |
| | | - The value is mutually exclusive with parameter **remote_ip_prefix**. |
| | | - The value is exclusive with parameter **remote_ip_prefix**. |
+-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| remote_address_group_id | String | - Specifies the remote IP address group ID. |
| | | - The value is mutually exclusive with parameters **remote_ip_prefix** and **remote_group_id**. |
| | | - The value is exclusive with parameters **remote_ip_prefix** and **remote_group_id**. |
+-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| tenant_id | String | - Specifies the ID of the project to which the security group rule belongs. |
+-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Example Response
----------------
- Example response
.. code-block::

View File

@ -36,32 +36,35 @@ Example:
| | | | |
| | | | This parameter can work together with the parameter **limit**. |
| | | | |
| | | | - If parameters **marker** and **limit** are not passed, resource records on the first page will be returned. |
| | | | - If parameters **marker** and **limit** are not passed, all resource records will be returned. |
| | | | - If the parameter **marker** is not passed and the value of parameter **limit** is set to **10**, the first 10 resource records will be returned. |
| | | | - If the value of the parameter **marker** is set to the resource ID of the 10th record and the value of parameter **limit** is set to **10**, the 11th to 20th resource records will be returned. |
| | | | - If the value of the parameter **marker** is set to the resource ID of the 10th record and the parameter **limit** is not passed, resource records starting from the 11th records (including 11th) will be returned. |
+-------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| limit | No | Integer | Specifies the number of records that will be returned on each page. The value is from 0 to intmax (2^31-1). The default value is 2000. |
| limit | No | Integer | Specifies the number of records that will be returned on each page. The value is from 0 to intmax. |
| | | | |
| | | | **limit** can be used together with **marker**. For details, see the parameter description of **marker**. |
+-------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| security_group_id | No | String | Specifies the security group ID. |
+-------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Request Parameters
------------------
Request Message
---------------
- Request parameter
None
Example Request
---------------
- Example request
.. code-block:: text
GET https://{Endpoint}/v1/{project_id}/security-group-rules
Response Parameters
-------------------
Response Message
----------------
- Response parameter
+----------------------+--------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------+
| Name | Type | Description |
@ -93,7 +96,7 @@ Response Parameters
| | | - The value can be **IPv4** or **IPv6**. |
+-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| protocol | String | - Specifies the protocol type. |
| | | - The value can be **icmp**, **tcp**, **udp**, or an IP protocol number (0 to 255, for example, 47 for GRE) |
| | | - The value can be **icmp**, **tcp**, or **udp**. |
| | | - If the parameter is left blank, all protocols are supported. |
+-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| port_range_min | Integer | - Specifies the start port number. |
@ -106,19 +109,18 @@ Response Parameters
+-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| remote_ip_prefix | String | - Specifies the remote IP address. If the access control direction is set to **egress**, the parameter specifies the source IP address. If the access control direction is set to **ingress**, the parameter specifies the destination IP address. |
| | | - The value can be in the CIDR format or IP addresses. |
| | | - The parameter is mutually exclusive with parameter **remote_group_id**. |
| | | - The parameter is exclusive with parameter **remote_group_id**. |
+-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| remote_group_id | String | - Specifies the ID of the peer security group. |
| | | - The value is mutually exclusive with parameter **remote_ip_prefix**. |
| | | - The value is exclusive with parameter **remote_ip_prefix**. |
+-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| remote_address_group_id | String | - Specifies the remote IP address group ID. |
| | | - The value is mutually exclusive with parameters **remote_ip_prefix** and **remote_group_id**. |
| | | - The value is exclusive with parameters **remote_ip_prefix** and **remote_group_id**. |
+-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| tenant_id | String | - Specifies the ID of the project to which the security group rule belongs. |
+-------------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Example Response
----------------
- Example response
.. code-block::

Some files were not shown because too many files have changed in this diff Show More