All Products
Search
Document Center

:GetFileVersion

Last Updated:Jun 11, 2026

Mengkueri informasi tentang 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 operasi ListFiles untuk mengkueri ID.

1000001

ProjectId

integer

No

ID ruang kerja DataWorks. Anda dapat mengklik ikon Workspace Manage di pojok kanan atas halaman DataStudio untuk membuka halaman Workspace dan Tampilan ID ruang kerja.

1000011

ProjectIdentifier

string

No

Identifier unik ruang kerja DataWorks. Anda dapat mengklik identifier di pojok kiri atas halaman DataStudio untuk beralih ke ruang kerja lain.

Anda harus menentukan parameter ini atau ProjectId untuk menentukan ruang kerja DataWorks tempat operasi diterapkan.

dw_project

FileVersion

integer

Yes

Versi file yang detailnya ingin Anda kueri.

2

Elemen respons

Element

Type

Description

Example

object

The returned data.

HttpStatusCode

integer

The HTTP status code returned.

200

ErrorMessage

string

The error message returned.

The connection does not exist.

RequestId

string

The ID of the request. You can troubleshoot issues based on the ID.

0000-ABCD-EFG****

ErrorCode

string

The error code returned.

Invalid.Tenant.ConnectionNotExists

Success

boolean

Indicates whether the request is successful.

true

Data

object

The details of the file version.

FileContent

string

The file code.

SHOW TABLES;

IsCurrentProd

boolean

Indicates whether the version is the latest version in the production environment.

true

Status

string

The status of the file version. Valid values: COMMITTING, COMMITTED, CHECK_OK, PACKAGED, DEPLOYING, DEPLOYED, and CANCELLED. The value CHECK_OK is equivalent to the value COMMITTED.

COMMITTED

NodeContent

string

The scheduling configurations of the node that corresponds to the file version.

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

CommitUser

string

The ID of the Alibaba Cloud account that is used to create the file version.

7384234****

Comment

string

The description of the file version.

Second version submission

FilePropertyContent

string

The basic information about the file.

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

FileName

string

The file name.

ods_user_info_d

UseType

string

The functional module to which the file belongs. Valid values: NORMAL, MANUAL, MANUAL_BIZ, SKIP, ADHOCQUERY, and COMPONENT. The value NORMAL indicates DataStudio. The value MANUAL indicates a manually triggered node. The value MANUAL_BIZ indicates a manually triggered workflow. The value SKIP indicates a dry-run DataStudio node. The value ADHOCQUERY indicates an ad hoc query. The value COMPONENT indicates snippets.

0

ChangeType

string

The change type of the file version. Valid values: CREATE, UPDATE, and DELETE.

UPDATE

FileVersion

integer

The file version.

2

CommitTime

integer

The time when the version was generated. This value is a UNIX timestamp representing the number of milliseconds that have elapsed since January 1, 1970, 00:00:00 UTC.

1593881265000

NodeId

integer

The ID of the node that corresponds to the file version.

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": "7384234****",
    "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.