Update content

This commit is contained in:
OpenTelekomCloud Proposal Bot 2024-06-03 09:20:28 +00:00 committed by Lukas Belejkanic
parent 35a6ebc9d7
commit 6546da69b1
33 changed files with 987 additions and 798 deletions

View File

@ -41,7 +41,7 @@ Request Parameters
+--------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description |
+==============+===========+========+====================================================================================================================================================+
| X-Auth-Token | No | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
| X-Auth-Token | Yes | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
+--------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+
.. table:: **Table 4** Request body parameters

View File

@ -54,6 +54,8 @@ Request Parameters
+--------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| top | No | Integer | Whether to pin on top. The options are as follows: 0: no; 1: yes. |
+--------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| bottom | No | Integer | Whether to pin on bottom. The options are as follows: 0: no; 1: yes. |
+--------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Response Parameters
-------------------

View File

@ -35,6 +35,8 @@ GET /v1/{project_id}/address-sets/{set_id}
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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
------------------
@ -64,17 +66,17 @@ Response Parameters
.. table:: **Table 5** data
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Type | Description |
+=======================+=======================+=============================================================================================+
+=======================+=======================+====================================================================================================================================================================================================================+
| id | String | ID of the IP address group |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| name | String | IP address group name |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| description | String | Address group description |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------+
| address_set_type | Integer | Address set type, 0 indicates a custom address set and 1 indicates a predefined 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. |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address_type | Integer | Specifies the address type. The value can be 0 (IPv4) or 1 (IPv6). |
| | | |
| | | Enumeration values: |
@ -82,7 +84,7 @@ Response Parameters
| | | - **0** |
| | | |
| | | - **1** |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
**Status code: 400**

View File

@ -25,23 +25,25 @@ GET /v1/{project_id}/address-items
.. table:: **Table 2** Query Parameters
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description |
+=======================+===========+=========+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
+========================+===========+=========+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
| set_id | Yes | String | ID of the IP address group |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| key_word | No | String | Keyword |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| limit | Yes | Integer | Number of records displayed on each page, in the range 1-1024 |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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**. |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address | No | String | IP address |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| enterprise_project_id | No | String | Enterprise project id, the id generated by the enterprise project after the user supports the enterprise project. |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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_address_set_type | No | Integer | Query address set type, 0 means custom define address set, 1 means predefined address set |
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Request Parameters
------------------

View File

@ -112,7 +112,7 @@ Response Parameters
+------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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. |
+------------------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address_set_type | Integer | Address set type, 0 indicates a custom address set and 1 indicates a predefined 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**

View File

@ -89,19 +89,17 @@ Response Parameters
.. table:: **Table 5** data
+-----------+-------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------+-------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Type | Description |
+===========+=========================================================================+================================================================================================================================================================================================================================================================================================================================================================================================================================================+
| 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. |
+-----------+-------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+===========+=========================================================================+=================================================================================================================================================+
| offset | 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**. |
+-----------+-------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------+-------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
| limit | Integer | Number of records displayed on each page, in the range 1-1024 |
+-----------+-------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------+-------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
| total | Integer | Total number of queried records |
+-----------+-------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------+-------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
| records | Array of :ref:`records <listblackwhitelists__response_records>` objects | Blacklist and whitelist records |
+-----------+-------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------+-------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
.. _listblackwhitelists__response_records:

View File

@ -47,31 +47,21 @@ Request Parameters
.. table:: **Table 4** Request body parameters
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+--------------+-----------+---------+--------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description |
+=================+=================+=================+================================================================================================================================================================================================================================================================================================================================================================================================================================================+
+==============+===========+=========+========================================================================================================+
| 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 | No | 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. |
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+--------------+-----------+---------+--------------------------------------------------------------------------------------------------------+
| port | No | String | Port |
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| list_type | No | Integer | Blacklist/Whitelist type. The options are 4 (blacklist) and 5 (whitelist). |
| | | | |
| | | | Enumeration values: |
| | | | |
| | | | - **4** |
| | | | |
| | | | - **5** |
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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. |
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+--------------+-----------+---------+--------------------------------------------------------------------------------------------------------+
| description | No | String | description |
+-----------------+-----------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+--------------+-----------+---------+--------------------------------------------------------------------------------------------------------+
Response Parameters
-------------------

View File

@ -59,7 +59,7 @@ Request Parameters
+-----------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| domain_names | No | Array of :ref:`DomainSetInfoDto <adddomainset__request_domainsetinfodto>` objects | domain names |
+-----------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| domain_set_type | Yes | Integer | Domain set type, 0 means URL filtering, 1 means domain parse |
| domain_set_type | Yes | Integer | Domain name group type. 0 means Application type and 1 means Network type. |
+-----------------+-----------+-----------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. _adddomainset__request_domainsetinfodto:

View File

@ -40,7 +40,7 @@ GET /v1/{project_id}/domain-sets
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| key_word | No | String | key |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| domain_set_type | No | Integer | Domain set type, 0 means URL filtering, 1 means domain parse |
| domain_set_type | No | Integer | Domain name group type. 0 means Application type and 1 means Network type. |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| config_status | No | Integer | config status |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@ -89,17 +89,36 @@ Response Parameters
.. table:: **Table 6** DomainSetVo
=============== ======= ===============
+-----------------+------------------------------------------------------------------------+----------------------------------------------------------------------------+
| Parameter | Type | Description |
+=================+========================================================================+============================================================================+
| set_id | String | set id |
+-----------------+------------------------------------------------------------------------+----------------------------------------------------------------------------+
| name | String | domain set name |
+-----------------+------------------------------------------------------------------------+----------------------------------------------------------------------------+
| description | String | description |
+-----------------+------------------------------------------------------------------------+----------------------------------------------------------------------------+
| ref_count | Integer | reference count |
+-----------------+------------------------------------------------------------------------+----------------------------------------------------------------------------+
| domain_set_type | Integer | Domain name group type. 0 means Application type and 1 means Network type. |
+-----------------+------------------------------------------------------------------------+----------------------------------------------------------------------------+
| config_status | Integer | config status |
+-----------------+------------------------------------------------------------------------+----------------------------------------------------------------------------+
| message | String | message |
+-----------------+------------------------------------------------------------------------+----------------------------------------------------------------------------+
| rules | Array of :ref:`UseRuleVO <listdomainsets__response_userulevo>` objects | used rule list |
+-----------------+------------------------------------------------------------------------+----------------------------------------------------------------------------+
.. _listdomainsets__response_userulevo:
.. table:: **Table 7** UseRuleVO
========= ====== ===========
Parameter Type Description
=============== ======= ===============
set_id String set id
name String domain set name
description String description
ref_count Integer reference count
domain_set_type Integer domain set type
config_status Integer config status
message String message
=============== ======= ===============
========= ====== ===========
id String rule id
name String rule name
========= ====== ===========
Example Requests
----------------

View File

@ -39,10 +39,6 @@ GET /v1/{project_id}/domain-set/domains/{domain_set_id}
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| domain_name | No | String | domain name |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| description | No | String | description |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| set_id | No | String | domain_set_id |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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. |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@ -54,7 +50,7 @@ Request Parameters
+--------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description |
+==============+===========+========+====================================================================================================================================================+
| X-Auth-Token | No | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
| X-Auth-Token | Yes | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
+--------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+
Response Parameters

View File

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

View File

@ -26,15 +26,15 @@ GET /v1/{project_id}/domain/parse/{domain_name}
.. table:: **Table 2** Query Parameters
+-----------------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description |
+=======================+===========+========+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
+=======================+===========+=========+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
| enterprise_project_id | No | String | Enterprise project id, the id generated by the enterprise project after the user supports the enterprise project. |
+-----------------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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. |
+-----------------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address_type | No | String | Specifies the address type. The value can be 0 (IPv4) or 1 (IPv6). |
+-----------------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| address_type | No | Integer | Specifies the address type. The value can be 0 (IPv4) or 1 (IPv6). |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Request Parameters
------------------

View File

@ -31,7 +31,7 @@ PUT /v1/{project_id}/domain-set/{set_id}
+=======================+===========+========+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
| enterprise_project_id | No | String | Enterprise project id, the id generated by the enterprise project after the user supports the enterprise project. |
+-----------------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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 | 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. |
+-----------------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Request Parameters
@ -47,14 +47,17 @@ Request Parameters
.. table:: **Table 4** Request body parameters
=============== ========= ======= ===============
Parameter Mandatory Type Description
=============== ========= ======= ===============
name Yes String name
description No String description
set_id No String domain set id
domain_set_type No Integer domain set type
=============== ========= ======= ===============
+-----------------+-----------+---------+----------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description |
+=================+===========+=========+============================================================================+
| name | Yes | String | name |
+-----------------+-----------+---------+----------------------------------------------------------------------------+
| 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
-------------------

View File

@ -49,7 +49,9 @@ GET /v1/{project_id}/eips/protect
| | | | Enumeration values: |
| | | | |
| | | | - **null** |
| | | | |
| | | | - **0** |
| | | | |
| | | | - **1** |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| sync | No | Integer | Specifies whether to synchronize tenant EIP data. The options are as follows: 0: no; 1: yes |
@ -57,6 +59,7 @@ GET /v1/{project_id}/eips/protect
| | | | Enumeration values: |
| | | | |
| | | | - **0** |
| | | | |
| | | | - **1** |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| limit | Yes | Integer | Number of records displayed on each page, in the range 1-1024 |
@ -138,6 +141,7 @@ Response Parameters
| | | Enumeration values: |
| | | |
| | | - **0** |
| | | |
| | | - **1** |
+--------------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| public_ipv6 | String | EIP IPv6 |
@ -215,7 +219,7 @@ Return value of EIP data query
"associate_instance_type" : "PORT",
"device_id" : "c87579ab-c76a-4afd-83ce-62e0f531f13e",
"device_name" : "test",
"device_owner" : "compute:endpoint",
"device_owner" : "compute:test",
"domain_id" : "7d07807209524a4280266db9df63c4fa",
"enterprise_project_id" : "0",
"fw_domain_id" : "7d07807209524a4280266db9df63c4fa",

View File

@ -63,22 +63,47 @@ Response Parameters
.. table:: **Table 5** Response body parameters
+-----------+--------------------------------------------------------------------+------------------------------------+
+-----------+--------------------------------------------------------------------------------------------+------------------------------------+
| Parameter | Type | Description |
+===========+====================================================================+====================================+
| data | :ref:`IdObject <createeastwestfirewall__response_idobject>` object | create east west firewall response |
+-----------+--------------------------------------------------------------------+------------------------------------+
+===========+============================================================================================+====================================+
| data | :ref:`CreateEWFirewallResp <createeastwestfirewall__response_createewfirewallresp>` object | create east west firewall response |
+-----------+--------------------------------------------------------------------------------------------+------------------------------------+
.. _createeastwestfirewall__response_idobject:
.. _createeastwestfirewall__response_createewfirewallresp:
.. table:: **Table 6** IdObject
.. table:: **Table 6** CreateEWFirewallResp
========= ====== ===========
+----------------+----------------------------------------------------------------------------------------------------------------+----------------+
| Parameter | Type | Description |
+================+================================================================================================================+================+
| id | String | Id |
+----------------+----------------------------------------------------------------------------------------------------------------+----------------+
| er | :ref:`ER <createeastwestfirewall__response_er>` object | ER data |
+----------------+----------------------------------------------------------------------------------------------------------------+----------------+
| inspertion_vpc | :ref:`CreateEWFirewallInspectVpcResp <createeastwestfirewall__response_createewfirewallinspectvpcresp>` object | inspection vpc |
+----------------+----------------------------------------------------------------------------------------------------------------+----------------+
.. _createeastwestfirewall__response_er:
.. table:: **Table 7** ER
============ ====== ============
Parameter Type Description
========= ====== ===========
id String ID
name String name
========= ====== ===========
============ ====== ============
er_id String ER ID
er_attach_id String ER attach ID
============ ====== ============
.. _createeastwestfirewall__response_createewfirewallinspectvpcresp:
.. table:: **Table 8** CreateEWFirewallInspectVpcResp
========== ================ ===========
Parameter Type Description
========== ================ ===========
vpc_id String vpc id
subnet_ids Array of strings subnet ids
========== ================ ===========
Example Requests
----------------
@ -106,7 +131,15 @@ Create East West Firewall Response Body
{
"data" : {
"id" : "b6d4a7d5-388e-4594-b696-fb4bba1d2b9e"
"id" : "acc86ca7-818b-4c3d-8a9a-3915a2b21651",
"er" : {
"er_id" : "f0f5275a-40aa-4d1e-ac78-2550f7818d43",
"er_attach_id" : "bd62ddd3-5e20-482b-aefa-9e2940e2b1a9"
},
"inspertion_vpc" : {
"vpc_id" : "00672633-0466-4c35-99ef-5e3f5c813a4b",
"subnet_ids" : [ "294682a0-1e85-45f5-92c8-e52bee09c204", "a86277bb-35d5-4442-bc0b-2e9d4e6a9080", "95829240-14e0-47e6-b9e7-2ac228e7b00f" ]
}
}
}

View File

@ -31,7 +31,7 @@ Request Parameters
+----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description |
+================+===========+========+========================================================================================================================================================================+
| X-Auth-Token | No | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
| X-Auth-Token | Yes | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
+----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| X-Client-Token | No | String | An identity that guarantees the idempotency of client requests. The identifier is in 32-bit UUID format, generated by the client, and must be unique between requests. |
+----------------+-----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@ -292,7 +292,28 @@ Create Firewall Response
.. code-block::
{
"data" : "6ed72853-34cb-4b97-9b87-cfc47087c96e"
"data" : {
"charge_info" : {
"charge_mode" : "prePaid",
"is_auto_pay" : true,
"is_auto_renew" : true,
"period_num" : 1,
"period_type" : "month"
},
"enterprise_project_id" : "0",
"flavor" : {
"extend_bandwidth" : 5000,
"extend_eip_count" : 2000,
"extend_vpc_count" : 100,
"version" : "Standard"
},
"name" : "CFW-TEST",
"tags" : [ {
"key" : "TagKey",
"value" : "TagVal"
} ]
},
"order_id" : "CS2403271050ZEM0L"
}
**Status code: 400**

View File

@ -32,7 +32,7 @@ Request Parameters
+--------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description |
+==============+===========+========+====================================================================================================================================================+
| X-Auth-Token | No | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
| X-Auth-Token | Yes | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
+--------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+
Response Parameters

View File

@ -50,6 +50,8 @@ GET /v1/{project_id}/firewall/exist
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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. |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| name | No | String | firewall instance name |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Request Parameters
------------------
@ -170,15 +172,17 @@ Response Parameters
+--------------------------+----------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| support_url_filtering | Boolean | whether to enable url filtering. The options are true (yes) and false (no). |
+--------------------------+----------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| tags | String | tags |
+--------------------------+----------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. _listfirewalldetail__response_flavor:
.. table:: **Table 7** Flavor
+-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Type | Description |
+=======================+=======================+==========================================================================================================+
| version | Integer | Firewall version. The value can be 0 (standard edition), 1 (professional edition), or 3 (basic edition). |
+=======================+=======================+================================================================================================================================+
| version | Integer | Firewall version. The value can be 0 (standard edition), 1 (professional edition), 2 (platinum edition), or 3 (basic edition). |
| | | |
| | | Enumeration values: |
| | | |
@ -186,32 +190,32 @@ Response Parameters
| | | |
| | | - **1** |
| | | |
| | | - **2** |
| | | |
| | | - **3** |
+-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| eip_count | Integer | Number of EIPs |
| | | |
| | | Minimum: **1** |
+-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| vpc_count | Integer | Number of VPCs |
| | | |
| | | Minimum: **1** |
+-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| bandwidth | Integer | Bandwidth |
| | | |
| | | Minimum: **1** |
+-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| log_storage | Integer | Log storage |
+-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+
| session_concurrent | Integer | concurrent session |
+-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+
| session_create | Integer | created session |
+-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+
| total_rule_count | Integer | total rule count |
+-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+
| used_rule_count | Integer | used rule count |
+-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+
| vpc_bandwith | Integer | vpc bandwith |
+-----------------------+-----------------------+----------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| default_bandwidth | Integer | default bandwidth |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| default_eip_count | Integer | default eip count |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| default_log_storage | Integer | default log storage |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| default_vpc_count | Integer | default vpc count |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+
.. _listfirewalldetail__response_protectobjectvo:
@ -312,8 +316,13 @@ Response to the request for obtaining a firewall instance
"used_rule_count" : 2136,
"version" : 1,
"vpc_bandwith" : 1400,
"vpc_count" : 8
"vpc_count" : 8,
"default_eip_count" : 20,
"default_vpc_count" : 0,
"default_bandwidth" : 10,
"default_log_storage" : 0
},
"tags" : "{\"key1234\":\"1234\",\"key122\":\"2222\"}",
"fw_instance_id" : "546af3f8-88e9-47f2-a205-2346d7090925",
"fw_instance_name" : "test",
"ha_type" : 1,

View File

@ -32,7 +32,7 @@ Request Parameters
+--------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description |
+==============+===========+========+====================================================================================================================================================+
| X-Auth-Token | No | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
| X-Auth-Token | Yes | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
+--------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+
Response Parameters
@ -64,23 +64,25 @@ Response Parameters
.. table:: **Table 4** data
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Type | Description |
+=======================+=======================+=========================================================================================================================================+
+=======================+=======================+=====================================================================================================================================================================================================+
| id | String | Job Id |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| status | String | Job execution status. Running means the job is being executed, Success means the job is successful, Failed means the job is failed. |
| | | |
| | | Enumeration values: |
| | | |
| | | - **Running** |
| | | |
| | | - **Success** |
| | | |
| | | - **Failed** |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
| begin_time | String | Creation time, in the format yyyy-mm-ddThh:mm:ssZ. where T refers to the beginning of a certain time; Z refers to the time zone offset. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
| end_time | String | End time, in the format "yyyy-mm-ddThh:mm:ssZ". where T refers to the beginning of a certain time; Z refers to the time zone offset. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| begin_time | String | Creation time, in the format yyyy-mm-ddThh:mm:ssZ. where T refers to the beginning of a certain time; Z refers to the time zone offset, for example, the Beijing time offset is displayed as +0800. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| end_time | String | End time, in the format "yyyy-mm-ddThh:mm:ssZ". where T refers to the beginning of a certain time; Z refers to the time zone offset, for example, the Beijing time offset is displayed as +0800. |
+-----------------------+-----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Example Requests
----------------

View File

@ -87,48 +87,15 @@ Response Parameters
.. table:: **Table 6** VpcAttachmentDetail
+-----------------------+---------------------------------------------------------------+-----------------------+
| Parameter | Type | Description |
+=======================+===============================================================+=======================+
| id | String | id |
+-----------------------+---------------------------------------------------------------+-----------------------+
| name | String | name |
+-----------------------+---------------------------------------------------------------+-----------------------+
| vpc_id | String | vpc id |
+-----------------------+---------------------------------------------------------------+-----------------------+
| virsubnet_id | String | subnet id |
+-----------------------+---------------------------------------------------------------+-----------------------+
| state | String | state |
+-----------------------+---------------------------------------------------------------+-----------------------+
| created_at | String | create time |
+-----------------------+---------------------------------------------------------------+-----------------------+
| updated_at | String | update time |
+-----------------------+---------------------------------------------------------------+-----------------------+
| tags | Array of :ref:`Tag <listprotectedvpcs__response_tag>` objects | tag |
+-----------------------+---------------------------------------------------------------+-----------------------+
| description | String | description |
+-----------------------+---------------------------------------------------------------+-----------------------+
| project_id | String | project id |
+-----------------------+---------------------------------------------------------------+-----------------------+
| vpc_project_id | String | vpc project id |
+-----------------------+---------------------------------------------------------------+-----------------------+
| enterprise_project_id | String | enterprise project id |
+-----------------------+---------------------------------------------------------------+-----------------------+
.. _listprotectedvpcs__response_tag:
.. table:: **Table 7** Tag
========= ====== ===========
Parameter Type Description
========= ====== ===========
key String key
value String value
vpc_id String vpc id
========= ====== ===========
**Status code: 500**
.. table:: **Table 8** Response body parameters
.. table:: **Table 7** Response body parameters
+-----------------------+-----------------------+-----------------------+
| Parameter | Type | Description |

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -61,8 +61,6 @@ Request Parameters
+-------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description |
+=============+===========+=========+==================================================================================================================================================================================================================+
| item_id | No | String | Service member ID |
+-------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| protocol | Yes | Integer | Protocol type. The value 6 indicates TCP, 17 indicates UDP, 1 indicates ICMP, 58 indicates ICMPv6, and -1 indicates any protocol. Regarding the addition type, a null value indicates it is automatically added. |
+-------------+-----------+---------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| source_port | Yes | String | Source port |

View File

@ -25,27 +25,29 @@ GET /v1/{project_id}/service-sets
.. table:: **Table 2** Query Parameters
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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. |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| key_word | No | String | Keyword |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| limit | Yes | Integer | Number of queries on each page, in the range 1-1024 |
| | | | |
| | | | Minimum: **1** |
| | | | |
| | | | Maximum: **1024** |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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**. |
| | | | |
| | | | Minimum: **0** |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| enterprise_project_id | No | String | Enterprise project id, the id generated by the enterprise project after the user supports the enterprise project. |
+-----------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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. |
+------------------------+-----------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Request Parameters
------------------
@ -55,7 +57,7 @@ Request Parameters
+--------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description |
+==============+===========+========+====================================================================================================================================================+
| X-Auth-Token | No | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
| X-Auth-Token | Yes | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
+--------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+
Response Parameters
@ -91,25 +93,25 @@ Response Parameters
.. table:: **Table 6** ServiceSet
+------------------+-------------------+---------------------------------------------------------------------------------------------+
+------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Type | Description |
+==================+===================+=============================================================================================+
+==================+===================+================================================================================================================================================================================+
| set_id | String | Service group ID |
+------------------+-------------------+---------------------------------------------------------------------------------------------+
+------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| name | String | Name |
+------------------+-------------------+---------------------------------------------------------------------------------------------+
+------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| description | String | Description |
+------------------+-------------------+---------------------------------------------------------------------------------------------+
| service_set_type | Integer | Service set type, 0 indicates a custom service set and 1 indicates a predefined service set |
+------------------+-------------------+---------------------------------------------------------------------------------------------+
+------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| service_set_type | Integer | Service set type, 0 indicates a custom service set, 1 indicates a predefined service set, 2 indicates commonly used remote login and PING, 3 indicates commonly used databases |
+------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ref_count | Integer | Reference count |
+------------------+-------------------+---------------------------------------------------------------------------------------------+
+------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| status | String | Status |
+------------------+-------------------+---------------------------------------------------------------------------------------------+
+------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| project_id | String | Project ID |
+------------------+-------------------+---------------------------------------------------------------------------------------------+
+------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| protocols | Array of integers | Protocols |
+------------------+-------------------+---------------------------------------------------------------------------------------------+
+------------------+-------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
**Status code: 400**

View File

@ -26,13 +26,15 @@ GET /v1/{project_id}/service-sets/{set_id}
.. table:: **Table 2** Query Parameters
+-----------------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description |
+=======================+===========+========+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
+========================+===========+=========+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
| enterprise_project_id | No | String | Enterprise project id, the id generated by the enterprise project after the user supports the enterprise project. |
+-----------------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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. |
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Request Parameters
------------------
@ -62,25 +64,25 @@ Response Parameters
.. table:: **Table 5** ServiceSetDetailResponseDto
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Type | Description |
+=======================+=======================+=============================================================================================+
+=======================+=======================+================================================================================================================================================================================+
| id | String | Service group ID |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| name | String | Service group name |
| | | |
| | | Minimum: **1** |
| | | |
| | | Maximum: **255** |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| description | String | Service group description |
| | | |
| | | Minimum: **1** |
| | | |
| | | Maximum: **255** |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------+
| service_set_type | Integer | Service set type, 0 indicates a custom service set and 1 indicates a predefined service set |
+-----------------------+-----------------------+---------------------------------------------------------------------------------------------+
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| service_set_type | Integer | Service set type, 0 indicates a custom service set, 1 indicates a predefined service set, 2 indicates commonly used remote login and PING, 3 indicates commonly used databases |
+-----------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
**Status code: 400**

View File

@ -25,21 +25,23 @@ GET /v1/{project_id}/service-items
.. table:: **Table 2** Query Parameters
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description |
+=======================+===========+=========+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
+========================+===========+=========+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
| set_id | Yes | String | Service group ID |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| key_word | No | String | Query field |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| limit | Yes | Integer | Number of records displayed on each page, in the range 1-1024 |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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**. |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| enterprise_project_id | No | String | Enterprise project id, the id generated by the enterprise project after the user supports the enterprise project. |
+-----------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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. |
+------------------------+-----------+---------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Request Parameters
------------------

View File

@ -5,8 +5,12 @@
Change History
==============
============ =========================================
Release Date Description
============ =========================================
2024-04-30 This issue is the first official release.
============ =========================================
+-----------------------------------+-----------------------------------------------------------------------+
| Release Date | Description |
+===================================+=======================================================================+
| 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. |
+-----------------------------------+-----------------------------------------------------------------------+