Background Jobs - Run On Demand Apply Changes

Layanan:

Dataflow

Versi API:

v1

Nota

API ini sedang dalam pratinjau.

Jalankan instans pekerjaan perubahan terapkan sesuai permintaan.

Cakupan yang Didelegasikan yang Diperlukan

Untuk API aliran data, gunakan jenis cakupan ini:

• Cakupan tertentu: Dataflow.Execute.All

untuk informasi selengkapnya tentang cakupan, lihat: artikel cakupan .

Identitas yang didukung oleh Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identitas	Dukungan
Pengguna	Ya
Prinsipal Layanan dan Identitas Terkelola	Tidak.

Antarmuka

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataflows/{dataflowId}/jobs/instances?jobType={jobType}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
dataflowId	path	True	string (uuid)	ID aliran data.
workspaceId	path	True	string (uuid)	ID ruangkerja.
jobType	query	True	string	Jenis pekerjaan ApplyChanges.

Respons

Nama	Jenis	Deskripsi
202 Accepted		Permintaan diterima, eksekusi pekerjaan sedang berlangsung. Header Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Kode kesalahan umum: InsufficientPrivileges - Pemanggil tidak memiliki izin yang memadai untuk menjalankan instans pekerjaan. InvalidJobType - Jenis pekerjaan yang diminta tidak valid. TooManyRequestsForJobs - Pemanggil meminta terlalu banyak permintaan pekerjaan sesuai permintaan. ItemNotFound - ID item yang diminta tidak ditemukan.

Contoh

Run dataflow ApplyChanges job instance example

Permintaan sampel

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/dataflows/dddddddd-9999-0000-1111-eeeeeeeeeeee/jobs/instances?jobType=ApplyChanges

Respon sampel

Kode status:

202

Location: https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/items/dddddddd-9999-0000-1111-eeeeeeeeeeee/jobs/instances/bbbbbbbb-1111-2222-3333-cccccccccccc
Retry-After: 60

Definisi

Nama	Deskripsi
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Detail respons kesalahan.

ErrorRelatedResource

Objek

Objek detail sumber daya terkait kesalahan.

Nama	Jenis	Deskripsi
resourceId	string	ID sumber daya yang terlibat dalam kesalahan.
resourceType	string	Jenis sumber daya yang terlibat dalam kesalahan.

ErrorResponse

Objek

Respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message	string	Representasi kesalahan yang dapat dibaca manusia.
moreDetails	ErrorResponseDetails[]	Daftar detail kesalahan tambahan.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.
requestId	string	ID permintaan yang terkait dengan kesalahan.

ErrorResponseDetails

Objek

Detail respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message	string	Representasi kesalahan yang dapat dibaca manusia.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.