@aws-sdk/client-emr 3.1060.0 → 3.1062.0

package/dist-types/commands/StartSessionCommand.d.ts

@@ -0,0 +1,141 @@
+import { Command as $Command } from "@smithy/core/client";
+import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import type { EMRClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EMRClient";
+import type { StartSessionInput, StartSessionOutput } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link StartSessionCommand}.
+ */
+export interface StartSessionCommandInput extends StartSessionInput {
+}
+/**
+ * @public
+ *
+ * The output of {@link StartSessionCommand}.
+ */
+export interface StartSessionCommandOutput extends StartSessionOutput, __MetadataBearer {
+}
+declare const StartSessionCommand_base: {
+    new (input: StartSessionCommandInput): import("@smithy/core/client").CommandImpl<StartSessionCommandInput, StartSessionCommandOutput, EMRClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (input: StartSessionCommandInput): import("@smithy/core/client").CommandImpl<StartSessionCommandInput, StartSessionCommandOutput, EMRClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): {
+        [x: string]: unknown;
+    };
+};
+/**
+ * <p>Creates and starts a new Spark Connect session on the specified cluster. The cluster must be in the <code>RUNNING</code> or <code>WAITING</code> state and have sessions enabled. This operation is supported in Amazon EMR Spark 8.0.0 and later.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { EMRClient, StartSessionCommand } from "@aws-sdk/client-emr"; // ES Modules import
+ * // const { EMRClient, StartSessionCommand } = require("@aws-sdk/client-emr"); // CommonJS import
+ * // import type { EMRClientConfig } from "@aws-sdk/client-emr";
+ * const config = {}; // type is EMRClientConfig
+ * const client = new EMRClient(config);
+ * const input = { // StartSessionInput
+ *   Name: "STRING_VALUE",
+ *   ClusterId: "STRING_VALUE", // required
+ *   ExecutionRoleArn: "STRING_VALUE",
+ *   EngineConfigurations: [ // ConfigurationList
+ *     { // Configuration
+ *       Classification: "STRING_VALUE",
+ *       Configurations: [
+ *         {
+ *           Classification: "STRING_VALUE",
+ *           Configurations: "<ConfigurationList>",
+ *           Properties: { // StringMap
+ *             "<keys>": "STRING_VALUE",
+ *           },
+ *         },
+ *       ],
+ *       Properties: {
+ *         "<keys>": "STRING_VALUE",
+ *       },
+ *     },
+ *   ],
+ *   MonitoringConfiguration: { // SessionMonitoringConfiguration
+ *     CloudWatchLoggingConfiguration: { // SessionCloudWatchLoggingConfiguration
+ *       Enabled: true || false,
+ *       LogGroup: "STRING_VALUE",
+ *       LogStreamNamePrefix: "STRING_VALUE",
+ *       EncryptionKeyArn: "STRING_VALUE",
+ *       LogTypes: { // LogTypesMap
+ *         "<keys>": [ // XmlStringList
+ *           "STRING_VALUE",
+ *         ],
+ *       },
+ *     },
+ *     ManagedLoggingConfiguration: { // SessionManagedLoggingConfiguration
+ *       Enabled: true || false,
+ *       EncryptionKeyArn: "STRING_VALUE",
+ *     },
+ *     S3LoggingConfiguration: { // SessionS3LoggingConfiguration
+ *       Enabled: true || false,
+ *       LogUri: "STRING_VALUE",
+ *       EncryptionKeyArn: "STRING_VALUE",
+ *       LogTypes: {
+ *         "<keys>": [
+ *           "STRING_VALUE",
+ *         ],
+ *       },
+ *     },
+ *   },
+ *   SessionIdleTimeoutInMinutes: Number("long"),
+ *   ClientRequestToken: "STRING_VALUE",
+ *   Tags: [ // TagList
+ *     { // Tag
+ *       Key: "STRING_VALUE",
+ *       Value: "STRING_VALUE",
+ *     },
+ *   ],
+ * };
+ * const command = new StartSessionCommand(input);
+ * const response = await client.send(command);
+ * // { // StartSessionOutput
+ * //   Id: "STRING_VALUE", // required
+ * //   ClusterId: "STRING_VALUE",
+ * //   Arn: "STRING_VALUE",
+ * //   AccountId: "STRING_VALUE",
+ * //   State: "SUBMITTED" || "STARTING" || "STARTED" || "IDLE" || "BUSY" || "TERMINATING" || "TERMINATED" || "FAILED",
+ * // };
+ *
+ * ```
+ *
+ * @param StartSessionCommandInput - {@link StartSessionCommandInput}
+ * @returns {@link StartSessionCommandOutput}
+ * @see {@link StartSessionCommandInput} for command's `input` shape.
+ * @see {@link StartSessionCommandOutput} for command's `response` shape.
+ * @see {@link EMRClientResolvedConfig | config} for EMRClient's `config` shape.
+ *
+ * @throws {@link InternalServerException} (server fault)
+ *  <p>This exception occurs when there is an internal failure in the Amazon EMR
+ *          service.</p>
+ *
+ * @throws {@link InvalidRequestException} (client fault)
+ *  <p>This exception occurs when there is something wrong with user input.</p>
+ *
+ * @throws {@link EMRServiceException}
+ * <p>Base exception class for all service exceptions from EMR service.</p>
+ *
+ *
+ * @public
+ */
+export declare class StartSessionCommand extends StartSessionCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: StartSessionInput;
+            output: StartSessionOutput;
+        };
+        sdk: {
+            input: StartSessionCommandInput;
+            output: StartSessionCommandOutput;
+        };
+    };
+}

package/dist-types/commands/TerminateSessionCommand.d.ts

@@ -0,0 +1,86 @@
+import { Command as $Command } from "@smithy/core/client";
+import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import type { EMRClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EMRClient";
+import type { TerminateSessionInput, TerminateSessionOutput } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link TerminateSessionCommand}.
+ */
+export interface TerminateSessionCommandInput extends TerminateSessionInput {
+}
+/**
+ * @public
+ *
+ * The output of {@link TerminateSessionCommand}.
+ */
+export interface TerminateSessionCommandOutput extends TerminateSessionOutput, __MetadataBearer {
+}
+declare const TerminateSessionCommand_base: {
+    new (input: TerminateSessionCommandInput): import("@smithy/core/client").CommandImpl<TerminateSessionCommandInput, TerminateSessionCommandOutput, EMRClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (input: TerminateSessionCommandInput): import("@smithy/core/client").CommandImpl<TerminateSessionCommandInput, TerminateSessionCommandOutput, EMRClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): {
+        [x: string]: unknown;
+    };
+};
+/**
+ * <p>Terminates an active session. After you call this operation, the session enters the <code>TERMINATING</code> state and then transitions to <code>TERMINATED</code>.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { EMRClient, TerminateSessionCommand } from "@aws-sdk/client-emr"; // ES Modules import
+ * // const { EMRClient, TerminateSessionCommand } = require("@aws-sdk/client-emr"); // CommonJS import
+ * // import type { EMRClientConfig } from "@aws-sdk/client-emr";
+ * const config = {}; // type is EMRClientConfig
+ * const client = new EMRClient(config);
+ * const input = { // TerminateSessionInput
+ *   ClusterId: "STRING_VALUE", // required
+ *   SessionId: "STRING_VALUE", // required
+ * };
+ * const command = new TerminateSessionCommand(input);
+ * const response = await client.send(command);
+ * // { // TerminateSessionOutput
+ * //   ClusterId: "STRING_VALUE", // required
+ * //   SessionId: "STRING_VALUE", // required
+ * //   State: "SUBMITTED" || "STARTING" || "STARTED" || "IDLE" || "BUSY" || "TERMINATING" || "TERMINATED" || "FAILED", // required
+ * // };
+ *
+ * ```
+ *
+ * @param TerminateSessionCommandInput - {@link TerminateSessionCommandInput}
+ * @returns {@link TerminateSessionCommandOutput}
+ * @see {@link TerminateSessionCommandInput} for command's `input` shape.
+ * @see {@link TerminateSessionCommandOutput} for command's `response` shape.
+ * @see {@link EMRClientResolvedConfig | config} for EMRClient's `config` shape.
+ *
+ * @throws {@link InternalServerException} (server fault)
+ *  <p>This exception occurs when there is an internal failure in the Amazon EMR
+ *          service.</p>
+ *
+ * @throws {@link InvalidRequestException} (client fault)
+ *  <p>This exception occurs when there is something wrong with user input.</p>
+ *
+ * @throws {@link EMRServiceException}
+ * <p>Base exception class for all service exceptions from EMR service.</p>
+ *
+ *
+ * @public
+ */
+export declare class TerminateSessionCommand extends TerminateSessionCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: TerminateSessionInput;
+            output: TerminateSessionOutput;
+        };
+        sdk: {
+            input: TerminateSessionCommandInput;
+            output: TerminateSessionCommandOutput;
+        };
+    };
+}

package/dist-types/commands/index.d.ts

@@ -24,6 +24,8 @@ export * from "./GetClusterSessionCredentialsCommand";
 export * from "./GetManagedScalingPolicyCommand";
 export * from "./GetOnClusterAppUIPresignedURLCommand";
 export * from "./GetPersistentAppUIPresignedURLCommand";
+export * from "./GetSessionCommand";
+export * from "./GetSessionEndpointCommand";
 export * from "./GetStudioSessionMappingCommand";
 export * from "./ListBootstrapActionsCommand";
 export * from "./ListClustersCommand";
@@ -33,6 +35,7 @@ export * from "./ListInstancesCommand";
 export * from "./ListNotebookExecutionsCommand";
 export * from "./ListReleaseLabelsCommand";
 export * from "./ListSecurityConfigurationsCommand";
+export * from "./ListSessionsCommand";
 export * from "./ListStepsCommand";
 export * from "./ListStudioSessionMappingsCommand";
 export * from "./ListStudiosCommand";
@@ -54,7 +57,9 @@ export * from "./SetTerminationProtectionCommand";
 export * from "./SetUnhealthyNodeReplacementCommand";
 export * from "./SetVisibleToAllUsersCommand";
 export * from "./StartNotebookExecutionCommand";
+export * from "./StartSessionCommand";
 export * from "./StopNotebookExecutionCommand";
 export * from "./TerminateJobFlowsCommand";
+export * from "./TerminateSessionCommand";
 export * from "./UpdateStudioCommand";
 export * from "./UpdateStudioSessionMappingCommand";

package/dist-types/models/enums.d.ts

@@ -584,6 +584,24 @@ export declare const OnClusterAppUIType: {
  * @public
  */
 export type OnClusterAppUIType = (typeof OnClusterAppUIType)[keyof typeof OnClusterAppUIType];
+/**
+ * @public
+ * @enum
+ */
+export declare const SessionState: {
+    readonly BUSY: "BUSY";
+    readonly FAILED: "FAILED";
+    readonly IDLE: "IDLE";
+    readonly STARTED: "STARTED";
+    readonly STARTING: "STARTING";
+    readonly SUBMITTED: "SUBMITTED";
+    readonly TERMINATED: "TERMINATED";
+    readonly TERMINATING: "TERMINATING";
+};
+/**
+ * @public
+ */
+export type SessionState = (typeof SessionState)[keyof typeof SessionState];
 /**
  * @public
  * @enum