All Products
Search

This Product

    DataWorks:ListPendingApprovals

    Document Center

    DataWorks:ListPendingApprovals

    Last Updated:Jun 24, 2026

    Mengambil daftar pesanan permintaan izin tertunda yang penyetujuannya adalah pengguna saat ini.

    Deskripsi operasi

    Deskripsi Permintaan

    API ini digunakan untuk mengkueri semua pesanan permintaan izin tertunda yang penyetujuannya adalah pengguna yang sedang masuk. API ini mendukung pemfilteran berdasarkan beberapa kondisi, termasuk tipe sumber daya, rentang waktu, dan status persetujuan, untuk menemukan pesanan permintaan tertentu secara lebih tepat.

    • ResourceType: Menentukan tipe sumber daya (seperti tabel), yang dapat memiliki beberapa nilai.

    • Resource: Menyediakan kondisi pencarian sumber daya tertentu, seperti nama proyek, database, atau tabel.

    • StartTime dan EndTime: Menentukan rentang waktu saat permintaan dikirim.

    • Statuses: Memungkinkan pemfilteran hasil berdasarkan status persetujuan, misalnya untuk melihat hanya permintaan yang menunggu persetujuan.

    • Grantee: Memfilter pesanan permintaan berdasarkan informasi pihak yang berwenang untuk otorisasi.

    • AccessTypes: Memfilter berdasarkan tipe izin tertentu yang diminta (seperti baca atau perbarui).

    • PageSize dan NextToken: Digunakan untuk kontrol paginasi, menentukan jumlah data yang dikembalikan per permintaan dan kursor yang diperlukan untuk mengambil halaman data berikutnya.

    Catatan:

    • Jika tidak ada kondisi pemfilteran yang diberikan, semua catatan yang cocok akan dikembalikan secara default.

    • Parameter NextToken dapat kosong atau dihilangkan untuk panggilan pertama. Permintaan halaman berikutnya harus menggunakan nilai NextToken yang disediakan dalam tanggapan sebelumnya.

    • Nilai default PageSize adalah 10, dan nilai maksimum adalah 200. Jika nilai yang ditentukan melebihi batas maksimum, nilai maksimum akan digunakan.

    • Ketika tidak ada lagi data yang akan dikembalikan, bidang HasMore diatur ke false, dan NextToken akan kosong atau tidak ada.

    Deskripsi Tanggapan

    Setelah panggilan API ini berhasil, badan respons berisi hasil paginasi dan informasi detail untuk setiap pesanan permintaan, seperti waktu aplikasi, deskripsi sumber daya, pihak yang berwenang untuk otorisasi, izin yang diminta, dan lainnya. Selain itu, status proses persetujuan dan metadata terkait lainnya juga disediakan.

    • Data: Set hasil paginasi, termasuk ukuran halaman (PageSize), kursor (NextToken), dan apakah tersedia data lainnya (HasMore).

    • ApplicationQueryResponse: Konten spesifik dari setiap pesanan permintaan, termasuk alasan permintaan, waktu pengiriman, status, dan daftar detail konten permintaan.

    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
    DefSchema

    string

    Yes

    Memfilter berdasarkan tipe sumber daya.

    Catatan: Tipe sumber daya yang didukung untuk permintaan dibatasi oleh ResourceSchema.name.

    Referensi: Dokumentasi Internasional ResourceSchema.

    MaxCompute
    ResourceType

    array

    Yes

    Memfilter berdasarkan tipe sumber daya izin minimum.

    Catatan: Tipe sumber daya izin minimum dibatasi oleh ResourceSchema.resources[*].isValidLeaf yang bernilai true.

    Referensi: Dokumentasi Internasional ResourceSchema.

    ["table", "column"]

    string

    No

    Tipe sumber daya.

    table
    Resource

    object

    No

    Memfilter berdasarkan sumber daya dengan pencocokan tepat atau fuzzy. Deskripsi sumber daya dibatasi oleh ResourceSchema.

    Referensi: Dokumentasi Internasional ResourceSchema.

    DefSchema

    string

    No

    Tipe sumber daya.

    Catatan: Tipe sumber daya yang didukung untuk permintaan dibatasi oleh ResourceSchema.name.

    Referensi: Dokumentasi Internasional ResourceSchema.

    MaxCompute
    DefVersion

    string

    No

    Versi penguraian sumber daya dibatasi oleh ResourceSchema.version.

    Referensi: Dokumentasi Internasional ResourceSchema.

    v1.0.0
    MetaData

    object

    No

    Metadata sumber daya.

    Catatan: Metadata dibatasi oleh ResourceSchema.resources. Deklarasi sumber daya yang valid harus menyertakan deklarasi metadata jalur lengkap dari level 0 hingga level validLeaf.

    Referensi: Dokumentasi Internasional ResourceSchema.

    any

    No

    Resource metadata

    { "workspace": "449056", "project": "sync_destination" }
    StartTime

    integer

    No

    Waktu mulai periode aplikasi (stempel waktu milidetik).

    1771948800000
    EndTime

    integer

    No

    Waktu akhir periode aplikasi (stempel waktu milidetik).

    1779724799999
    Grantee

    object

    No

    Memfilter berdasarkan pihak yang berwenang untuk otorisasi.

    Catatan: Tipe pihak yang berwenang untuk otorisasi yang didukung dibatasi oleh ResourceSchema.authPrincipal.

    Referensi: Dokumentasi Internasional ResourceSchema

    PrincipalType

    string

    No

    Tipe pihak yang berwenang untuk otorisasi.

    RamRole
    PrincipalId

    string

    No

    ID pihak yang berwenang untuk otorisasi.

    ROLE_3133343434
    AccessTypes

    array

    No

    Memfilter berdasarkan izin yang diminta.

    Catatan: Level sumber daya yang berbeda mendukung tipe izin yang berbeda. Semua dibatasi secara seragam oleh ResourceSchema.isValidLeaf, accessTypeRestrictions, dan authMethodAccessTypes.

    Referensi: Dokumentasi Internasional ResourceSchema.

    string

    No

    Izin.

    select
    NextToken

    string

    No

    Kursor.

    eyJpZCI6MTIzfQ==
    PageSize

    integer

    No

    Ukuran halaman (default: 10, maksimum: 200).

    20

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Tanggapan permintaan API. Kode kesalahan tidak kosong ketika panggilan gagal.

    RequestId

    string

    ID permintaan API, dihasilkan sebagai UUID.

    0bc5df3a17****903790e8e8a
    Data

    object

    Hasil paginasi.

    PageSize

    integer

    Ukuran halaman (default: 10, maksimum: 200).

    10
    NextToken

    string

    Kursor.

    eyJpZCI6MTIzfQ==
    HasMore

    boolean

    Apakah tersedia data lainnya.

    false
    Data

    array<object>

    Daftar data dalam hasil paginasi.

    array<object>

    Proses persetujuan dan konten permintaan.

    ProcessInstanceId

    string

    The process instance ID.

    176906667488145
    DefSchema

    string

    The resource type.

    MaxCompute
    Reason

    string

    The reason for the request.

    业务需要
    ApplicationTime

    integer

    The submission time of the request.

    申请时间
    Status

    string

    The approval status. Valid values:

    • WaitApproval: Pending approval

    • Confirmed: Pending authorization

    • RejectApproval: Rejected

    • AuthorizeSucceed: Authorization successful

    • AuthorizeFailed: Authorization failed

    • Deleted: Deleted

    • Canceled: Canceled

    Deleted
    Contents

    array<object>

    The content of the request.

    array<object>

    The requested items.

    Id

    string

    The unique identifier of the requested item.

    210001918826
    ProcessInstanceId

    string

    The process instance ID.

    176906667488145
    TenantId

    string

    The tenant ID.

    69973837489
    ResourceName

    string

    The type of the resource, such as a table or function.

    table
    DefSchema

    string

    The resource type.

    MaxCompute
    AuthMethod

    string

    The authorization method.

    default
    Resource

    object

    The resource declaration.

    DefSchema

    string

    The name of the ResourceSchema used to parse the resource.

    MaxCompute
    DefVersion

    string

    The version of the ResourceSchema used to parse the resource.

    v1.0.0
    MetaData

    object

    The resource metadata. The content is constrained by the DefSchema.

    any

    The content of the resource metadata.

    { "schema": "default", "threeTierModel": false, "project": "sync_dtestn", "workspace": "4477656", "table": "order", "tenant": "524257424864736" }
    Grantee

    object

    Information about the grantee.

    PrincipalType

    string

    The principal type. Valid values:

    • RamRole: A RAM role.

    • RamUser: A RAM user.

    • DataWorksTenantMember: A DataWorks tenant member.

    • DataWorksTenantRole: A DataWorks tenant role.

    • DataWorksProjectMember: A DataWorks workspace member.

    • DataWorksProjectRole: A DataWorks workspace role.

    • DlfRole: A DLF role.

    RamUser
    PrincipalId

    string

    The principal ID.

    Note: The meaning of this ID varies based on the principalType.

    • If the principalType is RamUser, this is the DataWorks user ID.

    • If the principalType is RamRole, this is the DataWorks user ID, prefixed with "ROLE_".

    • If the principalType is DataWorksTenantMember, this is the DataWorks user ID.

    • If the principalType is DataWorksTenantRole, this is the DataWorks tenant role code.

    • If the principalType is DataWorksProjectRole, this is the DataWorks workspace role code.

    • If the principalType is DataWorksProjectMember, this is the DataWorks user ID.

    • If the principalType is DlfRole, this is the DLF role name.

    213463068144525171
    AccessTypes

    array

    The permissions requested for the resource.

    string

    A permission.

    select
    FinalAccessTypes

    array

    The final permissions granted after approval.

    string

    A granted permission.

    select
    ExpirationTime

    integer

    The permission expiration time, in milliseconds since the Unix epoch.

    1782354014507
    Status

    string

    The approval status. Valid values:

    • WaitApproval: Pending approval

    • Confirmed: Pending authorization

    • RejectApproval: Rejected

    • AuthorizeSucceed: Authorization successful

    • AuthorizeFailed: Authorization failed

    • Deleted: Deleted

    • Canceled: Canceled

    Deleted
    CreateTime

    integer

    The creation time of the entry.

    2025-09-11 10:13:21
    UpdateTime

    integer

    The time the entry was last updated.

    2022-07-06 19:13:05

    Contoh

    Respons sukses

    JSONformat

    {
  "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
          }
        ]
      }
    ]
  }
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.