@alicloud/waf-openapi20211001 6.8.0 → 6.8.2

package/src/models/DescribeSecurityEventTopNmetricRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeSecurityEventTopNMetricRequestFilterConditions extends $dara.Model {
   /**
    * @remarks
-   * The field name. This operation supports all fields. For more information, see the **Supported field names** section below.
+   * The field name on which the filter operation is performed. This operation supports all fields.
    * 
    * @example
    * matched_host
@@ -13,7 +13,7 @@ export class DescribeSecurityEventTopNMetricRequestFilterConditions extends $dar
   key?: string;
   /**
    * @remarks
-   * The operator. For more information, see the **Supported operators** section below.
+   * The operator.
    * 
    * @example
    * eq
@@ -21,7 +21,7 @@ export class DescribeSecurityEventTopNMetricRequestFilterConditions extends $dar
   opValue?: string;
   /**
    * @remarks
-   * The field content.
+   * The filter values.
    * 
    * @example
    * test.waf-top
@@ -55,7 +55,7 @@ export class DescribeSecurityEventTopNMetricRequestFilterConditions extends $dar
 export class DescribeSecurityEventTopNMetricRequestFilterDateRange extends $dara.Model {
   /**
    * @remarks
-   * The end of the time range to query. The value is a Unix timestamp. Unit: seconds.
+   * The end time used for querying data, expressed as a UNIX timestamp. Unit: seconds.
    * 
    * This parameter is required.
    * 
@@ -65,7 +65,11 @@ export class DescribeSecurityEventTopNMetricRequestFilterDateRange extends $dara
   endDate?: number;
   /**
    * @remarks
-   * The beginning of the time range to query. The value is a Unix timestamp. Unit: seconds.
+   * The query data range cannot exceed the past 30 days. The start time used for querying data, expressed as a UNIX timestamp. Unit: seconds.
+   * 
+   * 
+   * > The start time must be later than the current time minus 30 days.
+   * > -
    * 
    * This parameter is required.
    * 
@@ -99,12 +103,12 @@ export class DescribeSecurityEventTopNMetricRequestFilterDateRange extends $dara
 export class DescribeSecurityEventTopNMetricRequestFilter extends $dara.Model {
   /**
    * @remarks
-   * The filter conditions. Each object describes a filter condition.
+   * The list of filter conditions. Each node describes a filter condition.
    */
   conditions?: DescribeSecurityEventTopNMetricRequestFilterConditions[];
   /**
    * @remarks
-   * The time range for the query.
+   * The query time range.
    * 
    * This parameter is required.
    */
@@ -141,16 +145,16 @@ export class DescribeSecurityEventTopNMetricRequestFilter extends $dara.Model {
 export class DescribeSecurityEventTopNMetricRequest extends $dara.Model {
   /**
    * @remarks
-   * The filter conditions for the query. Multiple conditions are evaluated by using a logical AND.
+   * The query filter conditions. Multiple filter conditions are evaluated using a logical AND.
    * 
    * This parameter is required.
    */
   filter?: DescribeSecurityEventTopNMetricRequestFilter;
   /**
    * @remarks
-   * The ID of the Web Application Firewall (WAF) instance.
+   * The ID of the WAF instance.
    * 
-   * >  You can call the [DescribeInstanceInfo](https://help.aliyun.com/document_detail/140857.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 current WAF instance.
    * 
    * This parameter is required.
    * 
@@ -160,7 +164,7 @@ export class DescribeSecurityEventTopNMetricRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The number of data entries that can be returned. Data entries are sorted in descending order before they are returned. Maximum value: 10.
+   * The number of data entries to return after the statistics are sorted in descending order. Maximum value: 10.
    * 
    * This parameter is required.
    * 
@@ -170,25 +174,24 @@ export class DescribeSecurityEventTopNMetricRequest extends $dara.Model {
   limit?: number;
   /**
    * @remarks
-   * The metric whose top N data entries you want to return. The following metrics are supported:
-   * 
-   * >  For more information about attack requests, see the "Operation description" section of this topic.
-   * 
-   * *   real_client_ip: The system aggregates the source IP addresses of attack requests to collect statistics, sorts the statistical results in descending order, and returns top N data entries.
-   * *   http_user_agent: The system aggregates the User-Agent header field of attack requests to collect statistics, sorts the statistical results in descending order, and returns top N data entries.
-   * *   matched_host: The system aggregates the protected objects that are matched by attack requests to collect statistics, sorts the statistical results in descending order, and returns top N data entries.
-   * *   remote_region_id: The system aggregates the countries to which the source IP addresses of attack requests belong to collect statistics, sorts the statistical results in descending order, and returns top N data entries.
-   * *   request_path: The system aggregates the URLs of attack requests to collect statistics, sorts the statistical results in descending order, and returns top N data entries. The URLs exclude query strings.
-   * *   block_defense_scene: The system aggregates the protection modules that block attack requests to collect statistics, sorts the statistical results in descending order, and returns top N data entries. The requests match protection rules whose actions are not set to Monitor.
-   * *   defense_scene: The system aggregates the protection modules that are matched by attack requests to collect statistics, sorts the statistical results in descending order, and returns top N data entries.
-   * *   defense_scene_rule_id: The system returns the IDs of top N protection rules that are matched by attack requests and also the related protection modules. Only protection rules whose actions are not set to Monitor are counted. The system returns the value in the following format:\\
-   *     `{ "Attribute": "waf_base", "Value": 140, "Name": "111034" }`
-   * *   defense_scene_with_rule_id: The system returns the IDs of top N protection rules that are matched by attack requests and also the related protection modules. The IDs and protection modules are connected by using hyphens (-). Protection rules whose actions are set to Monitor and Block are counted. The system returns the value in the following format:\\
-   *     `{ "Attribute": "", "Value": 1, "Name": "120075-waf_base" }`
-   * *   defense_scene_top_rule_id: The system returns top N matched protection rules of a specific protection module. You can specify Conditions in Filter to configure filter conditions. For example, you can use the following condition to query top N matched protection rules of the custom rule module:\\
-   *     `{ "Key": "defense_scene_map", "OpValue": "contain", "Values": "custom_acl" }`
-   * *   defense_scene_rule_type: The system returns top N matched protection rules of the core web protection module. This metric is supported only by the core web protection module because only this module supports subtypes of protection rules. You must specify Conditions in Filter to configure filter conditions. Example:\\
-   *     `{ "Key": "defense_scene", "OpValue": "eq", "Values": "waf_base" }`
+   * Specifies the type of data to return. Different Metric values correspond to different data content. The following Metric values are supported by this API operation:
+   * > The definition of "attack request" is described in the API operation description. The following descriptions reference this concept.
+   * 
+   * - real_client_ip: performs aggregation and sorting of the source IP addresses of attack requests in descending order, and returns the top N entries.
+   * - http_user_agent: performs aggregation and sorting of the User-Agent values of attack requests in descending order, and returns the top N entries.
+   * - matched_host: performs aggregation and sorting of the protected objects hit by attack requests in descending order, and returns the top N entries.
+   * - remote_region_id: performs aggregation and sorting of the countries to which the source IP addresses of attack requests belong in descending order, and returns the top N entries.
+   * - request_path: performs aggregation and sorting of the URLs (excluding query strings) of attack requests in descending order, and returns the top N entries.
+   * - block_defense_scene: performs aggregation and sorting of the final action modules of blocked requests (whose action is not "monitor") in descending order, and returns the top N entries.
+   * - defense_scene: performs aggregation and sorting of all protection modules hit by attack requests in descending order, and returns the top N entries.
+   * - defense_scene_rule_id: queries the top rule IDs of hit non-monitor rules and the protection modules to which the rules belong. This query returns statistics only for non-monitor mode rules. The returned data format is as follows:<br>
+   *  `{ "Attribute": "waf_base", "Value": 140, "Name": "111034" }`
+   * - defense_scene_with_rule_id: returns the top N rule IDs ranked by the number of hit requests and the protection modules to which the rules belong, connected by "-". This query does not distinguish between rule actions and includes both monitor rules and block rules. The returned format is as follows:<br>
+   *  `{ "Attribute": "",  "Value": 1,  "Name": "120075-waf_base" }`
+   * - defense_scene_top_rule_id: queries the top rule hits of a specific protection module. Specify filter conditions in the Conditions field of Filter. For example, to query the top rule hits of the "custom ACL" module, set the Conditions field as follows:<br>
+   *    `{ "Key": "defense_scene_map", "OpValue": "contain", "Values": "custom_acl" }`
+   * - defense_scene_rule_type: queries the top hit rule types of the web core protection module. Only the web core protection module supports this query because only web core protection has rule child classes. Specify filter conditions in the Conditions field of Filter. The format is as follows:<br>
+   * `    { "Key": "defense_scene", "OpValue": "eq", "Values": "waf_base" }`
    * 
    * This parameter is required.
    * 
@@ -198,18 +201,18 @@ export class DescribeSecurityEventTopNMetricRequest extends $dara.Model {
   metric?: string;
   /**
    * @remarks
-   * The region ID of the WAF instance. 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.
    * 
    * @example
-   * ap-southeast-1
+   * cn-hangzhou
    */
   regionId?: string;
   /**
    * @remarks
-   * The ID of the Alibaba Cloud resource group.
+   * The Alibaba Cloud resource group ID.
    * 
    * @example
    * rg-acfm***q

package/src/models/DescribeSecurityEventTopNmetricResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeSecurityEventTopNMetricResponseBodySecurityEventTopNValues extends $dara.Model {
   /**
    * @remarks
-   * The additional information, such as the protection module for a protection rule whose ID is returned.
+   * The additional information, such as the protection module to which a rule ID belongs.
    * 
    * @example
    * waf_base
@@ -13,7 +13,7 @@ export class DescribeSecurityEventTopNMetricResponseBodySecurityEventTopNValues
   attribute?: string;
   /**
    * @remarks
-   * The field value, which varies based on the metric.
+   * The value of a specific field. The meaning varies depending on the queried Metric.
    * 
    * @example
    * 10000
@@ -21,7 +21,7 @@ export class DescribeSecurityEventTopNMetricResponseBodySecurityEventTopNValues
   name?: string;
   /**
    * @remarks
-   * The count for the data entry.
+   * The statistical count used for top N sorting.
    * 
    * @example
    * 1111
@@ -55,7 +55,7 @@ export class DescribeSecurityEventTopNMetricResponseBodySecurityEventTopNValues
 export class DescribeSecurityEventTopNMetricResponseBodyTopNMetaDataDateRange extends $dara.Model {
   /**
    * @remarks
-   * The end of the time range to query. The value is a Unix timestamp. Unit: seconds. This value is the same as the value of EndDate in the request parameters.
+   * The end time used for querying data, expressed as a UNIX timestamp. Unit: seconds. This value is the same as the EndDate in the request parameters.
    * 
    * @example
    * 1713888600
@@ -63,7 +63,7 @@ export class DescribeSecurityEventTopNMetricResponseBodyTopNMetaDataDateRange ex
   endDate?: number;
   /**
    * @remarks
-   * The beginning of the time range to query. The value is a Unix timestamp. Unit: seconds. This value is the same as the value of StartDate in the request parameters.
+   * The start time used for querying data, expressed as a UNIX timestamp. Unit: seconds. This value is the same as the StartDate in the request parameters.
    * 
    * @example
    * 1713888000
@@ -95,12 +95,12 @@ export class DescribeSecurityEventTopNMetricResponseBodyTopNMetaDataDateRange ex
 export class DescribeSecurityEventTopNMetricResponseBodyTopNMetaData extends $dara.Model {
   /**
    * @remarks
-   * The time range that is used for the query.
+   * The time range used for the query.
    */
   dateRange?: DescribeSecurityEventTopNMetricResponseBodyTopNMetaDataDateRange;
   /**
    * @remarks
-   * The unit of the statistics returned. It is fixed as requests.
+   * The unit of the returned statistics.
    * 
    * @example
    * requests
@@ -143,12 +143,12 @@ export class DescribeSecurityEventTopNMetricResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The top N data entries returned.
+   * The array of top N statistics.
    */
   securityEventTopNValues?: DescribeSecurityEventTopNMetricResponseBodySecurityEventTopNValues[];
   /**
    * @remarks
-   * The metadata of the data entries returned.
+   * The metadata of the returned data.
    */
   topNMetaData?: DescribeSecurityEventTopNMetricResponseBodyTopNMetaData;
   static names(): { [key: string]: string } {

package/src/models/DescribeSecurityEventTopNmetricShrinkRequest.ts

@@ -5,16 +5,16 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeSecurityEventTopNMetricShrinkRequest extends $dara.Model {
   /**
    * @remarks
-   * The filter conditions for the query. Multiple conditions are evaluated by using a logical AND.
+   * The query filter conditions. Multiple filter conditions are evaluated using a logical AND.
    * 
    * This parameter is required.
    */
   filterShrink?: string;
   /**
    * @remarks
-   * The ID of the Web Application Firewall (WAF) instance.
+   * The ID of the WAF instance.
    * 
-   * >  You can call the [DescribeInstanceInfo](https://help.aliyun.com/document_detail/140857.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 current WAF instance.
    * 
    * This parameter is required.
    * 
@@ -24,7 +24,7 @@ export class DescribeSecurityEventTopNMetricShrinkRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The number of data entries that can be returned. Data entries are sorted in descending order before they are returned. Maximum value: 10.
+   * The number of data entries to return after the statistics are sorted in descending order. Maximum value: 10.
    * 
    * This parameter is required.
    * 
@@ -34,25 +34,24 @@ export class DescribeSecurityEventTopNMetricShrinkRequest extends $dara.Model {
   limit?: number;
   /**
    * @remarks
-   * The metric whose top N data entries you want to return. The following metrics are supported:
+   * Specifies the type of data to return. Different Metric values correspond to different data content. The following Metric values are supported by this API operation:
+   * > The definition of "attack request" is described in the API operation description. The following descriptions reference this concept.
    * 
-   * >  For more information about attack requests, see the "Operation description" section of this topic.
-   * 
-   * *   real_client_ip: The system aggregates the source IP addresses of attack requests to collect statistics, sorts the statistical results in descending order, and returns top N data entries.
-   * *   http_user_agent: The system aggregates the User-Agent header field of attack requests to collect statistics, sorts the statistical results in descending order, and returns top N data entries.
-   * *   matched_host: The system aggregates the protected objects that are matched by attack requests to collect statistics, sorts the statistical results in descending order, and returns top N data entries.
-   * *   remote_region_id: The system aggregates the countries to which the source IP addresses of attack requests belong to collect statistics, sorts the statistical results in descending order, and returns top N data entries.
-   * *   request_path: The system aggregates the URLs of attack requests to collect statistics, sorts the statistical results in descending order, and returns top N data entries. The URLs exclude query strings.
-   * *   block_defense_scene: The system aggregates the protection modules that block attack requests to collect statistics, sorts the statistical results in descending order, and returns top N data entries. The requests match protection rules whose actions are not set to Monitor.
-   * *   defense_scene: The system aggregates the protection modules that are matched by attack requests to collect statistics, sorts the statistical results in descending order, and returns top N data entries.
-   * *   defense_scene_rule_id: The system returns the IDs of top N protection rules that are matched by attack requests and also the related protection modules. Only protection rules whose actions are not set to Monitor are counted. The system returns the value in the following format:\\
-   *     `{ "Attribute": "waf_base", "Value": 140, "Name": "111034" }`
-   * *   defense_scene_with_rule_id: The system returns the IDs of top N protection rules that are matched by attack requests and also the related protection modules. The IDs and protection modules are connected by using hyphens (-). Protection rules whose actions are set to Monitor and Block are counted. The system returns the value in the following format:\\
-   *     `{ "Attribute": "", "Value": 1, "Name": "120075-waf_base" }`
-   * *   defense_scene_top_rule_id: The system returns top N matched protection rules of a specific protection module. You can specify Conditions in Filter to configure filter conditions. For example, you can use the following condition to query top N matched protection rules of the custom rule module:\\
-   *     `{ "Key": "defense_scene_map", "OpValue": "contain", "Values": "custom_acl" }`
-   * *   defense_scene_rule_type: The system returns top N matched protection rules of the core web protection module. This metric is supported only by the core web protection module because only this module supports subtypes of protection rules. You must specify Conditions in Filter to configure filter conditions. Example:\\
-   *     `{ "Key": "defense_scene", "OpValue": "eq", "Values": "waf_base" }`
+   * - real_client_ip: performs aggregation and sorting of the source IP addresses of attack requests in descending order, and returns the top N entries.
+   * - http_user_agent: performs aggregation and sorting of the User-Agent values of attack requests in descending order, and returns the top N entries.
+   * - matched_host: performs aggregation and sorting of the protected objects hit by attack requests in descending order, and returns the top N entries.
+   * - remote_region_id: performs aggregation and sorting of the countries to which the source IP addresses of attack requests belong in descending order, and returns the top N entries.
+   * - request_path: performs aggregation and sorting of the URLs (excluding query strings) of attack requests in descending order, and returns the top N entries.
+   * - block_defense_scene: performs aggregation and sorting of the final action modules of blocked requests (whose action is not "monitor") in descending order, and returns the top N entries.
+   * - defense_scene: performs aggregation and sorting of all protection modules hit by attack requests in descending order, and returns the top N entries.
+   * - defense_scene_rule_id: queries the top rule IDs of hit non-monitor rules and the protection modules to which the rules belong. This query returns statistics only for non-monitor mode rules. The returned data format is as follows:<br>
+   *  `{ "Attribute": "waf_base", "Value": 140, "Name": "111034" }`
+   * - defense_scene_with_rule_id: returns the top N rule IDs ranked by the number of hit requests and the protection modules to which the rules belong, connected by "-". This query does not distinguish between rule actions and includes both monitor rules and block rules. The returned format is as follows:<br>
+   *  `{ "Attribute": "",  "Value": 1,  "Name": "120075-waf_base" }`
+   * - defense_scene_top_rule_id: queries the top rule hits of a specific protection module. Specify filter conditions in the Conditions field of Filter. For example, to query the top rule hits of the "custom ACL" module, set the Conditions field as follows:<br>
+   *    `{ "Key": "defense_scene_map", "OpValue": "contain", "Values": "custom_acl" }`
+   * - defense_scene_rule_type: queries the top hit rule types of the web core protection module. Only the web core protection module supports this query because only web core protection has rule child classes. Specify filter conditions in the Conditions field of Filter. The format is as follows:<br>
+   * `    { "Key": "defense_scene", "OpValue": "eq", "Values": "waf_base" }`
    * 
    * This parameter is required.
    * 
@@ -62,18 +61,18 @@ export class DescribeSecurityEventTopNMetricShrinkRequest extends $dara.Model {
   metric?: string;
   /**
    * @remarks
-   * The region ID of the WAF instance. 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.
    * 
    * @example
-   * ap-southeast-1
+   * cn-hangzhou
    */
   regionId?: string;
   /**
    * @remarks
-   * The ID of the Alibaba Cloud resource group.
+   * The Alibaba Cloud resource group ID.
    * 
    * @example
    * rg-acfm***q

package/src/models/DescribeSensitiveApiStatisticRequest.ts

@@ -6,7 +6,7 @@ export class DescribeSensitiveApiStatisticRequest extends $dara.Model {
   /**
    * @remarks
    * The ID of the hybrid cloud cluster.
-   * >For hybrid cloud scenarios only, you can call the [DescribeHybridCloudClusters](https://help.aliyun.com/document_detail/2849376.html) operation to query the hybrid cloud clusters.
+   * > This parameter applies only to hybrid cloud scenarios. You can call [DescribeHybridCloudClusters](https://help.aliyun.com/document_detail/2849376.html) to obtain hybrid cloud cluster information.
    * 
    * @example
    * 269
@@ -14,9 +14,9 @@ export class DescribeSensitiveApiStatisticRequest extends $dara.Model {
   clusterId?: string;
   /**
    * @remarks
-   * The end of the time range to query. The value is a UNIX timestamp displayed in UTC. Unit: seconds.
+   * The end of the time range to query. The value is a UNIX timestamp (UTC) in seconds.
    * 
-   * >  You can query only data of the previous month, previous 3 months, previous 6 months, previous 12 months, and data generated since January 1 of last year for compliance check. You must specify a valid time range.
+   * > Compliance review currently supports querying data only for the last 1 month, last 3 months, last 6 months, last 12 months, or from January 1 of the previous year to the present. Make sure the time range is valid.
    * 
    * @example
    * 1725966000
@@ -26,7 +26,7 @@ export class DescribeSensitiveApiStatisticRequest 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 current WAF instance.
    * 
    * This parameter is required.
    * 
@@ -36,7 +36,7 @@ export class DescribeSensitiveApiStatisticRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The domain name or IP address of the API.
+   * The domain name or IP address to which the API operation belongs.
    * 
    * @example
    * a.***.com
@@ -44,7 +44,7 @@ export class DescribeSensitiveApiStatisticRequest extends $dara.Model {
   matchedHost?: string;
   /**
    * @remarks
-   * The page number. Default value: **1**.
+   * The page number to return in a paged query. Default value: **1**, which indicates the first page.
    * 
    * @example
    * 1
@@ -52,7 +52,7 @@ export class DescribeSensitiveApiStatisticRequest extends $dara.Model {
   pageNumber?: number;
   /**
    * @remarks
-   * The number of entries per page. Default value: **10**.
+   * The number of entries per page in a paged query. Default value: **10**, which indicates 10 entries per page.
    * 
    * @example
    * 10
@@ -60,10 +60,11 @@ export class DescribeSensitiveApiStatisticRequest extends $dara.Model {
   pageSize?: number;
   /**
    * @remarks
-   * The region in which the Web Application Firewall (WAF) instance is deployed. 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
@@ -79,14 +80,26 @@ export class DescribeSensitiveApiStatisticRequest extends $dara.Model {
   resourceManagerResourceGroupId?: string;
   /**
    * @remarks
-   * The beginning of the time range to query. The value is a UNIX timestamp displayed in UTC. Unit: seconds.
-   * 
-   * >  You can query only data of the previous month, previous 3 months, previous 6 months, previous 12 months, and data generated since January 1 of last year for compliance check. You must specify a valid time range.
+   * The beginning of the time range to query. The value is a UNIX timestamp (UTC) in seconds.
+   * > Compliance review currently supports querying data only for the last 1 month, last 3 months, last 6 months, last 12 months, or from January 1 of the previous year to the present. Make sure the time range is valid.
    * 
    * @example
    * 1672502400
    */
   startTime?: number;
+  /**
+   * @remarks
+   * The dimension for statistics. Valid values:
+   * 
+   * - **matchedHost** (default): statistics by domain name.
+   * 
+   * - **apiFormat**: statistics by API operation.
+   * 
+   * > When the **apiFormat** dimension is used, specify the corresponding domain name in the **MatchedHost** parameter.
+   * 
+   * @example
+   * matchedHost
+   */
   type?: string;
   static names(): { [key: string]: string } {
     return {

package/src/models/DescribeSensitiveApiStatisticResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeSensitiveApiStatisticResponseBodyDataList extends $dara.Model {
   /**
    * @remarks
-   * The API.
+   * The API operation.
    * 
    * @example
    * /api/login
@@ -13,7 +13,7 @@ export class DescribeSensitiveApiStatisticResponseBodyDataList extends $dara.Mod
   apiFormat?: string;
   /**
    * @remarks
-   * The ID of the API.
+   * The ID of the API operation.
    * 
    * @example
    * d288137009c119a873d4c395****
@@ -21,7 +21,7 @@ export class DescribeSensitiveApiStatisticResponseBodyDataList extends $dara.Mod
   apiId?: string;
   /**
    * @remarks
-   * The number of personal information records involved in cross-border data transfer by API.
+   * The number of outbound personal information entries at the API level.
    * 
    * @example
    * 78
@@ -29,12 +29,12 @@ export class DescribeSensitiveApiStatisticResponseBodyDataList extends $dara.Mod
   infoCount?: number;
   /**
    * @remarks
-   * The types of sensitive data.
+   * The list of sensitive data types.
    */
   sensitiveCode?: string[];
   /**
    * @remarks
-   * The number of sensitive personal information records involved in cross-border data transfer by API.
+   * The number of outbound sensitive personal information items at the API level.
    * 
    * @example
    * 55
@@ -75,7 +75,7 @@ export class DescribeSensitiveApiStatisticResponseBodyDataList extends $dara.Mod
 export class DescribeSensitiveApiStatisticResponseBodyData extends $dara.Model {
   /**
    * @remarks
-   * The number of personal information records involved in cross-border data transfer by domain name.
+   * The number of outbound personal information entries at the domain name level.
    * 
    * @example
    * 213
@@ -83,7 +83,9 @@ export class DescribeSensitiveApiStatisticResponseBodyData extends $dara.Model {
   infoOutboundCount?: number;
   /**
    * @remarks
-   * The domain name-related APIs.
+   * The list of API operation statistics information under the domain name.
+   * 
+   * > This field is returned only when the **Type** parameter is set to **apiFormat**, which represents the API dimension statistics information.
    */
   list?: DescribeSensitiveApiStatisticResponseBodyDataList[];
   /**
@@ -96,7 +98,7 @@ export class DescribeSensitiveApiStatisticResponseBodyData extends $dara.Model {
   matchedHost?: string;
   /**
    * @remarks
-   * The number of sensitive personal information records involved in cross-border data transfer by domain name.
+   * The number of outbound sensitive personal information items at the domain name level.
    * 
    * @example
    * 127
@@ -135,7 +137,7 @@ export class DescribeSensitiveApiStatisticResponseBodyData extends $dara.Model {
 export class DescribeSensitiveApiStatisticResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The statistics.
+   * The statistics list.
    */
   data?: DescribeSensitiveApiStatisticResponseBodyData[];
   /**

package/src/models/DescribeSensitiveDetectionResultRequest.ts

@@ -5,8 +5,8 @@ import * as $dara from '@darabonba/typescript';
 export class DescribeSensitiveDetectionResultRequest extends $dara.Model {
   /**
    * @remarks
-   * The ID of the hybrid cloud cluster.
-   * >For hybrid cloud scenarios only, you can call the [DescribeHybridCloudClusters](https://help.aliyun.com/document_detail/2849376.html) operation to query the hybrid cloud clusters.
+   * The hybrid cloud cluster ID.
+   * > This parameter applies only to hybrid cloud scenarios. You can call [DescribeHybridCloudClusters](https://help.aliyun.com/document_detail/2849376.html) to obtain hybrid cloud cluster information.
    * 
    * @example
    * 428
@@ -14,7 +14,7 @@ export class DescribeSensitiveDetectionResultRequest extends $dara.Model {
   clusterId?: string;
   /**
    * @remarks
-   * The end of the time range to query. This value is a UNIX timestamp in UTC. Unit: seconds.
+   * The end of the time range to query. The value is a UNIX timestamp (UTC). Unit: seconds.
    * 
    * @example
    * 1725966000
@@ -24,7 +24,7 @@ export class DescribeSensitiveDetectionResultRequest 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 current WAF instance.
    * 
    * This parameter is required.
    * 
@@ -34,10 +34,11 @@ export class DescribeSensitiveDetectionResultRequest extends $dara.Model {
   instanceId?: string;
   /**
    * @remarks
-   * The region in which the Web Application Firewall (WAF) instance is deployed. 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
@@ -45,7 +46,7 @@ export class DescribeSensitiveDetectionResultRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The ID of the Alibaba Cloud resource group.
+   * The Alibaba Cloud resource group ID.
    * 
    * @example
    * rg-acfm***q
@@ -53,7 +54,7 @@ export class DescribeSensitiveDetectionResultRequest extends $dara.Model {
   resourceManagerResourceGroupId?: string;
   /**
    * @remarks
-   * The beginning of the time range to query. This value is a UNIX timestamp in UTC. Unit: seconds.
+   * The beginning of the time range to query. The value is a UNIX timestamp (UTC). Unit: seconds.
    * 
    * @example
    * 1672502400