All Products
Search
Document Center

DataWorks:SetDataSourceShare

Last Updated:Jun 11, 2026

Membagikan sumber data ke ruang kerja DataWorks tertentu atau pengguna tertentu.

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.

Parameter permintaan

Parameter

Type

Required

Description

Example

ProjectId

integer

Yes

ID ruang kerja DataWorks tempat sumber data berada. Anda dapat memanggil operasi ListProjects untuk mengkueri ID.

10000

DatasourceName

string

Yes

Nama sumber data yang ingin Anda bagikan.

mysql_name

EnvType

string

No

Lingkungan tempat sumber data digunakan. Nilai valid:

  • 0: lingkungan pengembangan

  • 1: lingkungan produksi.

1

ProjectPermissions

string

No

Ruang kerja DataWorks tempat Anda ingin membagikan sumber data. Jika Anda mengonfigurasi parameter ini, semua anggota ruang kerja DataWorks yang ditentukan dapat Tampilan dan menggunakan sumber data. Nilai parameter ini adalah array JSON. Contoh: [{"projectId":1000,"permission":"WRITE","sharedName":"PX_DATAHUB1.shared_name"}], Deskripsi parameter:

  • projectId: ID ruang kerja DataWorks tempat Anda ingin membagikan sumber data.

  • permission: izin pembagian sumber data. Nilai valid: READ dan WRITE. Nilai READ menunjukkan bahwa semua anggota ruang kerja yang ditentukan dapat membaca data dari sumber data, tetapi tidak dapat memodifikasi data. Nilai WRITE menunjukkan bahwa semua anggota ruang kerja yang ditentukan dapat memodifikasi data di sumber data.

  • sharedName: nama sumber data yang ingin Anda bagikan.

[{"projectId":1000,"permission":"WRITE","sharedName":"PX_DATAHUB1.shared_name"}]

UserPermissions

string

No

Pengguna yang ingin Anda bagikan sumber data. Jika Anda mengonfigurasi parameter ini, pengguna yang ditentukan dapat Tampilan atau menggunakan sumber data. Nilai parameter ini adalah array JSON. Contoh: [{"projectId":10000,"users":[{"userId":"276184575345452131","permission":"WRITE"}],"sharedName":"PX_DATAHUB1.shared_name"}], Deskripsi parameter:

  • projectId: ID ruang kerja DataWorks. Jika Anda mengonfigurasi parameter UserPermissions, pengguna yang ditentukan hanya dapat Tampilan atau menggunakan sumber data di ruang kerja DataWorks yang ditentukan.

  • userId: ID pengguna yang ingin Anda bagikan sumber data.

  • permission: izin pembagian sumber data. Nilai valid: READ dan WRITE. Nilai READ menunjukkan bahwa pengguna yang ditentukan dapat membaca data dari sumber data, tetapi tidak dapat memodifikasi data. Nilai WRITE menunjukkan bahwa pengguna yang ditentukan dapat memodifikasi data di sumber data.

  • sharedName: nama sumber data yang ingin Anda bagikan.

Jika parameter ProjectPermissions dan UserPermissions keduanya dikosongkan, sumber data yang ditentukan tidak dibagikan ke ruang kerja DataWorks atau pengguna mana pun. Jika kedua parameter tidak dikosongkan, kedua parameter akan berlaku.

[{"projectId":10000,"users":[{"userId":"276184575345452131","permission":"WRITE"}],"sharedName":"PX_DATAHUB1.shared_name"}]

Elemen respons

Element

Type

Description

Example

object

Success

boolean

Indicates whether the request was successful. Valid values:

  • true

  • false

true

RequestId

string

The request ID.

0000-ABCD-EFG

Data

object

The information about the sharing operation.

Status

string

Indicates whether the data source was shared. Valid values:

  • success

  • fail. You can view the value of the Message parameter to identify the cause of the failure.

success

Message

string

The reason why the data source failed to be shared. If the data source is successfully shared, the value of this parameter is an empty string.

datasource is wrong

Contoh

Respons sukses

JSONformat

{
  "Success": true,
  "RequestId": "0000-ABCD-EFG\t",
  "Data": {
    "Status": "success",
    "Message": "datasource is wrong"
  }
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 Invalid.DI.Parameter The parameter is invalid.
500 InternalError.DI.Parameter A DI internal error occurred.
403 Forbidden.DI.NoPrivilege No access.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.