DsgSceneAddOrUpdateScene -

調試

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

請求參數

名稱	類型	是否必選	樣本值	描述
Action	String	是	DsgSceneAddOrUpdateScene	系統規定參數。取值：DsgSceneAddOrUpdateScene。
scenes	Array	是		二級脫敏情境資訊。
id	String	否	123	二級脫敏情境ID。不配置該參數：表示當前操作為新增二級脫敏情境。配置該參數：表示編輯指定二級脫敏情境資訊。您可調用DsgSceneQuerySceneListByName介面查詢二級脫敏情境ID。
sceneName	String	是	dev_scene	二級脫敏情境名稱。
sceneCode	String	是	dataworks_display_desense_code	二級脫敏情境所屬的一級脫敏情境Code。取值如下：資料開發/資料地圖展示脫敏：dataworks_display_desense_code MaxCompute引擎層脫敏：maxcompute_desense_code MaxCompute引擎層脫敏（新）：maxcompute_new_desense_code 資料分析展示脫敏：dataworks_analysis_desense_code
projects	Array	否		脫敏情境生效的引擎資訊。
clusterId	String	否	c-1234	若脫敏情境生效的資料範圍為EMR引擎，此處需輸入EMR叢集ID。僅當使用EMR引擎時需配置該參數。
projectName	String	否	dev_project	脫敏情境生效的引擎執行個體名稱。
dbType	String	否	ODPS.ODPS	脫敏情境生效的引擎類型。取值如下： ODPS：ODPS.ODPS HOLO：HOLO.POSTGRES EMR：EMR
desc	String	否	測試用情境	描述。
userGroupIds	Array of Long	否	123	脫敏情境生效的使用者組ID。您可調用DsgUserGroupQueryList介面擷取。

返回資料

名稱	類型	樣本值	描述
Success	Boolean	true	調用是否成功。取值如下： true：調用成功。 false：調用失敗。
ErrorCode	String	1029030003	錯誤碼。
ErrorMessage	String	param error	錯誤資訊。
HttpStatusCode	Integer	400	HTTP狀態代碼。
Data	Boolean	true	操作結果。
RequestId	String	102400001	請求的ID。用於定位日誌，排查問題。

樣本

請求樣本

http(s)://[Endpoint]/?Action=DsgSceneAddOrUpdateScene
&scenes=[{"id":"123","sceneName":"dev_scene","sceneCode":"dataworks_display_desense_code","projects":[{"clusterId":"c-1234","projectName":"dev_project","dbType":"ODPS.ODPS"}],"desc":"測試用情境","userGroupIds":[123]}]
&公用請求參數

正常返回樣本

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DsgSceneAddOrUpdateSceneResponse>
    <Success>true</Success>
    <ErrorCode>1029030003</ErrorCode>
    <ErrorMessage>param error</ErrorMessage>
    <HttpStatusCode>400</HttpStatusCode>
    <Data>true</Data>
    <RequestId>102400001</RequestId>
</DsgSceneAddOrUpdateSceneResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Success" : true,
  "ErrorCode" : "1029030003",
  "ErrorMessage" : "param error",
  "HttpStatusCode" : 400,
  "Data" : true,
  "RequestId" : "102400001"
}

錯誤碼

HttpCode	錯誤碼	錯誤資訊	描述
400	DESENSSCENE.ID.ERROR	The desensitization scenario ID does not match or does not exist with the tenant.	情境ID不存在或不屬於該租戶。
400	DESENSSCENE.IDLEVEL.ERROR	The desensitization scenario is not a secondary scenario.	脫敏情境不是二級情境。
400	DESENSSCENE.PROJECT.ERROR	The project space does not exist.	工作空間不存在。
400	DESENSSCENE.SIZE.ERROR	The number of desens scene exceeds the limit.	脫敏情境數量超限。
400	DESENSSCENE.UESRGROUP.ERROR	The user group ID does not match the tenant or does not exist.	使用者組ID不存在或不屬於該租戶。
400	PARAMS.ERROR	param error.	參數錯誤。
403	PERMISSION.DENIED.ERROR	Permission denied	許可權不足。
500	UNKNOWN.ERROR	unknown error.	未知錯誤。

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