全部產品
Search
文件中心

DataWorks:SetDataSourceShare

更新時間:Jul 31, 2026

分享目標資料來源至指定DataWorks工作空間或指定使用者。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

ProjectId

integer

目標資料來源所在的 DataWorks 工作空間 ID。您可以呼叫 ListProjects 介面取得工作空間 ID。

10000

DatasourceName

string

待分享的目標資料來源名稱。

mysql_name

EnvType

string

目標資料來源所屬的環境。取值如下:

  • 0:開發環境。

  • 1:生產環境。

1

ProjectPermissions

string

指定需要分享目標資料來源的 DataWorks 工作空間。分享後,該工作空間的所有成員均可查看或使用目標資料來源。使用 JSONARRAY 格式。[{"projectId":1000,"permission":"WRITE","sharedName":"PX_DATAHUB1.shared_name"}], 參數說明如下:

  • projectId:需要分享目標資料來源的工作空間 ID。

  • permission:支援 READ(讀取)和 WRITE(寫入)兩種模式權限。READ(讀取)表示指定工作空間的所有成員僅可以讀取目標資料來源的資料,但是不能修改該資料;WRITE(寫入)表示指定工作空間的所有成員可以修改目標資料來源的資料。

  • sharedName:待分享的資料來源名稱。

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

UserPermissions

string

指定需要分享目標資料來源的使用者。分享後,該使用者可查看或使用目標資料來源。使用 JSONARRAY 格式。[{"projectId":10000,"users":[{"userId":"276184575345452131","permission":"WRITE"}],"sharedName":"PX_DATAHUB1.shared_name"}], 參數說明如下:

  • projectId:指定 DataWorks 工作空間的 ID。表示需要分享目標資料來源的使用者僅在該工作空間下可查看或使用目標資料來源。

  • userId:需要分享目標資料來源的使用者 ID。

  • permission:支援 READ(讀取)和 WRITE(寫入)兩種模式權限。READ(讀取)表示指定的使用者僅可以讀取目標資料來源的資料,但是不能修改該資料;WRITE(寫入)表示指定的使用者可以修改目標資料來源的資料。

  • sharedName:待分享的資料來源名稱。

ProjectPermissions 和 UserPermissions 如果都為空,則該介面不會做任何修改。如果都不為空,則既會 UserPermissions 生效,ProjectPermissions 也會生效

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

返回參數

名稱

類型

描述

樣本值

object

Success

boolean

請求是否成功。取值如下:

  • true:成功。

  • false:失敗。

true

RequestId

string

本次呼叫的唯一 ID。用於出現錯誤後定位日誌,排查問題。

0000-ABCD-EFG

Data

object

分享目標資料來源的傳回資料。

Status

string

分享目標資料來源的結果狀態。取值如下:

  • success:表示目標資料來源分享成功。

  • fail:表示目標資料來源分享失敗。您可以查看 Message 參數定位失敗原因。

success

Message

string

分享目標資料來源失敗後的原因描述。如果分享目標資料來源成功,則該參數的傳回值為空。

datasource is wrong

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

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

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情