GetLivyCompute - E-MapReduce: Central de Documentação do Alibaba Cloud

Obtém as informações do 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:GetLivyCompute

get

*Todos os recursos.

*

Nenhuma

Sintaxe da solicitação

GET /api/interactive/v1/workspace/{workspaceBizId}/livycompute/{livyComputeId} HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
workspaceBizId	string	Não	O ID do workspace.	w-8adde60aa809701f
livyComputeId	string	Não	O ID do Livy Gateway.	lc-i8xogcdfa4fk3yn1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
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.	DD6B1B2A-5837-5237-ABE4-FF0C8944****
code	string	O código de retorno da solicitação. O valor 1000000 indica que a solicitação foi bem-sucedida. Outros valores indicam que a solicitação falhou. Para obter detalhes sobre o erro, consulte o campo message.	1000000
message	string	A mensagem de erro.	ok
data	object	O resultado retornado.
computeId	string	O ID do Livy Gateway.	lc-xxxxxxxxxxxxx
name	string	O nome.	test
livyVersion	string	A versão do Livy.	0.8.0
releaseVersion	string	O número da versão do mecanismo Spark DPI. Este campo está obsoleto. Use displayReleaseVersion em seu lugar.	esr-4.3.0 (Spark 3.5.2, Scala 2.12, Java Runtime)
queueName	string	O nome da fila.	root_queue
cpuLimit	string	O número de núcleos de CPU para o Livy Server. Valores válidos: 1 2 4 Valores válidos: 1 : 1 2 : 2 4 : 4	1
memoryLimit	string	O tamanho da memória do Livy Server. Valores válidos: 4Gi 8Gi 16Gi Valores válidos: 16Gi : 16Gi 4Gi : 4Gi 8Gi : 8Gi	4Gi
autoStopConfiguration	object	A configuração de parada automática.
enable	boolean	Especifica se deve iniciar automaticamente após a criação. Valores válidos: true: Sim. false: Não.	false
idleTimeoutMinutes	integer	O número de minutos de ociosidade após os quais o Livy Gateway é parado automaticamente.	300
authType	string	O método de autenticação.	Token
status	string	O status de execução.	RUNNING
endpoint	string	O endereço de conexão de rede pública.	emr-spark-livy-gateway-cn-hangzhou.data.aliyun.com/api/v1/workspace/w-xxxxxxxxx/livycompute/lc-xxxxxxxxxxx
createdBy	string	O nome do criador.	alice
ramUserId	string	O ID do criador.	10000001
displayReleaseVersion	string	O número da versão do mecanismo Spark DPI.	esr-4.3.0 (Spark 3.5.2, Scala 2.12)
fusion	boolean	Especifica se o recurso de fusão está ativado.	false
startTime	integer	A hora de início. O valor é um timestamp UNIX em milissegundos.	1749456094000
gmtCreate	integer	A hora de criação.	1749456094000
environmentId	string	O ID do ambiente de execução.	ev-cq31c7tlhtgm9nrrlj4g
endpointInner	string	O endereço de conexão de rede interna.	emr-spark-livy-gateway-cn-hangzhou-internal.aliyun.com/api/v1/workspace/w-xxxxxxxxx/livycompute/lc-xxxxxxxxxxx
networkName	string	O nome da conectividade de rede.	test
livyServerConf	string	A configuração do Livy Gateway no formato JSON. Os seguintes arquivos são suportados: sparkDefaultsConf sparkBlackListConf livyConf livyClientConf	{ "sparkDefaultsConf": "spark.driver.cores 1\nspark.driver.memory 4g\nspark.executor.cores 1\nspark.executor.memory 4g\n", "sparkBlackListConf": "spark.driver.cores\nspark.driver.memory", "livyConf": "livy.server.session.timeout 1h\n", "livyClientConf": "livy.rsc.sql.num-rows 1000\n" }
enablePublic	boolean	O status da chave de endereço de rede pública.	true

Exemplos

Resposta de sucesso

JSON formato

{
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****",
  "code": "1000000",
  "message": "ok",
  "data": {
    "computeId": "lc-xxxxxxxxxxxxx",
    "name": "test",
    "livyVersion": "0.8.0",
    "releaseVersion": "esr-4.3.0 (Spark 3.5.2, Scala 2.12, Java Runtime)\n",
    "queueName": "root_queue",
    "cpuLimit": "1",
    "memoryLimit": "4Gi",
    "autoStopConfiguration": {
      "enable": false,
      "idleTimeoutMinutes": 300
    },
    "authType": "Token",
    "status": "RUNNING",
    "endpoint": "emr-spark-livy-gateway-cn-hangzhou.data.aliyun.com/api/v1/workspace/w-xxxxxxxxx/livycompute/lc-xxxxxxxxxxx",
    "createdBy": "alice",
    "ramUserId": "10000001",
    "displayReleaseVersion": "esr-4.3.0 (Spark 3.5.2, Scala 2.12)",
    "fusion": true,
    "startTime": 1749456094000,
    "gmtCreate": 1749456094000,
    "environmentId": "ev-cq31c7tlhtgm9nrrlj4g",
    "endpointInner": "emr-spark-livy-gateway-cn-hangzhou-internal.aliyun.com/api/v1/workspace/w-xxxxxxxxx/livycompute/lc-xxxxxxxxxxx",
    "networkName": "test",
    "livyServerConf": "\t\n{\n  \"sparkDefaultsConf\": \"spark.driver.cores     1\\nspark.driver.memory    4g\\nspark.executor.cores   1\\nspark.executor.memory  4g\\n\",\n  \"sparkBlackListConf\": \"spark.driver.cores\\nspark.driver.memory\",\n  \"livyConf\": \"livy.server.session.timeout  1h\\n\",\n  \"livyClientConf\": \"livy.rsc.sql.num-rows  1000\\n\"\n}",
    "enablePublic": true
  }
}

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.