ApplyResourceAccessPermission - DataWorks

用於提交對特定資源的存取權限申請。

介面說明

請求說明

Reason：申請理由，必須提供。
ApplyContents：包含多個資源權限申請內容，每個內容包括資源描述（Resource）、授權主體描述（Grantee）、權限類型（AccessTypes）和權限到期時間（ExpirationTime）。單次最大限制 400 條。
Resource：資源描述，需要指定資源解析依賴的 ResourceSchema.name 和 version，以及資源中繼資料 MetaData。
Grantee：授權主體描述，需要指定授權主體類型（PrincipalType）和主體 ID（PrincipalId）。
AccessTypes：權限類型清單，支援多種權限組合。
ExpirationTime：權限到期時間，以毫秒時間戳記形式提供。
AuthMethod：可選參數，指定授權方式，預設使用系統內建的預設授權方式。
ClientToken：用戶端令牌，用於防止重複請求，非必填項。

請確保所有必填欄位都已正確填寫，並且符合相應的約束條件。例如，Resource 中的 DefVersion 和 MetaData 應與所選 DefSchema 相匹配。

調試

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

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

dataworks:ApplyResourceAccessPermission

create

*全部資源。

*

無

請求參數

名稱	類型	必填	描述	樣本值
Reason	string	是	申請理由。	業務發展需要
ApplyContents	array<object>	是	資源權限申請內容清單。
	array<object>	否
Resource	object	否	資源描述。
DefSchema	string	是	資源類型。注意：系統支援申請的資源類型受 ResourceSchema .name 約束。附：ResourceSchema 國際站說明文件枚舉值： MaxCompute : MaxCompute LINDORM : LINDORM EMR_ON_ECS_HIVE : EMR_ON_ECS_HIVE DLF_V1 : DLF_V1 HOLOGRES : HOLOGRES SEVERLESS_STARROCKS : SEVERLESS_STARROCKS DATAWORKS_ENTITY : DATAWORKS_ENTITY DLF_NEXT : DLF_NEXT	MaxCompute
DefVersion	string	否	資源解析版本受 ResourceSchema .version 約束。 ResourceSchema 國際站說明文件	v1.0.0
MetaData	object	否	資源中繼資料宣告。注意：中繼資料受 ResourceSchema .resources 約束，有效的資源宣告需要包含 level 0 到 validLeaf 層的全路徑中繼資料宣告。附：ResourceSchema 國際站說明文件
	any	否	透過 Map<String,Object> 格式宣告具體資源，需要符合 ResourceSchema 中具體資源類型的 resource 約束。注意： MaxCompute 申請欄位權限時同步宣告欄位安全等級 columnSensibleLevel 才會進行 label 授權。開啟 Schema 的 MaxCompute 權限申請需傳遞 threeTierModel 參數並設定為 true。	{ "workspace": "449656", "project": "sync_destination", "table": "order_table", "threeTierModel": false }
Grantee	object	是	授權主體描述。注意：系統支援的授權主體類型受 ResourceSchema .authPrincipal 約束。附：ResourceSchema 國際站說明文件
PrincipalType	string	是	授權主體類型。列舉： RamRole RamUser DlfRole 枚舉值： DlfRole : DlfRole RamUser : RamUser RamRole : RamRole	RamRole
PrincipalId	string	是	授權主體 ID，不同授權主體類型對應的 ID 具有不同語意： RamUser：DataWorks UserId RamRole：以 "ROLE_" 開頭的 DataWorks UserId DlfRole：DlfNext 角色名稱	ROLE_32237475848545
AccessTypes	array	是	申請的權限清單。注意：不同層級資源支援申請的權限類型不同，統一受 ResourceSchema .isValidLeaf、accessTypeRestrictions 和 authMethodAccessTypes 約束。附：ResourceSchema 國際站說明文件
	string	否	資源權限。	select
ExpirationTime	integer	否	權限到期時間，毫秒時間戳記。	1785835708000
AuthMethod	string	否	授權方式。目前只有 SEVERLESS_STARROCKS 支援指定授權方式：ranger、starrocksManager。注意：不同資源支援的授權方式不同，統一受 ResourceSchema .authMethods 約束。附：ResourceSchema 國際站說明文件枚舉值： starrocksManager : Starrocks Manager ranger : Ranger	ranger
ClientToken	string	否	冪等參數。用於避免多次呼叫導致操作重複。	ABFUOEUOTRTRJKE

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
RequestId	string	請求 ID。用於定位日誌，排查問題。	0bc5df3a17***903790e8e8a
Data	array	申請單 ID 清單。
	string	申請單／審批流程 ID。	332066440109224007

樣本

正常返回樣本

JSON格式

{
  "RequestId": "0bc5df3a17***903790e8e8a",
  "Data": [
    "332066440109224007"
  ]
}

錯誤碼

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

變更歷史

更多資訊，參考變更詳情。