@alicloud/waf-openapi20211001 6.6.1 → 6.7.1

package/src/models/ModifyCloudResourceRequest.ts

@@ -5,11 +5,10 @@ import * as $dara from '@darabonba/typescript';
 export class ModifyCloudResourceRequestListenCertificates extends $dara.Model {
   /**
    * @remarks
-   * The type of the certificate for the HTTPS protocol. Valid values:
+   * The type of the certificate. Valid values:
    * 
-   * - **default**: a default certificate.
-   * 
-   * - **extension**: an extension certificate.
+   * *   **default**: default certificate.
+   * *   **extension**: additional certificate.
    * 
    * @example
    * default
@@ -49,18 +48,16 @@ export class ModifyCloudResourceRequestListenCertificates extends $dara.Model {
 export class ModifyCloudResourceRequestListen extends $dara.Model {
   /**
    * @remarks
-   * The certificate information.
+   * The certificates.
    */
   certificates?: ModifyCloudResourceRequestListenCertificates[];
   /**
    * @remarks
-   * The type of the cipher suite to add. This parameter applies only when you use the HTTPS protocol. Valid values:
-   * 
-   * - **1**: adds all cipher suites.
+   * The type of the cipher suites that you want to add. This parameter is available only if you specify **HttpsPorts**. Valid values:
    * 
-   * - **2**: adds strong cipher suites. This value is available only when **TLSVersion** is set to **tlsv1.2**.
-   * 
-   * - **99**: adds custom cipher suites.
+   * *   **1**: all cipher suites.
+   * *   **2**: strong cipher suites. This value is available only if you set **TLSVersion** to **tlsv1.2**.
+   * *   **99**: custom cipher suites.
    * 
    * @example
    * 1
@@ -68,16 +65,15 @@ export class ModifyCloudResourceRequestListen extends $dara.Model {
   cipherSuite?: number;
   /**
    * @remarks
-   * The custom cipher suites.
+   * The custom cipher suites that you want to add.
    */
   customCiphers?: string[];
   /**
    * @remarks
-   * Indicates whether TLS 1.3 is supported. This parameter applies only when you use the HTTPS protocol. Valid values:
-   * 
-   * - **true**: TLS 1.3 is supported.
+   * Specifies whether to support TLS 1.3. This parameter is available only if you specify **HttpsPorts**. Valid values:
    * 
-   * - **false**: TLS 1.3 is not supported.
+   * *   **true**
+   * *   **false**
    * 
    * @example
    * true
@@ -88,11 +84,10 @@ export class ModifyCloudResourceRequestListen extends $dara.Model {
   enableTLSv3?: boolean;
   /**
    * @remarks
-   * Indicates whether HTTP/2 is enabled. This parameter applies only when you use the HTTPS protocol. Valid values:
+   * Specifies whether to enable HTTP/2. This parameter is available only if you specify **HttpsPorts**. Valid values:
    * 
-   * - **true**: enables HTTP/2.
-   * 
-   * - **false** (default): disables HTTP/2.
+   * *   **true**
+   * *   **false** (default)
    * 
    * @example
    * true
@@ -100,7 +95,7 @@ export class ModifyCloudResourceRequestListen extends $dara.Model {
   http2Enabled?: boolean;
   /**
    * @remarks
-   * The listening port of the cloud service instance that is added to WAF.
+   * The port of the cloud service instance that is added to WAF.
    * 
    * @example
    * 80
@@ -112,9 +107,8 @@ export class ModifyCloudResourceRequestListen extends $dara.Model {
    * @remarks
    * The protocol type. Valid values:
    * 
-   * - **http**: HTTP.
-   * 
-   * - **https**: HTTPS.
+   * *   **http**
+   * *   **https**
    * 
    * This parameter is required.
    * 
@@ -124,7 +118,7 @@ export class ModifyCloudResourceRequestListen extends $dara.Model {
   protocol?: string;
   /**
    * @remarks
-   * The ID of the cloud service instance.
+   * The ID of the cloud service instance that is added to WAF.
    * 
    * @example
    * lb-***
@@ -136,13 +130,10 @@ export class ModifyCloudResourceRequestListen extends $dara.Model {
    * @remarks
    * The type of the cloud service. Valid values:
    * 
-   * - **clb4**: Layer 4 Classic Load Balancer (CLB).
-   * 
-   * - **clb7**: Layer 7 CLB.
-   * 
-   * - **ecs**: Elastic Compute Service (ECS).
-   * 
-   * - **nlb**: Network Load Balancer (NLB).
+   * *   **clb4**: Layer 4 Classic Load Balancer (CLB).
+   * *   **clb7**: Layer 7 CLB.
+   * *   **ecs**: Elastic Compute Service (ECS).
+   * *   **nlb**: Network Load Balancer (NLB).
    * 
    * @example
    * clb7
@@ -152,13 +143,11 @@ export class ModifyCloudResourceRequestListen extends $dara.Model {
   resourceProduct?: string;
   /**
    * @remarks
-   * The Transport Layer Security (TLS) version. This parameter applies only when you use the HTTPS protocol. Valid values:
-   * 
-   * - **tlsv1**
+   * The Transport Layer Security (TLS) version that you want to add. This parameter is available only if you specify **HttpsPorts**. Valid values:
    * 
-   * - **tlsv1.1**
-   * 
-   * - **tlsv1.2**
+   * *   **tlsv1**
+   * *   **tlsv1.1**
+   * *   **tlsv1.2**
    * 
    * @example
    * tlsv1.2
@@ -212,7 +201,7 @@ export class ModifyCloudResourceRequestListen extends $dara.Model {
 export class ModifyCloudResourceRequestRedirectRequestHeaders extends $dara.Model {
   /**
    * @remarks
-   * The custom request header field.
+   * The key of the custom header field.
    * 
    * @example
    * key1
@@ -220,7 +209,7 @@ export class ModifyCloudResourceRequestRedirectRequestHeaders extends $dara.Mode
   key?: string;
   /**
    * @remarks
-   * The value of the custom request header field.
+   * The value of the custom header field.
    * 
    * @example
    * value1
@@ -252,11 +241,10 @@ export class ModifyCloudResourceRequestRedirectRequestHeaders extends $dara.Mode
 export class ModifyCloudResourceRequestRedirect extends $dara.Model {
   /**
    * @remarks
-   * Indicates whether persistent connections are enabled. Valid values:
-   * 
-   * - **true** (default): enables persistent connections.
+   * Specifies whether to enable the persistent connection feature. Valid values:
    * 
-   * - **false**: disables persistent connections.
+   * *   **true** (default)
+   * *   **false**
    * 
    * @example
    * true
@@ -264,7 +252,9 @@ export class ModifyCloudResourceRequestRedirect extends $dara.Model {
   keepalive?: boolean;
   /**
    * @remarks
-   * The maximum number of requests that can be served through one persistent connection. Valid values: 60 to 1000.
+   * The number of reused persistent connections. Valid values: 60 to 1000.
+   * 
+   * >  This parameter specifies the number of persistent connections that can be reused after you enable the persistent connection feature.
    * 
    * @example
    * 1000
@@ -272,23 +262,22 @@ export class ModifyCloudResourceRequestRedirect extends $dara.Model {
   keepaliveRequests?: number;
   /**
    * @remarks
-   * The timeout period for an idle persistent connection. Valid values: 10 to 3600. Default value: 3600. Unit: seconds.
+   * The timeout period of idle persistent connections. Valid values: 10 to 3600. Default value: 3600. Unit: seconds.
+   * 
+   * >  This parameter specifies the period of time after which an idle persistent connection is closed.
    * 
    * @example
    * 15
    */
   keepaliveTimeout?: number;
   /**
-   * @remarks
-   * The maximum size of a request body. Valid values: 2 to 10. Default value: 2. Unit: GB.
-   * 
    * @example
-   * 2
+   * 5
    */
   maxBodySize?: number;
   /**
    * @remarks
-   * The read timeout period. Unit: seconds. Valid values: 1 to 3600.
+   * The timeout period of read connections. Unit: seconds. Valid values: 1 to 3600.
    * 
    * @example
    * 1
@@ -296,12 +285,12 @@ export class ModifyCloudResourceRequestRedirect extends $dara.Model {
   readTimeout?: number;
   /**
    * @remarks
-   * The custom header fields used to mark traffic that is processed by WAF.
+   * The custom header fields, which are key-value pairs. The fields are used to mark requests that pass through WAF.
    */
   requestHeaders?: ModifyCloudResourceRequestRedirectRequestHeaders[];
   /**
    * @remarks
-   * The write timeout period. Unit: seconds. Valid values: 1 to 3600.
+   * The timeout period of write connections. Unit: seconds. Valid values: 1 to 3600.
    * 
    * @example
    * 1
@@ -309,13 +298,11 @@ export class ModifyCloudResourceRequestRedirect extends $dara.Model {
   writeTimeout?: number;
   /**
    * @remarks
-   * The method that WAF uses to obtain the real IP address of a client. Valid values:
-   * 
-   * - **0**: WAF obtains the real IP address of the client from the request. Use this value when no Layer 7 proxy resides before WAF.
+   * The method that is used to obtain the originating IP address of a client. Valid values:
    * 
-   * - **1**: WAF reads the first value of the X-Forwarded-For (XFF) header as the client IP address.
-   * 
-   * - **2**: WAF reads the value of a custom header field as the client IP address.
+   * *   **0**: No Layer 7 proxies are deployed in front of WAF.
+   * *   **1**: WAF reads the first value of the X-Forwarded-For (XFF) header field as the originating IP address of the client.
+   * *   **2**: WAF reads the value of a custom header field as the originating IP address of the client.
    * 
    * @example
    * 0
@@ -323,18 +310,17 @@ export class ModifyCloudResourceRequestRedirect extends $dara.Model {
   xffHeaderMode?: number;
   /**
    * @remarks
-   * The custom header fields that are used to obtain the client IP address.
+   * The custom header fields that are used to obtain the originating IP address of a client. Specify the value in the ["header1","header2",...] format.
    * 
-   * > This parameter is required only when **XffHeaderMode** is set to **2**.
+   * >  This parameter is required only if you set **XffHeaderMode** to 2.
    */
   xffHeaders?: string[];
   /**
    * @remarks
-   * Indicates whether the X-Forwarded-Proto header is used to pass the protocol used by WAF. Valid values:
-   * 
-   * - **true** (default): passes the protocol.
+   * Specifies whether to use the X-Forward-For-Proto header field to pass the protocol used by WAF to forward requests to the origin server. Valid values:
    * 
-   * - **false**: does not pass the protocol.
+   * *   **true** (default)
+   * *   **false**
    * 
    * @example
    * true
@@ -386,21 +372,12 @@ export class ModifyCloudResourceRequestRedirect extends $dara.Model {
 }
 
 export class ModifyCloudResourceRequest extends $dara.Model {
-  /**
-   * @remarks
-   * The ID of the cloud resource that is added to WAF.
-   * 
-   * > Call [CreateCloudResource](https://help.aliyun.com/document_detail/2839876.html) to add a cloud resource. The resource ID is included in the response.
-   * 
-   * @example
-   * lb-***-80-clb7
-   */
   cloudResourceId?: string;
   /**
    * @remarks
    * The ID of the WAF instance.
    * 
-   * > Call [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) to query the ID of the WAF instance.
+   * >  You can call the [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) operation to query the ID of the WAF instance.
    * 
    * This parameter is required.
    * 
@@ -410,23 +387,22 @@ export class ModifyCloudResourceRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The listener configuration.
+   * The listener configurations.
    * 
    * This parameter is required.
    */
   listen?: ModifyCloudResourceRequestListen;
   /**
    * @remarks
-   * The forwarding configuration.
+   * The forwarding configurations.
    */
   redirect?: ModifyCloudResourceRequestRedirect;
   /**
    * @remarks
-   * The region of the WAF instance. Valid values:
-   * 
-   * - **cn-hangzhou**: the Chinese mainland.
+   * The region in which the WAF instance is deployed. Valid values:
    * 
-   * - **ap-southeast-1**: outside the Chinese mainland.
+   * *   **cn-hangzhou**: the Chinese mainland.
+   * *   **ap-southeast-1**: outside the Chinese mainland.
    * 
    * This parameter is required.
    * 
@@ -436,7 +412,7 @@ export class ModifyCloudResourceRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The ID of the resource group.
+   * The ID of the Alibaba Cloud resource group.
    * 
    * @example
    * rg-acfm***q

package/src/models/ModifyCloudResourceResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ModifyCloudResourceResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The ID of the cloud resource that is added to WAF.
+   * The ID of the resource that is added to WAF.
    * 
    * @example
    * lb-xxx-80-clb7
@@ -13,7 +13,7 @@ export class ModifyCloudResourceResponseBody extends $dara.Model {
   cloudResource?: string;
   /**
    * @remarks
-   * The request ID.
+   * The ID of the request.
    * 
    * @example
    * D7861F61-5B61-46CE-A47C-***

package/src/models/ModifyCloudResourceShrinkRequest.ts

@@ -3,21 +3,12 @@ import * as $dara from '@darabonba/typescript';
 
 
 export class ModifyCloudResourceShrinkRequest extends $dara.Model {
-  /**
-   * @remarks
-   * The ID of the cloud resource that is added to WAF.
-   * 
-   * > Call [CreateCloudResource](https://help.aliyun.com/document_detail/2839876.html) to add a cloud resource. The resource ID is included in the response.
-   * 
-   * @example
-   * lb-***-80-clb7
-   */
   cloudResourceId?: string;
   /**
    * @remarks
    * The ID of the WAF instance.
    * 
-   * > Call [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) to query the ID of the WAF instance.
+   * >  You can call the [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) operation to query the ID of the WAF instance.
    * 
    * This parameter is required.
    * 
@@ -27,23 +18,22 @@ export class ModifyCloudResourceShrinkRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The listener configuration.
+   * The listener configurations.
    * 
    * This parameter is required.
    */
   listenShrink?: string;
   /**
    * @remarks
-   * The forwarding configuration.
+   * The forwarding configurations.
    */
   redirectShrink?: string;
   /**
    * @remarks
-   * The region of the WAF instance. Valid values:
-   * 
-   * - **cn-hangzhou**: the Chinese mainland.
+   * The region in which the WAF instance is deployed. Valid values:
    * 
-   * - **ap-southeast-1**: outside the Chinese mainland.
+   * *   **cn-hangzhou**: the Chinese mainland.
+   * *   **ap-southeast-1**: outside the Chinese mainland.
    * 
    * This parameter is required.
    * 
@@ -53,7 +43,7 @@ export class ModifyCloudResourceShrinkRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The ID of the resource group.
+   * The ID of the Alibaba Cloud resource group.
    * 
    * @example
    * rg-acfm***q

package/src/models/ModifyDefaultHttpsRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ModifyDefaultHttpsRequest extends $dara.Model {
   /**
    * @remarks
-   * The certificate ID.
+   * The ID of the certificate.
    * 
    * This parameter is required.
    * 
@@ -15,13 +15,11 @@ export class ModifyDefaultHttpsRequest extends $dara.Model {
   certId?: string;
   /**
    * @remarks
-   * The type of the cipher suite. Valid values:
+   * The type of the cipher suites. Valid values:
    * 
-   * - **1**: adds all cipher suites.
-   * 
-   * - **2**: adds strong cipher suites.
-   * 
-   * - **99**: adds custom cipher suites.
+   * *   **1**: all cipher suites.
+   * *   **2**: strong cipher suites.
+   * *   **99**: custom cipher suites.
    * 
    * @example
    * 0
@@ -29,16 +27,15 @@ export class ModifyDefaultHttpsRequest extends $dara.Model {
   cipherSuite?: number;
   /**
    * @remarks
-   * The custom cipher suites that you want to add. This parameter is used only when **CipherSuite** is set to **99**.
+   * The custom cipher suites that you want to add. This parameter is available only if you set **CipherSuite** to **99**.
    */
   customCiphers?: string[];
   /**
    * @remarks
    * Specifies whether to support TLS 1.3. Valid values:
    * 
-   * - **true**: supports TLS 1.3.
-   * 
-   * - **false**: does not support TLS 1.3.
+   * *   **true**
+   * *   **false**
    * 
    * @example
    * true
@@ -46,9 +43,9 @@ export class ModifyDefaultHttpsRequest extends $dara.Model {
   enableTLSv3?: boolean;
   /**
    * @remarks
-   * The ID of the WAF instance.
+   * The ID of the Web Application Firewall (WAF) instance.
    * 
-   * > You can call [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) to view the ID of the current WAF instance.
+   * >  You can call the [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) operation to query the ID of the WAF instance.
    * 
    * This parameter is required.
    * 
@@ -60,9 +57,8 @@ export class ModifyDefaultHttpsRequest extends $dara.Model {
    * @remarks
    * The region in which the WAF instance is deployed. Valid values:
    * 
-   * - **cn-hangzhou**: the Chinese mainland.
-   * 
-   * - **ap-southeast-1**: regions outside the Chinese mainland.
+   * *   **cn-hangzhou**: the Chinese mainland.
+   * *   **ap-southeast-1**: outside the Chinese mainland.
    * 
    * @example
    * cn-hangzhou
@@ -70,7 +66,7 @@ export class ModifyDefaultHttpsRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The ID of the Alibaba Cloud resource group.
+   * 阿里云资源组ID。
    * 
    * @example
    * rg-acfm***q
@@ -80,11 +76,9 @@ export class ModifyDefaultHttpsRequest extends $dara.Model {
    * @remarks
    * The version of the TLS protocol. Valid values:
    * 
-   * - **tlsv1**
-   * 
-   * - **tlsv1.1**
-   * 
-   * - **tlsv1.2**
+   * *   **tlsv1**
+   * *   **tlsv1.1**
+   * *   **tlsv1.2**
    * 
    * This parameter is required.
    * 

package/src/models/ModifyDefaultHttpsResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ModifyDefaultHttpsResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The request ID, which is used to locate and troubleshoot issues.
+   * The request ID.
    * 
    * @example
    * 276D7566-31C9-4192-9DD1-***

package/src/models/ModifyDefenseResourceGroupRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ModifyDefenseResourceGroupRequest extends $dara.Model {
   /**
    * @remarks
-   * The protected objects to add to the protected object group. Separate multiple protected objects with commas (,). If this parameter is empty, no protected objects are added to the protected object group.
+   * The protected objects that you want to add to the protected object group. Separate the protected objects with commas (,). If you leave this parameter empty, no protected objects are added to the protected object group.
    * 
    * @example
    * test1.aliyundoc.com,test2.aliyundoc.com
@@ -13,7 +13,7 @@ export class ModifyDefenseResourceGroupRequest extends $dara.Model {
   addList?: string;
   /**
    * @remarks
-   * The protected objects to remove from the protected object group. Separate multiple protected objects with commas (,). If this parameter is empty, no protected objects are removed from the protected object group.
+   * The protected objects that you want to remove from the protected object group. Separate the protected objects with commas (,). If you leave this parameter empty, no protected objects are removed from the protected object group.
    * 
    * @example
    * test14.waf.com,test24.waf.com
@@ -21,7 +21,7 @@ export class ModifyDefenseResourceGroupRequest extends $dara.Model {
   deleteList?: string;
   /**
    * @remarks
-   * The description of the protected object group. The description can be up to 512 characters long.
+   * The description of the protected object group.
    * 
    * @example
    * test
@@ -29,7 +29,7 @@ export class ModifyDefenseResourceGroupRequest extends $dara.Model {
   description?: string;
   /**
    * @remarks
-   * The name of the protected object group to modify.
+   * The name of the protected object group whose configurations you want to modify.
    * 
    * This parameter is required.
    * 
@@ -41,7 +41,7 @@ export class ModifyDefenseResourceGroupRequest extends $dara.Model {
    * @remarks
    * The ID of the Web Application Firewall (WAF) instance.
    * 
-   * > Call the [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) operation to obtain the ID of the current WAF instance.
+   * >  You can call the [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) operation to obtain the ID of the WAF instance.
    * 
    * This parameter is required.
    * 
@@ -51,11 +51,10 @@ export class ModifyDefenseResourceGroupRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The region where the WAF instance is located. Valid values:
+   * The region where the WAF instance resides. Valid values:
    * 
-   * - **cn-hangzhou**: the Chinese mainland.
-   * 
-   * - **ap-southeast-1**: outside the Chinese mainland.
+   * *   **cn-hangzhou:** the Chinese mainland.
+   * *   **ap-southeast-1:** outside the Chinese mainland.
    * 
    * @example
    * cn-hangzhou
@@ -63,7 +62,7 @@ export class ModifyDefenseResourceGroupRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The ID of the Alibaba Cloud resource group.
+   * The ID of the resource group.
    * 
    * @example
    * rg-acfm***q

package/src/models/ModifyDefenseResourceGroupResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ModifyDefenseResourceGroupResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The request ID.
+   * The ID of the request.
    * 
    * @example
    * 2CC1AFDE-BB31-5A2F-906E-92FCBDDE6B75