@alicloud/esa20240910 3.4.0 → 3.5.0

package/dist/client.js

@@ -363,7 +363,7 @@ class Client extends openapi_core_1.default {
         return await this.batchCreateRecordsWithOptions(request, runtime);
     }
     /**
-     * This operation creates multiple WAF rules and configures their shared settings in a single request.
+     * Batch creates rules in a specified WAF phase. You can create multiple rules at a time and configure shared settings for these rules.
      *
      * @param tmpReq - BatchCreateWafRulesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -417,7 +417,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.BatchCreateWafRulesResponse({}));
     }
     /**
-     * This operation creates multiple WAF rules and configures their shared settings in a single request.
+     * Batch creates rules in a specified WAF phase. You can create multiple rules at a time and configure shared settings for these rules.
      *
      * @param request - BatchCreateWafRulesRequest
      * @returns BatchCreateWafRulesResponse
@@ -1004,7 +1004,7 @@ class Client extends openapi_core_1.default {
         return batchPutKvWithHighCapacityResp;
     }
     /**
-     * Updates the configurations of multiple rules in a specified WAF ruleset.
+     * Batch updates rules in a specified WAF ruleset. You can use this operation to update the configurations of multiple rules at a time.
      *
      * @param tmpReq - BatchUpdateWafRulesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1058,7 +1058,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.BatchUpdateWafRulesResponse({}));
     }
     /**
-     * Updates the configurations of multiple rules in a specified WAF ruleset.
+     * Batch updates rules in a specified WAF ruleset. You can use this operation to update the configurations of multiple rules at a time.
      *
      * @param request - BatchUpdateWafRulesRequest
      * @returns BatchUpdateWafRulesResponse
@@ -1261,7 +1261,8 @@ class Client extends openapi_core_1.default {
         return await this.checkUserProjectNameWithOptions(request, runtime);
     }
     /**
-     * Submits the test version (unstable) code of an Edge Routine and generates a production version.
+     * Submits the staging (unstable) code of an Edge Routine and generates a production version.
+     * Prerequisite: Before calling this API operation, call GetRoutineStagingCodeUploadInfo to obtain OSS upload credentials. Upload the code file through OSS POST. After the upload callback succeeds, call this API operation to submit the code.
      *
      * @param request - CommitRoutineStagingCodeRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1296,7 +1297,8 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CommitRoutineStagingCodeResponse({}));
     }
     /**
-     * Submits the test version (unstable) code of an Edge Routine and generates a production version.
+     * Submits the staging (unstable) code of an Edge Routine and generates a production version.
+     * Prerequisite: Before calling this API operation, call GetRoutineStagingCodeUploadInfo to obtain OSS upload credentials. Upload the code file through OSS POST. After the upload callback succeeds, call this API operation to submit the code.
      *
      * @param request - CommitRoutineStagingCodeRequest
      * @returns CommitRoutineStagingCodeResponse
@@ -1429,7 +1431,7 @@ class Client extends openapi_core_1.default {
         return await this.createCacheRuleWithOptions(request, runtime);
     }
     /**
-     * Uses the ESA-managed certificate authority (CA) to issue client certificates.
+     * Issues a client certificate by using the ESA certificate authority (CA).
      *
      * @param request - CreateClientCertificateRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1469,7 +1471,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateClientCertificateResponse({}));
     }
     /**
-     * Uses the ESA-managed certificate authority (CA) to issue client certificates.
+     * Issues a client certificate by using the ESA certificate authority (CA).
      *
      * @param request - CreateClientCertificateRequest
      * @returns CreateClientCertificateResponse
@@ -2484,7 +2486,7 @@ class Client extends openapi_core_1.default {
         return await this.createKvNamespaceWithOptions(request, runtime);
     }
     /**
-     * Creates a list. Lists are used for the referencing of values in the rules engine to implement complex logic and control in security policies.
+     * Creates a custom list. Custom lists are typically referenced by the rule matching engine for values used in various security policies to implement complex logic and control.
      *
      * @param tmpReq - CreateListRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2527,7 +2529,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateListResponse({}));
     }
     /**
-     * Creates a list. Lists are used for the referencing of values in the rules engine to implement complex logic and control in security policies.
+     * Creates a custom list. Custom lists are typically referenced by the rule matching engine for values used in various security policies to implement complex logic and control.
      *
      * @param request - CreateListRequest
      * @returns CreateListResponse
@@ -2537,10 +2539,11 @@ class Client extends openapi_core_1.default {
         return await this.createListWithOptions(request, runtime);
     }
     /**
-     * Creates a new Server Load Balancer instance with advanced features, including custom routing, session persistence, and health check configuration.
+     * Creates a load balancer instance that supports custom routing policies, session persistence, monitoring configurations, and other advanced features.
      *
      * @remarks
-     * Use this API to configure Server Load Balancer features for effective traffic management and optimization, such as adaptive routing, weighted round-robin, rule matching, and health checks.
+     * Creates a load balancing service based on your business requirements. You can configure settings such as adaptive routing, weighted polling, rule matching, and health checks to effectively manage and optimize traffic.
+     * Only Enterprise plans support the load balancing service. To use this feature, contact Alibaba Cloud sales to apply for an Enterprise plan.
      *
      * @param tmpReq - CreateLoadBalancerRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2628,10 +2631,11 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateLoadBalancerResponse({}));
     }
     /**
-     * Creates a new Server Load Balancer instance with advanced features, including custom routing, session persistence, and health check configuration.
+     * Creates a load balancer instance that supports custom routing policies, session persistence, monitoring configurations, and other advanced features.
      *
      * @remarks
-     * Use this API to configure Server Load Balancer features for effective traffic management and optimization, such as adaptive routing, weighted round-robin, rule matching, and health checks.
+     * Creates a load balancing service based on your business requirements. You can configure settings such as adaptive routing, weighted polling, rule matching, and health checks to effectively manage and optimize traffic.
+     * Only Enterprise plans support the load balancing service. To use this feature, contact Alibaba Cloud sales to apply for an Enterprise plan.
      *
      * @param request - CreateLoadBalancerRequest
      * @returns CreateLoadBalancerResponse
@@ -2919,7 +2923,7 @@ class Client extends openapi_core_1.default {
         return await this.createOriginRuleWithOptions(request, runtime);
     }
     /**
-     * Creates a custom error page. This page appears when the web application firewall (WAF) blocks a user request. You can configure the page\\"s HTML content, content type, and description, and submit the page content using BASE64 encoding.
+     * Creates a custom error response page. When a user request is blocked by Web Application Firewall (WAF), these custom error pages can be displayed. You can configure the page HTML content, page type, description, and other information, and submit the page content in BASE64 encoding.
      *
      * @param tmpReq - CreatePageRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2965,7 +2969,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreatePageResponse({}));
     }
     /**
-     * Creates a custom error page. This page appears when the web application firewall (WAF) blocks a user request. You can configure the page\\"s HTML content, content type, and description, and submit the page content using BASE64 encoding.
+     * Creates a custom error response page. When a user request is blocked by Web Application Firewall (WAF), these custom error pages can be displayed. You can configure the page HTML content, page type, description, and other information, and submit the page content in BASE64 encoding.
      *
      * @param request - CreatePageRequest
      * @returns CreatePageResponse
@@ -4046,18 +4050,18 @@ class Client extends openapi_core_1.default {
         return await this.createUserDeliveryTaskWithOptions(request, runtime);
     }
     /**
-     * Creates an instance-level Web Application Firewall (WAF) ruleset that supports various types of protection rules.
+     * Creates an instance-level Web Application Firewall (WAF) ruleset that supports multiple types of protection rules.
      *
      * @remarks
-     * ## Description
-     * - You can use this API to create a Web Application Firewall (WAF) ruleset for a specific instance.
-     * - The required `InstanceId` parameter specifies the instance for which to create the ruleset.
-     * - The `Phase` parameter defines the execution phase of the ruleset, such as a custom rule or rate limiting.
-     * - The required `Name` and `Expression` parameters specify the ruleset\\"s name and match expression.
-     * - The optional `Description` parameter describes the purpose of the ruleset.
-     * - The `Status` parameter controls whether the ruleset is immediately enabled (`on`) or disabled (`off`).
-     * - Use the `Rules` parameter to configure a detailed rule list. Each rule includes properties such as name, position, expression, and action.
-     * - A successful response returns the unique ID of the new ruleset in `Id` and a list of associated rule IDs in `RuleIds`.
+     * ## Operation description
+     * - This API operation allows you to create a WAF ruleset for a specified instance.
+     * - InstanceId is a required parameter that specifies the instance for which you want to create the ruleset.
+     * - The Phase parameter defines the phase in which the ruleset is applied, such as custom rules or rate limiting.
+     * - Name and Expression are required parameters that specify the ruleset name and the match expression.
+     * - The optional Description parameter provides a text description of the ruleset function or purpose.
+     * - Status controls whether the ruleset takes effect immediately (`on`) or is disabled (`off`).
+     * - Use the Rules parameter to configure a detailed list of rules. Each rule contains properties such as name, position, expression, and action.
+     * - A successful response returns the unique identifier Id of the newly created ruleset and the RuleIds list of all associated rule IDs.
      *
      * @param tmpReq - CreateUserWafRulesetRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -4117,18 +4121,18 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateUserWafRulesetResponse({}));
     }
     /**
-     * Creates an instance-level Web Application Firewall (WAF) ruleset that supports various types of protection rules.
+     * Creates an instance-level Web Application Firewall (WAF) ruleset that supports multiple types of protection rules.
      *
      * @remarks
-     * ## Description
-     * - You can use this API to create a Web Application Firewall (WAF) ruleset for a specific instance.
-     * - The required `InstanceId` parameter specifies the instance for which to create the ruleset.
-     * - The `Phase` parameter defines the execution phase of the ruleset, such as a custom rule or rate limiting.
-     * - The required `Name` and `Expression` parameters specify the ruleset\\"s name and match expression.
-     * - The optional `Description` parameter describes the purpose of the ruleset.
-     * - The `Status` parameter controls whether the ruleset is immediately enabled (`on`) or disabled (`off`).
-     * - Use the `Rules` parameter to configure a detailed rule list. Each rule includes properties such as name, position, expression, and action.
-     * - A successful response returns the unique ID of the new ruleset in `Id` and a list of associated rule IDs in `RuleIds`.
+     * ## Operation description
+     * - This API operation allows you to create a WAF ruleset for a specified instance.
+     * - InstanceId is a required parameter that specifies the instance for which you want to create the ruleset.
+     * - The Phase parameter defines the phase in which the ruleset is applied, such as custom rules or rate limiting.
+     * - Name and Expression are required parameters that specify the ruleset name and the match expression.
+     * - The optional Description parameter provides a text description of the ruleset function or purpose.
+     * - Status controls whether the ruleset takes effect immediately (`on`) or is disabled (`off`).
+     * - Use the Rules parameter to configure a detailed list of rules. Each rule contains properties such as name, position, expression, and action.
+     * - A successful response returns the unique identifier Id of the newly created ruleset and the RuleIds list of all associated rule IDs.
      *
      * @param request - CreateUserWafRulesetRequest
      * @returns CreateUserWafRulesetResponse
@@ -4210,7 +4214,7 @@ class Client extends openapi_core_1.default {
         return await this.createVideoProcessingWithOptions(request, runtime);
     }
     /**
-     * Creates a new rule in the Web Application Firewall (WAF). Use this operation to fine-tune firewall behavior and improve the security of your site or application.
+     * Creates a rule in Web Application Firewall (WAF). You can use this operation to refine firewall behavior and improve the security of your website or application.
      *
      * @param tmpReq - CreateWafRuleRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -4258,7 +4262,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateWafRuleResponse({}));
     }
     /**
-     * Creates a new rule in the Web Application Firewall (WAF). Use this operation to fine-tune firewall behavior and improve the security of your site or application.
+     * Creates a rule in Web Application Firewall (WAF). You can use this operation to refine firewall behavior and improve the security of your website or application.
      *
      * @param request - CreateWafRuleRequest
      * @returns CreateWafRuleResponse
@@ -7644,7 +7648,7 @@ class Client extends openapi_core_1.default {
         return await this.describePreloadTasksWithOptions(request, runtime);
     }
     /**
-     * Queries the execution status of a refresh task.
+     * Queries the execution status of refresh tasks.
      *
      * @param request - DescribePurgeTasksRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -7670,7 +7674,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribePurgeTasksResponse({}));
     }
     /**
-     * Queries the execution status of a refresh task.
+     * Queries the execution status of refresh tasks.
      *
      * @param request - DescribePurgeTasksRequest
      * @returns DescribePurgeTasksResponse
@@ -7779,7 +7783,7 @@ class Client extends openapi_core_1.default {
      * Queries the price difference for a plan specification change by calling DescribeRatePlanPriceGap.
      *
      * @remarks
-     * The plan name and plan code can be obtained from the DescribeRatePlanPrice operation.
+     * The plan name and plan code can be obtained from the [DescribeRatePlanPrice](~~DescribeRatePlanPrice~~) operation.
      *
      * @param request - DescribeRatePlanPriceGapRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -7820,7 +7824,7 @@ class Client extends openapi_core_1.default {
      * Queries the price difference for a plan specification change by calling DescribeRatePlanPriceGap.
      *
      * @remarks
-     * The plan name and plan code can be obtained from the DescribeRatePlanPrice operation.
+     * The plan name and plan code can be obtained from the [DescribeRatePlanPrice](~~DescribeRatePlanPrice~~) operation.
      *
      * @param request - DescribeRatePlanPriceGapRequest
      * @returns DescribeRatePlanPriceGapResponse
@@ -8036,10 +8040,153 @@ class Client extends openapi_core_1.default {
         return await this.describeSiteTopDataWithOptions(request, runtime);
     }
     /**
-     * Get diagnostic report details. 1. Call GenerateTraceDiagnose to obtain the diagnostic link. 2. Open the link in a browser to complete client-side diagnosis. 3. Call ListTraceTasks to obtain the TaskId/TraceId. 4. Call this API to get the report.
+     * Retrieves time series data for WAF event analysis of a website.
+     *
+     * @remarks
+     * - If you do not specify StartTime and EndTime, this operation returns data from the past 24 hours. If you specify StartTime and EndTime, this operation returns data for the specified time range.
+     * - The time granularity of the returned data varies based on the time span between StartTime and EndTime.
+     *   * Less than or equal to 3 hours: returns data at a 1-minute granularity.
+     *   * Greater than 3 hours and less than or equal to 12 hours: returns data at a 5-minute granularity.
+     *   * Greater than 12 hours and less than or equal to 1 day: returns data at a 15-minute granularity.
+     *   * Greater than 1 day and less than or equal to 10 days: returns data at an hourly granularity.
+     *   * Greater than 10 days and less than or equal to 31 days: returns data at a daily granularity.
+     * - Because the number of access requests during the query period may be large, the data analytics results may undergo sampling.
+     *
+     * @param tmpReq - DescribeSiteWafTimeSeriesDataRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns DescribeSiteWafTimeSeriesDataResponse
+     */
+    async describeSiteWafTimeSeriesDataWithOptions(tmpReq, runtime) {
+        tmpReq.validate();
+        let request = new $_model.DescribeSiteWafTimeSeriesDataShrinkRequest({});
+        openapi_core_2.OpenApiUtil.convert(tmpReq, request);
+        if (!$dara.isNull(tmpReq.fields)) {
+            request.fieldsShrink = openapi_core_2.OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.fields, "Fields", "json");
+        }
+        let query = {};
+        if (!$dara.isNull(request.endTime)) {
+            query["EndTime"] = request.endTime;
+        }
+        if (!$dara.isNull(request.fieldsShrink)) {
+            query["Fields"] = request.fieldsShrink;
+        }
+        if (!$dara.isNull(request.interval)) {
+            query["Interval"] = request.interval;
+        }
+        if (!$dara.isNull(request.siteId)) {
+            query["SiteId"] = request.siteId;
+        }
+        if (!$dara.isNull(request.startTime)) {
+            query["StartTime"] = request.startTime;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            query: openapi_core_2.OpenApiUtil.query(query),
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "DescribeSiteWafTimeSeriesData",
+            version: "2024-09-10",
+            protocol: "HTTPS",
+            pathname: "/",
+            method: "POST",
+            authType: "AK",
+            style: "RPC",
+            reqBodyType: "formData",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeSiteWafTimeSeriesDataResponse({}));
+    }
+    /**
+     * Retrieves time series data for WAF event analysis of a website.
      *
      * @remarks
-     * >Notice: Make sure you have activated the Layer 4 acceleration service before using this API.1. Call GenerateTraceDiagnose to obtain the diagnostic link. 2. Open the link in a browser to complete client-side diagnosis. 3. Call ListTraceTasks to obtain the TaskId/TraceId. 4. Call this API to get the report.
+     * - If you do not specify StartTime and EndTime, this operation returns data from the past 24 hours. If you specify StartTime and EndTime, this operation returns data for the specified time range.
+     * - The time granularity of the returned data varies based on the time span between StartTime and EndTime.
+     *   * Less than or equal to 3 hours: returns data at a 1-minute granularity.
+     *   * Greater than 3 hours and less than or equal to 12 hours: returns data at a 5-minute granularity.
+     *   * Greater than 12 hours and less than or equal to 1 day: returns data at a 15-minute granularity.
+     *   * Greater than 1 day and less than or equal to 10 days: returns data at an hourly granularity.
+     *   * Greater than 10 days and less than or equal to 31 days: returns data at a daily granularity.
+     * - Because the number of access requests during the query period may be large, the data analytics results may undergo sampling.
+     *
+     * @param request - DescribeSiteWafTimeSeriesDataRequest
+     * @returns DescribeSiteWafTimeSeriesDataResponse
+     */
+    async describeSiteWafTimeSeriesData(request) {
+        let runtime = new $dara.RuntimeOptions({});
+        return await this.describeSiteWafTimeSeriesDataWithOptions(request, runtime);
+    }
+    /**
+     * Retrieves the top data from WAF event analysis for a website.
+     *
+     * @remarks
+     * - If you do not specify StartTime or EndTime, this operation returns data from the past 24 hours. If you specify StartTime and EndTime, this operation returns data for the specified time range.
+     * - Because of the high volume of access requests during the query period, data analytics may involve sampling.
+     *
+     * @param tmpReq - DescribeSiteWafTopDataRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns DescribeSiteWafTopDataResponse
+     */
+    async describeSiteWafTopDataWithOptions(tmpReq, runtime) {
+        tmpReq.validate();
+        let request = new $_model.DescribeSiteWafTopDataShrinkRequest({});
+        openapi_core_2.OpenApiUtil.convert(tmpReq, request);
+        if (!$dara.isNull(tmpReq.fields)) {
+            request.fieldsShrink = openapi_core_2.OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.fields, "Fields", "json");
+        }
+        let query = {};
+        if (!$dara.isNull(request.endTime)) {
+            query["EndTime"] = request.endTime;
+        }
+        if (!$dara.isNull(request.fieldsShrink)) {
+            query["Fields"] = request.fieldsShrink;
+        }
+        if (!$dara.isNull(request.interval)) {
+            query["Interval"] = request.interval;
+        }
+        if (!$dara.isNull(request.limit)) {
+            query["Limit"] = request.limit;
+        }
+        if (!$dara.isNull(request.siteId)) {
+            query["SiteId"] = request.siteId;
+        }
+        if (!$dara.isNull(request.startTime)) {
+            query["StartTime"] = request.startTime;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            query: openapi_core_2.OpenApiUtil.query(query),
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "DescribeSiteWafTopData",
+            version: "2024-09-10",
+            protocol: "HTTPS",
+            pathname: "/",
+            method: "POST",
+            authType: "AK",
+            style: "RPC",
+            reqBodyType: "formData",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeSiteWafTopDataResponse({}));
+    }
+    /**
+     * Retrieves the top data from WAF event analysis for a website.
+     *
+     * @remarks
+     * - If you do not specify StartTime or EndTime, this operation returns data from the past 24 hours. If you specify StartTime and EndTime, this operation returns data for the specified time range.
+     * - Because of the high volume of access requests during the query period, data analytics may involve sampling.
+     *
+     * @param request - DescribeSiteWafTopDataRequest
+     * @returns DescribeSiteWafTopDataResponse
+     */
+    async describeSiteWafTopData(request) {
+        let runtime = new $dara.RuntimeOptions({});
+        return await this.describeSiteWafTopDataWithOptions(request, runtime);
+    }
+    /**
+     * Retrieves the details of a diagnostic report. 1. Call GenerateTraceDiagnose to obtain a diagnostic link. 2. Open the link in a browser to complete client-side diagnostics. 3. Call ListTraceTasks to obtain the TaskId or TraceId. 4. Call this operation to retrieve the report.
+     *
+     * @remarks
+     * >Notice: Make sure that you have activated the Layer 4 acceleration service before calling this operation.1. Call GenerateTraceDiagnose to obtain a diagnostic link. 2. Open the link in a browser to complete client-side diagnostics. 3. Call ListTraceTasks to obtain the TaskId or TraceId. 4. Call this operation to retrieve the report.
      *
      * @param request - DescribeTraceDiagnoseReportRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -8071,10 +8218,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeTraceDiagnoseReportResponse({}));
     }
     /**
-     * Get diagnostic report details. 1. Call GenerateTraceDiagnose to obtain the diagnostic link. 2. Open the link in a browser to complete client-side diagnosis. 3. Call ListTraceTasks to obtain the TaskId/TraceId. 4. Call this API to get the report.
+     * Retrieves the details of a diagnostic report. 1. Call GenerateTraceDiagnose to obtain a diagnostic link. 2. Open the link in a browser to complete client-side diagnostics. 3. Call ListTraceTasks to obtain the TaskId or TraceId. 4. Call this operation to retrieve the report.
      *
      * @remarks
-     * >Notice: Make sure you have activated the Layer 4 acceleration service before using this API.1. Call GenerateTraceDiagnose to obtain the diagnostic link. 2. Open the link in a browser to complete client-side diagnosis. 3. Call ListTraceTasks to obtain the TaskId/TraceId. 4. Call this API to get the report.
+     * >Notice: Make sure that you have activated the Layer 4 acceleration service before calling this operation.1. Call GenerateTraceDiagnose to obtain a diagnostic link. 2. Open the link in a browser to complete client-side diagnostics. 3. Call ListTraceTasks to obtain the TaskId or TraceId. 4. Call this operation to retrieve the report.
      *
      * @param request - DescribeTraceDiagnoseReportRequest
      * @returns DescribeTraceDiagnoseReportResponse
@@ -8137,6 +8284,72 @@ class Client extends openapi_core_1.default {
         let runtime = new $dara.RuntimeOptions({});
         return await this.describeUrlObservationDataWithOptions(request, runtime);
     }
+    /**
+     * Queries the usage data of WAF by calling DescribeWafUsageData.
+     *
+     * @remarks
+     * Maximum storage duration: 93 days.
+     * * Maximum query time range: 31 days.
+     * * Default time range: 24 hours.
+     * All times are expressed in UTC+0.
+     *
+     * @param request - DescribeWafUsageDataRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns DescribeWafUsageDataResponse
+     */
+    async describeWafUsageDataWithOptions(request, runtime) {
+        request.validate();
+        let query = {};
+        if (!$dara.isNull(request.endTime)) {
+            query["EndTime"] = request.endTime;
+        }
+        if (!$dara.isNull(request.interval)) {
+            query["Interval"] = request.interval;
+        }
+        if (!$dara.isNull(request.recordName)) {
+            query["RecordName"] = request.recordName;
+        }
+        if (!$dara.isNull(request.siteId)) {
+            query["SiteId"] = request.siteId;
+        }
+        if (!$dara.isNull(request.splitBy)) {
+            query["SplitBy"] = request.splitBy;
+        }
+        if (!$dara.isNull(request.startTime)) {
+            query["StartTime"] = request.startTime;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            query: openapi_core_2.OpenApiUtil.query(query),
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "DescribeWafUsageData",
+            version: "2024-09-10",
+            protocol: "HTTPS",
+            pathname: "/",
+            method: "POST",
+            authType: "AK",
+            style: "RPC",
+            reqBodyType: "formData",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeWafUsageDataResponse({}));
+    }
+    /**
+     * Queries the usage data of WAF by calling DescribeWafUsageData.
+     *
+     * @remarks
+     * Maximum storage duration: 93 days.
+     * * Maximum query time range: 31 days.
+     * * Default time range: 24 hours.
+     * All times are expressed in UTC+0.
+     *
+     * @param request - DescribeWafUsageDataRequest
+     * @returns DescribeWafUsageDataResponse
+     */
+    async describeWafUsageData(request) {
+        let runtime = new $dara.RuntimeOptions({});
+        return await this.describeWafUsageDataWithOptions(request, runtime);
+    }
     /**
      * Disables a scenario-specific policy.
      *
@@ -8531,7 +8744,7 @@ class Client extends openapi_core_1.default {
         return await this.getCacheTagWithOptions(request, runtime);
     }
     /**
-     * Retrieves a specified certificate for a site.
+     * Retrieves information about a specified certificate for a site.
      *
      * @param request - GetCertificateRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -8563,7 +8776,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetCertificateResponse({}));
     }
     /**
-     * Retrieves a specified certificate for a site.
+     * Retrieves information about a specified certificate for a site.
      *
      * @param request - GetCertificateRequest
      * @returns GetCertificateResponse
@@ -8609,7 +8822,7 @@ class Client extends openapi_core_1.default {
         return await this.getCertificateQuotaWithOptions(request, runtime);
     }
     /**
-     * Gets the specified client CA certificate.
+     * Retrieves a specified client CA certificate.
      *
      * @param request - GetClientCaCertificateRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -8635,7 +8848,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetClientCaCertificateResponse({}));
     }
     /**
-     * Gets the specified client CA certificate.
+     * Retrieves a specified client CA certificate.
      *
      * @param request - GetClientCaCertificateRequest
      * @returns GetClientCaCertificateResponse
@@ -8687,7 +8900,7 @@ class Client extends openapi_core_1.default {
         return await this.getClientCaCertificateHostnamesWithOptions(request, runtime);
     }
     /**
-     * Retrieves the details of a specified client certificate.
+     * Retrieves information about a specified client certificate.
      *
      * @param request - GetClientCertificateRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -8713,7 +8926,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetClientCertificateResponse({}));
     }
     /**
-     * Retrieves the details of a specified client certificate.
+     * Retrieves information about a specified client certificate.
      *
      * @param request - GetClientCertificateRequest
      * @returns GetClientCertificateResponse
@@ -9512,7 +9725,7 @@ class Client extends openapi_core_1.default {
         return await this.getErServiceWithOptions(request, runtime);
     }
     /**
-     * Downloads a failed file.
+     * Downloads the failed file for a specified upload task.
      *
      * @param request - GetFailFileRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -9538,7 +9751,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetFailFileResponse({}));
     }
     /**
-     * Downloads a failed file.
+     * Downloads the failed file for a specified upload task.
      *
      * @param request - GetFailFileRequest
      * @returns GetFailFileResponse
@@ -9836,7 +10049,7 @@ class Client extends openapi_core_1.default {
         return await this.getImageTransformWithOptions(request, runtime);
     }
     /**
-     * Retrieves the configuration of a keyless server.
+     * Retrieves the configuration of a Keyless server.
      *
      * @param request - GetKeylessServerRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -9868,7 +10081,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetKeylessServerResponse({}));
     }
     /**
-     * Retrieves the configuration of a keyless server.
+     * Retrieves the configuration of a Keyless server.
      *
      * @param request - GetKeylessServerRequest
      * @returns GetKeylessServerResponse
@@ -10021,7 +10234,7 @@ class Client extends openapi_core_1.default {
         return await this.getKvNamespaceWithOptions(request, runtime);
     }
     /**
-     * Queries a custom list, such as the name, description, type, and content.
+     * Retrieves the details of a specific custom list. You can use this operation to query the properties of a specific list, including the name, description, kind, and list items.
      *
      * @param request - GetListRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -10050,7 +10263,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetListResponse({}));
     }
     /**
-     * Queries a custom list, such as the name, description, type, and content.
+     * Retrieves the details of a specific custom list. You can use this operation to query the properties of a specific list, including the name, description, kind, and list items.
      *
      * @param request - GetListRequest
      * @returns GetListResponse
@@ -10060,10 +10273,10 @@ class Client extends openapi_core_1.default {
         return await this.getListWithOptions(request, runtime);
     }
     /**
-     * Retrieves the details of a load balancer by its site ID and load balancer ID.
+     * Retrieves the details of a specific load balancer based on the specified site ID and load balancer ID.
      *
      * @remarks
-     * Use this API to query the configuration details of a load balancer, such as its name, session persistence policy, and routing policy, by providing its resource identifier and authentication information.
+     * This API allows you to query the configuration details of a specific load balancer by providing the required authentication information and resource identity. The details include but are not limited to the name, session persistence policy, and load balancing policy.
      *
      * @param request - GetLoadBalancerRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -10089,10 +10302,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetLoadBalancerResponse({}));
     }
     /**
-     * Retrieves the details of a load balancer by its site ID and load balancer ID.
+     * Retrieves the details of a specific load balancer based on the specified site ID and load balancer ID.
      *
      * @remarks
-     * Use this API to query the configuration details of a load balancer, such as its name, session persistence policy, and routing policy, by providing its resource identifier and authentication information.
+     * This API allows you to query the configuration details of a specific load balancer by providing the required authentication information and resource identity. The details include but are not limited to the name, session persistence policy, and load balancing policy.
      *
      * @param request - GetLoadBalancerRequest
      * @returns GetLoadBalancerResponse
@@ -10174,7 +10387,7 @@ class Client extends openapi_core_1.default {
         return await this.getNetworkOptimizationWithOptions(request, runtime);
     }
     /**
-     * Get the CA certificate of the source server.
+     * Retrieves the CA certificate information of an origin server.
      *
      * @param request - GetOriginCaCertificateRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -10200,7 +10413,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetOriginCaCertificateResponse({}));
     }
     /**
-     * Get the CA certificate of the source server.
+     * Retrieves the CA certificate information of an origin server.
      *
      * @param request - GetOriginCaCertificateRequest
      * @returns GetOriginCaCertificateResponse
@@ -10210,7 +10423,7 @@ class Client extends openapi_core_1.default {
         return await this.getOriginCaCertificateWithOptions(request, runtime);
     }
     /**
-     * Retrieves origin-pull client certificate information for a domain.
+     * Retrieves the back-to-origin client certificate information at the domain name granularity.
      *
      * @param request - GetOriginClientCertificateRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -10236,7 +10449,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetOriginClientCertificateResponse({}));
     }
     /**
-     * Retrieves origin-pull client certificate information for a domain.
+     * Retrieves the back-to-origin client certificate information at the domain name granularity.
      *
      * @param request - GetOriginClientCertificateRequest
      * @returns GetOriginClientCertificateResponse
@@ -10390,7 +10603,7 @@ class Client extends openapi_core_1.default {
         return await this.getOriginRuleWithOptions(request, runtime);
     }
     /**
-     * Gets the details of a custom response page by its ID.
+     * Retrieves the details of a custom response page by its ID.
      *
      * @param request - GetPageRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -10419,7 +10632,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetPageResponse({}));
     }
     /**
-     * Gets the details of a custom response page by its ID.
+     * Retrieves the details of a custom response page by its ID.
      *
      * @param request - GetPageRequest
      * @returns GetPageResponse
@@ -10774,11 +10987,11 @@ class Client extends openapi_core_1.default {
         return await this.getRoutineCodeVersionWithOptions(request, runtime);
     }
     /**
-     * Queries the status and other information of a specific code version of a specified Edge Routine.
+     * Queries the status and other information of a specific code version of a specified Routine.
      *
      * @remarks
      * ## Operation description
-     * By calling this API operation, you can retrieve detailed information about a specific Edge Routine at a specified version, including but not limited to the version status, creation time, and whether the version contains asset resource files. You must provide the Edge Routine name and the specific code version number as request parameters.
+     * By calling this API operation, you can retrieve detailed information about a specific code version of a Routine, including but not limited to the version status, creation time, and whether the version contains Assets resource files. You must specify the Routine name and the code version number as request parameters.
      *
      * @param request - GetRoutineCodeVersionInfoRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -10810,11 +11023,11 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetRoutineCodeVersionInfoResponse({}));
     }
     /**
-     * Queries the status and other information of a specific code version of a specified Edge Routine.
+     * Queries the status and other information of a specific code version of a specified Routine.
      *
      * @remarks
      * ## Operation description
-     * By calling this API operation, you can retrieve detailed information about a specific Edge Routine at a specified version, including but not limited to the version status, creation time, and whether the version contains asset resource files. You must provide the Edge Routine name and the specific code version number as request parameters.
+     * By calling this API operation, you can retrieve detailed information about a specific code version of a Routine, including but not limited to the version status, creation time, and whether the version contains Assets resource files. You must specify the Routine name and the code version number as request parameters.
      *
      * @param request - GetRoutineCodeVersionInfoRequest
      * @returns GetRoutineCodeVersionInfoResponse
@@ -10824,7 +11037,7 @@ class Client extends openapi_core_1.default {
         return await this.getRoutineCodeVersionInfoWithOptions(request, runtime);
     }
     /**
-     * Retrieves a specific edge function route configuration.
+     * Queries the configuration of a single Edge Routine route.
      *
      * @param request - GetRoutineRouteRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -10856,7 +11069,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetRoutineRouteResponse({}));
     }
     /**
-     * Retrieves a specific edge function route configuration.
+     * Queries the configuration of a single Edge Routine route.
      *
      * @param request - GetRoutineRouteRequest
      * @returns GetRoutineRouteResponse
@@ -11290,7 +11503,7 @@ class Client extends openapi_core_1.default {
         return await this.getSiteNameExclusiveWithOptions(request, runtime);
     }
     /**
-     * Retrieves origin-pull client certificate information at the site level.
+     * Retrieves the back-to-origin client certificate information at the site level.
      *
      * @param request - GetSiteOriginClientCertificateRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -11316,7 +11529,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetSiteOriginClientCertificateResponse({}));
     }
     /**
-     * Retrieves origin-pull client certificate information at the site level.
+     * Retrieves the back-to-origin client certificate information at the site level.
      *
      * @param request - GetSiteOriginClientCertificateRequest
      * @returns GetSiteOriginClientCertificateResponse
@@ -11607,11 +11820,11 @@ class Client extends openapi_core_1.default {
         return await this.getUserLogDeliveryQuotaWithOptions(request, runtime);
     }
     /**
-     * This API retrieves the details of the WAF rule set for a specified instance.
+     * Queries the details of a WAF ruleset for a specified instance.
      *
      * @remarks
-     * ## Request
-     * `GetUserWafRuleset` retrieves the details of a specific Web Application Firewall (WAF) ruleset, identified by its instance ID and ruleset ID. The response includes details such as the ruleset\\"s location, name, description, status, and its rules. Specify all required parameters correctly to prevent request failures.
+     * ## Operation description
+     * By calling the `GetUserWafRuleset` operation, you can retrieve information about a specific Web Application Firewall (WAF) ruleset based on the instance ID and ruleset ID. The returned information includes but is not limited to the position, name, description, status, and specific rules of the ruleset. Make sure that you correctly specify the required parameters to avoid request failures.
      *
      * @param request - GetUserWafRulesetRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -11643,11 +11856,11 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetUserWafRulesetResponse({}));
     }
     /**
-     * This API retrieves the details of the WAF rule set for a specified instance.
+     * Queries the details of a WAF ruleset for a specified instance.
      *
      * @remarks
-     * ## Request
-     * `GetUserWafRuleset` retrieves the details of a specific Web Application Firewall (WAF) ruleset, identified by its instance ID and ruleset ID. The response includes details such as the ruleset\\"s location, name, description, status, and its rules. Specify all required parameters correctly to prevent request failures.
+     * ## Operation description
+     * By calling the `GetUserWafRuleset` operation, you can retrieve information about a specific Web Application Firewall (WAF) ruleset based on the instance ID and ruleset ID. The returned information includes but is not limited to the position, name, description, status, and specific rules of the ruleset. Make sure that you correctly specify the required parameters to avoid request failures.
      *
      * @param request - GetUserWafRulesetRequest
      * @returns GetUserWafRulesetResponse
@@ -11776,7 +11989,7 @@ class Client extends openapi_core_1.default {
         return await this.getWafFilterWithOptions(request, runtime);
     }
     /**
-     * Web Application Firewall (WAF) quotas define the maximum number of resources a customer can use, including managed rule groups, custom lists, custom response pages, and scenario-based protection rules.
+     * Retrieves quota details for Web Application Firewall (WAF) resources. These quotas define the quantity limits of corresponding resources that a customer can use, such as managed rule groups, custom lists, custom response pages, and scenario-specific protection rules.
      *
      * @param request - GetWafQuotaRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -11805,7 +12018,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetWafQuotaResponse({}));
     }
     /**
-     * Web Application Firewall (WAF) quotas define the maximum number of resources a customer can use, including managed rule groups, custom lists, custom response pages, and scenario-based protection rules.
+     * Retrieves quota details for Web Application Firewall (WAF) resources. These quotas define the quantity limits of corresponding resources that a customer can use, such as managed rule groups, custom lists, custom response pages, and scenario-specific protection rules.
      *
      * @param request - GetWafQuotaRequest
      * @returns GetWafQuotaResponse
@@ -11815,7 +12028,7 @@ class Client extends openapi_core_1.default {
         return await this.getWafQuotaWithOptions(request, runtime);
     }
     /**
-     * Retrieves the details of a specific WAF rule, including its configuration and status.
+     * Retrieves the details of a single rule in Web Application Firewall (WAF). You can call this operation to query the configuration and status of a specific rule.
      *
      * @param request - GetWafRuleRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -11847,7 +12060,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetWafRuleResponse({}));
     }
     /**
-     * Retrieves the details of a specific WAF rule, including its configuration and status.
+     * Retrieves the details of a single rule in Web Application Firewall (WAF). You can call this operation to query the configuration and status of a specific rule.
      *
      * @param request - GetWafRuleRequest
      * @returns GetWafRuleResponse
@@ -11857,7 +12070,7 @@ class Client extends openapi_core_1.default {
         return await this.getWafRuleWithOptions(request, runtime);
     }
     /**
-     * Retrieves the details of a specified WAF ruleset, including its configuration and status.
+     * Retrieves the details of a specified WAF ruleset. You can call this operation to query the configuration and status information of a specific ruleset.
      *
      * @param request - GetWafRulesetRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -11892,7 +12105,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetWafRulesetResponse({}));
     }
     /**
-     * Retrieves the details of a specified WAF ruleset, including its configuration and status.
+     * Retrieves the details of a specified WAF ruleset. You can call this operation to query the configuration and status information of a specific ruleset.
      *
      * @param request - GetWafRulesetRequest
      * @returns GetWafRulesetResponse
@@ -12022,7 +12235,7 @@ class Client extends openapi_core_1.default {
         return await this.listCasCertificatesWithOptions(request, runtime);
     }
     /**
-     * Lists the certificates for a given site.
+     * Queries the certificate list for a specific site.
      *
      * @param request - ListCertificatesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -12063,7 +12276,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListCertificatesResponse({}));
     }
     /**
-     * Lists the certificates for a given site.
+     * Queries the certificate list for a specific site.
      *
      * @param request - ListCertificatesRequest
      * @returns ListCertificatesResponse
@@ -12073,7 +12286,7 @@ class Client extends openapi_core_1.default {
         return await this.listCertificatesWithOptions(request, runtime);
     }
     /**
-     * Retrieves site certificates for multiple matching records.
+     * Queries the list of site certificates that match records. Batch record matching is supported.
      *
      * @param request - ListCertificatesByRecordRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -12111,7 +12324,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListCertificatesByRecordResponse({}));
     }
     /**
-     * Retrieves site certificates for multiple matching records.
+     * Queries the list of site certificates that match records. Batch record matching is supported.
      *
      * @param request - ListCertificatesByRecordRequest
      * @returns ListCertificatesByRecordResponse
@@ -12157,7 +12370,7 @@ class Client extends openapi_core_1.default {
         return await this.listCiphersWithOptions(request, runtime);
     }
     /**
-     * Retrieves the client CA certificates for a specified site.
+     * Retrieves the list of client CA certificates for a specified site.
      *
      * @param request - ListClientCaCertificatesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -12183,7 +12396,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListClientCaCertificatesResponse({}));
     }
     /**
-     * Retrieves the client CA certificates for a specified site.
+     * Retrieves the list of client CA certificates for a specified site.
      *
      * @param request - ListClientCaCertificatesRequest
      * @returns ListClientCaCertificatesResponse
@@ -12193,7 +12406,7 @@ class Client extends openapi_core_1.default {
         return await this.listClientCaCertificatesWithOptions(request, runtime);
     }
     /**
-     * Retrieves a list of client certificates for a specified site.
+     * Retrieves the list of client certificates for a specified site.
      *
      * @param request - ListClientCertificatesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -12219,7 +12432,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListClientCertificatesResponse({}));
     }
     /**
-     * Retrieves a list of client certificates for a specified site.
+     * Retrieves the list of client certificates for a specified site.
      *
      * @param request - ListClientCertificatesRequest
      * @returns ListClientCertificatesResponse
@@ -13074,7 +13287,7 @@ class Client extends openapi_core_1.default {
         return await this.listInstanceQuotasWithUsageWithOptions(request, runtime);
     }
     /**
-     * Retrieves keyless server configurations for a site.
+     * Retrieves the list of Keyless server configurations for a site.
      *
      * @param request - ListKeylessServersRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -13109,7 +13322,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListKeylessServersResponse({}));
     }
     /**
-     * Retrieves keyless server configurations for a site.
+     * Retrieves the list of Keyless server configurations for a site.
      *
      * @param request - ListKeylessServersRequest
      * @returns ListKeylessServersResponse
@@ -13155,7 +13368,7 @@ class Client extends openapi_core_1.default {
         return await this.listKvsWithOptions(request, runtime);
     }
     /**
-     * Lists all custom lists and their details for an account. Use query parameters to filter the results and pagination to navigate the list collection.
+     * Lists all custom lists under the account along with their details. You can use query parameters to filter results and paginate to retrieve a specific set of lists.
      *
      * @param tmpReq - ListListsRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -13195,7 +13408,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListListsResponse({}));
     }
     /**
-     * Lists all custom lists and their details for an account. Use query parameters to filter the results and pagination to navigate the list collection.
+     * Lists all custom lists under the account along with their details. You can use query parameters to filter results and paginate to retrieve a specific set of lists.
      *
      * @param request - ListListsRequest
      * @returns ListListsResponse
@@ -13297,7 +13510,7 @@ class Client extends openapi_core_1.default {
         return await this.listLoadBalancerRegionsWithOptions(request, runtime);
     }
     /**
-     * Retrieves a paged list of load balancers in a specific site, returning their details. You can filter the list by load balancer name.
+     * Queries the list of load balancers under a site and returns load balancing information. You can query by load balancer name. Paging is supported.
      *
      * @param request - ListLoadBalancersRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -13323,7 +13536,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListLoadBalancersResponse({}));
     }
     /**
-     * Retrieves a paged list of load balancers in a specific site, returning their details. You can filter the list by load balancer name.
+     * Queries the list of load balancers under a site and returns load balancing information. You can query by load balancer name. Paging is supported.
      *
      * @param request - ListLoadBalancersRequest
      * @returns ListLoadBalancersResponse
@@ -13411,7 +13624,7 @@ class Client extends openapi_core_1.default {
         return await this.listNetworkOptimizationsWithOptions(request, runtime);
     }
     /**
-     * Retrieves the CA certificates for the source server.
+     * Queries the list of origin server CA certificates.
      *
      * @param request - ListOriginCaCertificatesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -13437,7 +13650,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListOriginCaCertificatesResponse({}));
     }
     /**
-     * Retrieves the CA certificates for the source server.
+     * Queries the list of origin server CA certificates.
      *
      * @param request - ListOriginCaCertificatesRequest
      * @returns ListOriginCaCertificatesResponse
@@ -13447,7 +13660,7 @@ class Client extends openapi_core_1.default {
         return await this.listOriginCaCertificatesWithOptions(request, runtime);
     }
     /**
-     * Lists back-to-source client certificates for a domain name.
+     * Queries the list of back-to-origin client certificates at the domain name granularity.
      *
      * @param request - ListOriginClientCertificatesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -13473,7 +13686,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListOriginClientCertificatesResponse({}));
     }
     /**
-     * Lists back-to-source client certificates for a domain name.
+     * Queries the list of back-to-origin client certificates at the domain name granularity.
      *
      * @param request - ListOriginClientCertificatesRequest
      * @returns ListOriginClientCertificatesResponse
@@ -13555,7 +13768,7 @@ class Client extends openapi_core_1.default {
         return await this.listOriginRulesWithOptions(request, runtime);
     }
     /**
-     * Retrieves a list of your custom response pages. This operation supports pagination, allowing you to control the results by specifying a page number and a page size.
+     * Lists all custom response pages created by the user. This operation supports pagination and allows you to retrieve the response page list by specifying the page number and page size.
      *
      * @param tmpReq - ListPagesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -13595,7 +13808,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListPagesResponse({}));
     }
     /**
-     * Retrieves a list of your custom response pages. This operation supports pagination, allowing you to control the results by specifying a page number and a page size.
+     * Lists all custom response pages created by the user. This operation supports pagination and allows you to retrieve the response page list by specifying the page number and page size.
      *
      * @param request - ListPagesRequest
      * @returns ListPagesResponse
@@ -13725,7 +13938,7 @@ class Client extends openapi_core_1.default {
         return await this.listRedirectRulesWithOptions(request, runtime);
     }
     /**
-     * List of Rewrite URL Rules
+     * Queries the list of URL rewrite configurations for a site.
      *
      * @param request - ListRewriteUrlRulesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -13751,7 +13964,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListRewriteUrlRulesResponse({}));
     }
     /**
-     * List of Rewrite URL Rules
+     * Queries the list of URL rewrite configurations for a site.
      *
      * @param request - ListRewriteUrlRulesRequest
      * @returns ListRewriteUrlRulesResponse
@@ -14053,7 +14266,7 @@ class Client extends openapi_core_1.default {
         return await this.listSiteDeliveryTasksWithOptions(request, runtime);
     }
     /**
-     * Lists the back-to-origin client certificates for a site.
+     * Queries the list of back-to-origin client certificates at the site level.
      *
      * @param request - ListSiteOriginClientCertificatesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -14079,7 +14292,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListSiteOriginClientCertificatesResponse({}));
     }
     /**
-     * Lists the back-to-origin client certificates for a site.
+     * Queries the list of back-to-origin client certificates at the site level.
      *
      * @param request - ListSiteOriginClientCertificatesRequest
      * @returns ListSiteOriginClientCertificatesResponse
@@ -14089,7 +14302,7 @@ class Client extends openapi_core_1.default {
         return await this.listSiteOriginClientCertificatesWithOptions(request, runtime);
     }
     /**
-     * Retrieves the function routes for a site.
+     * Queries the list of Edge Routine routes for a site.
      *
      * @param request - ListSiteRoutesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -14133,7 +14346,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListSiteRoutesResponse({}));
     }
     /**
-     * Retrieves the function routes for a site.
+     * Queries the list of Edge Routine routes for a site.
      *
      * @param request - ListSiteRoutesRequest
      * @returns ListSiteRoutesResponse
@@ -14376,7 +14589,7 @@ class Client extends openapi_core_1.default {
         return await this.listUploadTasksWithOptions(request, runtime);
     }
     /**
-     * Queries the list of page monitoring configurations.
+     * Queries the list of web page observation configurations.
      *
      * @param request - ListUrlObservationsRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -14414,7 +14627,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListUrlObservationsResponse({}));
     }
     /**
-     * Queries the list of page monitoring configurations.
+     * Queries the list of web page observation configurations.
      *
      * @param request - ListUrlObservationsRequest
      * @returns ListUrlObservationsResponse
@@ -14792,7 +15005,7 @@ class Client extends openapi_core_1.default {
         return await this.listWafPhasesWithOptions(request, runtime);
     }
     /**
-     * This API retrieves a paginated list of detailed WAF rules, which can be filtered by specific conditions.
+     * Lists all rules or filters rules by specific conditions under Web Application Firewall (WAF). You can use this operation to query detailed information about WAF rules in a paged manner.
      *
      * @param tmpReq - ListWafRulesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -14844,7 +15057,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListWafRulesResponse({}));
     }
     /**
-     * This API retrieves a paginated list of detailed WAF rules, which can be filtered by specific conditions.
+     * Lists all rules or filters rules by specific conditions under Web Application Firewall (WAF). You can use this operation to query detailed information about WAF rules in a paged manner.
      *
      * @param request - ListWafRulesRequest
      * @returns ListWafRulesResponse
@@ -14854,7 +15067,7 @@ class Client extends openapi_core_1.default {
         return await this.listWafRulesWithOptions(request, runtime);
     }
     /**
-     * Retrieves a paginated list of rule sets in the current WAF runtime phase, returning their basic information and status.
+     * Lists the rulesets under the current WAF execution phase. Queries basic information and status of rulesets with paging support.
      *
      * @param tmpReq - ListWafRulesetsRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -14903,7 +15116,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListWafRulesetsResponse({}));
     }
     /**
-     * Retrieves a paginated list of rule sets in the current WAF runtime phase, returning their basic information and status.
+     * Lists the rulesets under the current WAF execution phase. Queries basic information and status of rulesets with paging support.
      *
      * @param request - ListWafRulesetsRequest
      * @returns ListWafRulesetsResponse
@@ -15383,7 +15596,49 @@ class Client extends openapi_core_1.default {
         return await this.publishRoutineCodeVersionWithOptions(request, runtime);
     }
     /**
-     * New Purchase of Cache Retention
+     * Purchases a new bot instance.
+     *
+     * @param request - PurchaseBotInstanceRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns PurchaseBotInstanceResponse
+     */
+    async purchaseBotInstanceWithOptions(request, runtime) {
+        request.validate();
+        let query = {};
+        if (!$dara.isNull(request.botInstanceLevel)) {
+            query["BotInstanceLevel"] = request.botInstanceLevel;
+        }
+        if (!$dara.isNull(request.siteInstanceId)) {
+            query["SiteInstanceId"] = request.siteInstanceId;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            query: openapi_core_2.OpenApiUtil.query(query),
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "PurchaseBotInstance",
+            version: "2024-09-10",
+            protocol: "HTTPS",
+            pathname: "/",
+            method: "POST",
+            authType: "AK",
+            style: "RPC",
+            reqBodyType: "formData",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.PurchaseBotInstanceResponse({}));
+    }
+    /**
+     * Purchases a new bot instance.
+     *
+     * @param request - PurchaseBotInstanceRequest
+     * @returns PurchaseBotInstanceResponse
+     */
+    async purchaseBotInstance(request) {
+        let runtime = new $dara.RuntimeOptions({});
+        return await this.purchaseBotInstanceWithOptions(request, runtime);
+    }
+    /**
+     * Purchases a cache reserve instance.
      *
      * @param request - PurchaseCacheReserveRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -15427,7 +15682,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.PurchaseCacheReserveResponse({}));
     }
     /**
-     * New Purchase of Cache Retention
+     * Purchases a cache reserve instance.
      *
      * @param request - PurchaseCacheReserveRequest
      * @returns PurchaseCacheReserveResponse
@@ -16209,7 +16464,7 @@ class Client extends openapi_core_1.default {
         return await this.setClientCaCertificateHostnamesWithOptions(request, runtime);
     }
     /**
-     * Binds one or more hostnames to a specified client CA certificate. If you do not specify a certificate, the hostnames are bound to the ESA CA certificate.
+     * Associates domain names with a specified client CA certificate. If no certificate is specified, the domain names are associated with the ESA CA certificate. This API is deprecated. Use SetClientCaCertificateHostnames instead.
      *
      * @param tmpReq - SetClientCertificateHostnamesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -16251,7 +16506,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.SetClientCertificateHostnamesResponse({}));
     }
     /**
-     * Binds one or more hostnames to a specified client CA certificate. If you do not specify a certificate, the hostnames are bound to the ESA CA certificate.
+     * Associates domain names with a specified client CA certificate. If no certificate is specified, the domain names are associated with the ESA CA certificate. This API is deprecated. Use SetClientCaCertificateHostnames instead.
      *
      * @param request - SetClientCertificateHostnamesRequest
      * @returns SetClientCertificateHostnamesResponse
@@ -18560,7 +18815,7 @@ class Client extends openapi_core_1.default {
         return await this.updateOriginRuleWithOptions(request, runtime);
     }
     /**
-     * Updates a user-created custom response page. Use this API to modify the page name, description, content type, and content.
+     * Updates a custom response page that the user has created. You can use this operation to modify the page name, description, content type, and content.
      *
      * @param tmpReq - UpdatePageRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -18609,7 +18864,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdatePageResponse({}));
     }
     /**
-     * Updates a user-created custom response page. Use this API to modify the page name, description, content type, and content.
+     * Updates a custom response page that the user has created. You can use this operation to modify the page name, description, content type, and content.
      *
      * @param request - UpdatePageRequest
      * @returns UpdatePageResponse
@@ -18813,7 +19068,7 @@ class Client extends openapi_core_1.default {
         return await this.updateRecordWithOptions(request, runtime);
     }
     /**
-     * Updates the redirection configuration of a site.
+     * Modifies the redirect configuration of a site.
      *
      * @param request - UpdateRedirectRuleRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -18869,7 +19124,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateRedirectRuleResponse({}));
     }
     /**
-     * Updates the redirection configuration of a site.
+     * Modifies the redirect configuration of a site.
      *
      * @param request - UpdateRedirectRuleRequest
      * @returns UpdateRedirectRuleResponse
@@ -18879,7 +19134,7 @@ class Client extends openapi_core_1.default {
         return await this.updateRedirectRuleWithOptions(request, runtime);
     }
     /**
-     * Update a Site\\"s URL Rewrite Configuration
+     * Modifies the URL rewrite configuration of a site.
      *
      * @param request - UpdateRewriteUrlRuleRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -18935,7 +19190,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateRewriteUrlRuleResponse({}));
     }
     /**
-     * Update a Site\\"s URL Rewrite Configuration
+     * Modifies the URL rewrite configuration of a site.
      *
      * @param request - UpdateRewriteUrlRuleRequest
      * @returns UpdateRewriteUrlRuleResponse
@@ -19644,7 +19899,7 @@ class Client extends openapi_core_1.default {
         return await this.updateTransportLayerApplicationWithOptions(request, runtime);
     }
     /**
-     * Updates the webpage monitoring configuration.
+     * Updates the URL observation configuration.
      *
      * @param request - UpdateUrlObservationRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -19679,7 +19934,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateUrlObservationResponse({}));
     }
     /**
-     * Updates the webpage monitoring configuration.
+     * Updates the URL observation configuration.
      *
      * @param request - UpdateUrlObservationRequest
      * @returns UpdateUrlObservationResponse
@@ -20303,7 +20558,7 @@ class Client extends openapi_core_1.default {
         return await this.updateWaitingRoomRuleWithOptions(request, runtime);
     }
     /**
-     * Uploads a client certificate authority (CA) certificate.
+     * Uploads a client CA certificate.
      *
      * @param request - UploadClientCaCertificateRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -20340,7 +20595,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UploadClientCaCertificateResponse({}));
     }
     /**
-     * Uploads a client certificate authority (CA) certificate.
+     * Uploads a client CA certificate.
      *
      * @param request - UploadClientCaCertificateRequest
      * @returns UploadClientCaCertificateResponse