Obtiene una lista de sesiones.
Pruébelo ahora
Test
Autorización de RAM
|
Action |
Nivel de acceso |
Tipo de recurso |
Clave de condición |
Acción dependiente |
|
emr-serverless-spark:ListSessionClusters |
list |
*Todos los recursos.
|
Ninguna | Ninguna |
Sintaxis de la solicitud
GET /api/v1/workspaces/{workspaceId}/sessionClusters HTTP/1.1
Parámetros de ruta
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
| workspaceId |
string |
No |
El ID del espacio de trabajo. |
w-1234abcd |
Parámetros de la solicitud
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
| nextToken |
string |
No |
El token que indica la posición desde la cual comenzar a leer. |
1 |
| maxResults |
integer |
No |
El número máximo de registros que se devuelven en una sola solicitud. |
20 |
| sessionClusterId |
string |
No |
El nombre del trabajo. |
emr-spark-demo-job |
| queueName |
string |
No |
El nombre de la cola. |
root |
| kind |
string |
No |
El tipo de sesión. Valores válidos:
|
SQL |
| regionId |
string |
No |
El ID de la región. |
cn-hangzhou |
Elementos de la respuesta
|
Elemento |
Tipo |
Descripción |
Ejemplo |
|
object |
Los datos de la respuesta. |
||
| sessionClusters |
array<object> |
La lista de sesiones. |
|
|
array<object> |
Los detalles de la sesión. |
||
| workspaceId |
string |
El ID del espacio de trabajo. |
w-1234abcd |
| sessionClusterId |
string |
El ID de la sesión. |
sc-123131 |
| userId |
string |
El ID de usuario. |
123131 |
| queueName |
string |
El nombre de la cola donde se ejecuta la sesión. |
dev_queue |
| state |
string |
El estado de la sesión. Valores válidos:
|
Running |
| stateChangeReason |
object |
Los detalles del cambio de estado más reciente de la sesión. |
|
| code |
string |
El código de cambio de estado. |
200 |
| message |
string |
El mensaje de cambio de estado. |
ok |
| autoStartConfiguration |
object |
La configuración de inicio automático. |
|
| enable |
boolean |
Especifica si el inicio automático está habilitado. |
true |
| autoStopConfiguration |
object |
La configuración de detención automática. |
|
| enable |
boolean |
Especifica si la detención automática está habilitada. |
false |
| idleTimeoutMinutes |
integer |
El número de minutos de inactividad después de los cuales la sesión se detiene automáticamente. |
45 |
| applicationConfigs |
array<object> |
Las configuraciones de la sesión, que equivalen a las configuraciones del trabajo subyacente de Spark. |
|
|
object |
Las configuraciones de SQL Compute, que equivalen a las configuraciones del trabajo subyacente de Spark. |
||
| configFileName |
string |
El nombre del archivo de configuración. |
spark-default.conf |
| configItemKey |
string |
La clave de configuración. |
spark.app.name |
| configItemValue |
string |
El valor de configuración. |
test_application |
| name |
string |
El nombre de la sesión. |
adhoc_query |
| userName |
string |
El nombre de usuario. |
test_user |
| kind |
string |
El tipo de sesión. Valores válidos:
|
SQL |
| webUI |
string |
La URL de la interfaz de usuario de Spark de la sesión. |
http://spark-ui-xxxx |
| releaseVersion |
string |
La versión de Serverless Spark. |
esr-4.0.0 (Spark 3.5.2, Scala 2.12) |
| draftId |
string |
El ID del trabajo de desarrollo vinculado a la sesión. |
TSK-xxxxxxxxx |
| domain |
string |
El nombre de dominio público del servidor Thrift. |
emr-spark-gateway-cn-hangzhou.data.aliyun.com |
| displayReleaseVersion |
string |
La versión que se muestra realmente en la consola. |
esr-4.0.0 (Spark 3.5.2, Scala 2.12) |
| fusion |
boolean |
Especifica si la aceleración del motor Fusion está habilitada. |
false |
| gmtCreate |
integer |
La hora de creación. |
1732267598000 |
| startTime |
integer |
La hora de inicio. El valor es una marca de tiempo UNIX en milisegundos. |
1732267598000 |
| domainInner |
string |
El nombre de dominio interno del servidor Thrift. |
emr-spark-gateway-cn-hangzhou-internal.data.aliyuncs.com |
| extra |
string |
Los metadatos adicionales de la sesión. |
{"extraInfoKey":"extraInfoValue"} |
| publicEndpointEnabled |
boolean |
Especifica si el endpoint de acceso a la red pública está habilitado. |
true |
| connectionToken |
string |
El token que se utiliza para conectarse al clúster de sesiones. |
|
| requestId |
string |
El ID de la solicitud. |
DD6B1B2A-5837-5237-ABE4-FF0C8944**** |
| nextToken |
string |
El token que indica la posición de los datos devueltos. |
1 |
| maxResults |
integer |
El número máximo de registros devueltos en la solicitud actual. |
20 |
| totalCount |
integer |
El número total de registros que cumplen con las condiciones de la solicitud actual. |
200 |
Ejemplos
Respuesta exitosa
JSON Formato
{
"sessionClusters": [
{
"workspaceId": "w-1234abcd",
"sessionClusterId": "sc-123131",
"userId": "123131",
"queueName": "dev_queue",
"state": "Running",
"stateChangeReason": {
"code": "200",
"message": "ok"
},
"autoStartConfiguration": {
"enable": true
},
"autoStopConfiguration": {
"enable": false,
"idleTimeoutMinutes": 45
},
"applicationConfigs": [
{
"configFileName": "spark-default.conf",
"configItemKey": "spark.app.name",
"configItemValue": "test_application"
}
],
"name": "adhoc_query",
"userName": "test_user",
"kind": "SQL",
"webUI": "http://spark-ui-xxxx",
"releaseVersion": "esr-4.0.0 (Spark 3.5.2, Scala 2.12)",
"draftId": "TSK-xxxxxxxxx\n",
"domain": "emr-spark-gateway-cn-hangzhou.data.aliyun.com",
"displayReleaseVersion": "esr-4.0.0 (Spark 3.5.2, Scala 2.12)",
"fusion": false,
"gmtCreate": 1732267598000,
"startTime": 1732267598000,
"domainInner": "emr-spark-gateway-cn-hangzhou-internal.data.aliyuncs.com",
"extra": "{\"extraInfoKey\":\"extraInfoValue\"}",
"publicEndpointEnabled": true,
"connectionToken": ""
}
],
"requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****",
"nextToken": "1",
"maxResults": 20,
"totalCount": 200
}
Códigos de error
Consulte Códigos de error para ver la lista completa.
Notas de la versión
Consulte Notas de la versión para ver la lista completa.