Todos os produtos
Search
Central de documentação

E-MapReduce:ListLivyComputeSessions

Última atualização: Oct 28, 2026

Obtém as sessões históricas de um Livy Gateway.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

emr-serverless-spark:ListLivyComputeSessions

list

*Todos os recursos.

*

Nenhuma Nenhuma

Sintaxe da solicitação

GET /api/v1/workspaces/{workspaceId}/livycompute/{livyComputeId}/session HTTP/1.1

Parâmetros de caminho

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

workspaceId

string

Não

O ID do workspace.

w-d80f373d3ace824f

livyComputeId

string

Não

O ID do Livy Gateway.

lc-zm4dzdiubu73w2yx

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

pageNum

integer

Não

O número da página. Valor padrão: 1.

1

pageSize

integer

Não

O número de entradas por página. Valor padrão: 20. Valor mínimo: 1. Valor máximo: 100.

20

regionId

string

Não

O ID da região.

cn-hangzhou

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

requestId

string

O ID da solicitação.

8FAA8EEC-3026-5D15-8733-4E2A3DD970A1

totalCount

integer

O número total de entradas.

10

sessions

array<object>

A lista de sessões.

object

name

string

O nome da sessão.

test_session

computeId

string

O ID do Livy Gateway.

lc-xxxxxx

sessionId

string

O ID da sessão do Livy Gateway.

livy-xxxxxx

sparkConf

string

A configuração do job Spark.

{ "proxyUser": "test", "conf": { "spark.driver.cores": 1 } }

state

string

O status da sessão. Valores válidos:

  • starting: Iniciando.

  • running: Em execução.

  • terminating: Terminando.

  • terminated: Terminado.

  • error: Erro.

Valores válidos:

  • running :

    Em execução.

  • terminating :

    Terminando.

  • error :

    Erro.

  • starting :

    Iniciando.

  • terminated :

    Terminado.

running

info

string

As informações de tempo de execução.

null

createTime

integer

A hora de criação. O valor é um timestamp UNIX em milissegundos.

1768213240000

webUI

string

O endereço da interface web da sessão.

http://emr-spark-ui-cn-hangzhou.data.aliyun.com

endTime

integer

A hora de término. O valor é um timestamp UNIX em milissegundos.

1768213240000

queue

string

O nome da fila.

root_queue

cuHours

number

O número de unidades de computação (CUs) consumidas durante o tempo de execução do job. Este valor é uma estimativa. O valor real está sujeito à fatura.

322.5

vcoreSeconds

integer

O número total de vcores alocados para o job multiplicado pelo número de segundos em que o job foi executado.

343

mbSeconds

integer

A quantidade total de memória alocada para o job multiplicada pelo número de segundos em que o job foi executado.

1098888

Exemplos

Resposta de sucesso

JSON formato

{
  "requestId": "8FAA8EEC-3026-5D15-8733-4E2A3DD970A1",
  "totalCount": 10,
  "sessions": [
    {
      "name": "test_session",
      "computeId": "lc-xxxxxx",
      "sessionId": "livy-xxxxxx",
      "sparkConf": "{\n    \"proxyUser\": \"test\",\n    \"conf\": {\n        \"spark.driver.cores\": 1\n    }\n}",
      "state": "running",
      "info": "null",
      "createTime": 1768213240000,
      "webUI": "http://emr-spark-ui-cn-hangzhou.data.aliyun.com",
      "endTime": 1768213240000,
      "queue": "root_queue",
      "cuHours": 322.5,
      "vcoreSeconds": 343,
      "mbSeconds": 1098888
    }
  ]
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.