# Sessões API interativas
A API de sessões interativas descreve a API do AWS Glue relacionada ao uso de sessões interativas do AWS Glue para criar e testar scripts de extração, transformação e carregamento (ETL) para a integração de dados.
## Tipos de dados
+ [Estrutura Session](#aws-glue-api-interactive-sessions-Session)
+ [Estrutura SessionCommand](#aws-glue-api-interactive-sessions-SessionCommand)
+ [Estrutura Statement](#aws-glue-api-interactive-sessions-Statement)
+ [Estrutura StatementOutput](#aws-glue-api-interactive-sessions-StatementOutput)
+ [Estrutura StatementOutputData](#aws-glue-api-interactive-sessions-StatementOutputData)
+ [Estrutura ConnectionsList](#aws-glue-api-interactive-sessions-ConnectionsList)
## Estrutura Session
O período em que um ambiente do runtime remoto do Spark está sendo executado.
**Campos**
+ `Id` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O ID da sessão.
+ `CreatedOn` – Timestamp.
A data e a hora em que a sessão foi criada.
+ `Status` – String UTF-8 (valores válidos: `PROVISIONING` \$1 `READY` \$1 `FAILED` \$1 `TIMEOUT` \$1 `STOPPING` \$1 `STOPPED`).
O status da sessão.
+ `ErrorMessage` – string de descrição com no máximo 2.048 bytes de comprimento e correspondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
A mensagem de erro exibida durante a sessão.
+ `Description` – string de descrição com no máximo 2.048 bytes de comprimento e correspondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
A descrição da sessão.
+ `Role` – String UTF-8, superior a 20 e inferior a 2048 bytes de comprimento, correspondente a [Custom string pattern #30](aws-glue-api-common.md#regex_30).
O nome ou nome de recurso da Amazon (ARN) da função do IAM associada à sessão.
+ `Command` – Um objeto [SessionCommand](#aws-glue-api-interactive-sessions-SessionCommand).
O comando Object.Consulte SessionCommand.
+ `DefaultArguments` – Uma matriz de mapas de pares de valores-chave, não mais de 75 pares.
Cada chave é uma string UTF-8, com comprimento entre 1 e 128 bytes, correspondente a [Custom string pattern #31](aws-glue-api-common.md#regex_31).
Cada valor é uma string UTF-8, com comprimento não superior a 4096 bytes, correspondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
Um array de mapa dos pares de valor-chave. O máximo é de 75 pares.
+ `Connections` – Um objeto [ConnectionsList](#aws-glue-api-interactive-sessions-ConnectionsList).
O número de conexões usadas para a sessão.
+ `Progress` – Número (duplo).
O andamento da execução do código da sessão.
+ `MaxCapacity` – Número (duplo).
O número de unidades de processamento de dados (DPUs) do AWS Glue que poderão ser alocadas quando o trabalho for executado. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória.
+ `SecurityConfiguration` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome da estrutura SecurityConfiguration a ser usada com a sessão.
+ `GlueVersion` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Custom string pattern #48](aws-glue-api-common.md#regex_48).
A versão AWS Glue determina as versões do Apache Spark e do Python compatíveis com o AWS Glue. O GlueVersion deve ser maior que 2.0.
+ `DataAccessId` - String UTF-8, não menos do que 1 ou superior a 36 bytes de comprimento.
O ID de acesso a dados da sessão.
+ `PartitionId` - String UTF-8, não menos do que 1 ou superior a 36 bytes de comprimento.
O ID da partição da sessão.
+ `NumberOfWorkers` – Número (íntegro).
O número de operadores de determinado `WorkerType` para usar na sessão.
+ `WorkerType` – string UTF-8 (valores válidos: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).
O tipo de operador predefinido que é alocado quando uma sessão é executada. Aceita um valor de `G.1X`, `G.2X`, `G.4X` ou `G.8X` para sessões do Spark. Aceita o valor `Z.2X` para sessões do Ray.
+ `CompletedOn` – Timestamp.
A data e a hora em que a execução desse trabalho foi concluída.
+ `ExecutionTime` – Número (duplo).
O tempo total durante o qual a sessão foi executada.
+ `DPUSeconds` – Número (duplo).
As DPUs consumidas pela sessão (fórmula: ExecutionTime \$1 MaxCapacity).
+ `IdleTimeout` – Número (íntegro).
O número de minutos de natividade até esgotar o tempo limite da sessão.
+ `ProfileName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome de um perfil de uso do AWS Glue associado à sessão.
## Estrutura SessionCommand
O `SessionCommand` que executa esse trabalho.
**Campos**
+ `Name` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Especifica o nome do SessionCommand. Pode ser “glueetl” ou “glueestreaming”.
+ `PythonVersion` – String UTF-8 correspondente a [Custom string pattern #49](aws-glue-api-common.md#regex_49).
Especifica a versão usada do Python. A versão do Python indica a versão compatível com trabalhos do tipo Spark.
## Estrutura Statement
A declaração ou solicitação para que uma ação específica ocorra em uma sessão.
**Campos**
+ `Id` – Número (íntegro).
O ID da instrução.
+ `Code` – String UTF-8.
O código de execução da instrução.
+ `State` – String UTF-8 (valores válidos: `WAITING` \$1 `RUNNING` \$1 `AVAILABLE` \$1 `CANCELLING` \$1 `CANCELLED` \$1 `ERROR`).
O estado enquanto a solicitação é acionada.
+ `Output` – Um objeto [StatementOutput](#aws-glue-api-interactive-sessions-StatementOutput).
A saída em JSON.
+ `Progress` – Número (duplo).
O progresso da execução do código.
+ `StartedOn` – Número (extenso).
A hora e a data unix em que a definição de trabalho foi iniciada.
+ `CompletedOn` – Número (extenso).
A hora e a data unix em que a definição de trabalho foi concluída.
## Estrutura StatementOutput
O resultado da execução de código no formato JSON.
**Campos**
+ `Data` – Um objeto [StatementOutputData](#aws-glue-api-interactive-sessions-StatementOutputData).
O resultado da execução de código.
+ `ExecutionCount` – Número (íntegro).
A contagem de execução da saída.
+ `Status` – String UTF-8 (valores válidos: `WAITING` \$1 `RUNNING` \$1 `AVAILABLE` \$1 `CANCELLING` \$1 `CANCELLED` \$1 `ERROR`).
O status da saída do código de execução.
+ `ErrorName` – String UTF-8.
O nome do erro na saída.
+ `ErrorValue` – String UTF-8.
O valor de erro da saída.
+ `Traceback` – Uma matriz de strings UTF-8.
O traceback da saída.
## Estrutura StatementOutputData
O resultado da execução de código no formato JSON.
**Campos**
+ `TextPlain` – String UTF-8.
O resultado da execução do código no formato de texto.
## Estrutura ConnectionsList
Especifica as conexões usadas por um trabalho.
**Campos**
+ `Connections`: uma matriz de strings UTF-8, no máximo mil strings.
Uma lista das conexões usadas pelo trabalho.
## Operações
+ [Ação CreateSession (Python: create\$1session)](#aws-glue-api-interactive-sessions-CreateSession)
+ [Ação StopSession (Python: stop\$1session)](#aws-glue-api-interactive-sessions-StopSession)
+ [Ação DeleteSession (Python: delete\$1session)](#aws-glue-api-interactive-sessions-DeleteSession)
+ [Ação GetSession (Python: get\$1session)](#aws-glue-api-interactive-sessions-GetSession)
+ [Ação ListSessions (Python: list\$1sessions)](#aws-glue-api-interactive-sessions-ListSessions)
+ [Ação RunStatement (Python: run\$1statement)](#aws-glue-api-interactive-sessions-RunStatement)
+ [Ação CancelStatement (Python: cancel\$1statement)](#aws-glue-api-interactive-sessions-CancelStatement)
+ [Ação GetStatement (Python: get\$1statement)](#aws-glue-api-interactive-sessions-GetStatement)
+ [Ação ListStatations (Python: list\$1statements)](#aws-glue-api-interactive-sessions-ListStatements)
+ [Ação GetGlueIdentityCenterConfiguration (Python: get\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-GetGlueIdentityCenterConfiguration)
+ [Ação UpdateGlueIdentityCenterConfiguration (Python: update\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-UpdateGlueIdentityCenterConfiguration)
+ [Ação CreateGlueIdentityCenterConfiguration (Python: create\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-CreateGlueIdentityCenterConfiguration)
+ [Ação DeleteGlueIdentityCenterConfiguration (Python: delete\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-DeleteGlueIdentityCenterConfiguration)
## Ação CreateSession (Python: create\$1session)
Cria uma nova sessão..
**Solicitação**
Solicitação para criar uma nova sessão.
+ `Id`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O ID da solicitação de sessão.
+ `Description` – string de descrição com no máximo 2.048 bytes de comprimento e correspondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
A descrição da sessão.
+ `Role` – *Obrigatório:* string UTF-8, não inferior a 20 ou superior a 2048 bytes de comprimento, correspondendo a [Custom string pattern #30](aws-glue-api-common.md#regex_30).
O ARN da função do &IAM
+ `Command` – *Obrigatório:* um objeto [SessionCommand](#aws-glue-api-interactive-sessions-SessionCommand).
O `SessionCommand` que executa esse trabalho.
+ `Timeout` – Número (inteiro), pelo menos 1.
O número de minutos até esgotar o tempo limite da sessão. O valor padrão para trabalhos de ETL no Spark é 48 horas, equivalente a 2.880 minutos. Consulte a documentação para outros tipos de trabalho.
+ `IdleTimeout` – Número (inteiro), pelo menos 1.
O número de minutos de natividade até esgotar o tempo limite da sessão. O padrão para trabalhos de ETL do Spark é o valor do tempo limite. Consulte a documentação para outros tipos de trabalho.
+ `DefaultArguments` – Uma matriz de mapas de pares de valores-chave, não mais de 75 pares.
Cada chave é uma string UTF-8, com comprimento entre 1 e 128 bytes, correspondente a [Custom string pattern #31](aws-glue-api-common.md#regex_31).
Cada valor é uma string UTF-8, com comprimento não superior a 4096 bytes, correspondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
Um array de mapa dos pares de valor-chave. O máximo é de 75 pares.
+ `Connections` – Um objeto [ConnectionsList](#aws-glue-api-interactive-sessions-ConnectionsList).
O número de conexões usadas para a sessão.
+ `MaxCapacity` – Número (duplo).
O número de unidades de processamento de dados (DPUs) do AWS Glue que poderão ser alocadas quando o trabalho for executado. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória.
+ `NumberOfWorkers` – Número (íntegro).
O número de operadores de determinado `WorkerType` para usar na sessão.
+ `WorkerType` – string UTF-8 (valores válidos: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).
O tipo de operador predefinido que é alocado quando um trabalho é executado. Aceita um valor de G.1X, G.2X, G.4X ou G.8X para trabalhos do Spark. Aceita o valor Z.2X para cadernos do Ray.
+ Para o tipo de operador `G.1X`, cada operador é mapeado em 1 DPU (4 vCPU, 16 GB de memória) com 94 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads, como transformações de dados, uniões e consultas, para oferecer uma maneira escalável e econômica de executar a maioria dos trabalhos.
+ Para o tipo de operador `G.2X`, cada operador é mapeado em 2 DPU (8 vCPU, 32 GB de memória) com 138 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads, como transformações de dados, uniões e consultas, para oferecer uma maneira escalável e econômica de executar a maioria dos trabalhos.
+ Para o tipo de operador `G.4X`, cada operador é mapeado em 4 DPU (16 vCPU, 64 GB de memória) com 256 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos cujas workloads contêm as transformações, agregações, uniões e consultas mais exigentes. Esse tipo de operador está disponível somente para trabalhos de ETL do Spark no AWS Glue versão 3.0 ou posterior nas seguintes regiões da AWS: Leste dos EUA (Ohio), Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon), Ásia-Pacífico (Singapura), Ásia-Pacífico (Sydney), Ásia-Pacífico (Tóquio), Canadá (Central), Europa (Frankfurt), Europa (Irlanda) e Europa (Estocolmo).
+ Para o tipo de operador `G.8X`, cada operador é mapeado em 8 DPU (32 vCPU, 128 GB de memória) com 512 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos cujas workloads contêm as transformações, agregações, uniões e consultas mais exigentes. Esse tipo de operador está disponível somente para trabalhos de ETL do Spark no AWS Glue versão 3.0 ou posterior, nas mesmas regiões da AWS compatíveis com o tipo de operador `G.4X`.
+ Para o tipo de operador `Z.2X`, cada operador é mapeado em 2 M-DPU (8 vCPUs, 64 GB de memória) com 128 GB de disco e fornece até 8 operadores do Ray baseados no autoscaler.
+ `SecurityConfiguration` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome da estrutura SecurityConfiguration a ser usada com a sessão.
+ `GlueVersion` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Custom string pattern #48](aws-glue-api-common.md#regex_48).
A versão AWS Glue determina as versões do Apache Spark e do Python compatíveis com o AWS Glue. O GlueVersion deve ser maior que 2.0.
+ `DataAccessId` - String UTF-8, não menos do que 1 ou superior a 36 bytes de comprimento.
O ID de acesso a dados da sessão.
+ `PartitionId` - String UTF-8, não menos do que 1 ou superior a 36 bytes de comprimento.
O ID da partição da sessão.
+ `Tags`: uma matriz de mapa dos pares de chave-valor, não mais que 50 pares.
Cada chave é uma string UTF-8, com comprimento entre 1 e 128 bytes.
Cada valor é uma string UTF-8, inferior a 256 bytes de comprimento.
O mapa dos pares de valores-chave (tags) pertencentes à sessão.
+ `RequestOrigin`: string UTF-8 com no mínimo 1 e no máximo 128 bytes de comprimento e correspondente a [Custom string pattern #31](aws-glue-api-common.md#regex_31).
A origem da solicitação.
+ `ProfileName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome de um perfil de uso do AWS Glue associado à sessão.
**Resposta**
+ `Session` – Um objeto [Sessão](#aws-glue-api-interactive-sessions-Session).
Retorna o objeto de sessão na resposta.
**Erros**
+ `AccessDeniedException`
+ `IdempotentParameterMismatchException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `ValidationException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
## Ação StopSession (Python: stop\$1session)
Interrompa a sessão.
**Solicitação**
+ `Id`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O ID da sessão a ser interrompida.
+ `RequestOrigin` – string UTF-8 com no mínimo 1 e no máximo 128 bytes de comprimento e correspondente a [Custom string pattern #31](aws-glue-api-common.md#regex_31).
A origem da solicitação.
**Resposta**
+ `Id` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Retorna o ID da sessão interrompida.
**Erros**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`
+ `ConcurrentModificationException`
## Ação DeleteSession (Python: delete\$1session)
Exclui a sessão.
**Solicitação**
+ `Id`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O ID da sessão a ser excluído.
+ `RequestOrigin` – string UTF-8 com no mínimo 1 e no máximo 128 bytes de comprimento e correspondente a [Custom string pattern #31](aws-glue-api-common.md#regex_31).
O nome da origem da solicitação de sessão de exclusão.
**Resposta**
+ `Id` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Retorna o ID da sessão excluída.
**Erros**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`
+ `ConcurrentModificationException`
## Ação GetSession (Python: get\$1session)
Recupera a sessão.
**Solicitação**
+ `Id`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O ID da sessão.
+ `RequestOrigin` – string UTF-8 com no mínimo 1 e no máximo 128 bytes de comprimento e correspondente a [Custom string pattern #31](aws-glue-api-common.md#regex_31).
A origem da solicitação.
**Resposta**
+ `Session` – Um objeto [Sessão](#aws-glue-api-interactive-sessions-Session).
O objeto de sessão é retornado na resposta.
**Erros**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
## Ação ListSessions (Python: list\$1sessions)
Recupere uma lista de sessões.
**Solicitação**
+ `NextToken`: string UTF-8, não superior a 400.000 bytes de comprimento.
O token para o próximo conjunto de resultados ou nulo se não houver mais resultados.
+ `MaxResults` – Número (inteiro), superior a 1 ou mais que 1000.
O número máximo de resultados.
+ `Tags`: uma matriz de mapa dos pares de chave-valor, não mais que 50 pares.
Cada chave é uma string UTF-8, com comprimento entre 1 e 128 bytes.
Cada valor é uma string UTF-8, inferior a 256 bytes de comprimento.
Tags pertencentes à sessão.
+ `RequestOrigin` – string UTF-8 com no mínimo 1 e no máximo 128 bytes de comprimento e correspondente a [Custom string pattern #31](aws-glue-api-common.md#regex_31).
A origem da solicitação.
**Resposta**
+ `Ids` – Uma matriz de strings UTF-8.
Retorna o ID da sessão.
+ `Sessions`: um array de objetos [Sessão](#aws-glue-api-interactive-sessions-Session).
Retorna o objeto de sessão.
+ `NextToken`: string UTF-8, não superior a 400.000 bytes de comprimento.
O token para o próximo conjunto de resultados ou nulo se não houver mais resultados.
**Erros**
+ `AccessDeniedException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
## Ação RunStatement (Python: run\$1statement)
Executa a instrução.
**Solicitação**
+ `SessionId`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O ID da sessão da instrução a ser executado.
+ `Code`: *Obrigatório:* string UTF-8, não superior a 68000 bytes de comprimento.
O código da instrução a ser executado.
+ `RequestOrigin` – string UTF-8 com no mínimo 1 e no máximo 128 bytes de comprimento e correspondente a [Custom string pattern #31](aws-glue-api-common.md#regex_31).
A origem da solicitação.
**Resposta**
+ `Id` – Número (íntegro).
Retorna o ID da instrução que foi executada.
**Erros**
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `ValidationException`
+ `ResourceNumberLimitExceededException`
+ `IllegalSessionStateException`
## Ação CancelStatement (Python: cancel\$1statement)
Cancela a instrução.
**Solicitação**
+ `SessionId`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O ID da sessão da instrução a ser cancelado.
+ `Id`: *obrigatório:* número (inteiro).
O ID da instrução a ser cancelado.
+ `RequestOrigin` – string UTF-8 com no mínimo 1 e no máximo 128 bytes de comprimento e correspondente a [Custom string pattern #31](aws-glue-api-common.md#regex_31).
A origem da solicitação para cancelar a instrução.
**Resposta**
+ *Nenhum parâmetro de resposta.*
**Erros**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`
## Ação GetStatement (Python: get\$1statement)
Recupera a instrução.
**Solicitação**
+ `SessionId`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O ID da sessão da instrução.
+ `Id`: *obrigatório:* número (inteiro).
O ID da instrução.
+ `RequestOrigin` – string UTF-8 com no mínimo 1 e no máximo 128 bytes de comprimento e correspondente a [Custom string pattern #31](aws-glue-api-common.md#regex_31).
A origem da solicitação.
**Resposta**
+ `Statement` – Um objeto [Declaração](#aws-glue-api-interactive-sessions-Statement).
Recupera a instrução.
**Erros**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`
## Ação ListStatations (Python: list\$1statements)
Lista as instruções para a sessão.
**Solicitação**
+ `SessionId`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O ID da sessão das instruções.
+ `RequestOrigin` – string UTF-8 com no mínimo 1 e no máximo 128 bytes de comprimento e correspondente a [Custom string pattern #31](aws-glue-api-common.md#regex_31).
A origem da solicitação para listar instruções.
+ `NextToken`: string UTF-8, não superior a 400.000 bytes de comprimento.
Um token de continuação, se esta for uma chamada de continuação.
**Resposta**
+ `Statements`: um array de objetos [Declaração](#aws-glue-api-interactive-sessions-Statement).
Retorna a lista de instruções.
+ `NextToken`: string UTF-8, não superior a 400.000 bytes de comprimento.
Um token de continuação, se nem todas as instruções ainda tiverem sido retornadas.
**Erros**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`
## Ação GetGlueIdentityCenterConfiguration (Python: get\$1glue\$1identity\$1center\$1configuration)
Recupera os detalhes da configuração atual do Centro de Identidade do AWS Glue, incluindo a instância associada do Centro de Identidade e as informações da aplicação.
**Solicitação**
+ *Sem parâmetros de solicitação.*
**Resposta**
Resposta que contém os detalhes da configuração do Centro de Identidade do AWS Glue.
+ `ApplicationArn`: string UTF-8 com no mínimo 10 e no máximo 1.224 bytes de comprimento.
O nome do recurso da Amazon (ARN) da aplicação do Centro de Identidade associada à configuração do AWS Glue.
+ `InstanceArn`: string UTF-8 com no mínimo 10 e no máximo 1.224 bytes de comprimento.
O nome do recurso da Amazon (ARN) da instância do Centro de Identidade associado à configuração do AWS Glue.
+ `Scopes` – Uma matriz de strings UTF-8.
Uma lista dos escopos do Centro de Identidade que definem as permissões e os níveis de acesso para a configuração do AWS Glue.
**Erros**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`
## Ação UpdateGlueIdentityCenterConfiguration (Python: update\$1glue\$1identity\$1center\$1configuration)
Atualiza a configuração existente do Centro de Identidade do AWS Glue, permitindo a modificação de escopos e permissões para a integração.
**Solicitação**
Solicitação para atualizar uma configuração existente do Centro de Identidade do AWS Glue.
+ `Scopes` - Uma matriz de strings UTF-8, não menos que 1 ou mais que 50 strings.
Uma lista dos escopos do Centro de Identidade que definem as permissões e os níveis de acesso atualizados para a configuração do AWS Glue.
**Resposta**
+ *Nenhum parâmetro de resposta.*
**Erros**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`
## Ação CreateGlueIdentityCenterConfiguration (Python: create\$1glue\$1identity\$1center\$1configuration)
Cria uma nova configuração do Centro de Identidade do AWS Glue para permitir a integração entre AWS Glue e o Centro de Identidade do AWS IAM para autenticação e autorização.
**Solicitação**
Solicitação para criar uma nova configuração do Centro de Identidade do AWS Glue.
+ `InstanceArn`: *obrigatório:* string UTF-8 com no mínimo 10 e no máximo 1.224 bytes de comprimento.
O nome do recurso da Amazon (ARN) da instância do Centro de Identidade a ser associado à configuração do AWS Glue.
+ `Scopes` - Uma matriz de strings UTF-8, não menos que 1 ou mais que 50 strings.
Uma lista dos escopos do Centro de Identidade que definem as permissões e os níveis de acesso para a configuração do AWS Glue.
**Resposta**
Resposta da criação de uma nova configuração do Centro de Identidade do AWS Glue.
+ `ApplicationArn`: string UTF-8 com no mínimo 10 e no máximo 1.224 bytes de comprimento.
O nome do recurso da Amazon (ARN) da aplicação do Centro de Identidade que foi criada para a configuração do AWS Glue.
**Erros**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`
## Ação DeleteGlueIdentityCenterConfiguration (Python: delete\$1glue\$1identity\$1center\$1configuration)
Exclui a configuração existente do Centro de Identidade do AWS Glue, removendo a integração entre o AWS Glue e o Centro de Identidade do AWS IAM.
**Solicitação**
+ *Sem parâmetros de solicitação.*
**Resposta**
+ *Nenhum parâmetro de resposta.*
**Erros**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`