GetRayJob - E-MapReduce - Alibaba Cloud Documentation Center

Mengambil informasi Ray Job.

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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

GET /api/v1/workspaces/{workspaceId}/rayJob/{submissionId} HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
workspaceId	string	No	ID ruang kerja.	w-d2d82aa09155
submissionId	string	No	ID Ray Job.	rj-xxxxxxxxxx

Parameter permintaan

Parameter

Type

Required

Description

Example

Tidak ada parameter yang diperlukan.

Elemen respons

Element	Type	Description	Example
	object	Skema respons.
requestId	string	ID permintaan.	DD6B1B2A-5837-5237-ABE4-FF0C8944
submissionId	string	ID Ray Job.	rj-xxxxxxxxxx
name	string	Nama kluster Ray.	myRayCluster
displayReleaseVersion	string	Versi Mesin DPI Ray.	err-1.2.0 (Ray 2.55.1, Python 3.12)
tags	array	Tag.
	Tag	Tag.
status	string	Status pekerjaan. Nilai valid: Submitted: Dikirim. Pending: Kluster sedang dibuat. Running: Pekerjaan sedang berjalan. Succeeded: Pekerjaan berhasil. Failed: Pekerjaan gagal. Cancelling: Membatalkan. Cancelled: Dibatalkan. Timeout: Waktu habis dan dibatalkan.	Running
message	string	Paket eksekusi.	Job finished successfully.
entrypoint	string	Perintah startup.	python main.py
submitTime	integer	Waktu pengiriman pekerjaan. Nilai ini adalah stempel waktu UNIX dalam milidetik.	1750327082303
startTime	integer	Waktu mulai. Nilai ini adalah stempel waktu UNIX dalam milidetik.	1750327083303
endTime	integer	Waktu selesai pekerjaan. Nilai ini adalah stempel waktu UNIX dalam milidetik.	1762949372000
duration	integer	Durasi pekerjaan, dalam detik.	2459764
networkServiceName	string	Nama konektivitas jaringan.	vpc
runtimeEnvJson	string	String JSON lingkungan waktu proses Ray.	{"pip":["requests==2.26.0","pendulum==2.1.2"],"env_vars":{"KEY":"VALUE"}}
workingDir	string	URL direktori kerja kode pekerjaan.	oss://mybucket/hello.zip
submissionMode	string	Mode pengiriman pekerjaan.	HTTPMode
metadataJson	string	String JSON metadata pekerjaan.	{"owner": "alice"}
entrypointNumCpus	string	Jumlah CPU yang diminta oleh tugas entrypoint.	1
entrypointNumGpus	string	Jumlah GPU yang diminta oleh tugas entrypoint.	0
entrypointMemory	string	Ukuran memori yang diminta oleh tugas entrypoint.	4Gi
entrypointResources	string	String JSON permintaan Resource kustom untuk tugas entrypoint.	{"fpu": 1}
shutdownAfterJobFinishes	boolean	Apakah akan secara otomatis menghapus kluster sementara setelah pekerjaan selesai. Nilai default: true.	true
ttlSecondsAfterFinished	integer	Jumlah detik untuk menunggu sebelum menghapus kluster. Parameter ini hanya berlaku jika shutdownAfterJobFinishes diatur ke true.	60
activeDeadlineSeconds	integer	Periode pengatur waktu.	3600
volumeIds	array	Daftar ID file terkelola.
	string	ID file terkelola.	vol-123456789
backoffLimit	integer	Jumlah percobaan ulang saat gagal. Saat ini tetap pada 0.	2
headSpec	object	Parameter node head kluster Ray.
replica	integer	Jumlah node.	1
enableAutoScaling	boolean	Indikator apakah penyesuaian skala otomatis diaktifkan untuk node pekerja.	true
idleTimeoutSeconds	integer	Pengatur waktu idle dalam detik untuk node pekerja saat penyesuaian skala otomatis diaktifkan.	60
queueName	string	Nama antrian.	root_queue
cpu	string	Jumlah core CPU.	2
memory	string	Ukuran memori, dalam GiB.	8Gi
gpuSpec	string	Tipe GPU.	ecs.gn6i-c4g1.xlarge
workerSpecs	array<object>	Informasi node pekerja kluster Ray dalam format JSON.
	object	Struktur informasi node pekerja kluster Ray dalam format JSON.
groupName	string	Nama kelompok node pekerja.	WorkerGroup1
replica	integer	Jumlah node pekerja.	1
minReplica	integer	Jumlah minimum pekerja.	1
maxReplica	integer	Jumlah maksimum pekerja.	10
queueName	string	Nama antrian.	root_queue
cpu	string	Jumlah core CPU.	2
memory	string	Ukuran memori, dalam GiB.	8Gi
gpuSpec	string	Tipe GPU.	ecs.gn6i-c4g1.xlarge
extraParam	string	Parameter tambahan dalam format JSON.	{"userDefinedFiles": "oss://mybucket/artifact/config.json,oss://mybucket/artifact/config2.json", "userRequirementsFile": "oss://mybucket/requirements.txt"}
creatorName	string	Nama panggilan pembuat.	Alice
dashboardUrl	string	URL dasbor kluster Ray. Saat kluster Ray berada dalam status Running, ini adalah Runtime UI. Setelah kluster dihapus, ini adalah History UI. History UI hanya didukung pada versi err-1.2.0 dan yang lebih baru.	https://emr-ray-gateway-cn-hangzhou.aliyuncs.com/workspace/w-xxxxxxxx/raycluster/ray-xxxxxx/dashboard?token=xxxxxx
logBucketName	string	Nama bucket yang menyimpan log.	ss-ray-cn-hangzhou
logPath	string	Jalur tempat log disimpan.	w-xxxxxxx/ray/logs/xxxxxx/
cuHours	number	Sumber daya CU yang dikonsumsi. Nilai ini dikembalikan 10 menit setelah kluster dilepas.	1899
guHours	object	Jam GPU yang dikonsumsi. Saat ini kosong.
gpuSpec	string	Tipe GPU.	ecs.gn6i-c4g1.xlarge
gpuHours	number	Jam GPU yang dikonsumsi.	2.6
dashboardUrlExtra	array	URL UI dasbor tambahan. Saat ini kosong.
	string	URL UI dasbor tambahan. Saat ini kosong.	-
clusterState	string	Status kluster Ray yang sesuai. Nilai valid: Deleted: Dihapus. Submitted: Dikirim tetapi belum dibuat. Pending: Sedang dibuat. Running: Berjalan.	Running
taskBizId	string	ID tugas pengembangan data.	TSK-682e0112f6f24d9f9305b92174846985

Contoh

Respons sukses

JSONformat

{
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944",
  "submissionId": "rj-xxxxxxxxxx",
  "name": "myRayCluster",
  "displayReleaseVersion": "err-1.2.0 (Ray 2.55.1, Python 3.12)",
  "tags": [
    {
      "key": "workflowId",
      "value": "wf-123test"
    }
  ],
  "status": "Running",
  "message": "Job finished successfully.",
  "entrypoint": "python main.py",
  "submitTime": 1750327082303,
  "startTime": 1750327083303,
  "endTime": 1762949372000,
  "duration": 2459764,
  "networkServiceName": "vpc",
  "runtimeEnvJson": "{\"pip\":[\"requests==2.26.0\",\"pendulum==2.1.2\"],\"env_vars\":{\"KEY\":\"VALUE\"}}",
  "workingDir": "oss://mybucket/hello.zip",
  "submissionMode": "HTTPMode",
  "metadataJson": "{\"owner\": \"alice\"}",
  "entrypointNumCpus": "1",
  "entrypointNumGpus": "0",
  "entrypointMemory": "4Gi",
  "entrypointResources": "{\"fpu\": 1}",
  "shutdownAfterJobFinishes": true,
  "ttlSecondsAfterFinished": 60,
  "activeDeadlineSeconds": 3600,
  "volumeIds": [
    "vol-123456789"
  ],
  "backoffLimit": 2,
  "headSpec": {
    "replica": 1,
    "enableAutoScaling": true,
    "idleTimeoutSeconds": 60,
    "queueName": "root_queue",
    "cpu": "2",
    "memory": "8Gi",
    "gpuSpec": "ecs.gn6i-c4g1.xlarge"
  },
  "workerSpecs": [
    {
      "groupName": "WorkerGroup1",
      "replica": 1,
      "minReplica": 1,
      "maxReplica": 10,
      "queueName": "root_queue",
      "cpu": "2",
      "memory": "8Gi",
      "gpuSpec": "ecs.gn6i-c4g1.xlarge"
    }
  ],
  "extraParam": "{\"userDefinedFiles\": \"oss://mybucket/artifact/config.json,oss://mybucket/artifact/config2.json\", \"userRequirementsFile\": \"oss://mybucket/requirements.txt\"}",
  "creatorName": "Alice",
  "dashboardUrl": "https://emr-ray-gateway-cn-hangzhou.aliyuncs.com/workspace/w-xxxxxxxx/raycluster/ray-xxxxxx/dashboard?token=xxxxxx",
  "logBucketName": "ss-ray-cn-hangzhou",
  "logPath": "w-xxxxxxx/ray/logs/xxxxxx/",
  "cuHours": 1899,
  "guHours": {
    "gpuSpec": "ecs.gn6i-c4g1.xlarge",
    "gpuHours": 2.6
  },
  "dashboardUrlExtra": [
    "-"
  ],
  "clusterState": "Running",
  "taskBizId": "TSK-682e0112f6f24d9f9305b92174846985"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.