ListPendingApprovals - DataWorks

取得目前使用者作為審批人、待處理的權限申請單列表。

介面說明

請求說明

本介面用於查詢目前登入使用者作為審批人的所有待處理權限申請單。支援透過多種條件進行篩選，包括資源類型、時間範圍、審批狀態等，以便更精確地定位到特定的申請單。

ResourceType：指定資源類型（如表），可以是多個值。
Resource：提供具體的資源檢索條件，比如所屬專案、資料庫或表名。
StartTime 和 EndTime：定義了申請發起的時間範圍。
Statuses：允許按審批狀態過濾結果，例如只查看待審批的狀態。
Grantee：根據授權對象的資訊來過濾申請單。
AccessTypes：基於請求的具體權限類型（如讀取、更新）來篩選。
PageSize 和 NextToken：用於分頁控制，每次請求返回的資料量以及取得下一頁資料所需的游標。

注意事項：

如果不提供任何篩選條件，則預設返回所有符合條件的記錄。
NextToken 參數在首次呼叫時可為空或省略；後續頁面請求需使用上一次回應中提供的 NextToken 值。
PageSize 的預設值為 10，最大值為 200。如果設定的值超過最大限制，則按最大值處理。
當沒有更多資料可返回時，HasMore 欄位將被設定為 false，並且 NextToken 將為空或不存在。

回應說明

成功呼叫該 API 後，回應體中包含分頁結果及每條申請單的詳細資訊，如申請時間、資源描述、授權對象、請求權限等。此外，還提供了審批流程的狀態和其他相關中繼資料。

Data：分頁結果集，包括每頁大小 (PageSize)、游標 (NextToken) 和是否還有更多資料 (HasMore) 等資訊。
ApplicationQueryResponse：每個申請單的具體內容，包括申請理由、發起時間、狀態以及詳細的申請內容列表。

調試

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

調試

授權資訊

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

請求參數

名稱	類型	必填	描述	樣本值
DefSchema	string	是	根據資源類型篩選。注意：系統支援申請的資源類型受 ResourceSchema .name 約束。附： ResourceSchema 國際站說明文件。	MaxCompute
ResourceType	array	是	根據最小權限資源類型篩選。注意：最小權限資源類型受 ResourceSchema . resources[*].isValidLeaf 為 true 約束。附： ResourceSchema 國際站說明文件。	["table", "column"]
	string	否	資源類型。	table
Resource	object	否	根據資源做精確/泛化篩選，資源的描述受 ResourceSchema 約束。附： ResourceSchema 國際站說明文件。
DefSchema	string	否	資源類型。注意：系統支援申請的資源類型受 ResourceSchema .name 約束。附： ResourceSchema 國際站說明文件。	MaxCompute
DefVersion	string	否	資源解析版本受 ResourceSchema .version 約束。 ResourceSchema 國際站說明文件。	v1.0.0
MetaData	object	否	資源中繼資料。注意：中繼資料受 ResourceSchema .resources 約束，有效的資源宣告需要包含 level 0 到 validLeaf 層的全路徑中繼資料宣告。附： ResourceSchema 國際站說明文件。
	any	否	资源元数据	{ "workspace": "449056", "project": "sync_destination" }
StartTime	integer	否	申請時間開始（毫秒時間戳）。	1771948800000
EndTime	integer	否	申請時間結束（毫秒時間戳）。	1779724799999
Grantee	object	否	根據授權主體篩選。注意：系統支援的授權主體類型受 ResourceSchema .authPrincipal 約束。附： ResourceSchema 國際站說明文件。
PrincipalType	string	否	授權主體類型。	RamRole
PrincipalId	string	否	授權主體 ID。	ROLE_3133343434
AccessTypes	array	否	根據申請的權限篩選。注意：不同層級資源支援權限的申請類型不同，統一受 ResourceSchema .isValidLeaf 和 accessTypeRestrictions 和 authMethodAccessTypes 約束。附： ResourceSchema 國際站說明文件。
	string	否	權限。	select
NextToken	string	否	游標。	eyJpZCI6MTIzfQ==
PageSize	integer	否	每頁大小（預設 10，最大 200）。	20

返回參數

名稱	類型	描述	樣本值
	object	API 請求回應錯誤碼，呼叫出錯時非空。
RequestId	string	API 請求 ID，uuid 生成。	0bc5df3a17****903790e8e8a
Data	object	分頁結果。
PageSize	integer	每頁大小（預設 10，最大 200）。	10
NextToken	string	游標。	eyJpZCI6MTIzfQ==
HasMore	boolean	是否有更多資料。	false
Data	array<object>	分頁結果中的資料列表。
	array<object>	審批流程與申請內容。
ProcessInstanceId	string	流程執行個體 ID	176906667488145
DefSchema	string	資源類型	MaxCompute
Reason	string	申請理由	业务需要
ApplicationTime	integer	申請發起時間	申请时间
Status	string	審批狀態篩選。枚舉： WaitApproval 待審批 Confirmed 待授權 RejectApproval 審批拒絕 AuthorizeSucceed 授權成功 AuthorizeFailed 授權失敗 Deleted 已刪除 Canceled 已撤回	Deleted
Contents	array<object>	申請內容
	array<object>	申請內容
Id	string	申請內容唯一標識	210001918826
ProcessInstanceId	string	流程執行個體 ID	176906667488145
TenantId	string	租戶 ID	69973837489
ResourceName	string	最小許可權資源類型	table
DefSchema	string	資源類型	MaxCompute
AuthMethod	string	授權方式	default
Resource	object	資源聲明
DefSchema	string	資源解析依賴的 ResourceSchema.name	MaxCompute
DefVersion	string	資源解析依賴的 ResourceSchema.version	v1.0.0
MetaData	object	資源中繼資料，資料內容受 ResourceSchema 約束
	any	資源內容	{ "schema": "default", "threeTierModel": false, "project": "sync_dtestn", "workspace": "4477656", "table": "order", "tenant": "524257424864736" }
Grantee	object	授權主體描述
PrincipalType	string	主體類型，枚舉： RamRole RamUser DataworksTenantMember DataworksTenantRole DataworksProjectMember DataworksProjectRole DlfRole	RamUser
PrincipalId	string	主體 ID。注意：當 principalType 為不同類型時，對應不同語義： RamUser：Dataworks UserId RamRole："ROLE_"開頭的 Dataworks UserId DataworksTenantMember：Dataworks UserId DataworksTenantRole：Dataworks tenant roleCode DataworksProjectRole：Dataworks workspace roleCode DataworksProjectMember：Dataworks UserId DlfRole：DlfNext role name	213463068144525171
AccessTypes	array	發起申請的資源操作許可權
	string	許可權	select
FinalAccessTypes	array	最終審批通過的資源操作許可權
	string	select	select
ExpirationTime	integer	許可權到期日，毫秒時間戳記	1782354014507
Status	string	審批狀態篩選。枚舉： WaitApproval 待審批 Confirmed 待授權 RejectApproval 審批拒絕 AuthorizeSucceed 授權成功 AuthorizeFailed 授權失敗 Deleted 已刪除 Canceled 已撤回	Deleted
CreateTime	integer	建立時間	2025-09-11 10:13:21
UpdateTime	integer	更新時間	2022-07-06 19:13:05

樣本

正常返回樣本

JSON格式

{
  "RequestId": "0bc5df3a17****903790e8e8a",
  "Data": {
    "PageSize": 10,
    "NextToken": "eyJpZCI6MTIzfQ==",
    "HasMore": false,
    "Data": [
      {
        "ProcessInstanceId": "176906667488145",
        "DefSchema": "MaxCompute",
        "Reason": "业务需要",
        "ApplicationTime": 0,
        "Status": "Deleted",
        "Contents": [
          {
            "Id": "210001918826",
            "ProcessInstanceId": "176906667488145",
            "TenantId": "69973837489",
            "ResourceName": "table",
            "DefSchema": "MaxCompute",
            "AuthMethod": "default",
            "Resource": {
              "DefSchema": "MaxCompute",
              "DefVersion": "v1.0.0",
              "MetaData": {
                "key": "{\n                \"schema\": \"default\",\n                \"threeTierModel\": false,\n                \"project\": \"sync_dtestn\",\n                \"workspace\": \"4477656\",\n                \"table\": \"order\",\n                \"tenant\": \"524257424864736\"\n              }"
              }
            },
            "Grantee": {
              "PrincipalType": "RamUser",
              "PrincipalId": "213463068144525171"
            },
            "AccessTypes": [
              "select"
            ],
            "FinalAccessTypes": [
              "select"
            ],
            "ExpirationTime": 1782354014507,
            "Status": "Deleted",
            "CreateTime": 0,
            "UpdateTime": 0
          }
        ]
      }
    ]
  }
}

錯誤碼

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

變更歷史

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