All Products
Search

This Product

    E-MapReduce:StartJobRun

    Document Center

    E-MapReduce:StartJobRun

    Last Updated:Jun 11, 2026

    Memulai pekerjaan Spark.

    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:StartJobRun

    create

    *All Resource

    *

    		 None None

    Sintaks permintaan

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

    Path Parameters

    Parameter

    Type

    Required

    Description

    Example
    workspaceId

    string

    Yes

    ID ruang kerja.

    w-d2d82aa09155****

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    body

    object

    No

    Badan permintaan pekerjaan Spark.

    releaseVersion

    string

    No

    The version of the Spark engine.

    esr-3.3.1
    jobId

    string

    No

    The job ID.

    jr-12345
    name

    string

    No

    The job name.

    spark_job_name
    resourceQueueId

    string

    No

    The resource queue on which the Spark job runs.

    dev_queue
    codeType

    string

    No

    The job type. Valid values:

    • SQL

    • JAR

    • PYTHON

    SQL
    executionTimeoutSeconds

    integer

    No

    The timeout period for the job.

    100
    configurationOverrides

    object

    No

    The advanced Spark configurations.

    configurations

    array<object>

    No

    The list of Spark configurations.

    object

    No

    A Spark configuration object.

    configFileName

    string

    No

    The configuration file to which the Spark configuration belongs.

    spark-defaults.conf
    configItemKey

    string

    No

    The key of the Spark configuration.

    spark.app.name
    configItemValue

    string

    No

    The value of the Spark configuration.

    test_app
    tags

    array

    No

    The list of job tags.

    Tag

    No

    A tag object.

    clientToken

    string

    No

    The idempotence token.

    8e6aae2810c8f67229ca70bb31cd****
    jobDriver JobDriver

    No

    The information about the Spark driver.

    displayReleaseVersion

    string

    No

    The version that is displayed in the console.

    esr-3.3.1

    fusion

    boolean

    No

    Specifies whether to enable the Fusion engine for acceleration.

    false
    regionId

    string

    No

    ID wilayah.

    cn-hangzhou

    Elemen respons

    Element

    Type

    Description

    Example

    object

    The data returned.

    jobRunId

    string

    The job run ID.

    jr-f09a8fda2396****
    requestId

    string

    The request ID.

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

    Contoh

    Respons sukses

    JSONformat

    {
  "jobRunId": "jr-f09a8fda2396****",
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.