@alicloud/waf-openapi20211001 6.8.1 → 6.8.2

package/src/models/CreateCloudResourceRequest.ts

@@ -7,10 +7,11 @@ import * as $dara from '@darabonba/typescript';
 export class CreateCloudResourceRequestListenCertificates extends $dara.Model {
   /**
    * @remarks
-   * The type of the certificate. Valid values:
+   * The certificate type for the HTTPS protocol. Valid values:
    * 
-   * *   **default**: default certificate.
-   * *   **extension**: additional certificate.
+   * - **default**: default certificate.
+   * 
+   * - **extension**: extended certificate.
    * 
    * @example
    * default
@@ -18,9 +19,9 @@ export class CreateCloudResourceRequestListenCertificates extends $dara.Model {
   appliedType?: string;
   /**
    * @remarks
-   * The ID of the certificate that you want to add.
+   * The ID of the certificate to add.
    * 
-   * >  You can call the [DescribeCertificates](https://help.aliyun.com/document_detail/160783.html) operation to query the IDs of all SSL certificates that are associated with a domain name.
+   * > You can call [DescribeResourceInstanceCerts](https://help.aliyun.com/document_detail/2718120.html) to query the IDs of all SSL certificates associated with the cloud service instance.
    * 
    * @example
    * 123-cn-hangzhou
@@ -52,16 +53,18 @@ export class CreateCloudResourceRequestListenCertificates extends $dara.Model {
 export class CreateCloudResourceRequestListen extends $dara.Model {
   /**
    * @remarks
-   * The certificates.
+   * The list of certificate IDs.
    */
   certificates?: CreateCloudResourceRequestListenCertificates[];
   /**
    * @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 cipher suite to add. This parameter is used only when **HttpsPorts** is not empty, which indicates that the domain name uses HTTPS. Valid values:
+   * 
+   * - **1**: 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**: strong cipher suites. This value is valid only when **TLSVersion** is set to **tlsv1.2**.
+   * 
+   * - **99**: custom cipher suites.
    * 
    * @example
    * 1
@@ -69,16 +72,17 @@ export class CreateCloudResourceRequestListen 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 specific custom cipher suites to add. This parameter is used only when **CipherSuite** is set to **99**.
    */
   customCiphers?: string[];
   domain?: string;
   /**
    * @remarks
-   * Specifies whether to support TLS 1.3. This parameter is available only if you specify **HttpsPorts**. Valid values:
+   * Specifies whether TLS 1.3 is supported. This parameter is used only when **HttpsPorts** is not empty, which indicates that the domain name uses HTTPS. Valid values:
+   * 
+   * - **true**: TLS 1.3 is supported.
    * 
-   * *   **true**
-   * *   **false**
+   * - **false**: TLS 1.3 is not supported.
    * 
    * @example
    * true
@@ -89,10 +93,11 @@ export class CreateCloudResourceRequestListen extends $dara.Model {
   enableTLSv3?: boolean;
   /**
    * @remarks
-   * Specifies whether to enable HTTP/2. This parameter is available only if you specify **HttpsPorts**. Valid values:
+   * Specifies whether to enable HTTP/2. This parameter is used only when **HttpsPorts** is not empty, which indicates that the domain name uses HTTPS. Valid values:
    * 
-   * *   **true**
-   * *   **false** (default)
+   * - **true**: HTTP/2 is enabled.
+   * 
+   * - **false** (default): HTTP/2 is not enabled.
    * 
    * @example
    * true
@@ -100,7 +105,7 @@ export class CreateCloudResourceRequestListen extends $dara.Model {
   http2Enabled?: boolean;
   /**
    * @remarks
-   * The port of the cloud service.
+   * The port of the cloud service connected to WAF.
    * 
    * @example
    * 80
@@ -109,9 +114,8 @@ export class CreateCloudResourceRequestListen extends $dara.Model {
   /**
    * @remarks
    * The protocol type. Valid values:
-   * 
-   * *   **http**
-   * *   **https**
+   * - **http**: HTTP.
+   * - **https**: HTTPS.
    * 
    * @example
    * http
@@ -119,7 +123,7 @@ export class CreateCloudResourceRequestListen extends $dara.Model {
   protocol?: string;
   /**
    * @remarks
-   * The instance ID of the cloud service.
+   * The ID of the cloud service instance.
    * 
    * @example
    * lb-bp1*****
@@ -127,12 +131,14 @@ export class CreateCloudResourceRequestListen extends $dara.Model {
   resourceInstanceId?: string;
   /**
    * @remarks
-   * The type of the cloud service that you want to add. Valid values:
+   * The cloud service type. Valid values:
+   * 
+   * - **clb4**: Layer 4 CLB.
    * 
-   * *   **clb4**: Layer 4 CLB.
-   * *   **clb7**: Layer 7 CLB.
-   * *   **ecs**: ECS.
-   * *   **nlb**: Network Load Balancer (NLB).
+   * - **clb7**: Layer 7 CLB.
+   * 
+   * - **ecs**: ECS.
+   * - **nlb**: NLB.
    * 
    * This parameter is required.
    * 
@@ -140,14 +146,24 @@ export class CreateCloudResourceRequestListen extends $dara.Model {
    * clb4
    */
   resourceProduct?: string;
-  resourceRegionId?: 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 region ID of the cloud service.
+   * 
    * 
-   * *   **tlsv1**
-   * *   **tlsv1.1**
-   * *   **tlsv1.2**
+   * 
+   * > This parameter is required when the instance ID to be connected has not been synchronized to WAF.
+   * 
+   * @example
+   * cn-hangzhou
+   */
+  resourceRegionId?: string;
+  /**
+   * @remarks
+   * The TLS version to add. This parameter is used only when **HttpsPorts** is not empty, which indicates that the domain name uses HTTPS. Valid values:
+   * - **tlsv1**
+   * - **tlsv1.1**
+   * - **tlsv1.2**
    * 
    * @example
    * tlsv1
@@ -205,7 +221,7 @@ export class CreateCloudResourceRequestListen extends $dara.Model {
 export class CreateCloudResourceRequestRedirectRequestHeaders extends $dara.Model {
   /**
    * @remarks
-   * The key of the custom header field.
+   * The custom request header field.
    * 
    * @example
    * key1
@@ -213,7 +229,7 @@ export class CreateCloudResourceRequestRedirectRequestHeaders extends $dara.Mode
   key?: string;
   /**
    * @remarks
-   * The value of the custom header field.
+   * The value of the custom request header field.
    * 
    * @example
    * value1
@@ -245,10 +261,11 @@ export class CreateCloudResourceRequestRedirectRequestHeaders extends $dara.Mode
 export class CreateCloudResourceRequestRedirect extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to enable the persistent connection feature. Valid values:
+   * Specifies whether to enable persistent connections. Valid values:
+   * 
+   * - **true** (default): Persistent connections are enabled.
    * 
-   * *   **true** (default)
-   * *   **false**
+   * - **false**: Persistent connections are not enabled.
    * 
    * @example
    * true
@@ -256,9 +273,9 @@ export class CreateCloudResourceRequestRedirect extends $dara.Model {
   keepalive?: boolean;
   /**
    * @remarks
-   * The number of reused persistent connections. Valid values: 60 to 1000.
+   * The number of requests that can reuse a persistent connection. Valid values: 60 to 1000.
    * 
-   * >  This parameter specifies the number of persistent connections that can be reused after you enable the persistent connection feature.
+   * > After persistent connections are enabled, this parameter specifies how many requests can reuse a persistent connection.
    * 
    * @example
    * 1000
@@ -266,22 +283,27 @@ export class CreateCloudResourceRequestRedirect extends $dara.Model {
   keepaliveRequests?: number;
   /**
    * @remarks
-   * The timeout period of idle persistent connections. Valid values: 10 to 3600. Default value: 3600. Unit: seconds.
+   * The idle timeout period for 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.
+   * > Specifies how long an idle persistent connection can remain open before it is released.
    * 
    * @example
-   * 15
+   * 3600
    */
   keepaliveTimeout?: number;
   /**
+   * @remarks
+   * The maximum request body size. Valid values: 2 to 10. Default value: 2. Unit: GB.
+   * > Only Ultimate Edition is supported.
+   * 
    * @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
@@ -289,14 +311,15 @@ export class CreateCloudResourceRequestRedirect extends $dara.Model {
   readTimeout?: number;
   /**
    * @remarks
-   * The custom header fields. Specify the value in the [**{"k":"*key*","v":"*value*"}**] format. ***key*** specifies the key of a custom header field. ***value*** specifies the value of a custom header field.
+   * The value of this parameter is in the format of [**{"k":"_key_","v":"_value_"}**], where **_key_** specifies the custom request header field and **_value_** specifies the value of the field.
    * 
-   * >  If a request contains a custom header field, WAF overwrites the original value of the field with the specified value.
+   * > If the custom header field already exists in the request, the system overwrites the value of the field with the specified traffic mark value.
    */
   requestHeaders?: CreateCloudResourceRequestRedirectRequestHeaders[];
   /**
    * @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
@@ -304,11 +327,13 @@ export class CreateCloudResourceRequestRedirect 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 originating IP address of the client. Valid values:
+   * 
+   * - **0**: No Layer 7 proxy is deployed in front of 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 field as the client IP address.
+   * 
+   * - **2**: WAF reads the value of a custom header field that you specify as the client IP address.
    * 
    * @example
    * 1
@@ -316,17 +341,18 @@ export class CreateCloudResourceRequestRedirect 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 list of custom header fields used to obtain the client IP address, in the format of [**"header1","header2",...**].
    * 
-   * >  This parameter is required only if you set **XffHeaderMode** to 2.
+   * > This parameter is required only when **XffHeaderMode** is set to 2, which indicates that WAF reads the value of a custom header field as the client IP address.
    */
   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:
+   * Specifies whether to use X-Forward-For-Proto to pass the protocol used by WAF. Valid values:
+   * 
+   * - **true** (default): The protocol used by WAF is passed.
    * 
-   * *   **true** (default)
-   * *   **false**
+   * - **false**: The protocol used by WAF is not passed.
    * 
    * @example
    * true
@@ -380,7 +406,7 @@ export class CreateCloudResourceRequestRedirect extends $dara.Model {
 export class CreateCloudResourceRequestTag extends $dara.Model {
   /**
    * @remarks
-   * The key of the tag.
+   * The tag key.
    * 
    * @example
    * TagKey1
@@ -388,7 +414,7 @@ export class CreateCloudResourceRequestTag extends $dara.Model {
   key?: string;
   /**
    * @remarks
-   * The value of the tag.
+   * The tag value.
    * 
    * @example
    * TagValue1
@@ -422,7 +448,7 @@ export class CreateCloudResourceRequest extends $dara.Model {
    * @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.
+   * > You can call [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) to query the ID of the WAF instance.
    * 
    * This parameter is required.
    * 
@@ -432,14 +458,14 @@ export class CreateCloudResourceRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The listener configurations.
+   * The listener configuration.
    * 
    * This parameter is required.
    */
   listen?: CreateCloudResourceRequestListen;
   /**
    * @remarks
-   * The ID of the Alibaba Cloud account to which the resource belongs.
+   * The UID that indicates the resource ownership.
    * 
    * @example
    * 123
@@ -447,15 +473,16 @@ export class CreateCloudResourceRequest extends $dara.Model {
   ownerUserId?: string;
   /**
    * @remarks
-   * The forwarding configurations.
+   * The forwarding configuration.
    */
   redirect?: CreateCloudResourceRequestRedirect;
   /**
    * @remarks
-   * The region in which the WAF instance is deployed. Valid values:
+   * The region where the WAF instance is deployed. 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.
    * 
@@ -465,7 +492,7 @@ export class CreateCloudResourceRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The ID of the Alibaba Cloud resource group.
+   * The Alibaba Cloud resource group ID.
    * 
    * @example
    * rg-acfm***q
@@ -473,7 +500,7 @@ export class CreateCloudResourceRequest extends $dara.Model {
   resourceManagerResourceGroupId?: string;
   /**
    * @remarks
-   * The tags. You can specify up to 20 tags.
+   * The list of tags. A maximum of 20 tags can be specified.
    */
   tag?: CreateCloudResourceRequestTag[];
   static names(): { [key: string]: string } {

package/src/models/CreateCloudResourceResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CreateCloudResourceResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The ID of the resource that is added to WAF. The ID is automatically generated.
+   * The ID of the connected resource, which is automatically generated by WAF.
    * 
    * @example
    * lb-***

package/src/models/CreateCloudResourceShrinkRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CreateCloudResourceShrinkRequestTag extends $dara.Model {
   /**
    * @remarks
-   * The key of the tag.
+   * The tag key.
    * 
    * @example
    * TagKey1
@@ -13,7 +13,7 @@ export class CreateCloudResourceShrinkRequestTag extends $dara.Model {
   key?: string;
   /**
    * @remarks
-   * The value of the tag.
+   * The tag value.
    * 
    * @example
    * TagValue1
@@ -47,7 +47,7 @@ export class CreateCloudResourceShrinkRequest extends $dara.Model {
    * @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.
+   * > You can call [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) to query the ID of the WAF instance.
    * 
    * This parameter is required.
    * 
@@ -57,14 +57,14 @@ export class CreateCloudResourceShrinkRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The listener configurations.
+   * The listener configuration.
    * 
    * This parameter is required.
    */
   listenShrink?: string;
   /**
    * @remarks
-   * The ID of the Alibaba Cloud account to which the resource belongs.
+   * The UID that indicates the resource ownership.
    * 
    * @example
    * 123
@@ -72,15 +72,16 @@ export class CreateCloudResourceShrinkRequest extends $dara.Model {
   ownerUserId?: string;
   /**
    * @remarks
-   * The forwarding configurations.
+   * The forwarding configuration.
    */
   redirectShrink?: string;
   /**
    * @remarks
-   * The region in which the WAF instance is deployed. Valid values:
+   * The region where 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**: outside the Chinese mainland.
    * 
    * This parameter is required.
    * 
@@ -90,7 +91,7 @@ export class CreateCloudResourceShrinkRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The ID of the Alibaba Cloud resource group.
+   * The Alibaba Cloud resource group ID.
    * 
    * @example
    * rg-acfm***q
@@ -98,7 +99,7 @@ export class CreateCloudResourceShrinkRequest extends $dara.Model {
   resourceManagerResourceGroupId?: string;
   /**
    * @remarks
-   * The tags. You can specify up to 20 tags.
+   * The list of tags. A maximum of 20 tags can be specified.
    */
   tag?: CreateCloudResourceShrinkRequestTag[];
   static names(): { [key: string]: string } {

package/src/models/CreateDefenseResourceGroupRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CreateDefenseResourceGroupRequest extends $dara.Model {
   /**
    * @remarks
-   * The protected objects that you want to add to the protected object group. You can add multiple protected objects to a protected object group at the same time. You can specify multiple protected objects. Separate them with commas (,).
+   * The protected objects to add to the protected object group. You can add multiple protected objects. Separate them with commas (,).
    * 
    * @example
    * test1.aliyundoc.com,test2.aliyundoc.com
@@ -13,7 +13,7 @@ export class CreateDefenseResourceGroupRequest extends $dara.Model {
   addList?: 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_domain
@@ -21,7 +21,7 @@ export class CreateDefenseResourceGroupRequest extends $dara.Model {
   description?: string;
   /**
    * @remarks
-   * The name of the protected object group that you want to create.
+   * The name of the protected object group. The name must be 1 to 255 characters long and can contain Chinese characters, letters, digits, underscores (_), periods (.), and hyphens (-).
    * 
    * This parameter is required.
    * 
@@ -31,9 +31,9 @@ export class CreateDefenseResourceGroupRequest extends $dara.Model {
   groupName?: string;
   /**
    * @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 obtain the ID of the WAF instance.
+   * > Call the [DescribeInstance](https://help.aliyun.com/document_detail/433756.html) operation to view the ID of the WAF instance.
    * 
    * This parameter is required.
    * 
@@ -43,10 +43,11 @@ export class CreateDefenseResourceGroupRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The region of the WAF instance. Valid values:
+   * The region where the WAF instance resides. Valid values:
    * 
-   * *   **cn-hangzhou**: Chinese mainland.
-   * *   **ap-southeast-1**: Outside the Chinese mainland.
+   * - **cn-hangzhou**: the Chinese mainland.
+   * 
+   * - **ap-southeast-1**: outside the Chinese mainland.
    * 
    * @example
    * cn-hangzhou
@@ -54,7 +55,7 @@ export class CreateDefenseResourceGroupRequest 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/CreateDefenseResourceGroupResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CreateDefenseResourceGroupResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The ID of the request.
+   * The request ID.
    * 
    * @example
    * 5D69B341-4F97-58E7-9E16-1B17FE7A9E98