本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 互動式工作階段 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>
+ [Session 結構](#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)

## Session 結構
<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` \$1 `READY` \$1 `FAILED` \$1 `TIMEOUT` \$1 `STOPPING` \$1 `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 個位元組，也不可以超過 2048 個位元組，且需符合 [Custom string pattern #30](aws-glue-api-common.md#regex_30)。

  與此工作階段相關聯 IAM 角色的名稱或 Amazon Resource Name (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 字串，長度不可超過 4096 個位元組，需符合 [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` – 數字 (雙位數)。

  工作階段的程式碼執行進度。
+ `MaxCapacity` – 數字 (雙位數)。

  任務執行時可配置的 AWS Glue 資料處理單位 (DPUs) 數量。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=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`)。

  工作階段執行時分配的預先定義工作者類型。接受 Spark 工作階段的 `G.1X`、`G.2X`、`G.4X` 或 `G.8X` 值。接受 Ray 工作階段的 `Z.2X` 值。
+ `CompletedOn` – 時間戳記。

  此工作階段完成的日期和時間。
+ `ExecutionTime` – 數字 (雙位數)。

  工作階段執行的總時間。
+ `DPUSeconds` – 數字 (雙位數)。

  工作階段使用的 DPU (公式：ExecutionTime \$1 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` \$1 `RUNNING` \$1 `AVAILABLE` \$1 `CANCELLING` \$1 `CANCELLED` \$1 `ERROR`)。

  處理請求時的狀態。
+ `Output` – [StatementOutput](#aws-glue-api-interactive-sessions-StatementOutput) 物件。

  JSON 格式的輸出。
+ `Progress` – 數字 (雙位數)。

  程式碼執行進度。
+ `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` \$1 `RUNNING` \$1 `AVAILABLE` \$1 `CANCELLING` \$1 `CANCELLED` \$1 `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 字串陣列，不可超過 1000 個字串。

  任務所使用連線的清單。

## 作業
<a name="aws-glue-api-interactive-sessions-actions"></a>
+ [CreateSession 動作 (Python: create\$1session)](#aws-glue-api-interactive-sessions-CreateSession)
+ [StopSession 動作 (Python: stop\$1session)](#aws-glue-api-interactive-sessions-StopSession)
+ [DeleteSession 動作 (Python: delete\$1session)](#aws-glue-api-interactive-sessions-DeleteSession)
+ [GetSession 動作 (Python: get\$1session)](#aws-glue-api-interactive-sessions-GetSession)
+ [ListSessions 動作 (Python: list\$1sessions)](#aws-glue-api-interactive-sessions-ListSessions)
+ [RunStatement 動作 (Python: run\$1statement)](#aws-glue-api-interactive-sessions-RunStatement)
+ [CancelStatement 動作 (Python: cancel\$1statement)](#aws-glue-api-interactive-sessions-CancelStatement)
+ [GetStatement 動作 (Python: get\$1statement)](#aws-glue-api-interactive-sessions-GetStatement)
+ [ListStatements 動作 (Python: list\$1statements)](#aws-glue-api-interactive-sessions-ListStatements)
+ [GetGlueIdentityCenterConfiguration 動作 (Python：get\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-GetGlueIdentityCenterConfiguration)
+ [UpdateGlueIdentityCenterConfiguration 動作 (Python：update\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-UpdateGlueIdentityCenterConfiguration)
+ [CreateGlueIdentityCenterConfiguration 動作 (Python：create\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-CreateGlueIdentityCenterConfiguration)
+ [DeleteGlueIdentityCenterConfiguration 動作 (Python：delete\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-DeleteGlueIdentityCenterConfiguration)

## CreateSession 動作 (Python: create\$1session)
<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` – 描述字串，長度不可超過 2048 個位元組，需符合[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)。

  工作階段的描述。
+ `Role` – *必要：*UTF-8 字串，長度不可小於 20 個位元組，也不可以超過 2048 個位元組，且需符合[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 字串，長度不可超過 4096 個位元組，需符合 [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` – 數字 (雙位數)。

  任務執行時可配置的 AWS Glue 資料處理單位 (DPUs) 數量。DPU 是相對的處理能力，包含 4 個 vCPU 的運算容量和 16 GB 的記憶體。
+ `NumberOfWorkers` – 數字 (整數)。

  用於工作階段的已定義 `WorkerType` 的工作者數量。
+ `WorkerType` – UTF-8 字串 (有效值：`Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `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 區域中的 3.0 AWS Glue 版或更新版本 Spark ETL 任務：美國東部 （俄亥俄）、美國東部 （維吉尼亞北部）、美國西部 （奧勒岡）、亞太區域 （新加坡）、亞太區域 （雪梨）、亞太區域 （東京）、加拿大 （中部）、歐洲 （法蘭克福）、歐洲 （愛爾蘭） 和歐洲 （斯德哥爾摩）。
  + 用於 `G.8X` 工作者類型時，每個工作者會映射到 8 個 DPU (32 個 vCPU、128 GB 的記憶體)，外加 512 GB 磁碟，並為每個工作者提供 1 個執行器。我們建議工作負載包含最嚴苛轉換、彙總、聯結和查詢的任務採用這種工作者類型。此工作者類型僅適用於 3.0 AWS Glue 版或更新版本的 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` – [Session (工作階段)](#aws-glue-api-interactive-sessions-Session) 物件。

  在回應中傳回工作階段物件。

**錯誤**
+ `AccessDeniedException`
+ `IdempotentParameterMismatchException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `ValidationException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`

## StopSession 動作 (Python: stop\$1session)
<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\$1session)
<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\$1session)
<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` – [Session (工作階段)](#aws-glue-api-interactive-sessions-Session) 物件。

  回應中傳回的工作階段物件。

**錯誤**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`

## ListSessions 動作 (Python: list\$1sessions)
<a name="aws-glue-api-interactive-sessions-ListSessions"></a>

擷取工作階段的清單。

**請求**
+ `NextToken` – UTF-8 字串，長度不可超過 400000 個位元組。

  用於下一組結果的字符，如果沒有更多結果則為 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` – 一個 [Session (工作階段)](#aws-glue-api-interactive-sessions-Session) 物件陣列。

  傳回工作階段物件。
+ `NextToken` – UTF-8 字串，長度不可超過 400000 個位元組。

  用於下一組結果的字符，如果沒有更多結果則為 null。

**錯誤**
+ `AccessDeniedException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## RunStatement 動作 (Python: run\$1statement)
<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 字串，長度不可超過 68000 個位元組。

  要執行的陳述式程式碼。
+ `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\$1statement)
<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` – *必要：*數字 (整數)。

  要取消之陳述式的 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\$1statement)
<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` – *必要：*數字 (整數)。

  陳述式的 ID。
+ `RequestOrigin` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組，且需符合 [Custom string pattern #31](aws-glue-api-common.md#regex_31)。

  請求的來源。

**回應**
+ `Statement` – [陳述式](#aws-glue-api-interactive-sessions-Statement) 物件。

  傳回陳述式。

**錯誤**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`

## ListStatements 動作 (Python: list\$1statements)
<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 字串，長度不可超過 400000 個位元組。

  接續符記，如果這是接續呼叫。

**回應**
+ `Statements` – 一個 [陳述式](#aws-glue-api-interactive-sessions-Statement) 物件陣列。

  傳回陳述式清單。
+ `NextToken` – UTF-8 字串，長度不可超過 400000 個位元組。

  接續字符 (如果尚未傳回所有陳述)。

**錯誤**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`

## GetGlueIdentityCenterConfiguration 動作 (Python：get\$1glue\$1identity\$1center\$1configuration)
<a name="aws-glue-api-interactive-sessions-GetGlueIdentityCenterConfiguration"></a>

擷取目前的 AWS Glue Identity Center 組態詳細資訊，包括相關聯的 Identity Center 執行個體和應用程式資訊。

**請求**
+ *無要求參數。*

**回應**

包含 AWS Glue Identity Center 組態詳細資訊的回應。
+ `ApplicationArn` – UTF-8 字串，長度不可小於 10 個位元組，也不可以超過 1224 個位元組。

  與 AWS Glue 組態相關聯之 Identity Center 應用程式的 Amazon Resource Name (ARN)。
+ `InstanceArn` – UTF-8 字串，長度不可小於 10 個位元組，也不可以超過 1224 個位元組。

  與 AWS Glue 組態相關聯之 Identity Center 執行個體的 Amazon Resource Name (ARN)。
+ `Scopes` – UTF-8 字串陣列。

  定義 AWS Glue 組態許可和存取層級的 Identity Center 範圍清單。

**錯誤**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`

## UpdateGlueIdentityCenterConfiguration 動作 (Python：update\$1glue\$1identity\$1center\$1configuration)
<a name="aws-glue-api-interactive-sessions-UpdateGlueIdentityCenterConfiguration"></a>

更新現有的 AWS Glue Identity Center 組態，允許修改整合的範圍和許可。

**請求**

請求更新現有的 AWS Glue Identity Center 組態。
+ `Scopes` – UTF-8 字串的陣列，不可小於 1 或超過 50 個字串。

  定義 AWS Glue 組態更新許可和存取層級的 Identity Center 範圍清單。

**回應**
+ *無回應參數。*

**錯誤**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`

## CreateGlueIdentityCenterConfiguration 動作 (Python：create\$1glue\$1identity\$1center\$1configuration)
<a name="aws-glue-api-interactive-sessions-CreateGlueIdentityCenterConfiguration"></a>

建立新的 AWS Glue Identity Center 組態，以啟用 AWS Glue 與 IAM Identity Center AWS 之間的整合，以進行身分驗證和授權。

**請求**

請求建立新的 AWS Glue Identity Center 組態。
+ `InstanceArn` – *必要：*UTF-8 字串，長度不可小於 10 個位元組，也不可以超過 1224 個位元組。

  要與 AWS Glue 組態建立關聯之 Identity Center 執行個體的 Amazon Resource Name (ARN)。
+ `Scopes` – UTF-8 字串的陣列，不可小於 1 或超過 50 個字串。

  定義 AWS Glue 組態許可和存取層級的 Identity Center 範圍清單。

**回應**

建立新 AWS Glue Identity Center 組態的回應。
+ `ApplicationArn` – UTF-8 字串，長度不可小於 10 個位元組，也不可以超過 1224 個位元組。

  為 AWS Glue 組態建立之 Identity Center 應用程式的 Amazon Resource Name (ARN)。

**錯誤**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`

## DeleteGlueIdentityCenterConfiguration 動作 (Python：delete\$1glue\$1identity\$1center\$1configuration)
<a name="aws-glue-api-interactive-sessions-DeleteGlueIdentityCenterConfiguration"></a>

刪除現有的 AWS Glue Identity Center 組態，移除 AWS Glue 和 AWS IAM Identity Center 之間的整合。

**請求**
+ *無要求參數。*

**回應**
+ *無回應參數。*

**錯誤**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`