@alicloud/emr-serverless-spark20230808 2.1.0 → 2.2.0

package/src/models/ListExecutorLogsRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListExecutorLogsRequest extends $dara.Model {
   /**
    * @remarks
-   * The type of log. Only logs of this type are returned.
+   * The log type.
    * 
    * @example
    * log4j
@@ -13,7 +13,7 @@ export class ListExecutorLogsRequest extends $dara.Model {
   logType?: string;
   /**
    * @remarks
-   * The maximum number of results to return per page. Valid values: 1 to 100. Default value: 20.
+   * The maximum number of records to return in a single request.
    * 
    * @example
    * 20
@@ -21,7 +21,7 @@ export class ListExecutorLogsRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The pagination token. This is the `nextToken` from a previously truncated response.
+   * The next token.
    * 
    * @example
    * 1
@@ -29,7 +29,7 @@ export class ListExecutorLogsRequest extends $dara.Model {
   nextToken?: string;
   /**
    * @remarks
-   * The ID of the region.
+   * The region ID.
    * 
    * @example
    * cn-hangzhou

package/src/models/ListExecutorLogsResponseBody.ts

@@ -5,12 +5,12 @@ import * as $dara from '@darabonba/typescript';
 export class ListExecutorLogsResponseBodyLogs extends $dara.Model {
   /**
    * @remarks
-   * The full path of the log file.
+   * The full file path.
    */
   fileName?: string;
   /**
    * @remarks
-   * The size of the file, in bytes.
+   * The file size.
    * 
    * @example
    * 6383327
@@ -34,7 +34,7 @@ export class ListExecutorLogsResponseBodyLogs extends $dara.Model {
   logType?: string;
   /**
    * @remarks
-   * The time the log file was last updated, as a Unix timestamp.
+   * The log update time. The value is a UNIX timestamp in seconds.
    * 
    * @example
    * 1745390462
@@ -72,12 +72,12 @@ export class ListExecutorLogsResponseBodyLogs extends $dara.Model {
 export class ListExecutorLogsResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The retrieved logs, sorted in contextual order. If no contextual logs are found based on the specified starting log, this parameter is empty.
+   * The retrieved logs, sorted in contextual order. This parameter is empty if no contextual logs are found in the log query based on the specified starting log.
    */
   logs?: ListExecutorLogsResponseBodyLogs[];
   /**
    * @remarks
-   * The maximum number of results returned per page.
+   * The maximum number of records to return in a single request.
    * 
    * @example
    * 20
@@ -85,7 +85,7 @@ export class ListExecutorLogsResponseBody extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The token to retrieve the next page of results. This value is null when there are no more results to return.
+   * The next token.
    * 
    * @example
    * 2
@@ -93,7 +93,7 @@ export class ListExecutorLogsResponseBody extends $dara.Model {
   nextToken?: string;
   /**
    * @remarks
-   * The request ID.
+   * Id of the request
    * 
    * @example
    * DD6B1B2A-5837-5237-ABE4-FF0C8944
@@ -101,7 +101,7 @@ export class ListExecutorLogsResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The total count of log files.
+   * The total number of records.
    * 
    * @example
    * 200

package/src/models/ListJobRunsRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListJobRunsRequestEndTime extends $dara.Model {
   /**
    * @remarks
-   * The end of the end time range.
+   * The end time of the time range. The value is a UNIX timestamp in milliseconds.
    * 
    * @example
    * 1710432000000
@@ -13,7 +13,7 @@ export class ListJobRunsRequestEndTime extends $dara.Model {
   endTime?: number;
   /**
    * @remarks
-   * The beginning of the end time range.
+   * The start time of the time range. The value is a UNIX timestamp in milliseconds.
    * 
    * @example
    * 1709740800000
@@ -45,7 +45,7 @@ export class ListJobRunsRequestEndTime extends $dara.Model {
 export class ListJobRunsRequestStartTime extends $dara.Model {
   /**
    * @remarks
-   * The end of the start time range.
+   * The end time of the time range. The value is a UNIX timestamp in milliseconds.
    * 
    * @example
    * 1710432000000
@@ -53,7 +53,7 @@ export class ListJobRunsRequestStartTime extends $dara.Model {
   endTime?: number;
   /**
    * @remarks
-   * The beginning of the start time range.
+   * The start time of the time range. The value is a UNIX timestamp in milliseconds.
    * 
    * @example
    * 1709740800000
@@ -141,13 +141,17 @@ export class ListJobRunsRequest extends $dara.Model {
   creator?: string;
   /**
    * @remarks
-   * The end time range of the job.
+   * The time range for the end time of the job run.
    */
   endTime?: ListJobRunsRequestEndTime;
+  /**
+   * @remarks
+   * Specifies whether to aggregate and return statistical results by job run state.
+   */
   groupByState?: boolean;
   /**
    * @remarks
-   * Specifies whether the job is a workflow job.
+   * Specifies whether the job run is a workflow job.
    * 
    * @example
    * false
@@ -155,7 +159,7 @@ export class ListJobRunsRequest extends $dara.Model {
   isWorkflow?: string;
   /**
    * @remarks
-   * The job ID of the streaming job deployment.
+   * The ID of the streaming job deployment.
    * 
    * @example
    * jd-b6d003f1930f****
@@ -163,7 +167,7 @@ export class ListJobRunsRequest extends $dara.Model {
   jobRunDeploymentId?: string;
   /**
    * @remarks
-   * The job ID.
+   * The ID of the job run.
    * 
    * @example
    * j-xxx
@@ -171,7 +175,7 @@ export class ListJobRunsRequest extends $dara.Model {
   jobRunId?: string;
   /**
    * @remarks
-   * The maximum number of records to retrieve in a single request. Maximum value: 100.
+   * The maximum number of entries to return in a single call. The maximum value is 100.
    * 
    * @example
    * 20
@@ -179,7 +183,7 @@ export class ListJobRunsRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The minimum execution duration of the job, in milliseconds.
+   * The minimum execution duration of the job run, in milliseconds.
    * 
    * @example
    * 60000
@@ -187,7 +191,7 @@ export class ListJobRunsRequest extends $dara.Model {
   minDuration?: number;
   /**
    * @remarks
-   * The job name.
+   * The name of the job.
    * 
    * @example
    * emr-spark-demo-job
@@ -195,7 +199,7 @@ export class ListJobRunsRequest extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The pagination token that marks the position from which to start reading.
+   * The pagination token that specifies the starting position for the query.
    * 
    * @example
    * DD6B1B2A-5837-5237-ABE4-FF0C89568980
@@ -211,7 +215,7 @@ export class ListJobRunsRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The name of the resource queue on which the Spark job runs.
+   * The name of the resource queue in which the Spark job runs.
    * 
    * @example
    * dev_queue
@@ -227,12 +231,12 @@ export class ListJobRunsRequest extends $dara.Model {
   runtimeConfigs?: string;
   /**
    * @remarks
-   * The start time range of the job.
+   * The time range for the start time of the job run.
    */
   startTime?: ListJobRunsRequestStartTime;
   /**
    * @remarks
-   * The job states.
+   * The states of the job runs.
    * 
    * @example
    * ["Running","Submitted"]

package/src/models/ListJobRunsResponseBody.ts

@@ -79,7 +79,7 @@ export class ListJobRunsResponseBodyJobRunsStateChangeReason extends $dara.Model
 export class ListJobRunsResponseBodyJobRuns extends $dara.Model {
   /**
    * @remarks
-   * The job code type. Valid values:
+   * The code type of the job. Valid values:
    * 
    * SQL
    * 
@@ -93,7 +93,7 @@ export class ListJobRunsResponseBodyJobRuns extends $dara.Model {
   codeType?: string;
   /**
    * @remarks
-   * The Spark advanced configurations. This parameter is not returned by the List operation.
+   * The advanced Spark configurations. This parameter is not returned by the List operation.
    */
   configurationOverrides?: ListJobRunsResponseBodyJobRunsConfigurationOverrides;
   /**
@@ -106,7 +106,7 @@ export class ListJobRunsResponseBodyJobRuns extends $dara.Model {
   creator?: string;
   /**
    * @remarks
-   * The number of compute units (CUs) consumed during the job run cycle. This value is an estimate. The actual value is subject to the bill.
+   * The number of compute units (CUs) consumed during the job run. This value is an estimate and the final value is subject to the bill.
    * 
    * @example
    * 2.059
@@ -114,7 +114,7 @@ export class ListJobRunsResponseBodyJobRuns extends $dara.Model {
   cuHours?: number;
   /**
    * @remarks
-   * The version of the Spark DPI engine used to run the job.
+   * The Spark DPI engine version of the running job.
    * 
    * @example
    * esr-3.0.0 (Spark 3.4.3, Scala 2.12)
@@ -122,7 +122,7 @@ export class ListJobRunsResponseBodyJobRuns extends $dara.Model {
   displayReleaseVersion?: string;
   /**
    * @remarks
-   * The job end time.
+   * The time when the job ended. The value is a UNIX timestamp in milliseconds.
    * 
    * @example
    * 1684119314000
@@ -130,7 +130,7 @@ export class ListJobRunsResponseBodyJobRuns extends $dara.Model {
   endTime?: number;
   /**
    * @remarks
-   * The execution timeout period, in seconds.
+   * The execution timeout period.
    * 
    * @example
    * 3600
@@ -138,7 +138,7 @@ export class ListJobRunsResponseBodyJobRuns extends $dara.Model {
   executionTimeoutSeconds?: number;
   /**
    * @remarks
-   * Indicates whether the Fusion engine acceleration is enabled.
+   * Specifies whether Fusion engine acceleration is enabled.
    * 
    * @example
    * true
@@ -146,12 +146,12 @@ export class ListJobRunsResponseBodyJobRuns extends $dara.Model {
   fusion?: boolean;
   /**
    * @remarks
-   * The Spark Driver information. This parameter is not returned by the List operation.
+   * The information about the Spark driver. This parameter is not returned by the List operation.
    */
   jobDriver?: JobDriver;
   /**
    * @remarks
-   * The job ID.
+   * The ID of the job run.
    * 
    * @example
    * jr-231231
@@ -159,12 +159,12 @@ export class ListJobRunsResponseBodyJobRuns extends $dara.Model {
   jobRunId?: string;
   /**
    * @remarks
-   * The path of the run log.
+   * The path to the execution log.
    */
   log?: RunLog;
   /**
    * @remarks
-   * The total amount of allocated memory multiplied by the number of seconds the job has been running.
+   * The total amount of memory allocated to the job multiplied by the number of seconds the job has run.
    * 
    * @example
    * 33030784
@@ -172,33 +172,39 @@ export class ListJobRunsResponseBodyJobRuns extends $dara.Model {
   mbSeconds?: number;
   /**
    * @remarks
-   * The job name.
+   * The name of the job.
    * 
    * @example
    * jobName
    */
   name?: string;
   /**
+   * @remarks
+   * The priority of the Spark job.
+   * 
    * @example
    * 5
    */
   priority?: string;
   /**
    * @remarks
-   * The version of the Spark DPI engine used to run the job.
+   * The Spark DPI engine version of the running job.
    * 
    * @example
    * esr-3.0.0 (Spark 3.4.3, Scala 2.12, Native Runtime)
    */
   releaseVersion?: string;
   /**
+   * @remarks
+   * The name of the resource queue in which the Spark job runs.
+   * 
    * @example
    * dev_queue
    */
   resourceQueueId?: string;
   /**
    * @remarks
-   * The job states.
+   * The states of the job runs.
    * 
    * @example
    * Running
@@ -211,7 +217,7 @@ export class ListJobRunsResponseBodyJobRuns extends $dara.Model {
   stateChangeReason?: ListJobRunsResponseBodyJobRunsStateChangeReason;
   /**
    * @remarks
-   * The job submission time.
+   * The time when the job was submitted. The value is a UNIX timestamp in milliseconds.
    * 
    * @example
    * 1684119314000
@@ -224,7 +230,7 @@ export class ListJobRunsResponseBodyJobRuns extends $dara.Model {
   tags?: Tag[];
   /**
    * @remarks
-   * The total number of allocated vcores multiplied by the number of seconds the job has been running.
+   * The total number of vcores allocated to the job multiplied by the number of seconds the job has run.
    * 
    * @example
    * 8236
@@ -232,7 +238,7 @@ export class ListJobRunsResponseBodyJobRuns extends $dara.Model {
   vcoreSeconds?: number;
   /**
    * @remarks
-   * The job Web UI.
+   * The web UI of the job.
    * 
    * @example
    * http://spark-ui
@@ -240,7 +246,7 @@ export class ListJobRunsResponseBodyJobRuns extends $dara.Model {
   webUI?: string;
   /**
    * @remarks
-   * The workspace ID.
+   * The ID of the workspace.
    * 
    * @example
    * w-d2d82aa09155****
@@ -327,15 +333,19 @@ export class ListJobRunsResponseBodyJobRuns extends $dara.Model {
 }
 
 export class ListJobRunsResponseBody extends $dara.Model {
+  /**
+   * @remarks
+   * The statistical results aggregated by job state.
+   */
   aggregations?: { [key: string]: string };
   /**
    * @remarks
-   * The list of Spark jobs.
+   * The list of Spark job runs.
    */
   jobRuns?: ListJobRunsResponseBodyJobRuns[];
   /**
    * @remarks
-   * The maximum number of records returned in this request.
+   * The maximum number of records returned for the request.
    * 
    * @example
    * 20
@@ -343,7 +353,7 @@ export class ListJobRunsResponseBody extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The position from which the data was read.
+   * The position of the data read.
    * 
    * @example
    * 1
@@ -359,7 +369,7 @@ export class ListJobRunsResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The total number of records that match the request conditions.
+   * The total number of records that meet the request conditions.
    * 
    * @example
    * 200

package/src/models/ListJobRunsShrinkRequest.ts

@@ -21,13 +21,17 @@ export class ListJobRunsShrinkRequest extends $dara.Model {
   creator?: string;
   /**
    * @remarks
-   * The end time range of the job.
+   * The time range for the end time of the job run.
    */
   endTimeShrink?: string;
+  /**
+   * @remarks
+   * Specifies whether to aggregate and return statistical results by job run state.
+   */
   groupByState?: boolean;
   /**
    * @remarks
-   * Specifies whether the job is a workflow job.
+   * Specifies whether the job run is a workflow job.
    * 
    * @example
    * false
@@ -35,7 +39,7 @@ export class ListJobRunsShrinkRequest extends $dara.Model {
   isWorkflow?: string;
   /**
    * @remarks
-   * The job ID of the streaming job deployment.
+   * The ID of the streaming job deployment.
    * 
    * @example
    * jd-b6d003f1930f****
@@ -43,7 +47,7 @@ export class ListJobRunsShrinkRequest extends $dara.Model {
   jobRunDeploymentId?: string;
   /**
    * @remarks
-   * The job ID.
+   * The ID of the job run.
    * 
    * @example
    * j-xxx
@@ -51,7 +55,7 @@ export class ListJobRunsShrinkRequest extends $dara.Model {
   jobRunId?: string;
   /**
    * @remarks
-   * The maximum number of records to retrieve in a single request. Maximum value: 100.
+   * The maximum number of entries to return in a single call. The maximum value is 100.
    * 
    * @example
    * 20
@@ -59,7 +63,7 @@ export class ListJobRunsShrinkRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The minimum execution duration of the job, in milliseconds.
+   * The minimum execution duration of the job run, in milliseconds.
    * 
    * @example
    * 60000
@@ -67,7 +71,7 @@ export class ListJobRunsShrinkRequest extends $dara.Model {
   minDuration?: number;
   /**
    * @remarks
-   * The job name.
+   * The name of the job.
    * 
    * @example
    * emr-spark-demo-job
@@ -75,7 +79,7 @@ export class ListJobRunsShrinkRequest extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The pagination token that marks the position from which to start reading.
+   * The pagination token that specifies the starting position for the query.
    * 
    * @example
    * DD6B1B2A-5837-5237-ABE4-FF0C89568980
@@ -91,7 +95,7 @@ export class ListJobRunsShrinkRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The name of the resource queue on which the Spark job runs.
+   * The name of the resource queue in which the Spark job runs.
    * 
    * @example
    * dev_queue
@@ -107,12 +111,12 @@ export class ListJobRunsShrinkRequest extends $dara.Model {
   runtimeConfigs?: string;
   /**
    * @remarks
-   * The start time range of the job.
+   * The time range for the start time of the job run.
    */
   startTimeShrink?: string;
   /**
    * @remarks
-   * The job states.
+   * The states of the job runs.
    * 
    * @example
    * ["Running","Submitted"]

package/src/models/ListKyuubiServicesRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListKyuubiServicesRequest extends $dara.Model {
   /**
    * @remarks
-   * The token of the Kyuubi Gateway.
+   * The Kyuubi Gateway token.
    * 
    * @example
    * 6w3s2e7y7t9fxnvtai9sv1uebw8b7bvc

package/src/models/ListKyuubiServicesResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListKyuubiServicesResponseBodyDataKyuubiServices extends $dara.Model {
   /**
    * @remarks
-   * The KyuubiServer instance type.
+   * The instance specifications of the Kyuubi server.
    * 
    * @example
    * 4C16G
@@ -13,7 +13,7 @@ export class ListKyuubiServicesResponseBodyDataKyuubiServices extends $dara.Mode
   computeInstance?: string;
   /**
    * @remarks
-   * The creation time.
+   * The creation time. The time is in UTC and follows the ISO 8601 standard.
    * 
    * @example
    * 2025-03-11T08:21:58Z
@@ -21,7 +21,7 @@ export class ListKyuubiServicesResponseBodyDataKyuubiServices extends $dara.Mode
   createTime?: string;
   /**
    * @remarks
-   * The UID of the user who created the KyuubiServer.
+   * The UID of the creator.
    * 
    * @example
    * 103*******
@@ -29,7 +29,7 @@ export class ListKyuubiServicesResponseBodyDataKyuubiServices extends $dara.Mode
   creator?: string;
   /**
    * @remarks
-   * The internal network endpoint.
+   * The internal domain name.
    * 
    * @example
    * kyuubi-cn-hangzhou-internal.spark.emr.aliyuncs.com
@@ -37,7 +37,7 @@ export class ListKyuubiServicesResponseBodyDataKyuubiServices extends $dara.Mode
   innerEndpoint?: string;
   /**
    * @remarks
-   * The KyuubiServer configurations.
+   * The Kyuubi server configurations.
    * 
    * @example
    * kyuubi.conf.key=value1
@@ -46,7 +46,7 @@ export class ListKyuubiServicesResponseBodyDataKyuubiServices extends $dara.Mode
   kyuubiConfigs?: string;
   /**
    * @remarks
-   * The KyuubiServer version.
+   * The version of the Kyuubi server.
    * 
    * @example
    * 1.9.2-0.0.1
@@ -54,7 +54,7 @@ export class ListKyuubiServicesResponseBodyDataKyuubiServices extends $dara.Mode
   kyuubiReleaseVersion?: string;
   /**
    * @remarks
-   * KyuubiServer ID。
+   * The KyuubiServer ID.
    * 
    * @example
    * kb-070104e7631242448d12a1377c309f30
@@ -62,7 +62,7 @@ export class ListKyuubiServicesResponseBodyDataKyuubiServices extends $dara.Mode
   kyuubiServiceId?: string;
   /**
    * @remarks
-   * The KyuubiServer name.
+   * The name of the Kyuubi server.
    * 
    * @example
    * test
@@ -78,7 +78,7 @@ export class ListKyuubiServicesResponseBodyDataKyuubiServices extends $dara.Mode
   publicEndpoint?: string;
   /**
    * @remarks
-   * The queue name.
+   * The name of the queue.
    * 
    * @example
    * dev_queue
@@ -86,7 +86,7 @@ export class ListKyuubiServicesResponseBodyDataKyuubiServices extends $dara.Mode
   queue?: string;
   /**
    * @remarks
-   * The Spark DPI engine database engine version number.
+   * The Spark DPI engine version.
    * 
    * @example
    * esr-4.2.0 (Spark 3.5.2, Scala 2.12)
@@ -94,7 +94,7 @@ export class ListKyuubiServicesResponseBodyDataKyuubiServices extends $dara.Mode
   releaseVersion?: string;
   /**
    * @remarks
-   * The number of KyuubiServer replicas.
+   * The number of replicas of the Kyuubi server.
    * 
    * @example
    * 3
@@ -102,7 +102,7 @@ export class ListKyuubiServicesResponseBodyDataKyuubiServices extends $dara.Mode
   replica?: number;
   /**
    * @remarks
-   * The default configurations for Spark applications started by KyuubiServer.
+   * The default configurations for the Kyuubi server to start a Spark application.
    * 
    * @example
    * spark.conf.key=value1
@@ -111,7 +111,7 @@ export class ListKyuubiServicesResponseBodyDataKyuubiServices extends $dara.Mode
   sparkConfigs?: string;
   /**
    * @remarks
-   * The most recent start time of KyuubiServer.
+   * The most recent start time of the Kyuubi server. The format is YYYY-MM-DD HH:mm:ss.
    * 
    * @example
    * 2024-11-23 09:22:00
@@ -119,7 +119,7 @@ export class ListKyuubiServicesResponseBodyDataKyuubiServices extends $dara.Mode
   startTime?: string;
   /**
    * @remarks
-   * The KyuubiServer status.
+   * The state of the Kyuubi server.
    * 
    * @example
    * Running
@@ -187,7 +187,7 @@ export class ListKyuubiServicesResponseBodyDataKyuubiServices extends $dara.Mode
 export class ListKyuubiServicesResponseBodyData extends $dara.Model {
   /**
    * @remarks
-   * The list of KyuubiServer instances.
+   * The list of Kyuubi servers.
    */
   kyuubiServices?: ListKyuubiServicesResponseBodyDataKyuubiServices[];
   static names(): { [key: string]: string } {