Zoho DataPrep REST APIのメータリング、単位、制限

Zoho DataPrep REST APIのメータリング、単位、制限

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

効率的なリソース利用とサービス品質を確保するため、Zoho DataPrep API の利用状況は、消費されたユニット数と API 通話の頻度に基づいて計測されます。

API ユニット

各 Zoho DataPrep API メソッドには、あらかじめユニットコストが定義されています。アプリケーションで消費された合計ユニット数は、使用した API メソッドの種類と頻度に基づき、1 日単位で集計されます。各 Zoho DataPrep の料金プランには、1 日あたりのユニット割り当てが含まれています。この上限を超えて利用する場合は、アドオンの購入が必要です。

ユニット消費に加えて、特定の種類の API には頻度(レート)制限が適用されます。これは、利用可能なユニット数に関係なく、一定時間内に許可されるリクエスト数の上限を設けるものです。

プランごとの API ユニット

以下の表は、各Zoho DataPrep プランにおける 1 日あたりのユニット割り当ての概要です。

プラン

1 日あたりのユニット割り当て

Free

Standard / Trial

1,000 ユニット/日

Enterprise / Trial

4,000 ユニット/日


アドオン ユニットの料金

追加の API ユニットは、まとめて購入できます。以下の表は、利用可能なアドオンの階層と USD 建ての料金を示しています。

 

API ユニット(アドオン ボリューム)

価格 (USD)

1,000 ユニットあたりの価格

1K

$18

$18.00

2K

$30

$15.00

5K

$60

$12.00

10K

$90

$9.00

25K

$150

$6.00

 

Notes
メモ: アドオン ユニットは Standard プランと Enterprise プランでのみ利用できます。Free プランでは API アクセスはサポートされていません。

API ユニットの消費

以下の表では、利用可能なすべての REST API メソッドについて、その説明、1 回の呼び出しあたりのユニットコスト、および使用される HTTP メソッドを一覧で示します。

 

API 名

説明

ユニット

メソッド

PIPELINE OPERATIONS

Get Job Status

パイプライン ジョブの現在のステータスを返します。

5 ユニット

GET

パイプライン内のすべてのジョブを取得

指定したパイプラインで実行されたすべてのジョブを一覧表示します。

5 ユニット

GET

パイプライン情報を取得

パイプライン内のすべてのステージ、データセット、設定の詳細を取得します。

5 ユニット

GET

すべてのパイプラインを取得

組織内のワークスペース全体にあるすべてのパイプラインを一覧表示します。

5 ユニット

GET

パイプラインを作成

ワークスペース内に新しいパイプラインを作成します。

2 ユニット

POST

パイプラインをクローン

既存のパイプラインのコピーを新しい名前で作成します。

50 ユニット

POST

ワークスペースをクローン

既存のワークスペースと、そのワークスペース内のすべてのパイプラインのコピーを作成します。消費量は 50 × N ユニットです(N = パイプライン数)。

50 × N ユニット

POST

パイプラインをスケジュール

設定した時刻と頻度でパイプラインを自動実行するようスケジュールします。

2 ユニット

POST

Webhook トリガー実行

Webhook 呼び出しにより、パイプラインの実行を即時にトリガーします。

50 ユニット

POST

パイプライン名を変更

既存のパイプラインの名前を変更します。

1 ユニット

PUT

パイプラインをゴミ箱に移動

パイプラインをゴミ箱に移動します。後から復元できます。

1 ユニット

POST

パイプラインを完全に削除

ごみ箱内のパイプラインを完全に削除します。復元はできません。

1 ユニット

削除

ワークスペース操作

すべてのワークスペースを取得

組織内のすべてのワークスペースを一覧表示します。

5 ユニット

GET

組織 ID を取得

ポータル名と組織 ID を取得します。

1 ユニット

GET

ワークスペースを作成

組織内に新しいワークスペースを作成します。

2 ユニット

POST

ワークスペース名を変更

既存のワークスペースの名前を変更します。

1 ユニット

PUT

ワークスペースをごみ箱に移動

ワークスペースをごみ箱に移動します。後から復元できます。

1 ユニット

POST

ワークスペースを完全に削除

ごみ箱内のワークスペースを完全に削除します。復元はできません。

1 ユニット

削除

ステージ操作

ステージを作成

インポートしたデータソースから、パイプライン内にデータセットステージを作成します。

2 ユニット

POST

ステージを派生作成

パイプライン内の既存ステージから、新しい派生データセットステージを作成します。

2 ユニット

POST

ステージ出力の詳細を取得

パイプライン実行後のデータセットステージの出力ファイルの詳細を取得します。

5 ユニット

GET

サンプルを読み込む

サンプル ID を使用して、データセットステージの列名とプレビュー用データを取得します。

2 ユニット

GET

準備完了にする

パイプライン実行の準備ができたデータセットステージとしてマークします。

2 ユニット

PUT

ステージ名を変更

パイプライン内のデータセットステージの名前を変更します。

1 ユニット

PUT

ステージを削除

パイプラインからデータセットステージを削除します。

1 ユニット

削除

データソース操作

接続 ID を取得

既存のソース(例:S3、FTP)の接続 ID を取得し、インポートで使用します。

1 ユニット

GET

インポートを開始

接続 ID を使用して、接続済みソースからのインポート処理を開始します。

1 ユニット

POST

データソースを作成

インポート結果を使用して、パイプラインのデータソースを作成します。データセット ID を返します。

2 ユニット

POST

データソースを変更

パイプラインの既存のデータソースを、新たにインポートしたデータソースに置き換えます。

2 ユニット

POST

クラウド宛先を追加

データセットステージをクラウド宛先(S3 または FTP)に接続し、エクスポートできるようにします。

5 ユニット

POST

ファイルエクスポート

データセットステージを設定し、出力をファイルとしてエクスポートできるようにします。

5 ユニット

POST

宛先を削除

パイプラインから設定済みの宛先を削除します。

2 ユニット

PUT

変換操作

結合

パイプライン内の 2 つのデータセットステージを結合します。

10 ユニット

POST

追加

パイプライン内で、あるデータセットステージを別のステージに追加します。

10 ユニット

POST

ピボット

データセットステージにピボット変換を適用します。

10 ユニット

POST

アンピボット

データセットステージにアンピボット変換を適用します。

10 ユニット

POST

その他の変換

フィルター、名前変更、数式など、その他の変換ルールをデータセットステージに適用します。

3 ユニット

POST

ルールセット操作

ルールセット履歴の取得

データセットステージに適用された変換ルールの一覧を取得します。

2 ユニット

GET

ルールセットテンプレート ID の取得

組織内で利用可能な保存済みルールセットテンプレートをすべて一覧表示します。

3 ユニット

GET

ルールセットテンプレートを保存

データセットステージの現在のルールセットを、再利用可能なテンプレートとして保存します。

2 ユニット

POST

保存済みルールセットテンプレートを適用

保存済みのルールセットテンプレートをデータセットステージに適用します。

5 ユニット

POST

ルールセットテンプレートファイルをインポート

パイプラインで使用するためのルールセットテンプレートファイル(.zdrt)をアップロードします。

5 ユニット

POST

ルールセットテンプレートファイルを適用

アップロード済みのルールセットテンプレートファイルをデータセットステージに適用します。

10 ユニット

POST

ルールセットを .zdrt ファイルとしてエクスポート

データセットステージのルールセットを .zdrt テンプレートファイルとしてエクスポートします。

2 ユニット

POST

 

Alert
* ワークスペースのクローン: ユニット = 50 × N(N はワークスペース内のパイプライン数)
* レート制限は HTTP メソッドごとに適用されます。GET リクエストは 1 分あたり 60 件まで、POST リクエストは 1 時間あたり 3 件までに制限されます。これらの制限は、1 日あたりのユニット割り当てとは独立して適用されます。

API 頻度制限

API の頻度制限は、特定の時間枠内で実行できるリクエストの最大数を定義します。これらの制限はユニット残高とは独立して適用されます。1 日あたりのユニット割り当てに余裕があっても、頻度制限を超えるとリクエストがスロットリングされます。
GET リクエストは 1 分あたり 60 件まで、POST リクエストは 1 時間あたり 3 件までに制限されます。

関連情報