@alicloud/waf-openapi20211001 6.5.2 → 6.6.1

package/src/models/ModifyCloudResourceRequest.ts

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

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ModifyCloudResourceResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The ID of the resource that is added to WAF.
+   * The ID of the cloud 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 ID of the request.
+   * The request ID.
    * 
    * @example
    * D7861F61-5B61-46CE-A47C-***

package/src/models/ModifyCloudResourceShrinkRequest.ts

@@ -3,12 +3,21 @@ 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.
    * 
-   * >  You can call the [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) operation to query the ID of the WAF instance.
+   * > Call [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) to query the ID of the WAF instance.
    * 
    * This parameter is required.
    * 
@@ -18,22 +27,23 @@ export class ModifyCloudResourceShrinkRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The listener configurations.
+   * The listener configuration.
    * 
    * This parameter is required.
    */
   listenShrink?: string;
   /**
    * @remarks
-   * The forwarding configurations.
+   * The forwarding configuration.
    */
   redirectShrink?: string;
   /**
    * @remarks
-   * The region in which the WAF instance is deployed. Valid values:
+   * The region of the WAF instance. Valid values:
+   * 
+   * - **cn-hangzhou**: the Chinese mainland.
    * 
-   * *   **cn-hangzhou**: the Chinese mainland.
-   * *   **ap-southeast-1**: outside the Chinese mainland.
+   * - **ap-southeast-1**: outside the Chinese mainland.
    * 
    * This parameter is required.
    * 
@@ -43,7 +53,7 @@ export class ModifyCloudResourceShrinkRequest 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/ModifyDefaultHttpsRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ModifyDefaultHttpsRequest extends $dara.Model {
   /**
    * @remarks
-   * The ID of the certificate.
+   * The certificate ID.
    * 
    * This parameter is required.
    * 
@@ -15,11 +15,13 @@ export class ModifyDefaultHttpsRequest extends $dara.Model {
   certId?: string;
   /**
    * @remarks
-   * The type of the cipher suites. Valid values:
+   * The type of the cipher suite. Valid values:
    * 
-   * *   **1**: all cipher suites.
-   * *   **2**: strong cipher suites.
-   * *   **99**: custom cipher suites.
+   * - **1**: adds all cipher suites.
+   * 
+   * - **2**: adds strong cipher suites.
+   * 
+   * - **99**: adds custom cipher suites.
    * 
    * @example
    * 0
@@ -27,15 +29,16 @@ export class ModifyDefaultHttpsRequest extends $dara.Model {
   cipherSuite?: number;
   /**
    * @remarks
-   * The custom cipher suites that you want to add. This parameter is available only if you set **CipherSuite** to **99**.
+   * The custom cipher suites that you want to add. This parameter is used only when **CipherSuite** is set to **99**.
    */
   customCiphers?: string[];
   /**
    * @remarks
    * Specifies whether to support TLS 1.3. Valid values:
    * 
-   * *   **true**
-   * *   **false**
+   * - **true**: supports TLS 1.3.
+   * 
+   * - **false**: does not support TLS 1.3.
    * 
    * @example
    * true
@@ -43,9 +46,9 @@ export class ModifyDefaultHttpsRequest extends $dara.Model {
   enableTLSv3?: boolean;
   /**
    * @remarks
-   * The ID of the Web Application Firewall (WAF) instance.
+   * 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.
+   * > You can call [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) to view the ID of the current WAF instance.
    * 
    * This parameter is required.
    * 
@@ -57,8 +60,9 @@ 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**: outside the Chinese mainland.
+   * - **cn-hangzhou**: the Chinese mainland.
+   * 
+   * - **ap-southeast-1**: regions outside the Chinese mainland.
    * 
    * @example
    * cn-hangzhou
@@ -66,7 +70,7 @@ export class ModifyDefaultHttpsRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * 阿里云资源组ID。
+   * The ID of the Alibaba Cloud resource group.
    * 
    * @example
    * rg-acfm***q
@@ -76,9 +80,11 @@ 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.
+   * The request ID, which is used to locate and troubleshoot issues.
    * 
    * @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 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.
+   * 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.
    * 
    * @example
    * test1.aliyundoc.com,test2.aliyundoc.com
@@ -13,7 +13,7 @@ export class ModifyDefenseResourceGroupRequest extends $dara.Model {
   addList?: string;
   /**
    * @remarks
-   * 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.
+   * 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.
    * 
    * @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 of the protected object group. The description can be up to 512 characters long.
    * 
    * @example
    * test
@@ -29,7 +29,7 @@ export class ModifyDefenseResourceGroupRequest extends $dara.Model {
   description?: string;
   /**
    * @remarks
-   * The name of the protected object group whose configurations you want to modify.
+   * The name of the protected object group 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.
    * 
-   * >  You can call the [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) operation to obtain the ID of the WAF instance.
+   * > Call the [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) operation to obtain the ID of the current WAF instance.
    * 
    * This parameter is required.
    * 
@@ -51,10 +51,11 @@ export class ModifyDefenseResourceGroupRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The region where the WAF instance resides. Valid values:
+   * The region where the WAF instance is located. 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
@@ -62,7 +63,7 @@ export class ModifyDefenseResourceGroupRequest 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/ModifyDefenseResourceGroupResponseBody.ts

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