すべてのプロダクト
Search
ドキュメントセンター

:GetLivyCompute

最終更新日:Sep 18, 2025

Livy ゲートウェイに関する情報を取得します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

emr-serverless-spark:GetLivyCompute

get

*All Resource

*

なし なし

リクエスト構文

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

リクエストパラメーター

パラメーター

必須 / 任意

説明

workspaceBizId

string

任意

ワークスペース ID。

w-8adde60aa809701f

livyComputeId

string

任意

Livy Gateway の ID。

lc-i8xogcdfa4fk3yn1

regionId

string

任意

リージョン ID。

cn-hangzhou

レスポンスフィールド

フィールド

説明

object

レスポンスのスキーマ

requestId

string

リクエスト ID。

DD6B1B2A-5837-5237-ABE4-FF0C8944****

code

string

応答コード。値が 1000000 の場合はリクエストが成功したことを示します。その他の値は、リクエストが失敗したことを示します。エラーの詳細については、message パラメーターをご確認ください。

1000000

message

string

エラーメッセージ。

ok

data

object

返されたデータ。

computeId

string

Livy Gateway の ID。

lc-xxxxxxxxxxxxx

name

string

名前。

test

livyVersion

string

Livy のバージョン。

0.8.0

releaseVersion

string

Spark エンジンのバージョン番号。このパラメーターは非推奨です。代わりに displayReleaseVersion を使用してください。

esr-4.3.0 (Spark 3.5.2, Scala 2.12, Java Runtime)

queueName

string

キュー名。

root_queue

cpuLimit

string

Livy サーバーの CPU コア数。

  • 1

  • 2

  • 4

列挙値:

  • 1 :
    1
  • 2 :
    2
  • 4 :
    4

1

memoryLimit

string

Livy サーバーのメモリサイズ。

  • 4Gi

  • 8Gi

  • 16Gi

列挙値:

  • 16Gi :
    16Gi
  • 4Gi :
    4Gi
  • 8Gi :
    8Gi

4Gi

autoStopConfiguration

object

自動停止構成。

enable

boolean

作成後にゲートウェイを自動的に開始するかどうかを示します。

  • true: はい。

  • false: いいえ。

false

idleTimeoutMinutes

integer

Livy Gateway がアイドル状態の場合に自動的に停止するまでの分数。

300

authType

string

認証方式。

Token

status

string

実行ステータス。

RUNNING

endpoint

string

パブリックエンドポイント。

emr-spark-livy-gateway-cn-hangzhou.data.aliyun.com/api/v1/workspace/w-xxxxxxxxx/livycompute/lc-xxxxxxxxxxx

createdBy

string

作成者の名前。

alice

ramUserId

string

作成者の ID。

10000001

displayReleaseVersion

string

Spark エンジンのバージョン番号。

esr-4.3.0 (Spark 3.5.2, Scala 2.12)

fusion

boolean

フュージョンスイッチが有効かどうかを示します。

false

startTime

integer

開始時刻。

1749456094000

gmtCreate

integer

作成時間。

1749456094000

environmentId

string

ランタイム環境の ID。

ev-cq31c7tlhtgm9nrrlj4g

endpointInner

string

内部エンドポイント。

emr-spark-livy-gateway-cn-hangzhou-internal.aliyun.com/api/v1/workspace/w-xxxxxxxxx/livycompute/lc-xxxxxxxxxxx

networkName

string

ネットワーク接続の名前。

test

livyServerConf

string

JSON 形式の Livy Gateway 構成。次のファイルがサポートされています:

  • 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

パブリックエンドポイントスイッチのステータス。

true

成功レスポンス

JSONJSON

{
  "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
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。