All Products
Search
Document Center

DataWorks:ListFolders

Last Updated:Aug 18, 2026

Mengkueri daftar folder.

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

ProjectId

integer

No

ID ruang kerja DataWorks.

Anda dapat masuk ke Konsol DataWorks dan membuka halaman konfigurasi ruang kerja untuk mendapatkan ID ruang kerja. Anda harus menentukan parameter ini atau ProjectIdentifier untuk menentukan ruang kerja DataWorks untuk panggilan API ini.

10000

ProjectIdentifier

string

No

Nama ruang kerja DataWorks.

Anda dapat masuk ke Konsol DataWorks dan membuka halaman konfigurasi ruang kerja untuk mendapatkan nama ruang kerja. Anda harus menentukan parameter ini atau ProjectId untuk menentukan ruang kerja DataWorks untuk panggilan API ini.

dw_project

ParentFolderPath

string

Yes

Jalur folder induk.

Business_process/my_first_business_process/MaxCompute

PageNumber

integer

Yes

Nomor halaman untuk paginasi.

1

PageSize

integer

Yes

Jumlah entri per halaman. Nilai default: 10. Nilai maksimum: 100.

10

Elemen respons

Element

Type

Description

Example

object

Parameter tanggapan.

HttpStatusCode

integer

Kode status HTTP.

200

ErrorMessage

string

Paket kesalahan.

The connection does not exist

RequestId

string

ID permintaan. Anda dapat menggunakan ID ini untuk memecahkan masalah.

0000-ABCD-****

ErrorCode

string

Kode kesalahan.

Invalid.Tenant.ConnectionNotExists

Success

boolean

Apakah panggilan berhasil. Nilai valid:

  • true: Panggilan berhasil.

  • false: Panggilan gagal.

true

Data

object

Daftar folder yang memenuhi kondisi yang ditentukan.

PageNumber

integer

Nomor halaman saat ini.

1

PageSize

integer

Jumlah entri pada halaman saat ini.

10

TotalCount

integer

Jumlah total entri yang memenuhi kondisi kueri.

13

Folders

array<object>

Daftar folder.

object

Informasi folder.

FolderPath

string

The folder path.

Business_process/my_first_business_process/MaxCompute/ods_layer

FolderId

string

The folder ID.

2735c2****

Contoh

Respons sukses

JSONformat

{
  "HttpStatusCode": 200,
  "ErrorMessage": "The connection does not exist.",
  "RequestId": "0000-ABCD-****",
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Success": true,
  "Data": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 13,
    "Folders": [
      {
        "FolderPath": "Business_process/my_first_business_process/MaxCompute/ods_layer",
        "FolderId": "2735c2****"
      }
    ]
  }
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

500 InternalError.System An internal system error occurred. Try again later.
500 InternalError.UserId.Missing An internal system error occurred. Try again later.
403 Forbidden.Access Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition.
429 Throttling.Api The request for this resource has exceeded your available limit.
429 Throttling.System The DataWorks system is busy. Try again later.
429 Throttling.User Your request is too frequent. Try again later.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.