lbelejka/cloud-firewall
1
0
Fork 0
forked from docs/cloud-firewall
Code Pull Requests Activity

Update content

Browse Source
This commit is contained in:
OpenTelekomCloud Proposal Bot 2024-07-03 08:09:51 +00:00 committed by Lukas Belejkanic
parent 6546da69b1
commit c6f8dcefb6
34 changed files with 284 additions and 281 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
api-ref/source/api/acl_rule_management/creating_an_acl_rule.rst
View File

@ -56,7 +56,9 @@ Request Parameters
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
| | | | - **0** | | | | | - **0** |
| | | | |
| | | | - **1** | | | | | - **1** |
| | | | |
| | | | - **2** | | | | | - **2** |
+-----------------+-----------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------------+-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| rules | Yes | Array of :ref:`rules <addaclrule__request_rules>` objects | rules | | rules | Yes | Array of :ref:`rules <addaclrule__request_rules>` objects | rules |
@ -78,7 +80,9 @@ Request Parameters
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
| | | | - **0** | | | | | - **0** |
| | | | |
| | | | - **1** | | | | | - **1** |
| | | | |
| | | | - **2** | | | | | - **2** |
+--------------------------+-----------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ +--------------------------+-----------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
| action_type | Yes | Integer | Action. 0: allow; 1: deny | | action_type | Yes | Integer | Action. 0: allow; 1: deny |
@ -88,6 +92,7 @@ Request Parameters
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
| | | | - **0** | | | | | - **0** |
| | | | |
| | | | - **1** | | | | | - **1** |
+--------------------------+-----------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ +--------------------------+-----------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
| applications | No | Array of strings | applications | | applications | No | Array of strings | applications |
@ -107,6 +112,7 @@ Request Parameters
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
| | | | - **0** | | | | | - **0** |
| | | | |
| | | | - **1** | | | | | - **1** |
+--------------------------+-----------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ +--------------------------+-----------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
| description | No | String | Description | | description | No | String | Description |
@ -116,6 +122,7 @@ Request Parameters
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
| | | | - **0** | | | | | - **0** |
| | | | |
| | | | - **1** | | | | | - **1** |
+--------------------------+-----------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ +--------------------------+-----------------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
| source | Yes | :ref:`RuleAddressDtoForRequest <addaclrule__request_ruleaddressdtoforrequest>` object | Source address transmission object | | source | Yes | :ref:`RuleAddressDtoForRequest <addaclrule__request_ruleaddressdtoforrequest>` object | Source address transmission object |
@ -174,6 +181,8 @@ Request Parameters
+---------------------+-----------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +---------------------+-----------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| predefined_group | No | Array of strings | predefined group | | predefined_group | No | Array of strings | predefined group |
+---------------------+-----------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +---------------------+-----------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address_group | No | Array of strings | address group |
+---------------------+-----------+-----------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. _addaclrule__request_ipregiondto: .. _addaclrule__request_ipregiondto:

2
api-ref/source/api/acl_rule_management/delete_acl_rule.rst
View File

@ -55,7 +55,7 @@ Response Parameters
+-----------+-------------------------------------------------------+-------------+ +-----------+-------------------------------------------------------+-------------+
| Parameter | Type | Description | | Parameter | Type | Description |
+===========+=======================================================+=============+ +===========+=======================================================+=============+
| data | :ref:`RuleId <deleteaclrule__response_ruleid>` object | | | data | :ref:`RuleId <deleteaclrule__response_ruleid>` object | Rule Id |
+-----------+-------------------------------------------------------+-------------+ +-----------+-------------------------------------------------------+-------------+
.. _deleteaclrule__response_ruleid: .. _deleteaclrule__response_ruleid:

10
api-ref/source/api/acl_rule_management/list_acl_rule_tags.rst
View File

@ -103,6 +103,8 @@ Example Responses
**Status code: 200** **Status code: 200**
Get acl tag response
.. code-block:: .. code-block::
{ {
@ -129,11 +131,11 @@ Example Responses
Status Codes Status Codes
------------ ------------
=========== =========== =========== ====================
Status Code Description Status Code Description
=========== =========== =========== ====================
200 200 Get acl tag response
=========== =========== =========== ====================
Error Codes Error Codes
----------- -----------

11
api-ref/source/api/acl_rule_management/querying_a_protection_rule.rst
View File

@ -35,7 +35,9 @@ GET /v1/{project_id}/acl-rules
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
| | | | - **0** | | | | | - **0** |
| | | | |
| | | | - **1** | | | | | - **1** |
| | | | |
| | | | - **2** | | | | | - **2** |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ip | No | String | IP address | | ip | No | String | IP address |
@ -49,6 +51,7 @@ GET /v1/{project_id}/acl-rules
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
| | | | - **0** | | | | | - **0** |
| | | | |
| | | | - **1** | | | | | - **1** |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| action_type | No | Integer | Action. 0: allow; 1: deny | | action_type | No | Integer | Action. 0: allow; 1: deny |
@ -56,6 +59,7 @@ GET /v1/{project_id}/acl-rules
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
| | | | - **0** | | | | | - **0** |
| | | | |
| | | | - **1** | | | | | - **1** |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address_type | No | Integer | Address type. The value can be 0 (IPv4). | | address_type | No | Integer | Address type. The value can be 0 (IPv4). |
@ -63,7 +67,9 @@ GET /v1/{project_id}/acl-rules
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
| | | | - **0** | | | | | - **0** |
| | | | |
| | | | - **1** | | | | | - **1** |
| | | | |
| | | | - **2** | | | | | - **2** |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| limit | Yes | Integer | Number of records displayed on each page, in the range 1-1024 | | limit | Yes | Integer | Number of records displayed on each page, in the range 1-1024 |
@ -145,7 +151,8 @@ Response Parameters
| | | Enumeration values: | | | | Enumeration values: |
| | | | | | | |
| | | - **0** | | | | - **0** |
| | | - **1end_time** | | | | |
| | | - **1** |
+--------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ +--------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
| action_type | Integer | Action. 0: allow; 1: deny | | action_type | Integer | Action. 0: allow; 1: deny |
+--------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ +--------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
@ -174,7 +181,9 @@ Response Parameters
| | | Enumeration values: | | | | Enumeration values: |
| | | | | | | |
| | | - **0** | | | | - **0** |
| | | |
| | | - **1** | | | | - **1** |
| | | |
| | | - **2** | | | | - **2** |
+--------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ +--------------------------+--------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
| created_date | String | Created time | | created_date | String | Created time |

6
api-ref/source/api/acl_rule_management/updating_an_acl_rule.rst
View File

@ -55,6 +55,7 @@ Request Parameters
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
| | | | - **0** | | | | | - **0** |
| | | | |
| | | | - **1** | | | | | - **1** |
+--------------------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ +--------------------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
| name | No | String | Rule name | | name | No | String | Rule name |
@ -66,6 +67,7 @@ Request Parameters
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
| | | | - **0** | | | | | - **0** |
| | | | |
| | | | - **1** | | | | | - **1** |
+--------------------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ +--------------------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
| action_type | No | Integer | Action. 0: allow; 1: deny | | action_type | No | Integer | Action. 0: allow; 1: deny |
@ -73,6 +75,7 @@ Request Parameters
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
| | | | - **0** | | | | | - **0** |
| | | | |
| | | | - **1** | | | | | - **1** |
+--------------------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ +--------------------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
| status | No | Integer | Rule delivery status. 0: disabled; 1: enabled. | | status | No | Integer | Rule delivery status. 0: disabled; 1: enabled. |
@ -96,6 +99,7 @@ Request Parameters
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
| | | | - **0** | | | | | - **0** |
| | | | |
| | | | - **1** | | | | | - **1** |
+--------------------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ +--------------------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
| source | No | :ref:`RuleAddressDto <updateaclrule__request_ruleaddressdto>` object | rule address dto | | source | No | :ref:`RuleAddressDto <updateaclrule__request_ruleaddressdto>` object | rule address dto |
@ -109,7 +113,9 @@ Request Parameters
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
| | | | - **0** | | | | | - **0** |
| | | | |
| | | | - **1** | | | | | - **1** |
| | | | |
| | | | - **2** | | | | | - **2** |
+--------------------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+ +--------------------------+-----------------+------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
| tag | No | :ref:`TagsVO <updateaclrule__request_tagsvo>` object | tag | | tag | No | :ref:`TagsVO <updateaclrule__request_tagsvo>` object | tag |

34
api-ref/source/api/address_set_management/adding_an_address_set.rst
View File

@ -46,23 +46,23 @@ Request Parameters
.. table:: **Table 4** Request body parameters .. table:: **Table 4** Request body parameters
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description | | Parameter | Mandatory | Type | Description |
+=================+=================+=================+================================================================================================================================================================================================================================================================================================================================================================================================================================================+ +=================+=================+=================+=====================================================================================================================================================================================================================================================================================+
| object_id | Yes | String | Protected object ID, which is used to distinguish Internet border protection from VPC border protection after a CFW instance is created. You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. For details, see the API Explorer and Help Center FAQ. | | object_id | Yes | String | Internet border Protected object ID, You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. |
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| name | Yes | String | IP address group name | | name | Yes | String | IP address group name |
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| description | No | String | Address group description | | description | No | String | Address group description |
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address_type | No | Integer | Address type. The value can be 0 (IPv4) or 1 (IPv6). | | address_type | No | Integer | Address type. The value can be 0 (IPv4) or 1 (IPv6). |
| | | | | | | | | |
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
| | | | - **0** | | | | | - **0** |
| | | | | | | | | |
| | | | - **1** | | | | | - **1** |
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Response Parameters Response Parameters
------------------- -------------------

10
api-ref/source/api/address_set_management/batch_delete_address_items.rst
View File

@ -85,6 +85,8 @@ Example Responses
**Status code: 200** **Status code: 200**
Batch delete address items response
.. code-block:: .. code-block::
{ {
@ -94,11 +96,11 @@ Example Responses
Status Codes Status Codes
------------ ------------
=========== =========== =========== ===================================
Status Code Description Status Code Description
=========== =========== =========== ===================================
200 200 Batch delete address items response
=========== =========== =========== ===================================
Error Codes Error Codes
----------- -----------

38
api-ref/source/api/address_set_management/querying_ip_address_sets.rst
View File

@ -28,7 +28,7 @@ GET /v1/{project_id}/address-sets
+------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description | | Parameter | Mandatory | Type | Description |
+========================+=================+=================+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ +========================+=================+=================+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
| object_id | Yes | String | Protected object ID, which is used to distinguish Internet border protection from VPC border protection after a CFW instance is created. You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. For details, see the API Explorer and Help Center FAQ. | | object_id | Yes | String | Internet border Protected object ID, You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. |
+------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| key_word | No | String | Keyword | | key_word | No | String | Keyword |
+------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@ -52,6 +52,8 @@ GET /v1/{project_id}/address-sets
+------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| query_address_set_type | No | Integer | Query address set type, 0 indicates a custom address set and 1 indicates a predefined address set | | query_address_set_type | No | Integer | Query address set type, 0 indicates a custom address set and 1 indicates a predefined address set |
+------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address_set_type | No | Integer | Address set type, 0 indicates a custom define address set, 1 indicates a WAF return-to-source IP address set, 2 indicates a DDoS return-to-source IP address set, and 3 indicates a NAT64 translation address set. |
+------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Request Parameters Request Parameters
------------------ ------------------
@ -97,23 +99,23 @@ Response Parameters
.. table:: **Table 6** records .. table:: **Table 6** records
+------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Type | Description | | Parameter | Type | Description |
+==================+=========+================================================================================================================================================================================================================================================================================================================================================================================================================================================+ +==================+=========+=====================================================================================================================================================================================================================================================================================+
| set_id | String | ID of the IP address group | | set_id | String | ID of the IP address group |
+------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ref_count | Integer | Reference count | | ref_count | Integer | Reference count |
+------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| description | String | Description | | description | String | Description |
+------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| name | String | IP address group name | | name | String | IP address group name |
+------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address_type | Integer | Address type. The value can be 0 (IPv4) or 1 (IPv6). | | address_type | Integer | Address type. The value can be 0 (IPv4) or 1 (IPv6). |
+------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| object_id | String | Protected object ID, which is used to distinguish Internet border protection from VPC border protection after a CFW instance is created. You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. For details, see the API Explorer and Help Center FAQ. | | object_id | String | Internet border Protected object ID, You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. |
+------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address_set_type | Integer | Address set type, 0 indicates a custom define address set, 1 indicates a WAF return-to-source IP address set, 2 indicates a DDoS return-to-source IP address set, and 3 indicates a NAT64 translation address set. | | address_set_type | Integer | Address set type, 0 indicates a custom define address set, 1 indicates a WAF return-to-source IP address set, 2 indicates a DDoS return-to-source IP address set, and 3 indicates a NAT64 translation address set. |
+------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
**Status code: 400** **Status code: 400**

28
api-ref/source/api/address_set_management/updating_address_set_information.rst
View File

@ -47,23 +47,12 @@ Request Parameters
.. table:: **Table 4** Request body parameters .. table:: **Table 4** Request body parameters
+-----------------+-----------------+-----------------+-------------------------------------------------------------------+ =========== ========= ====== =========================
| Parameter | Mandatory | Type | Description | Parameter Mandatory Type Description
+=================+=================+=================+===================================================================+ =========== ========= ====== =========================
| name | No | String | IP address group name | name No String IP address group name
+-----------------+-----------------+-----------------+-------------------------------------------------------------------+ description No String Address group description
| description | No | String | Address group description | =========== ========= ====== =========================
+-----------------+-----------------+-----------------+-------------------------------------------------------------------+
| address_type | No | Integer | Address type. The value can be 0 (IPv4), 1 (IPv6), or 2 (domain). |
| | | | |
| | | | Enumeration values: |
| | | | |
| | | | - **0** |
| | | | |
| | | | - **1** |
| | | | |
| | | | - **2** |
+-----------------+-----------------+-----------------+-------------------------------------------------------------------+
Response Parameters Response Parameters
------------------- -------------------
@ -111,7 +100,7 @@ Response Parameters
Example Requests Example Requests
---------------- ----------------
In the project 9d80d070b6d44942af73c9c3d38e0429, change the name of the address set whose ID is cf18f0b1-0ce7-4eb8-83b6-4b33c8448e16 to ABCD. Change its address set type to IPV4. In the project 9d80d070b6d44942af73c9c3d38e0429, change the name of the address set whose ID is cf18f0b1-0ce7-4eb8-83b6-4b33c8448e16 to ABCD.
.. code-block:: .. code-block::
@ -119,8 +108,7 @@ In the project 9d80d070b6d44942af73c9c3d38e0429, change the name of the address
{ {
"name" : "ABCD", "name" : "ABCD",
"description" : "", "description" : ""
"address_type" : 0
} }
Example Responses Example Responses

2
api-ref/source/api/blacklist_and_whitelist_management/creating_a_blacklist_or_whitelist_rule.rst
View File

@ -55,7 +55,7 @@ Request Parameters
+--------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +--------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| direction | Yes | Integer | Indicates the address direction. 0: source address 1: destination address | | direction | Yes | Integer | Indicates the address direction. 0: source address 1: destination address |
+--------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +--------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address_type | Yes | Integer | IP address type. 0: ipv4; 1: ipv6; 2: domain | | address_type | Yes | Integer | IP address type. 0: ipv4; 1: ipv6 |
+--------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +--------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address | Yes | String | Address type | | address | Yes | String | Address type |
+--------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +--------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

6
api-ref/source/api/blacklist_and_whitelist_management/querying_a_blacklist_or_whitelist.rst
View File

@ -28,7 +28,7 @@ GET /v1/{project_id}/black-white-lists
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description | | Parameter | Mandatory | Type | Description |
+=======================+=================+=================+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ +=======================+=================+=================+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
| object_id | Yes | String | Protected object ID, which is used to distinguish Internet border protection from VPC border protection after a CFW instance is created. You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. For details, see the API Explorer and Help Center FAQ. | | object_id | Yes | String | Internet border Protected object ID, You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| list_type | Yes | Integer | Blacklist/Whitelist type. The options are 4 (blacklist) and 5 (whitelist). | | list_type | Yes | Integer | Blacklist/Whitelist type. The options are 4 (blacklist) and 5 (whitelist). |
| | | | | | | | | |
@ -38,7 +38,7 @@ GET /v1/{project_id}/black-white-lists
| | | | | | | | | |
| | | | - **5** | | | | | - **5** |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address_type | No | Integer | Specifies the IP address type. The value can be 0 (IPv4), 1 (IPv6), or 2 (domain). | | address_type | No | Integer | Specifies the IP address type. The value can be 0 (IPv4), 1 (IPv6). |
| | | | | | | | | |
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
@ -112,7 +112,7 @@ Response Parameters
+--------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +--------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| direction | Integer | Direction of a black or white address. 0: source address; 1: destination address. | | direction | Integer | Direction of a black or white address. 0: source address; 1: destination address. |
+--------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +--------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address_type | Integer | IP address type. 0: ipv4; 1: ipv6; 2: domain | | address_type | Integer | IP address type. 0: ipv4; 1: ipv6 |
+--------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +--------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address | String | IP address | | address | String | IP address |
+--------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +--------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

4
api-ref/source/api/blacklist_and_whitelist_management/updating_the_blacklist_or_whitelist.rst
View File

@ -52,9 +52,9 @@ Request Parameters
+==============+===========+=========+========================================================================================================+ +==============+===========+=========+========================================================================================================+
| direction | No | Integer | Indicates the address direction. 0: source address 1: destination address | | direction | No | Integer | Indicates the address direction. 0: source address 1: destination address |
+--------------+-----------+---------+--------------------------------------------------------------------------------------------------------+ +--------------+-----------+---------+--------------------------------------------------------------------------------------------------------+
| address_type | No | Integer | Address type. 0: ipv4; 1: ipv6; 2: domain | | address_type | No | Integer | Address type. 0: ipv4; 1: ipv6 |
+--------------+-----------+---------+--------------------------------------------------------------------------------------------------------+ +--------------+-----------+---------+--------------------------------------------------------------------------------------------------------+
| address | No | String | IP address | | address | Yes | String | IP address |
+--------------+-----------+---------+--------------------------------------------------------------------------------------------------------+ +--------------+-----------+---------+--------------------------------------------------------------------------------------------------------+
| protocol | No | Integer | Protocol type. The value is 6 for TCP, 17 for UDP, 1 for ICMP, 58 for ICMPv6, and -1 for any protocol. | | protocol | No | Integer | Protocol type. The value is 6 for TCP, 17 for UDP, 1 for ICMP, 58 for ICMPv6, and -1 for any protocol. |
+--------------+-----------+---------+--------------------------------------------------------------------------------------------------------+ +--------------+-----------+---------+--------------------------------------------------------------------------------------------------------+

8
api-ref/source/api/domain_parse_and_domain_set_management/add_domain_set.rst
View File

@ -51,13 +51,13 @@ Request Parameters
+=================+===========+===================================================================================+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ +=================+===========+===================================================================================+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
| fw_instance_id | Yes | String | Firewall instance ID, which is automatically generated after a CFW instance is created. You can obtain the ID by calling the API used for querying a firewall instance. For details, see the API Explorer and Help Center FAQ.By default, if fw_instance_Id is not specified, information about the first firewall under the account is returned. If fw_instance_Id is specified, information about the firewall with this fw_instance_Id is returned.If object_Id is specified, information about the firewall with this object_Id is returned by default. If both fw_instance_Id and object_Id are specified, the specified object_Id must belong to the specified firewall. | | fw_instance_id | Yes | String | Firewall instance ID, which is automatically generated after a CFW instance is created. You can obtain the ID by calling the API used for querying a firewall instance. For details, see the API Explorer and Help Center FAQ.By default, if fw_instance_Id is not specified, information about the first firewall under the account is returned. If fw_instance_Id is specified, information about the firewall with this fw_instance_Id is returned.If object_Id is specified, information about the firewall with this object_Id is returned by default. If both fw_instance_Id and object_Id are specified, the specified object_Id must belong to the specified firewall. |
+-----------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| object_id | Yes | String | Protected object ID, which is used to distinguish Internet border protection from VPC border protection after a CFW instance is created. You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. For details, see the API Explorer and Help Center FAQ. | | object_id | Yes | String | Internet border Protected object ID, You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. |
+-----------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| name | Yes | String | name | | name | Yes | String | name |
+-----------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| description | No | String | description | | description | No | String | description |
+-----------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| domain_names | No | Array of :ref:`DomainSetInfoDto <adddomainset__request_domainsetinfodto>` objects | domain names | | domain_names | Yes | Array of :ref:`DomainSetInfoDto <adddomainset__request_domainsetinfodto>` objects | domain names |
+-----------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| domain_set_type | Yes | Integer | Domain name group type. 0 means Application type and 1 means Network type. | | domain_set_type | Yes | Integer | Domain name group type. 0 means Application type and 1 means Network type. |
+-----------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@ -69,7 +69,7 @@ Request Parameters
=========== ========= ====== =========== =========== ========= ====== ===========
Parameter Mandatory Type Description Parameter Mandatory Type Description
=========== ========= ====== =========== =========== ========= ====== ===========
domain_name No String domain name domain_name Yes String domain name
description No String description description No String description
=========== ========= ====== =========== =========== ========= ====== ===========
@ -100,7 +100,7 @@ Response Parameters
Example Requests Example Requests
---------------- ----------------
Add a domain set whose project ID is 9d80d070b6d44942af73c9c3d38e0429, firewall ID is 546af3f8-88e9-47f2-a205-2346d7090925, domain set name is test, domain name is www.aaa.com, and protected object ID is fde07429-2e02-45c0-a85f-4f1cacea24d2. Add a domain set whose project ID is 9d80d070b6d44942af73c9c3d38e0429, firewall ID is 546af3f8-88e9-47f2-a205-2346d7090925, domain set name is test, domain name is www.aaa.com, and protected object ID is fde07429-2e02-45c0-a85f-4f1cacea24d2 and domain set type is application type.
.. code-block:: .. code-block::

2
api-ref/source/api/domain_parse_and_domain_set_management/add_domains.rst
View File

@ -64,7 +64,7 @@ Request Parameters
=========== ========= ====== =========== =========== ========= ====== ===========
Parameter Mandatory Type Description Parameter Mandatory Type Description
=========== ========= ====== =========== =========== ========= ====== ===========
domain_name No String domain name domain_name Yes String domain name
description No String description description No String description
=========== ========= ====== =========== =========== ========= ====== ===========

2
api-ref/source/api/domain_parse_and_domain_set_management/list_domain_sets.rst
View File

@ -36,7 +36,7 @@ GET /v1/{project_id}/domain-sets
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| offset | Yes | Integer | Offset, which specifies the start position of the record to be returned. The value must be a number no less than 0. The default value is **0**. | | offset | Yes | Integer | Offset, which specifies the start position of the record to be returned. The value must be a number no less than 0. The default value is **0**. |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| object_id | Yes | String | Protected object ID, which is used to distinguish Internet border protection from VPC border protection after a CFW instance is created. You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. For details, see the API Explorer and Help Center FAQ. | | object_id | Yes | String | Internet border Protected object ID, You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| key_word | No | String | key | | key_word | No | String | key |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

2
api-ref/source/api/domain_parse_and_domain_set_management/list_domains.rst
View File

@ -39,7 +39,7 @@ GET /v1/{project_id}/domain-set/domains/{domain_set_id}
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| domain_name | No | String | domain name | | domain_name | No | String | domain name |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| object_Id | No | String | Protected object ID, which is used to distinguish Internet border protection from VPC border protection after a CFW instance is created. You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. For details, see the API Explorer and Help Center FAQ. | | object_Id | No | String | Internet border Protected object ID, You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Request Parameters Request Parameters

2
api-ref/source/api/domain_parse_and_domain_set_management/querying_the_dns_server_list.rst
View File

@ -88,7 +88,7 @@ Obtain the DNS server list of the project whose ID is 2349ba469daf4b7daf268bb026
.. code-block:: .. code-block::
https://console.xxxxxx.com/cfw/v1/2349ba469daf4b7daf268bb0261d18b0/dns/servers https://console.example.com/cfw/v1/2349ba469daf4b7daf268bb0261d18b0/dns/servers
Example Responses Example Responses
----------------- -----------------

25
api-ref/source/api/domain_parse_and_domain_set_management/update_domain_set.rst
View File

@ -17,12 +17,12 @@ PUT /v1/{project_id}/domain-set/{set_id}
.. table:: **Table 1** Path Parameters .. table:: **Table 1** Path Parameters
========== ========= ====== =========== ========== ========= ====== =============
Parameter Mandatory Type Description Parameter Mandatory Type Description
========== ========= ====== =========== ========== ========= ====== =============
project_id Yes String project ID project_id Yes String project ID
set_id Yes String set id set_id Yes String domain set id
========== ========= ====== =========== ========== ========= ====== =============
.. table:: **Table 2** Query Parameters .. table:: **Table 2** Query Parameters
@ -47,17 +47,12 @@ Request Parameters
.. table:: **Table 4** Request body parameters .. table:: **Table 4** Request body parameters
+-----------------+-----------+---------+----------------------------------------------------------------------------+ =========== ========= ====== ===========
| Parameter | Mandatory | Type | Description | Parameter Mandatory Type Description
+=================+===========+=========+============================================================================+ =========== ========= ====== ===========
| name | Yes | String | name | name Yes String name
+-----------------+-----------+---------+----------------------------------------------------------------------------+ description No String description
| description | No | String | description | =========== ========= ====== ===========
+-----------------+-----------+---------+----------------------------------------------------------------------------+
| set_id | No | String | domain set id |
+-----------------+-----------+---------+----------------------------------------------------------------------------+
| domain_set_type | No | Integer | Domain name group type. 0 means Application type and 1 means Network type. |
+-----------------+-----------+---------+----------------------------------------------------------------------------+
Response Parameters Response Parameters
------------------- -------------------

2
api-ref/source/api/domain_parse_and_domain_set_management/updating_the_dns_server_list.rst
View File

@ -49,7 +49,7 @@ Request Parameters
+--------------------------+-----------+---------------------------------------------------------------------------+--------------------------+ +--------------------------+-----------+---------------------------------------------------------------------------+--------------------------+
| Parameter | Mandatory | Type | Description | | Parameter | Mandatory | Type | Description |
+==========================+===========+===========================================================================+==========================+ +==========================+===========+===========================================================================+==========================+
| dns_server | No | Array of :ref:`dns_server <updatednsservers__request_dns_server>` objects | DNS server | | dns_server | Yes | Array of :ref:`dns_server <updatednsservers__request_dns_server>` objects | DNS server |
+--------------------------+-----------+---------------------------------------------------------------------------+--------------------------+ +--------------------------+-----------+---------------------------------------------------------------------------+--------------------------+
| health_check_domain_name | No | String | Health check domain name | | health_check_domain_name | No | String | Health check domain name |
+--------------------------+-----------+---------------------------------------------------------------------------+--------------------------+ +--------------------------+-----------+---------------------------------------------------------------------------+--------------------------+

2
api-ref/source/api/eip_management/querying_the_number_of_eips.rst
View File

@ -138,7 +138,7 @@ OK
"eip_protected" : 1, "eip_protected" : 1,
"eip_protected_self" : 4, "eip_protected_self" : 4,
"eip_total" : 5, "eip_total" : 5,
"object_id" : "6d3db4fd-fd58-4d8e-914b-ef91aa268f62" "object_id" : ""
} }
} }

12
api-ref/source/api/firewall_management/create_firewall.rst
View File

@ -51,7 +51,7 @@ Request Parameters
+-----------------------+-----------------+-----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| tags | No | Array of :ref:`tags <createfirewall__request_tags>` objects | Resource Tag | | tags | No | Array of :ref:`tags <createfirewall__request_tags>` objects | Resource Tag |
+-----------------------+-----------------+-----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| flavor | No | :ref:`flavor <createfirewall__request_flavor>` object | flavor | | flavor | Yes | :ref:`flavor <createfirewall__request_flavor>` object | flavor |
+-----------------------+-----------------+-----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| charge_info | Yes | :ref:`charge_info <createfirewall__request_charge_info>` object | Billing type information, prepaid and postpaid, the default is postpaid. | | charge_info | Yes | :ref:`charge_info <createfirewall__request_charge_info>` object | Billing type information, prepaid and postpaid, the default is postpaid. |
+-----------------------+-----------------+-----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
@ -63,8 +63,8 @@ Request Parameters
========= ========= ====== =========== ========= ========= ====== ===========
Parameter Mandatory Type Description Parameter Mandatory Type Description
========= ========= ====== =========== ========= ========= ====== ===========
key Yes String Tag Key key No String Tag Key
value Yes String Tag Value value No String Tag Value
========= ========= ====== =========== ========= ========= ====== ===========
.. _createfirewall__request_flavor: .. _createfirewall__request_flavor:
@ -74,7 +74,7 @@ Request Parameters
+------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description | | Parameter | Mandatory | Type | Description |
+==================+=================+=================+================================================================================================================================================================================================+ +==================+=================+=================+================================================================================================================================================================================================+
| version | No | String | Firewall version: If charge_mode is set to prePaid, only the Professional Edition is supported, and when charge_mode is set to postPaid, the Standard and Professional Editions are supported. | | version | Yes | String | Firewall version: If charge_mode is set to postPaid, only the Professional Edition is supported, and when charge_mode is set to prePaid, the Standard and Professional Editions are supported. |
| | | | | | | | | |
| | | | Enumeration values: | | | | | Enumeration values: |
| | | | | | | | | |
@ -180,7 +180,7 @@ Response Parameters
+-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Type | Description | | Parameter | Type | Description |
+=======================+=======================+================================================================================================================================================================================================+ +=======================+=======================+================================================================================================================================================================================================+
| version | String | Firewall version: If charge_mode is set to prePaid, only the Professional Edition is supported, and when charge_mode is set to postPaid, the Standard and Professional Editions are supported. | | version | String | Firewall version: If charge_mode is set to postPaid, only the Professional Edition is supported, and when charge_mode is set to prePaid, the Standard and Professional Editions are supported. |
| | | | | | | |
| | | Enumeration values: | | | | Enumeration values: |
| | | | | | | |
@ -268,7 +268,7 @@ Enable a standard firewall with 2000 extended EIP, 5,000 Mbps extended protectio
"value" : "TagVal" "value" : "TagVal"
} ], } ],
"flavor" : { "flavor" : {
"version" : "standard", "version" : "Standard",
"extend_eip_count" : 2000, "extend_eip_count" : 2000,
"extend_bandwidth" : 5000, "extend_bandwidth" : 5000,
"extend_vpc_count" : 100 "extend_vpc_count" : 100

2
api-ref/source/api/firewall_management/querying_the_number_of_protected_vpcs.rst
View File

@ -56,8 +56,6 @@ Response Parameters
+-----------+-------------------------------------------------------------------------+--------------------------------+ +-----------+-------------------------------------------------------------------------+--------------------------------+
| Parameter | Type | Description | | Parameter | Type | Description |
+===========+=========================================================================+================================+ +===========+=========================================================================+================================+
| trace_id | String | Call chain ID |
+-----------+-------------------------------------------------------------------------+--------------------------------+
| data | :ref:`VPCProtectsVo <listprotectedvpcs__response_vpcprotectsvo>` object | Return value of VPC protection | | data | :ref:`VPCProtectsVo <listprotectedvpcs__response_vpcprotectsvo>` object | Return value of VPC protection |
+-----------+-------------------------------------------------------------------------+--------------------------------+ +-----------+-------------------------------------------------------------------------+--------------------------------+

2
api-ref/source/api/ips_management/enabling_or_disabling_ips.rst
View File

@ -74,8 +74,6 @@ Response Parameters
+-----------+-----------------------------------------------------------+-------------+ +-----------+-----------------------------------------------------------+-------------+
| Parameter | Type | Description | | Parameter | Type | Description |
+===========+===========================================================+=============+ +===========+===========================================================+=============+
| trace_id | String | trace_id |
+-----------+-----------------------------------------------------------+-------------+
| data | :ref:`data <changeipsswitchstatus__response_data>` object | object | | data | :ref:`data <changeipsswitchstatus__response_data>` object | object |
+-----------+-----------------------------------------------------------+-------------+ +-----------+-----------------------------------------------------------+-------------+

23
api-ref/source/api/ips_management/switching_the_protection_mode.rst
View File

@ -61,22 +61,21 @@ Response Parameters
.. table:: **Table 5** Response body parameters .. table:: **Table 5** Response body parameters
+-----------+------------------------------------------------------------------+--------------------------------+ +-----------+----------------------------------------------------------+-------------+
| Parameter | Type | Description | | Parameter | Type | Description |
+===========+==================================================================+================================+ +===========+==========================================================+=============+
| data | :ref:`IdObject <changeipsprotectmode__response_idobject>` object | Update the IPS protection mode | | data | :ref:`data <changeipsprotectmode__response_data>` object | object |
+-----------+------------------------------------------------------------------+--------------------------------+ +-----------+----------------------------------------------------------+-------------+
.. _changeipsprotectmode__response_idobject: .. _changeipsprotectmode__response_data:
.. table:: **Table 6** IdObject .. table:: **Table 6** data
========= ====== =========== ========= ====== ===================
Parameter Type Description Parameter Type Description
========= ====== =========== ========= ====== ===================
id String ID id String Protected object ID
name String name ========= ====== ===================
========= ====== ===========
**Status code: 400** **Status code: 400**

6
api-ref/source/api/log_management/querying_access_control_logs.rst
View File

@ -32,9 +32,9 @@ GET /v1/{project_id}/cfw/logs/access-control
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| rule_id | No | String | Rule ID | | rule_id | No | String | Rule ID |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| start_time | Yes | Long | Start time | | start_time | Yes | Long | Start time, a timestamp in milliseconds, such as 1718936272648 |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| end_time | Yes | Long | End time | | end_time | Yes | Long | End time, a timestamp in milliseconds, such as 1718936272648 |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| src_ip | No | String | Source IP address | | src_ip | No | String | Source IP address |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@ -138,7 +138,7 @@ Response Parameters
+-------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| rule_id | String | Rule ID | | rule_id | String | Rule ID |
+-------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| hit_time | Long | Hit time | | hit_time | Long | Hit time, a timestamp in milliseconds, such as 1718936272648 |
+-------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| src_region_id | String | source region id | | src_region_id | String | source region id |
+-------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

170
api-ref/source/api/log_management/querying_attack_logs.rst
View File

File diff suppressed because it is too large Load Diff

8
api-ref/source/api/log_management/querying_flow_logs.rst
View File

@ -42,9 +42,9 @@ GET /v1/{project_id}/cfw/logs/flow
| | | | | | | | | |
| | | | - **nat** | | | | | - **nat** |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| start_time | Yes | Long | Start time | | start_time | Yes | Long | Start time, a timestamp in milliseconds, such as 1718936272648 |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| end_time | Yes | Long | End time | | end_time | Yes | Long | End time, a timestamp in milliseconds, such as 1718936272648 |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| src_ip | No | String | Source IP address | | src_ip | No | String | Source IP address |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@ -152,9 +152,9 @@ Response Parameters
+-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| packets | Integer | Packet | | packets | Integer | Packet |
+-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| start_time | Long | Start time | | start_time | Long | Start time, a timestamp in milliseconds, such as 1718936272648 |
+-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| end_time | Long | End time | | end_time | Long | End time, a timestamp in milliseconds, such as 1718936272648 |
+-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| log_id | String | Document ID | | log_id | String | Document ID |
+-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

19
api-ref/source/api/service_set_management/creating_a_service_member.rst
View File

@ -67,8 +67,6 @@ Request Parameters
+-------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| dest_port | Yes | String | Destination port | | dest_port | Yes | String | Destination port |
+-------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| name | No | String | Service member name |
+-------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| description | No | String | Service member description | | description | No | String | Service member description |
+-------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@ -89,21 +87,20 @@ Response Parameters
.. table:: **Table 7** ServiceItemIds .. table:: **Table 7** ServiceItemIds
+-----------+-----------------------------------------------------------------------+------------------------------+ +-----------+-----------------------------------------------------------------+----------------------+
| Parameter | Type | Description | | Parameter | Type | Description |
+===========+=======================================================================+==============================+ +===========+=================================================================+======================+
| items | Array of :ref:`IdObject <addserviceitems__response_idobject>` objects | Service group member ID list | | items | Array of :ref:`items <addserviceitems__response_items>` objects | service item id list |
+-----------+-----------------------------------------------------------------------+------------------------------+ +-----------+-----------------------------------------------------------------+----------------------+
.. _addserviceitems__response_idobject: .. _addserviceitems__response_items:
.. table:: **Table 8** IdObject .. table:: **Table 8** items
========= ====== =========== ========= ====== ===========
Parameter Type Description Parameter Type Description
========= ====== =========== ========= ====== ===========
id String ID id String id
name String name
========= ====== =========== ========= ====== ===========
**Status code: 400** **Status code: 400**

57
api-ref/source/api/service_set_management/creating_a_service_set.rst
View File

@ -46,23 +46,23 @@ Request Parameters
.. table:: **Table 4** Request body parameters .. table:: **Table 4** Request body parameters
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description | | Parameter | Mandatory | Type | Description |
+=================+=================+=================+================================================================================================================================================================================================================================================================================================================================================================================================================================================+ +=================+=================+=================+=====================================================================================================================================================================================================================================================================================+
| object_id | Yes | String | Protected object ID, which is used to distinguish Internet border protection from VPC border protection after a CFW instance is created. You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. For details, see the API Explorer and Help Center FAQ. | | object_id | Yes | String | Internet border Protected object ID, You can obtain the ID by calling the API used for querying a firewall instance. Note that the value 0 indicates the ID of a protected object on the Internet border, and the value 1 indicates the ID of a protected object on the VPC border. |
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| name | Yes | String | Service group name | | name | Yes | String | Service group name |
| | | | | | | | | |
| | | | Minimum: **1** | | | | | Minimum: **1** |
| | | | | | | | | |
| | | | Maximum: **255** | | | | | Maximum: **255** |
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| description | No | String | Service group description | | description | No | String | Service group description |
| | | | | | | | | |
| | | | Minimum: **1** | | | | | Minimum: **1** |
| | | | | | | | | |
| | | | Maximum: **255** | | | | | Maximum: **255** |
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Response Parameters Response Parameters
------------------- -------------------
@ -71,22 +71,21 @@ Response Parameters
.. table:: **Table 5** Response body parameters .. table:: **Table 5** Response body parameters
+-----------+-----------------------------------------------------------+-----------------------------------------------+ ========= ================================================= ===========
| Parameter | Type | Description | Parameter Type Description
+===========+===========================================================+===============================================+ ========= ================================================= ===========
| data | :ref:`IdObject <addserviceset__response_idobject>` object | Data returned when a service group is created | data :ref:`data <addserviceset__response_data>` object object
+-----------+-----------------------------------------------------------+-----------------------------------------------+ ========= ================================================= ===========
.. _addserviceset__response_idobject: .. _addserviceset__response_data:
.. table:: **Table 6** IdObject .. table:: **Table 6** data
========= ====== =========== ========= ====== ===================
Parameter Type Description Parameter Type Description
========= ====== =========== ========= ====== ===================
id String ID id String Protected object ID
name String name ========= ====== ===================
========= ====== ===========
**Status code: 400** **Status code: 400**

23
api-ref/source/api/service_set_management/modifying_a_service_set.rst
View File

@ -70,22 +70,21 @@ Response Parameters
.. table:: **Table 5** Response body parameters .. table:: **Table 5** Response body parameters
+-----------+--------------------------------------------------------------+-----------------------------------------------+ +-----------+------------------------------------------------------+-------------+
| Parameter | Type | Description | | Parameter | Type | Description |
+===========+==============================================================+===============================================+ +===========+======================================================+=============+
| data | :ref:`IdObject <updateserviceset__response_idobject>` object | Data returned when a service group is updated | | data | :ref:`data <updateserviceset__response_data>` object | object |
+-----------+--------------------------------------------------------------+-----------------------------------------------+ +-----------+------------------------------------------------------+-------------+
.. _updateserviceset__response_idobject: .. _updateserviceset__response_data:
.. table:: **Table 6** IdObject .. table:: **Table 6** data
========= ====== =========== ========= ====== ===================
Parameter Type Description Parameter Type Description
========= ====== =========== ========= ====== ===================
id String ID id String Protected object ID
name String name ========= ====== ===================
========= ====== ===========
**Status code: 400** **Status code: 400**

2
api-ref/source/api/service_set_management/obtaining_the_service_set_list.rst
View File

@ -106,8 +106,6 @@ Response Parameters
+------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ref_count | Integer | Reference count | | ref_count | Integer | Reference count |
+------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| status | String | Status |
+------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| project_id | String | Project ID | | project_id | String | Project ID |
+------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| protocols | Array of integers | Protocols | | protocols | Array of integers | Protocols |

4
api-ref/source/api/service_set_management/querying_the_service_set_member_list.rst
View File

@ -40,7 +40,7 @@ GET /v1/{project_id}/service-items
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| fw_instance_id | No | String | Firewall instance ID, which is automatically generated after a CFW instance is created. You can obtain the ID by calling the API used for querying a firewall instance. For details, see the API Explorer and Help Center FAQ.By default, if fw_instance_Id is not specified, information about the first firewall under the account is returned. If fw_instance_Id is specified, information about the firewall with this fw_instance_Id is returned.If object_Id is specified, information about the firewall with this object_Id is returned by default. If both fw_instance_Id and object_Id are specified, the specified object_Id must belong to the specified firewall. | | fw_instance_id | No | String | Firewall instance ID, which is automatically generated after a CFW instance is created. You can obtain the ID by calling the API used for querying a firewall instance. For details, see the API Explorer and Help Center FAQ.By default, if fw_instance_Id is not specified, information about the first firewall under the account is returned. If fw_instance_Id is specified, information about the firewall with this fw_instance_Id is returned.If object_Id is specified, information about the firewall with this object_Id is returned by default. If both fw_instance_Id and object_Id are specified, the specified object_Id must belong to the specified firewall. |
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| query_service_set_type | No | Integer | Query service set type, 0 means custom define service set, 1 means predefine service set. | | query_service_set_type | No | Integer | Query service set type, 0 means custom define service set, 1 means predefine service set, Takes effect only if the set_id is a predefined service set ID |
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Request Parameters Request Parameters
@ -100,8 +100,6 @@ Response Parameters
+-------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| dest_port | String | Destination port | | dest_port | String | Destination port |
+-------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| name | String | Service member name |
+-------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| description | String | Service member description | | description | String | Service member description |
+-------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +-------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

4
api-ref/source/appendix/index.rst
View File

@ -1,6 +1,6 @@
:original_name: cfw_02_0011.html :original_name: cfw_02_0023.html
.. _cfw_02_0011: .. _cfw_02_0023:
Appendix Appendix
======== ========

28
api-ref/source/change_history.rst
View File

@ -1,16 +1,22 @@
:original_name: cfw_02_0016.html :original_name: cfw_02_0017.html
.. _cfw_02_0016: .. _cfw_02_0017:
Change History Change History
============== ==============
+-----------------------------------+-----------------------------------------------------------------------+ +-----------------------------------+----------------------------------------------------------------------------------+
| Release Date | Description | | Release Date | Description |
+===================================+=======================================================================+ +===================================+==================================================================================+
| 2024-05-28 | This issue is the second official release. | | 2024-07-02 | This issue is the third official release. |
| | | | | |
| | Modified the description about whether **X-Auth-Token** is mandatory. | | | Deleted: |
+-----------------------------------+-----------------------------------------------------------------------+ | | |
| 2024-04-30 | This issue is the first official release. | | | - The **address_type** parameter in the "Updating Address Set Information" API. |
+-----------------------------------+-----------------------------------------------------------------------+ +-----------------------------------+----------------------------------------------------------------------------------+
| 2024-05-28 | This issue is the second official release. |
| | |
| | Modified the description about whether **X-Auth-Token** is mandatory. |
+-----------------------------------+----------------------------------------------------------------------------------+
| 2024-04-30 | This issue is the first official release. |
+-----------------------------------+----------------------------------------------------------------------------------+