すべてのプロダクト
Search
ドキュメントセンター

DataWorks:GetFileVersion

最終更新日:Mar 21, 2026

ファイルバージョンの情報を照会します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

FileId

integer

必須

ファイルの ID。ListFiles 操作を呼び出して ID を照会できます。

1000001

ProjectId

integer

任意

DataWorks ワークスペースの ID。DataStudio ページの右上にあるワークスペース管理アイコンをクリックしてワークスペースページに移動し、ワークスペース ID を表示できます。

1000011

ProjectIdentifier

string

任意

DataWorks ワークスペースの一意の識別子。DataStudio ページの左上にある識別子をクリックすると、別のワークスペースに切り替えられます。

操作を適用する DataWorks ワークスペースを特定するには、このパラメーターまたは ProjectId のいずれかを指定する必要があります。

dw_project

FileVersion

integer

必須

詳細を照会するファイルバージョン。

2

レスポンスフィールド

フィールド

型

説明

例

object

返されるデータ。

HttpStatusCode

integer

返される HTTP ステータスコード。

200

ErrorMessage

string

返されるエラーメッセージ。

The connection does not exist.

RequestId

string

リクエストの ID。この ID に基づいて問題をトラブルシューティングできます。

0000-ABCD-EFG****

ErrorCode

string

返されるエラーコード。

Invalid.Tenant.ConnectionNotExists

Success

boolean

リクエストが成功したかどうかを示します。

true

Data

object

ファイルバージョンの詳細。

FileContent

string

ファイルコード。

SHOW TABLES;

IsCurrentProd

boolean

このバージョンが本番環境の最新バージョンであるかどうかを示します。

true

Status

string

ファイルバージョンのステータス。有効な値:COMMITTING、COMMITTED、CHECK_OK、PACKAGED、DEPLOYING、DEPLOYED、CANCELLED。CHECK_OK は COMMITTED と同等の値です。

COMMITTED

NodeContent

string

ファイルバージョンに対応するノードのスケジューリング設定。

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

CommitUser

string

ファイルバージョンの作成に使用される Alibaba Cloud アカウントの ID。

7384234****

Comment

string

ファイルバージョンの説明。

Second version submission

FilePropertyContent

string

ファイルに関する基本情報。

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

FileName

string

ファイル名。

ods_user_info_d

UseType

string

ファイルが属する機能モジュール。有効な値:NORMAL、MANUAL、MANUAL_BIZ、SKIP、ADHOCQUERY、COMPONENT。NORMAL は DataStudio を示します。MANUAL は手動トリガーノードを示します。MANUAL_BIZ は手動トリガーワークフローを示します。SKIP はドライランの DataStudio ノードを示します。ADHOCQUERY はアドホッククエリを示します。COMPONENT はスニペットを示します。

0

ChangeType

string

ファイルバージョンの変更タイプ。有効な値:CREATE、UPDATE、DELETE。

UPDATE

FileVersion

integer

ファイルバージョン。

2

CommitTime

integer

バージョンが生成された時刻。この値は、1970年1月1日 00:00:00 (協定世界時) から経過したミリ秒数を表す UNIX タイムスタンプです。

1593881265000

NodeId

integer

ファイルバージョンに対応するノードの ID。

3000001

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。