

# インタラクティブセッション API
<a name="aws-glue-api-interactive-sessions"></a>

インタラクティブセッション API は、AWS Glue インタラクティブセッションを使用して、データ統合に向けた抽出、変換、ロード (ETL) スクリプトを構築およびテストする際に関連する AWS Glue API について説明します。

## データタイプ
<a name="aws-glue-api-interactive-sessions-objects"></a>
+ [セッション構造](#aws-glue-api-interactive-sessions-Session)
+ [SessionCommand の構造](#aws-glue-api-interactive-sessions-SessionCommand)
+ [Statement 構造](#aws-glue-api-interactive-sessions-Statement)
+ [StatementOutput 構造](#aws-glue-api-interactive-sessions-StatementOutput)
+ [StatementOutputData 構造](#aws-glue-api-interactive-sessions-StatementOutputData)
+ [ConnectionsList 構造](#aws-glue-api-interactive-sessions-ConnectionsList)

## セッション構造
<a name="aws-glue-api-interactive-sessions-Session"></a>

リモート Spark ランタイム環境が実行されている期間。

**フィールド**
+ `Id` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  セッションの ID
+ `CreatedOn` – タイムスタンプ。

  セッションが作成された日時。
+ `Status` - UTF-8 文字列 (有効値:`PROVISIONING` \|`READY` \|`FAILED` \|`TIMEOUT` \|`STOPPING` \|`STOPPED` ).。

  セッションのステータスです。
+ `ErrorMessage` – 説明文字列。2048 バイト長以下。[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) に一致。

  セッション中に表示されるエラーメッセージです。
+ `Description` – 説明文字列。2048 バイト長以下。[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) に一致。

  セッションの説明です。
+ `Role` - UTF-8 文字列。20 ～ 2,048 バイト長。[Custom string pattern #30](aws-glue-api-common.md#regex_30) に一致。

  セッションに関連付けられている IAM ロールの名前または Amazon リソースネーム (ARN)。
+ `Command` – [SessionCommand](#aws-glue-api-interactive-sessions-SessionCommand) オブジェクト。

  コマンドオブジェクト。「sessionCommand」を参照してください。
+ `DefaultArguments` – キーバリューペアのマップ配列。75 ペア以下。

  各キーは UTF-8 文字列、1～128 バイト長で、[Custom string pattern #31](aws-glue-api-common.md#regex_31) に一致します。

  各値は UTF-8 文字列、4,096 バイト長で、[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) に一致します。

  キーバリューペアのマップ配列。最大ペア数は 75 です。
+ `Connections` – [ConnectionsList](#aws-glue-api-interactive-sessions-ConnectionsList) オブジェクト。

  セッションに使用される接続の数。
+ `Progress` – 数値 (double)。

  セッションのコード実行の進行状況。
+ `MaxCapacity` – 数値 (double)。

  ジョブの実行に割り当てることができる AWS Glue データ処理ユニット (DPU) の数。DPU は処理能力を相対的に測定するもので、4 個の vCPU のコンピューティング性能と 16 GB のメモリで構成されています。
+ `SecurityConfiguration` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  セッションで使用される SecurityConfiguration 構造の名前。
+ `GlueVersion` – UTF-8 文字列。1～255 バイト長。[Custom string pattern #48](aws-glue-api-common.md#regex_48) に一致。

  AWS Glueバージョンにより、AWS Glueがサポートする Apache Spark と Python のバージョンが決定されます。GlueVersion は 2.0 以上である必要があります。
+ `DataAccessId` – UTF-8 文字列、1 ～ 36 バイト。

  セッションのデータアクセス ID。
+ `PartitionId` – UTF-8 文字列、1 ～ 36 バイト。

  セッションのパーティション ID。
+ `NumberOfWorkers` – 数値 (整数)。

  セッションに使用する、定義済み `WorkerType` のワーカー数。
+ `WorkerType` – UTF-8 文字列 (有効な値: `Standard=""` \| `G.1X=""` \| `G.2X=""` \| `G.025X=""` \| `G.4X=""` \| `G.8X=""` \| `Z.2X=""`)。

  セッションの実行時に割り当てられる事前定義済みのワーカーの種類。Spark セッション用 に `G.1X`、`G.2X`、`G.4X`、または `G.8X` の値を使用できます。Ray セッション用に 値 `Z.2X` を使用できます。
+ `CompletedOn` – タイムスタンプ。

  このセッションが完了した日付と時刻。
+ `ExecutionTime` – 数値 (double)。

  セッションの合計実行時間。
+ `DPUSeconds` – 数値 (double)。

  セッションによって消費された DPU (式: ExecutionTime \* MaxCapacity)。
+ `IdleTimeout` – 数値 (整数)。

  セッションがタイムアウトするまでのアイドル時の分数。
+ `ProfileName` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  セッションに関連付けられた AWS Glue 使用プロフィールの名前。

## SessionCommand の構造
<a name="aws-glue-api-interactive-sessions-SessionCommand"></a>

ジョブを実行する `SessionCommand`。

**フィールド**
+ `Name` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  SessionCommand の名前を指定します。「glueetl」または「gluestreaming」を使用できます。
+ `PythonVersion`– UTF-8 文字列。[Custom string pattern #49](aws-glue-api-common.md#regex_49) に一致。

  Python バージョンを指定します。Python バージョンは、Spark タイプのジョブでサポートされるバージョンを示します。

## Statement 構造
<a name="aws-glue-api-interactive-sessions-Statement"></a>

セッションで特定のアクションを発生させるためのステートメントまたはリクエスト。

**フィールド**
+ `Id` – 数値 (整数)。

  ステートメントの ID。
+ `Code` – UTF–8 文字列。

  ステートメントの実行コード。
+ `State` - UTF-8 文字列 (有効値:`WAITING` \|`RUNNING` \|`AVAILABLE` \|`CANCELLING` \|`CANCELLED` \|`ERROR` ).。

  リクエストがアクションされている間の状態。
+ `Output` – [StatementOutput](#aws-glue-api-interactive-sessions-StatementOutput) オブジェクト。

  JSON 形式での出力。
+ `Progress` – 数値 (double)。

  コード実行の進行状況。
+ `StartedOn` – 数値 (long)。

  ジョブ定義が開始された UNIX の日時。
+ `CompletedOn` – 数値 (long)。

  ジョブ定義が完了した UNIX の日時。

## StatementOutput 構造
<a name="aws-glue-api-interactive-sessions-StatementOutput"></a>

JSON 形式のコード実行の出力。

**フィールド**
+ `Data` – [StatementOutputData](#aws-glue-api-interactive-sessions-StatementOutputData) オブジェクト。

  コード実行の出力。
+ `ExecutionCount` – 数値 (整数)。

  出力の実行回数。
+ `Status` - UTF-8 文字列 (有効値:`WAITING` \|`RUNNING` \|`AVAILABLE` \|`CANCELLING` \|`CANCELLED` \|`ERROR` ).。

  コード実行の出力状態。
+ `ErrorName` – UTF–8 文字列。

  出力内エラーの名前。
+ `ErrorValue` – UTF–8 文字列。

  出力のエラー値。
+ `Traceback` – UTF-8 文字列の配列。

  出力のトレースバック。

## StatementOutputData 構造
<a name="aws-glue-api-interactive-sessions-StatementOutputData"></a>

JSON 形式のコード実行の出力。

**フィールド**
+ `TextPlain` – UTF-8 文字列。

  テキスト形式のコード実行の出力。

## ConnectionsList 構造
<a name="aws-glue-api-interactive-sessions-ConnectionsList"></a>

ジョブが使用する接続を指定します。

**フィールド**
+ `Connections` - UTF-8 文字列の配列。文字列 1,000 個以下。

  ジョブが使用する接続のリスト。

## 操作
<a name="aws-glue-api-interactive-sessions-actions"></a>
+ [CreateSession アクション (Python: create\_session)](#aws-glue-api-interactive-sessions-CreateSession)
+ [StopSession アクション (Python: stop\_session)](#aws-glue-api-interactive-sessions-StopSession)
+ [DeleteSession アクション (Python: delete\_session)](#aws-glue-api-interactive-sessions-DeleteSession)
+ [GetSession アクション (Python: get\_session)](#aws-glue-api-interactive-sessions-GetSession)
+ [ListSessions アクション (Python: list\_sessions)](#aws-glue-api-interactive-sessions-ListSessions)
+ [RunStatement アクション (Python: run\_statement)](#aws-glue-api-interactive-sessions-RunStatement)
+ [CancelStatement アクション (Python: cancel\_statement)](#aws-glue-api-interactive-sessions-CancelStatement)
+ [GetStatement アクション (Python: get\_statement)](#aws-glue-api-interactive-sessions-GetStatement)
+ [ListStatements アクション (Python: list\_statements)](#aws-glue-api-interactive-sessions-ListStatements)
+ [GetGlueIdentityCenterConfiguration action (Python: get\_glue\_identity\_center\_configuration)](#aws-glue-api-interactive-sessions-GetGlueIdentityCenterConfiguration)
+ [UpdateGlueIdentityCenterConfiguration action (Python: update\_glue\_identity\_center\_configuration)](#aws-glue-api-interactive-sessions-UpdateGlueIdentityCenterConfiguration)
+ [CreateGlueIdentityCenterConfiguration action (Python: create\_glue\_identity\_center\_configuration)](#aws-glue-api-interactive-sessions-CreateGlueIdentityCenterConfiguration)
+ [DeleteGlueIdentityCenterConfiguration action (Python: delete\_glue\_identity\_center\_configuration)](#aws-glue-api-interactive-sessions-DeleteGlueIdentityCenterConfiguration)

## CreateSession アクション (Python: create\_session)
<a name="aws-glue-api-interactive-sessions-CreateSession"></a>

新しいセッションを作成します。

**リクエスト**

新しいセッションの作成をリクエストします。
+ `Id` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  セッションリクエストの ID。
+ `Description` – 説明文字列。2,048 バイト長以下。[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) に一致。

  セッションの説明です。
+ `Role` – *必須:* UTF-8 文字列。20 ～ 2,048 バイト長。[Custom string pattern #30](aws-glue-api-common.md#regex_30) に一致。

  IAM ロール の ARN 
+ `Command` – *必須:* [SessionCommand](#aws-glue-api-interactive-sessions-SessionCommand) オブジェクト。

  ジョブを実行する `SessionCommand`。
+ `Timeout` – 数値 (整数)。1 以上。

   セッションがタイムアウトするまでの時間 (分)。Spark ETL ジョブのデフォルト値は 48 時間 (2,880 分) です。他のジョブタイプについては、ドキュメントを参照してください。
+ `IdleTimeout` – 数値 (整数)。1 以上。

   セッションがタイムアウトするまでのアイドル時の分数。Spark ETL ジョブのデフォルトは、タイムアウト値です。他のジョブタイプについては、ドキュメントを参照してください。
+ `DefaultArguments` – キーバリューペアのマップ配列。75 ペア以下。

  各キーは UTF-8 文字列、1～128 バイト長で、[Custom string pattern #31](aws-glue-api-common.md#regex_31) に一致します。

  各値は UTF-8 文字列、4,096 バイト長で、[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) に一致します。

  キーバリューペアのマップ配列。最大ペア数は 75 です。
+ `Connections` – [ConnectionsList](#aws-glue-api-interactive-sessions-ConnectionsList) オブジェクト。

  セッションに使用する接続の数。
+ `MaxCapacity` – 数値 (double)。

  ジョブの実行に割り当てることができる AWS Glue データ処理ユニット (DPU) の数。DPU は処理能力を相対的に測定するもので、4 個の vCPU のコンピューティング性能と 16 GB のメモリで構成されています。
+ `NumberOfWorkers` – 数値 (整数)。

  セッションに使用する、定義済み `WorkerType` のワーカー数。
+ `WorkerType` – UTF-8 文字列 (有効な値: `Standard=""` \| `G.1X=""` \| `G.2X=""` \| `G.025X=""` \| `G.4X=""` \| `G.8X=""` \| `Z.2X=""`)。

  ジョブの実行時に割り当てられる事前定義済みのワーカーの種類。Spark ジョブに使用できる値は G.1X、G.2X、G.4X、または G.8X です。Ray ノートブックに使用できる値は Z.2X です。
  + `G.1X` ワーカータイプでは、各ワーカーは 1 DPU (4 vCPU、16 GB のメモリ、94 GB のディスク) にマッピングされており、ワーカーごとに 1 個のエグゼキュターを提供します。データ変換、結合、クエリなどのワークロードには、ほとんどのジョブを実行するためのスケーラブルで費用対効果の高い方法として、このワーカータイプをお勧めします。
  + `G.2X` ワーカータイプでは、各ワーカーは 2 DPU (8 vCPU、32 GB のメモリ、138 GB のディスク) にマッピングされており、ワーカーごとに 1 個のエグゼキュターを提供します。データ変換、結合、クエリなどのワークロードには、ほとんどのジョブを実行するためのスケーラブルで費用対効果の高い方法として、このワーカータイプをお勧めします。
  + `G.4X` ワーカータイプでは、各ワーカーは 4 DPU (16 vCPU、64 GB のメモリ、256 GB のディスク) にマッピングされており、ワーカーごとに 1 個のエグゼキュターを提供します。ワークロードに含まれる変換、集約、結合、クエリへの要求が非常に厳しいジョブには、このワーカータイプをお勧めします。このワーカータイプは、AWS Glue バージョン 3.0 以降の Spark ETL ジョブでのみ使用可能で、以下の AWS リージョンで使用できます。米国東部 (オハイオ)、米国東部 (バージニア北部)、米国西部 (オレゴン)、アジアパシフィック (シンガポール)、アジアパシフィック (シドニー)、アジアパシフィック (東京)、カナダ (中部)、欧州 (フランクフルト)、欧州 (アイルランド)、欧州 (ストックホルム)。
  + `G.8X` ワーカータイプでは、各ワーカーは 8 DPU (32 vCPU、128 GB のメモリ、512 GB のディスク) にマッピングされており、ワーカーごとに 1 個のエグゼキュターを提供します。ワークロードに含まれる変換、集約、結合、クエリへの要求が非常に厳しいジョブには、このワーカータイプをお勧めします。このワーカータイプは、AWS Glue バージョン 3.0 以降の Spark ETL ジョブでのみ使用可能で、`G.4X` ワーカータイプでサポートされているのと同じ AWS リージョンで使用できます。
  + `Z.2X` ワーカータイプでは、各ワーカーは 2 M-DPU (8 vCPU、64 GB のメモリ、128 GB のディスク) にマッピングされており、オートスケーラーに基づき最大 8 個の Ray ワーカーを提供します。
+ `SecurityConfiguration` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  セッションで使用される SecurityConfiguration 構造の名前 
+ `GlueVersion` – UTF-8 文字列。1～255 バイト長。[Custom string pattern #48](aws-glue-api-common.md#regex_48) に一致。

  AWS Glueバージョンにより、AWS Glueがサポートする Apache Spark と Python のバージョンが決定されます。GlueVersion は 2.0 以上である必要があります。
+ `DataAccessId` – UTF-8 文字列、1 ～ 36 バイト。

  セッションのデータアクセス ID。
+ `PartitionId` – UTF-8 文字列、1 ～ 36 バイト。

  セッションのパーティション ID。
+ `Tags` – キーと値のペアのマップ配列。50 ペア以下。

  各キーは UTF-8 文字列で、1～128 バイト長です。

  各値は UTF-8 文字列で、256 バイト長以下です。

  セッションに属するキーバリューペアのマップ (タグ)。
+ `RequestOrigin` – UTF-8 文字列。1～128 バイト長。[Custom string pattern #31](aws-glue-api-common.md#regex_31) に一致。

  リクエストの送信元。
+ `ProfileName` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  セッションに関連付けられた AWS Glue 使用プロフィールの名前。

**応答**
+ `Session` – [セッション](#aws-glue-api-interactive-sessions-Session) オブジェクト。

  レスポンス内のセッションオブジェクトを返します。

**エラー**
+ `AccessDeniedException`
+ `IdempotentParameterMismatchException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `ValidationException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`

## StopSession アクション (Python: stop\_session)
<a name="aws-glue-api-interactive-sessions-StopSession"></a>

セッションを停止します。

**リクエスト**
+ `Id` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  停止するセッションの ID。
+ `RequestOrigin` – UTF-8 文字列。1～128 バイト長。[Custom string pattern #31](aws-glue-api-common.md#regex_31) に一致。

  リクエストの送信元。

**応答**
+ `Id` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  停止したセッションの ID を返します。

**エラー**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`
+ `ConcurrentModificationException`

## DeleteSession アクション (Python: delete\_session)
<a name="aws-glue-api-interactive-sessions-DeleteSession"></a>

セッションを削除します。

**リクエスト**
+ `Id` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  削除するセッションの ID。
+ `RequestOrigin` – UTF-8 文字列。1～128 バイト長。[Custom string pattern #31](aws-glue-api-common.md#regex_31) に一致。

  セッション削除リクエスト送信元の名前。

**応答**
+ `Id` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  削除したセッションの ID を返します。

**エラー**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`
+ `ConcurrentModificationException`

## GetSession アクション (Python: get\_session)
<a name="aws-glue-api-interactive-sessions-GetSession"></a>

セッションを取得します。

**リクエスト**
+ `Id` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  セッションの ID 
+ `RequestOrigin` – UTF-8 文字列。1～128 バイト長。[Custom string pattern #31](aws-glue-api-common.md#regex_31) に一致。

  リクエストの送信元。

**応答**
+ `Session` – [セッション](#aws-glue-api-interactive-sessions-Session) オブジェクト。

  セッションオブジェクトはレスポンスで返されます。

**エラー**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`

## ListSessions アクション (Python: list\_sessions)
<a name="aws-glue-api-interactive-sessions-ListSessions"></a>

セッションのリストを取得します。

**リクエスト**
+ `NextToken` - UTF-8 文字列。400,000 バイト長以下。

  次の結果セットのトークン、または追加の結果がない場合は null。
+ `MaxResults` – 1～1000 の数値 (整数)。

  結果の最大数。
+ `Tags` – キーと値のペアのマップ配列。50 ペア以下。

  各キーは UTF-8 文字列で、1～128 バイト長です。

  各値は UTF-8 文字列で、256 バイト長以下です。

  セッションに属するタグ。
+ `RequestOrigin` – UTF-8 文字列。1～128 バイト長。[Custom string pattern #31](aws-glue-api-common.md#regex_31) に一致。

  リクエストの送信元。

**応答**
+ `Ids` – UTF-8 文字列の配列。

  セッションの ID を返します。
+ `Sessions` – [セッション](#aws-glue-api-interactive-sessions-Session) オブジェクトの配列。

  セッションオブジェクトを返します。
+ `NextToken` - UTF-8 文字列。400,000 バイト長以下。

  次の結果セットのトークン、または追加の結果がない場合は null。

**エラー**
+ `AccessDeniedException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## RunStatement アクション (Python: run\_statement)
<a name="aws-glue-api-interactive-sessions-RunStatement"></a>

ステートメントを実行します。

**リクエスト**
+ `SessionId` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  実行するステートメントのセッション ID。
+ `Code` – *必須:* UTF-8 文字列。68,000 バイト長未満。

  実行するステートメントのコード。
+ `RequestOrigin` – UTF-8 文字列。1～128 バイト長。[Custom string pattern #31](aws-glue-api-common.md#regex_31) に一致。

  リクエストの送信元。

**応答**
+ `Id` – 数値 (整数)。

  実行されたステートメントの ID を返します。

**エラー**
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `ValidationException`
+ `ResourceNumberLimitExceededException`
+ `IllegalSessionStateException`

## CancelStatement アクション (Python: cancel\_statement)
<a name="aws-glue-api-interactive-sessions-CancelStatement"></a>

ステートメントをキャンセルします。

**リクエスト**
+ `SessionId` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  キャンセルするステートメントのセッション ID。
+ `Id` – *必須:* 数値 (integer)。

  キャンセルするステートメントの ID。
+ `RequestOrigin` – UTF-8 文字列。1～128 バイト長。[Custom string pattern #31](aws-glue-api-common.md#regex_31) に一致。

  ステートメントのキャンセルをリクエストした送信元。

**応答**
+ *応答パラメータはありません。*

**エラー**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`

## GetStatement アクション (Python: get\_statement)
<a name="aws-glue-api-interactive-sessions-GetStatement"></a>

ステートメントを取得します。

**リクエスト**
+ `SessionId` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  ステートメントのセッション ID。
+ `Id` – *必須:* 数値 (integer)。

  ステートメントの ID。
+ `RequestOrigin` – UTF-8 文字列。1～128 バイト長。[Custom string pattern #31](aws-glue-api-common.md#regex_31) に一致。

  リクエストの送信元。

**応答**
+ `Statement` – [Statement](#aws-glue-api-interactive-sessions-Statement) オブジェクト。

  ステートメントを返します。

**エラー**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`

## ListStatements アクション (Python: list\_statements)
<a name="aws-glue-api-interactive-sessions-ListStatements"></a>

セッションのステートメントをリスト表示します。

**リクエスト**
+ `SessionId` – *必須:* UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。

  ステートメントのセッション ID。
+ `RequestOrigin` – UTF-8 文字列。1～128 バイト長。[Custom string pattern #31](aws-glue-api-common.md#regex_31) に一致。

  ステートメントのリスト表示をリクエストした送信元。
+ `NextToken` - UTF-8 文字列。400,000 バイト長以下。

  継続トークン (これが継続呼び出しの場合)。

**応答**
+ `Statements` – [Statement](#aws-glue-api-interactive-sessions-Statement) オブジェクトの配列。

  ステートメントのリストを返します。
+ `NextToken` - UTF-8 文字列。400,000 バイト長以下。

  一部のステートメントがまだ返されていない場合は、継続トークン。

**エラー**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`

## GetGlueIdentityCenterConfiguration action (Python: get\_glue\_identity\_center\_configuration)
<a name="aws-glue-api-interactive-sessions-GetGlueIdentityCenterConfiguration"></a>

関連付けられた AWS Glue アイデンティセンターインスタンスとアプリケーション情報を含む、現在のアイデンティセンター設定の詳細を取得します。

**リクエスト**
+ *リクエストパラメータなし*

**応答**

AWS Glue アイデンティセンター設定の詳細を含むレスポンス。
+ `ApplicationArn` – UTF-8 文字列。10～1,224 バイト長。

  AWS Glue 設定に関連付けられたアイデンティセンターアプリケーションの Amazon リソースネーム (ARN)。
+ `InstanceArn` – UTF-8 文字列。10～1,224 バイト長。

  AWS Glue 設定に関連付けられたアイデンティセンターインスタンスの Amazon リソースネーム (ARN)。
+ `Scopes` – UTF-8 文字列の配列。

  AWS Glue 設定のアクセス許可とアクセスレベルを定義するアイデンティセンタースコープのリスト。

**エラー**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`

## UpdateGlueIdentityCenterConfiguration action (Python: update\_glue\_identity\_center\_configuration)
<a name="aws-glue-api-interactive-sessions-UpdateGlueIdentityCenterConfiguration"></a>

既存の AWS Glue アイデンティセンター設定を更新し、統合のスコープとアクセス許可の変更を許可します。

**リクエスト**

既存の AWS Glue アイデンティセンター設定の更新をリクエストします。
+ `Scopes` – UTF-8 文字列の配列、1～50 個の文字列。

  AWS Glue 設定の更新されたアクセス許可とアクセスレベルを定義するアイデンティセンタースコープのリスト。

**応答**
+ *応答パラメータはありません。*

**エラー**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`

## CreateGlueIdentityCenterConfiguration action (Python: create\_glue\_identity\_center\_configuration)
<a name="aws-glue-api-interactive-sessions-CreateGlueIdentityCenterConfiguration"></a>

認証と認可のために AWS Glue と AWS IAM アイデンティセンターの統合を有効にする新しい AWS Glue アイデンティセンター設定を作成します。

**リクエスト**

新しい AWS Glue アイデンティセンター設定の作成をリクエストします。
+ `InstanceArn` – *必須:* UTF-8 文字列。10～1,224 バイト長。

  AWS Glue 設定に関連付けられるアイデンティセンターインスタンスの Amazon リソースネーム (ARN)。
+ `Scopes` – UTF-8 文字列の配列、1～50 個の文字列。

  AWS Glue 設定のアクセス許可とアクセスレベルを定義するアイデンティセンタースコープのリスト。

**応答**

新しい AWS Glue アイデンティセンター設定の作成のレスポンス。
+ `ApplicationArn` – UTF-8 文字列。10～1,224 バイト長。

  AWS Glue 設定向けに作成されたアイデンティセンターアプリケーションの Amazon リソースネーム (ARN)。

**エラー**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`

## DeleteGlueIdentityCenterConfiguration action (Python: delete\_glue\_identity\_center\_configuration)
<a name="aws-glue-api-interactive-sessions-DeleteGlueIdentityCenterConfiguration"></a>

既存の AWS Glue アイデンティセンター設定を削除し、AWS Glue と AWS IAM アイデンティセンターの統合を削除します。

**リクエスト**
+ *リクエストパラメータなし*

**応答**
+ *応答パラメータはありません。*

**エラー**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`