@alicloud/emr-serverless-spark20230808 2.0.0 → 2.2.0

package/src/models/ListRayJobResponseBody.ts

@@ -6,10 +6,10 @@ export class ListRayJobResponseBodyRayJobs extends $dara.Model {
   /**
    * @remarks
    * The status of the corresponding Ray cluster. Valid values:
-   * - Deleted: deleted.
-   * - Submitted: submitted but not yet being created.
-   * - Pending: being created.
-   * - Running: running.
+   * - Deleted: The cluster is deleted.
+   * - Submitted: The cluster is submitted but not yet created.
+   * - Pending: The cluster is being created.
+   * - Running: The cluster is running.
    * 
    * @example
    * Running
@@ -25,7 +25,7 @@ export class ListRayJobResponseBodyRayJobs extends $dara.Model {
   creatorName?: string;
   /**
    * @remarks
-   * The number of compute units (CUs) consumed during the job execution cycle. This value is an estimate. The actual value is subject to the bill.
+   * The number of compute units (CUs) consumed during the job runtime. This value is an estimate. The actual value is subject to the bill.
    * 
    * @example
    * 120
@@ -33,7 +33,7 @@ export class ListRayJobResponseBodyRayJobs extends $dara.Model {
   cuHours?: number;
   /**
    * @remarks
-   * The URL of the Ray cluster dashboard. When the Ray cluster is in the Running state, the URL points to the Runtime UI. After the cluster is in the Deleted state, the URL points to the History UI. The History UI is supported only in err-1.2.0 and later versions.
+   * The URL of the Ray cluster dashboard. If the Ray cluster is in the Running state, the URL points to the Runtime UI. If the cluster is in the Deleted state, the URL points to the History UI. The History UI is supported only in err-1.2.0 and later.
    * 
    * @example
    * https://emr-ray-gateway.aliyuncs.com?token=xxxxxxxxx
@@ -41,7 +41,7 @@ export class ListRayJobResponseBodyRayJobs extends $dara.Model {
   dashboardUrl?: string;
   /**
    * @remarks
-   * The execution duration of the job. Unit: seconds.
+   * The execution duration of the job, in seconds.
    * 
    * @example
    * 3564
@@ -49,7 +49,7 @@ export class ListRayJobResponseBodyRayJobs extends $dara.Model {
   duration?: number;
   /**
    * @remarks
-   * The time when the job ended.
+   * The time when the job ended. The value is a UNIX timestamp in milliseconds.
    * 
    * @example
    * 1776945509000
@@ -57,7 +57,7 @@ export class ListRayJobResponseBodyRayJobs extends $dara.Model {
   endTime?: number;
   /**
    * @remarks
-   * The name of the Ray Job.
+   * The name of the Ray job.
    * 
    * @example
    * testRayJob
@@ -65,7 +65,7 @@ export class ListRayJobResponseBodyRayJobs extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The Ray DPI engine version.
+   * The Ray engine version.
    * 
    * @example
    * err-1.2.0 (Ray 2.55.1, Python 3.12)
@@ -73,7 +73,7 @@ export class ListRayJobResponseBodyRayJobs extends $dara.Model {
   resourceQueue?: string;
   /**
    * @remarks
-   * The time when the job was started.
+   * The time when the job was started. The value is a UNIX timestamp in milliseconds.
    * 
    * @example
    * 1776945499000
@@ -81,15 +81,15 @@ export class ListRayJobResponseBodyRayJobs extends $dara.Model {
   startTime?: number;
   /**
    * @remarks
-   * The job status. Valid values:
-   * - Submitted: submitted.
-   * - Pending: the cluster is being created.
-   * - Running: the job is running.
-   * - Succeeded: the job succeeded.
-   * - Failed: the job failed.
-   * - Cancelling: the job is being canceled.
-   * - Cancelled: the job is canceled.
-   * - Timeout: the job timed out and was canceled.
+   * The status of the job. Valid values:
+   * - Submitted: The job is submitted.
+   * - Pending: The cluster is being created.
+   * - Running: The job is running.
+   * - Succeeded: The job succeeded.
+   * - Failed: The job failed.
+   * - Cancelling: The job is being cancelled.
+   * - Cancelled: The job is cancelled.
+   * - Timeout: The job is cancelled due to a timeout.
    * 
    * @example
    * Running
@@ -97,7 +97,7 @@ export class ListRayJobResponseBodyRayJobs extends $dara.Model {
   status?: string;
   /**
    * @remarks
-   * The ID of the Ray Job.
+   * The ID of the Ray job.
    * 
    * @example
    * rj-uiulpgow9xljimm1
@@ -105,7 +105,7 @@ export class ListRayJobResponseBodyRayJobs extends $dara.Model {
   submissionId?: string;
   /**
    * @remarks
-   * The time when the job was submitted.
+   * The time when the job was submitted. The value is a UNIX timestamp in milliseconds.
    * 
    * @example
    * 1776945399000
@@ -157,7 +157,7 @@ export class ListRayJobResponseBodyRayJobs extends $dara.Model {
 export class ListRayJobResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The list of Ray Jobs.
+   * The list of Ray jobs.
    */
   rayJobs?: ListRayJobResponseBodyRayJobs[];
   /**

package/src/models/ListRayJobShrinkRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListRayJobShrinkRequest extends $dara.Model {
   /**
    * @remarks
-   * The name of the Ray Job (exact match).
+   * The name of the Ray job. Exact match is supported.
    * 
    * @example
    * myrayjob
@@ -21,7 +21,7 @@ export class ListRayJobShrinkRequest extends $dara.Model {
   pageNum?: number;
   /**
    * @remarks
-   * The number of entries per page. Default value: 20.
+   * The number of entries to return on each page. Default value: 20.
    * 
    * @example
    * 20
@@ -29,7 +29,7 @@ export class ListRayJobShrinkRequest extends $dara.Model {
   pageSize?: number;
   /**
    * @remarks
-   * The submission ID of the Ray Job.
+   * The submission ID of the Ray job.
    * 
    * @example
    * rj-xxxxxxxxxxx
@@ -37,12 +37,12 @@ export class ListRayJobShrinkRequest extends $dara.Model {
   submissionId?: string;
   /**
    * @remarks
-   * The submit time range.
+   * The submission time range.
    */
   submitTimeShrink?: string;
   /**
    * @remarks
-   * The data development node ID.
+   * The ID of the data development node.
    * 
    * @example
    * TSK-db8b870d901e443ba0aebba40c923e02

package/src/models/ListSessionClustersRequest.ts

@@ -13,7 +13,7 @@ export class ListSessionClustersRequest extends $dara.Model {
   kind?: string;
   /**
    * @remarks
-   * The maximum number of records to return.
+   * The maximum number of records to return in a single request.
    * 
    * @example
    * 20
@@ -21,7 +21,7 @@ export class ListSessionClustersRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The token that marks the start of the next page of results.
+   * The token that indicates the position from which to start reading.
    * 
    * @example
    * 1
@@ -45,7 +45,7 @@ export class ListSessionClustersRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The name of the job.
+   * The job name.
    * 
    * @example
    * emr-spark-demo-job

package/src/models/ListSessionClustersResponseBody.ts

@@ -55,7 +55,7 @@ export class ListSessionClustersResponseBodySessionClustersApplicationConfigs ex
 export class ListSessionClustersResponseBodySessionClustersAutoStartConfiguration extends $dara.Model {
   /**
    * @remarks
-   * Indicates whether auto-start is enabled.
+   * Specifies whether auto-start is enabled.
    * 
    * @example
    * true
@@ -85,7 +85,7 @@ export class ListSessionClustersResponseBodySessionClustersAutoStartConfiguratio
 export class ListSessionClustersResponseBodySessionClustersAutoStopConfiguration extends $dara.Model {
   /**
    * @remarks
-   * Indicates whether auto-stop is enabled.
+   * Specifies whether auto-stop is enabled.
    * 
    * @example
    * false
@@ -93,7 +93,7 @@ export class ListSessionClustersResponseBodySessionClustersAutoStopConfiguration
   enable?: boolean;
   /**
    * @remarks
-   * The number of minutes of inactivity before the session is automatically stopped.
+   * The number of idle minutes after which the session is automatically stopped.
    * 
    * @example
    * 45
@@ -125,7 +125,7 @@ export class ListSessionClustersResponseBodySessionClustersAutoStopConfiguration
 export class ListSessionClustersResponseBodySessionClustersStateChangeReason extends $dara.Model {
   /**
    * @remarks
-   * The state change code.
+   * The status change code.
    * 
    * @example
    * 200
@@ -133,7 +133,7 @@ export class ListSessionClustersResponseBodySessionClustersStateChangeReason ext
   code?: string;
   /**
    * @remarks
-   * The state change message.
+   * The status change message.
    * 
    * @example
    * ok
@@ -165,7 +165,7 @@ export class ListSessionClustersResponseBodySessionClustersStateChangeReason ext
 export class ListSessionClustersResponseBodySessionClusters extends $dara.Model {
   /**
    * @remarks
-   * The session configurations. These are equivalent to the configurations of the underlying Spark job.
+   * The session configurations, which are equivalent to the configurations of the underlying Spark job.
    */
   applicationConfigs?: ListSessionClustersResponseBodySessionClustersApplicationConfigs[];
   /**
@@ -178,10 +178,14 @@ export class ListSessionClustersResponseBodySessionClusters extends $dara.Model
    * The auto-stop configuration.
    */
   autoStopConfiguration?: ListSessionClustersResponseBodySessionClustersAutoStopConfiguration;
+  /**
+   * @remarks
+   * The token used to connect to the session cluster.
+   */
   connectionToken?: string;
   /**
    * @remarks
-   * The version displayed in the console.
+   * The version actually displayed in the console.
    * 
    * @example
    * esr-4.0.0 (Spark 3.5.2, Scala 2.12)
@@ -189,7 +193,7 @@ export class ListSessionClustersResponseBodySessionClusters extends $dara.Model
   displayReleaseVersion?: string;
   /**
    * @remarks
-   * The public endpoint of the Thrift server.
+   * The public domain name of the Thrift server.
    * 
    * @example
    * emr-spark-gateway-cn-hangzhou.data.aliyun.com
@@ -197,7 +201,7 @@ export class ListSessionClustersResponseBodySessionClusters extends $dara.Model
   domain?: string;
   /**
    * @remarks
-   * The internal same-region endpoint of the Thrift server.
+   * The internal domain name of the Thrift server.
    * 
    * @example
    * emr-spark-gateway-cn-hangzhou-internal.data.aliyuncs.com
@@ -205,7 +209,7 @@ export class ListSessionClustersResponseBodySessionClusters extends $dara.Model
   domainInner?: string;
   /**
    * @remarks
-   * The ID of the developer job that is attached to the session.
+   * The ID of the development job bound to the session.
    * 
    * @example
    * TSK-xxxxxxxxx
@@ -221,7 +225,7 @@ export class ListSessionClustersResponseBodySessionClusters extends $dara.Model
   extra?: string;
   /**
    * @remarks
-   * Indicates whether acceleration by the Fusion engine is enabled.
+   * Specifies whether Fusion engine acceleration is enabled.
    * 
    * @example
    * false
@@ -229,7 +233,7 @@ export class ListSessionClustersResponseBodySessionClusters extends $dara.Model
   fusion?: boolean;
   /**
    * @remarks
-   * The time when the session was created.
+   * The creation time.
    * 
    * @example
    * 1732267598000
@@ -251,10 +255,17 @@ export class ListSessionClustersResponseBodySessionClusters extends $dara.Model
    * adhoc_query
    */
   name?: string;
+  /**
+   * @remarks
+   * Specifies whether the public network access endpoint is enabled.
+   * 
+   * @example
+   * true
+   */
   publicEndpointEnabled?: boolean;
   /**
    * @remarks
-   * The name of the queue in which the session runs.
+   * The name of the queue where the session runs.
    * 
    * @example
    * dev_queue
@@ -278,7 +289,7 @@ export class ListSessionClustersResponseBodySessionClusters extends $dara.Model
   sessionClusterId?: string;
   /**
    * @remarks
-   * The time when the session was started.
+   * The start time. The value is a UNIX timestamp in milliseconds.
    * 
    * @example
    * 1732267598000
@@ -286,17 +297,12 @@ export class ListSessionClustersResponseBodySessionClusters extends $dara.Model
   startTime?: number;
   /**
    * @remarks
-   * The session state.
-   * 
-   * - Starting: The session is starting.
-   * 
-   * - Running: The session is running.
-   * 
-   * - Stopping: The session is stopping.
-   * 
-   * - Stopped: The session is stopped.
-   * 
-   * - Error: The session has failed.
+   * The session status. Valid values:
+   * - Starting: Starting.
+   * - Running: Running.
+   * - Stopping: Stopping.
+   * - Stopped: Stopped.
+   * - Error: Failed.
    * 
    * @example
    * Running
@@ -304,7 +310,7 @@ export class ListSessionClustersResponseBodySessionClusters extends $dara.Model
   state?: string;
   /**
    * @remarks
-   * The details of the last state change of the session.
+   * The details of the most recent session status change.
    */
   stateChangeReason?: ListSessionClustersResponseBodySessionClustersStateChangeReason;
   /**
@@ -325,7 +331,7 @@ export class ListSessionClustersResponseBodySessionClusters extends $dara.Model
   userName?: string;
   /**
    * @remarks
-   * The URL of the Spark UI for the session.
+   * The Spark UI URL of the session.
    * 
    * @example
    * http://spark-ui-xxxx
@@ -421,7 +427,7 @@ export class ListSessionClustersResponseBodySessionClusters extends $dara.Model
 export class ListSessionClustersResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The maximum number of entries returned for the request.
+   * The maximum number of records returned in the current request.
    * 
    * @example
    * 20
@@ -429,7 +435,7 @@ export class ListSessionClustersResponseBody extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The token that marks the start of the next page of results.
+   * The token that indicates the position of the returned data.
    * 
    * @example
    * 1
@@ -445,12 +451,12 @@ export class ListSessionClustersResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * A list of sessions.
+   * The list of sessions.
    */
   sessionClusters?: ListSessionClustersResponseBodySessionClusters[];
   /**
    * @remarks
-   * The total number of entries that match the query criteria.
+   * The total number of records that meet the current request conditions.
    * 
    * @example
    * 200

package/src/models/ListWorkspaceQueuesResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListWorkspaceQueuesResponseBodyQueuesAllowActions extends $dara.Model {
   /**
    * @remarks
-   * The action ARN.
+   * The ARN of the action.
    * 
    * @example
    * acs:emr::workspaceId:action/create_queue
@@ -21,7 +21,7 @@ export class ListWorkspaceQueuesResponseBodyQueuesAllowActions extends $dara.Mod
   actionName?: string;
   /**
    * @remarks
-   * The list of action dependencies.
+   * The list of dependencies for the action.
    * 
    * @example
    * ["view"]
@@ -29,7 +29,7 @@ export class ListWorkspaceQueuesResponseBodyQueuesAllowActions extends $dara.Mod
   dependencies?: string[];
   /**
    * @remarks
-   * The action description.
+   * The description of the action.
    * 
    * @example
    * Directory traversal and file browsing
@@ -40,7 +40,7 @@ export class ListWorkspaceQueuesResponseBodyQueuesAllowActions extends $dara.Mod
    * The display name of the permission.
    * 
    * @example
-   * File directory traversal, file browsing
+   * Directory traversal and file browsing
    */
   displayName?: string;
   static names(): { [key: string]: string } {
@@ -78,12 +78,12 @@ export class ListWorkspaceQueuesResponseBodyQueuesAllowActions extends $dara.Mod
 export class ListWorkspaceQueuesResponseBodyQueues extends $dara.Model {
   /**
    * @remarks
-   * The list of allowed actions on the queue.
+   * The list of allowed operations for the queue.
    */
   allowActions?: ListWorkspaceQueuesResponseBodyQueuesAllowActions[];
   /**
    * @remarks
-   * The time when the workspace was created.
+   * The time when the workspace was created. The value is a UNIX timestamp in milliseconds.
    * 
    * @example
    * 1684115879955
@@ -91,7 +91,7 @@ export class ListWorkspaceQueuesResponseBodyQueues extends $dara.Model {
   createTime?: number;
   /**
    * @remarks
-   * The UID of the user who created the queue.
+   * The UID of the creator.
    * 
    * @example
    * 237109
@@ -107,15 +107,26 @@ export class ListWorkspaceQueuesResponseBodyQueues extends $dara.Model {
   description?: string;
   /**
    * @remarks
-   * The list of queue environment types.
+   * The list of environment types for the queue.
    */
   environments?: string[];
+  /**
+   * @remarks
+   * The number of GPU machines.
+   * 
+   * @example
+   * 0
+   */
   gpuMachineNum?: number;
   /**
    * @remarks
-   * The list of GPU models.
+   * The list of GPU instance types.
    */
   gpuSpec?: string[];
+  /**
+   * @remarks
+   * The ID of the resource instance associated with the queue.
+   */
   instanceId?: string;
   /**
    * @remarks
@@ -135,10 +146,10 @@ export class ListWorkspaceQueuesResponseBodyQueues extends $dara.Model {
   minResource?: string;
   /**
    * @remarks
-   * The billing type. Valid values:
+   * The billing method. Valid values:
    * 
-   * - PayAsYouGo: pay-as-you-go.
-   * - Pre: subscription.
+   * - PayAsYouGo: pay-as-you-go
+   * - Pre: subscription
    * 
    * @example
    * PayAsYouGo
@@ -146,7 +157,10 @@ export class ListWorkspaceQueuesResponseBodyQueues extends $dara.Model {
   paymentType?: string;
   /**
    * @remarks
-   * Indicates whether resource prefetch is enabled.
+   * Specifies whether resource prefetching is performed.
+   * 
+   * @example
+   * true
    */
   preheat?: boolean;
   /**
@@ -159,7 +173,7 @@ export class ListWorkspaceQueuesResponseBodyQueues extends $dara.Model {
   properties?: string;
   /**
    * @remarks
-   * The queue category, CPU or GPU.
+   * The queue category, such as CPU or GPU.
    * 
    * @example
    * CPU
@@ -297,7 +311,7 @@ export class ListWorkspaceQueuesResponseBodyQueues extends $dara.Model {
 export class ListWorkspaceQueuesResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The maximum number of records returned per request.
+   * The maximum number of records to return per request.
    * 
    * @example
    * 20

package/src/models/ListWorkspacesRequest.ts

@@ -4,13 +4,19 @@ import * as $dara from '@darabonba/typescript';
 
 export class ListWorkspacesRequestTag extends $dara.Model {
   /**
+   * @remarks
+   * The tag key.
+   * 
    * @example
    * cn-shenzhen-finance.edas.config.server
    */
   key?: string;
   /**
+   * @remarks
+   * The tag value.
+   * 
    * @example
-   * iPhone disk space remaining rate
+   * iPhone remaining disk space percentage
    */
   value?: string;
   static names(): { [key: string]: string } {
@@ -39,7 +45,7 @@ export class ListWorkspacesRequestTag extends $dara.Model {
 export class ListWorkspacesRequest extends $dara.Model {
   /**
    * @remarks
-   * The maximum number of records to retrieve in a single request.
+   * The maximum number of records to return in a single request.
    * 
    * @example
    * 20
@@ -47,7 +53,7 @@ export class ListWorkspacesRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The name of the workspace. Fuzzy match is supported.
+   * The name of the workspace. Fuzzy search by workspace name is supported.
    * 
    * @example
    * test_workspace
@@ -55,7 +61,7 @@ export class ListWorkspacesRequest extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The pagination token that marks the current read position.
+   * The token that indicates the position from which to start reading.
    * 
    * @example
    * 1
@@ -70,18 +76,30 @@ export class ListWorkspacesRequest extends $dara.Model {
    */
   regionId?: string;
   /**
+   * @remarks
+   * The resource group ID.
+   * 
    * @example
    * rg-aek2thxggoqhmhq
    */
   resourceGroupId?: string;
   /**
    * @remarks
-   * The workspace status.
+   * The state of the workspace. Valid values:
+   * - Starting: The workspace is starting.
+   * - Running: The workspace is running.
+   * - Stopping: The workspace is stopping.
+   * - Stopped: The workspace is stopped.
+   * - Error: The workspace failed.
    * 
    * @example
    * running
    */
   state?: string;
+  /**
+   * @remarks
+   * The list of tags used to filter workspaces.
+   */
   tag?: ListWorkspacesRequestTag[];
   static names(): { [key: string]: string } {
     return {