All Products
Search
Document Center

E-MapReduce:SubmitRayJob

Last Updated:Jul 08, 2026

Mengirimkan pekerjaan Ray.

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

POST /api/v1/workspaces/{workspaceId}/rayJob HTTP/1.1

Path Parameters

Parameter

Type

Required

Description

Example

workspaceId

string

No

ID ruang kerja.

w-d2d82aa09155

Parameter permintaan

Parameter

Type

Required

Description

Example

body

object

No

Struktur permintaan.

entrypoint

string

No

Perintah startup.

python -c "print('hello ray job')"

name

string

No

Nama pekerjaan.

my-job

displayReleaseVersion

string

No

Nomor versi Mesin DPI Ray.

err-1.2.0 (Ray 2.55.1, Python 3.12)

tags

array<object>

No

Tag.

object

No

key

string

No

Kunci.

jobname

value

string

No

Nilai.

test

networkServiceName

string

No

Nama konektivitas jaringan.

vpc

runtimeEnvJson

string

No

String JSON lingkungan waktu proses Ray.

{"pip":["requests==2.26.0","pendulum==2.1.2"],"env_vars":{"KEY":"VALUE"}}

workingDir

string

No

URL direktori kerja kode pekerjaan.

oss://mybucket/rayjob.zip

metadataJson

string

No

String JSON metadata pekerjaan.

{"resourceName": "test"}

submissionMode

string

No

Mode pengiriman pekerjaan.

HTTPMode

entrypointNumCpus

string

No

Jumlah CPU yang diminta oleh tugas entrypoint.

1

entrypointNumGpus

string

No

Jumlah GPU yang diminta oleh tugas entrypoint.

0

entrypointMemory

string

No

Ukuran memori yang diminta oleh tugas entrypoint.

4Gi

entrypointResources

string

No

String JSON permintaan Resource kustom untuk tugas entrypoint.

{"fpu": 1}

shutdownAfterJobFinishes

boolean

No

Apakah akan secara otomatis menghapus kluster sementara setelah pekerjaan selesai. Nilai default: true.

true

ttlSecondsAfterFinished

integer

No

Jumlah detik untuk menunggu sebelum menghapus kluster. Parameter ini hanya berlaku jika shutdownAfterJobFinishes diatur ke true.

60

activeDeadlineSeconds

integer

No

Periode pengatur waktu pekerjaan, yang mencakup waktu pembuatan kluster dan waktu proses pekerjaan. Pekerjaan akan dibatalkan jika periode ini terlampaui.

3600

volumeIds

array

No

Daftar ID volume yang dipasang.

string

No

ID file terkelola.

vol-12345678

headSpec

object

No

Parameter node head kluster Ray.

queueName

string

No

Nama antrian.

root_queue

cpu

string

No

Jumlah inti CPU.

2

memory

string

No

Ukuran memori. Unit: Gi.

8Gi

enableAutoScaling

boolean

No

Apakah akan mengaktifkan skalabilitas otomatis worker.

true

idleTimeoutSeconds

integer

No

Periode pengatur waktu idle worker setelah skalabilitas otomatis diaktifkan.

60

gpuSpec

string

No

Tipe instans GPU.

ecs.gn6i-c4g1.xlarge

workerSpec

array<object>

No

Parameter node pekerja kluster Ray.

object

No

Struktur node pekerja.

groupName

string

No

Nama kelompok worker.

WorkerGroup1

workerType

string

No

Tipe worker.

CPU

replica

integer

No

Jumlah worker.

2

queueName

string

No

Nama antrian.

root_queue

cpu

string

No

Jumlah inti CPU.

4

memory

string

No

Ukuran memori. Unit: Gi.

16Gi

minReplica

integer

No

Jumlah minimum worker setelah skalabilitas otomatis diaktifkan.

1

maxReplica

integer

No

Jumlah maksimum worker setelah skalabilitas otomatis diaktifkan.

10

gpuSpec

string

No

Tipe instans GPU.

ecs.gn6i-c4g1.xlarge

extraParam

string

No

String JSON parameter tambahan.

{"userDefinedFiles": "oss://mybucket/artifact/config.json,oss://mybucket/artifact/config2.json", "userRequirementsFile": "oss://mybucket/requirements.txt"}

Elemen respons

Element

Type

Description

Example

object

Skema respons.

requestId

string

ID permintaan.

DD6B1B2A-5837-5237-ABE4-FF0C8944

submissionId

string

ID Pekerjaan Ray.

rj-k7nm8ahl5te4tg91

Contoh

Respons sukses

JSONformat

{
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944",
  "submissionId": "rj-k7nm8ahl5te4tg91"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.