Gunakan API GetSessionCluster untuk kueri detail kluster sesi - E-MapReduce - Alibaba Cloud - E-MapReduce

Mengambil detail sesi.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

emr-serverless-spark:GetSessionCluster

get

*All Resource

*

None

Sintaks permintaan

GET /api/v1/workspaces/{workspaceId}/sessionClusters/{sessionClusterId} HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
workspaceId	string	No	ID workspace.	w-1234abcd
sessionClusterId	string	No	Nama job.	emr-spark-demo-job

Parameter permintaan

Parameter	Type	Required	Description	Example
regionId	string	No	ID region.	cn-hangzhou

Elemen respons

Element	Type	Description	Example
	object	Data yang dikembalikan.
sessionCluster	object	Objek sesi.
workspaceId	string	ID workspace.	w-1234abcd
sessionClusterId	string	ID cluster sesi.	1234abcd-12ab-34cd-56ef-1234567890ab
userId	string	ID pengguna.	123xxxxxxxx
queueName	string	Nama queue.	dev_queue
state	string	Status job. Starting: Job sedang dimulai. Running: Job sedang berjalan. Stopping: Job sedang dihentikan. Stopped: Job telah dihentikan. Error: Job gagal.	Running
stateChangeReason	object	Alasan perubahan status.
code	string	The state change code.	1000000
message	string	The state change message.	ok
autoStartConfiguration	object	Konfigurasi auto-start.
enable	boolean	Specifies whether to enable auto-start. true: Auto-start is enabled. false: Auto-start is disabled.	false
autoStopConfiguration	object	Konfigurasi auto-stop.
enable	boolean	Specifies whether to enable auto-stop. true: Auto-stop is enabled. false: Auto-stop is disabled.	false
idleTimeoutMinutes	integer	The number of minutes a session can be idle before it is automatically stopped.	60
applicationConfigs	array<object>	Daftar konfigurasi aplikasi Spark.
	object	Konfigurasi aplikasi Spark.
configFileName	string	The name of the configuration file.	spark-defaults.conf
configItemKey	string	The configuration key.	spark.app.name
configItemValue	string	The configuration value.	test
releaseVersion	string	Versi Serverless Spark.	esr-4.0.0 (Spark 3.5.2, Scala 2.12)
name	string	Nama sesi.	test
userName	string	Nama pengguna yang membuat sesi.	user1
kind	string	Tipe job. Parameter ini wajib diisi dan tidak dapat diubah setelah job dibuat. SQLSCRIPT: job SQL. JAR: job JAR. PYTHON: job Python.	SQL
webUI	string	URL Spark UI untuk sesi.	https://spark-ui/link
draftId	string	ID job developer yang dilampirkan ke sesi.	TSK-xxxxxxxx
domain	string	Nama domain Spark UI untuk sesi.	your.domain.com
displayReleaseVersion	string	Versi yang ditampilkan di konsol.	esr-4.0.0 (Spark 3.5.2, Scala 2.12)
fusion	boolean	Menentukan apakah akan mengaktifkan akselerasi menggunakan engine Fusion.	false
envId	string	ID environment.	env-cpv569tlhtgndjl8****
gmtCreate	integer	Waktu saat sesi dibuat.	2024-09-01 06:23:01
startTime	integer	Waktu saat sesi dimulai.	2024-09-01 06:23:01
domainInner	string	Endpoint internal di region yang sama.	emr-spark-gateway-cn-hangzhou-internal.data.aliyuncs.com
extra	string	Metadata tambahan sesi.	{"extraInfoKey":"extraInfoValue"}
publicEndpointEnabled	boolean
connectionToken	string
requestId	string	ID request.	DD6B1B2A-5837-5237-ABE4-FF0C8944****

Contoh

Respons sukses

JSONformat

{
  "sessionCluster": {
    "workspaceId": "w-1234abcd",
    "sessionClusterId": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "userId": "123xxxxxxxx",
    "queueName": "dev_queue",
    "state": "Running",
    "stateChangeReason": {
      "code": "1000000",
      "message": "ok"
    },
    "autoStartConfiguration": {
      "enable": false
    },
    "autoStopConfiguration": {
      "enable": false,
      "idleTimeoutMinutes": 60
    },
    "applicationConfigs": [
      {
        "configFileName": "spark-defaults.conf",
        "configItemKey": "spark.app.name",
        "configItemValue": "test"
      }
    ],
    "releaseVersion": "esr-4.0.0 (Spark 3.5.2, Scala 2.12)",
    "name": "test",
    "userName": "user1",
    "kind": "SQL",
    "webUI": "https://spark-ui/link",
    "draftId": "TSK-xxxxxxxx",
    "domain": "your.domain.com",
    "displayReleaseVersion": "esr-4.0.0 (Spark 3.5.2, Scala 2.12)",
    "fusion": false,
    "envId": "env-cpv569tlhtgndjl8****",
    "gmtCreate": 0,
    "startTime": 0,
    "domainInner": "emr-spark-gateway-cn-hangzhou-internal.data.aliyuncs.com",
    "extra": "{\"extraInfoKey\":\"extraInfoValue\"}",
    "publicEndpointEnabled": false,
    "connectionToken": ""
  },
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.