All Products
Search
Document Center

DataWorks:ListFolders

Last Updated:Jun 11, 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 Ruang Kerja untuk mengkueri ID tersebut. Anda harus menentukan parameter ini atau parameter ProjectIdentifier untuk mengidentifikasi ruang kerja DataWorks saat memanggil operasi ini.

10000

ProjectIdentifier

string

No

Nama ruang kerja DataWorks. Anda dapat masuk ke Konsol DataWorks dan membuka halaman Ruang Kerja untuk mengkueri nama ruang kerja. Anda harus menentukan parameter ini atau parameter ProjectId untuk mengidentifikasi ruang kerja DataWorks saat memanggil operasi ini.

dw_project

ParentFolderPath

string

Yes

Jalur folder induk.

Business_process/my_first_business_process/MaxCompute

PageNumber

integer

Yes

Nomor halaman. Digunakan untuk paginasi.

1

PageSize

integer

Yes

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

10

Elemen respons

Element

Type

Description

Example

object

Responses

HttpStatusCode

integer

The HTTP status code.

200

ErrorMessage

string

The error message

The connection does not exist.

RequestId

string

The request ID. Used to troubleshoot errors.

0000-ABCD-****

ErrorCode

string

The error code.

Invalid.Tenant.ConnectionNotExists

Success

boolean

Indicates whether the request was successful. Valid values:

  • true: success.

  • false: failure.

true

Data

object

The list of folders that meet the conditions.

PageNumber

integer

The current page number.

1

PageSize

integer

The number of records on the current page.

10

TotalCount

integer

The total number of records that meet the query conditions.

13

Folders

array<object>

The list of folders.

object

The folder details.

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. No permission, please authorize
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.