All Products
Search
Document Center

DataWorks:GetFileVersion

Last Updated:Aug 18, 2026

Mengambil detail versi file.

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

FileId

integer

Yes

ID file. Anda dapat memanggil ListFiles untuk mengkueri ID file.

1000001

ProjectId

integer

No

ID ruang kerja DataWorks. Anda dapat mengklik ikon kunci pas kecil di pojok kanan atas halaman untuk menuju ke halaman manajemen penyimpanan dan melihat ID-nya di Tampilan.

1000011

ProjectIdentifier

string

No

Pengidentifikasi unik ruang kerja DataWorks, yaitu pengidentifikasi bahasa Inggris yang ditampilkan di bagian atas halaman DataStudio untuk beralih antar ruang kerja.

Anda harus mengatur salah satu dari parameter ini atau ProjectId untuk menentukan ruang kerja DataWorks bagi pemanggilan API ini.

dw_project

FileVersion

integer

Yes

Versi file yang akan dikueri.

2

Elemen respons

Element

Type

Description

Example

object

HttpStatusCode

integer

Kode status HTTP.

200

ErrorMessage

string

Paket kesalahan.

The connection does not exist

RequestId

string

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

0000-ABCD-EFG****

ErrorCode

string

Kode kesalahan.

Invalid.Tenant.ConnectionNotExists

Success

boolean

Apakah panggilan berhasil. Nilai valid:

  • true: Panggilan berhasil.

  • false: Panggilan gagal.

true

Data

object

Detail versi file.

FileContent

string

Kode file yang menghasilkan versi file ini.

SHOW TABLES;

IsCurrentProd

boolean

Apakah versi file ini adalah versi terbaru di lingkungan produksi. Nilai valid:

  • true: Versi tersebut adalah versi terbaru.

  • false: Versi tersebut bukan versi terbaru.

true

Status

string

Status saat ini dari versi file. Nilai valid:

  • COMMITTING: Versi sedang dikomit.

  • COMMITTED atau CHECK_OK: Versi telah dikomit.

  • PACKAGED: Versi siap untuk diterapkan.

  • DEPLOYING: Versi sedang diterapkan.

  • DEPLOYED: Versi telah diterapkan.

  • CANCELLED: Penerapan telah dibatalkan.

COMMITTED

NodeContent

string

Konfigurasi penjadwalan saat versi file ini dihasilkan.

{"cycleType":0,"cronExpress":"00 05 00 * * ?"}

CommitUser

string

ID pengguna Alibaba Cloud yang menghasilkan versi file ini.

7384234****

Comment

string

Deskripsi versi file ini.

Second version submission

FilePropertyContent

string

Informasi dasar file saat versi file ini dihasilkan.

{"fileName":"ods_user_info_d","fileType":10}

FileName

string

Nama file yang menghasilkan versi file ini.

ods_user_info_d

UseType

string

Modul fungsional tempat file berada. Nilai valid:

  • 0: NORMAL (DataStudio)

  • 1: MANUAL (node manual)

  • 2: MANUAL_BIZ (alur kerja manual)

  • 3: SKIP (penjadwalan dry-run di DataStudio)

  • 10: ADHOCQUERY (kueri ad hoc)

  • 30: COMPONENT (manajemen komponen)

0

ChangeType

string

Jenis perubahan versi file ini. Nilai valid: CREATE, UPDATE, dan DELETE.

UPDATE

FileVersion

integer

Versi file.

2

CommitTime

integer

Stempel waktu saat versi file dihasilkan, dalam milidetik.

1593881265000

NodeId

integer

ID node penjadwalan yang terkait dengan versi file saat dihasilkan.

3000001

Contoh

Respons sukses

JSONformat

{
  "HttpStatusCode": 200,
  "ErrorMessage": "The connection does not exist.",
  "RequestId": "0000-ABCD-EFG****",
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Success": true,
  "Data": {
    "FileContent": "SHOW TABLES;",
    "IsCurrentProd": true,
    "Status": "COMMITTED",
    "NodeContent": "{\"cycleType\":0,\"cronExpress\":\"00 05 00 * * ?\"}",
    "CommitUser": "\t\n7384234****\n",
    "Comment": "Second version submission",
    "FilePropertyContent": "{\"fileName\":\"ods_user_info_d\",\"fileType\":10}",
    "FileName": "ods_user_info_d",
    "UseType": "0",
    "ChangeType": "UPDATE",
    "FileVersion": 2,
    "CommitTime": 1593881265000,
    "NodeId": 3000001
  }
}

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.