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

DataWorks:GetFileVersion

最終更新日:Sep 03, 2026

ファイルのバージョンの詳細を取得します。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

FileId

integer

必須

ファイルの ID。 ListFiles を呼び出してファイル ID をクエリできます。

1000001

ProjectId

integer

任意

DataWorks ワークスペースの ID。ページの右上隅にある small レンチアイコンをクリックしてストレージ管理ページに移動し、ID をビューできます。

1000011

ProjectIdentifier

string

任意

DataWorks ワークスペースの一意の識別子です。これは、ワークスペースを切り替えるために DataStudio ページの上部に表示される英語の識別子です。

この API 呼び出しの対象となる 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: 呼び出しが成功しました。

  • false: 呼び出しが失敗しました。

true

Data

object

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

FileContent

string

このファイルバージョンを生成したファイルのコード。

SHOW TABLES;

IsCurrentProd

boolean

このファイルバージョンが本番環境における最新バージョンであるかどうかを示します。有効な値:

  • true: 最新バージョンです。

  • false: 最新バージョンではありません。

true

Status

string

ファイルバージョンの現在のステータス。有効な値:

  • COMMITTING: バージョンはコミット中です。

  • COMMITTED または CHECK_OK: バージョンはコミット済みです。

  • PACKAGED: バージョンは Deployment 準備完了です。

  • DEPLOYING: バージョンはデプロイ中です。

  • DEPLOYED: バージョンはデプロイ済みです。

  • CANCELLED: Deployment はキャンセルされました。

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

ファイルが属する機能モジュール。有効な値:

  • 0: NORMAL (DataStudio)

  • 1: MANUAL (手動ノード)

  • 2: MANUAL_BIZ (手動ワークフロー)

  • 3: SKIP (DataStudio でのドライランスケジューリング)

  • 10: ADHOCQUERY (アドホッククエリ)

  • 30: COMPONENT (コンポーネント管理)

0

ChangeType

string

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

UPDATE

FileVersion

integer

ファイルのバージョン。

2

CommitTime

integer

ファイルバージョンが生成されたタイムスタンプ (ミリ秒単位)。

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": "\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
  }
}

エラーコード

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.

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

変更履歴

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