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

パイプラインをクローン

既存のパイプラインのコピーを作成します。

50 ユニット

POST

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

ワークスペース内のすべてのパイプラインを含めて、ワークスペースのコピーを作成します。ユニット数はパイプライン数に応じて増加します:50 × N ユニット(N = ワークスペース内のパイプライン数)。

50 × N ユニット

POST

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

自動パイプライン実行のスケジュールを設定または更新します。

2 ユニット

POST

パイプライン情報を取得

パイプラインのメタデータおよび設定の詳細を取得します。

5 ユニット

GET

パイプラインを作成

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

2 ユニット

POST

パイプライン名を変更

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

1 ユニット

PUT

パイプラインをごみ箱に移動

パイプラインをごみ箱に移動します。

1 ユニット

POST

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

ごみ箱内のパイプラインを完全に削除します。

1 ユニット

削除

WORKSPACE OPERATIONS

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

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

5 ユニット

GET

組織 ID を取得

組織の一意の ID を取得します。

1 ユニット

GET

ワークスペースを作成

新しいワークスペースを作成します。

2 ユニット

POST

ワークスペース名を変更

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

1 ユニット

PUT

ワークスペースをゴミ箱に移動

ワークスペースをゴミ箱に移動します。

1 ユニット

POST

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

ゴミ箱内のワークスペースを完全に削除します。

1 ユニット

削除

ステージ操作

ステージを作成

パイプラインに新しいステージを追加します。

2 ユニット

POST

派生ステージを作成

変換処理に基づいて派生ステージを作成します。

2 ユニット

POST

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

特定のステージの出力の詳細を取得します。

5 ユニット

GET

ステージ名を変更

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

1 ユニット

PUT

ステージを削除

パイプラインからステージを完全に削除します。

1 ユニット

削除

準備完了にする

ステージまたはパイプラインを実行可能な状態(準備完了)としてマークします。

2 ユニット

PUT

データソース操作

接続 ID を取得

設定済みデータ接続の ID を取得します。

1 ユニット

GET

インポートを開始

指定したソースのデータインポート処理を開始します。

1 ユニット

POST

データソースを作成

新しいデータソース設定を作成します。

2 ユニット

POST

データソースを変更

パイプラインステージにリンクされているデータソースを更新します。

2 ユニット

POST

サンプル ID を取得

ステージ用のサンプルデータセット ID を取得します。

1 ユニット

GET

サンプルを読み込む

パイプラインステージにサンプルデータを読み込みます。

2 ユニット

GET

クラウド送信先を追加

データエクスポート用のクラウド送信先を設定します。

5 ユニット

POST

送信先を削除

設定済みのクラウド送信先を削除します。

2 ユニット

PUT

ファイルエクスポート

ステージの出力データをファイルにエクスポートします。

5 ユニット

POST

変換操作

結合(Join)

2 つのデータセット間で結合変換を適用します。

10 ユニット

POST

追加(Append)

一方のデータセットの行を別のデータセットに追加します。

10 ユニット

POST

ピボット(Pivot)

データ構造を変更するピボット変換を適用します。

10 ユニット

POST

アンピボット(Unpivot)

データを正規化するアンピボット変換を適用します。

10 ユニット

POST

その他の変換

上記以外の変換(例:フィルター、名前変更、数式)を適用します。

3 ユニット

POST

ルールセット操作

ルールセット履歴の取得

ルールセットのバージョン履歴を取得します。

2 ユニット

GET

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

保存済みのルールセットテンプレート ID の一覧を取得します。

3 ユニット

GET

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

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

2 ユニット

POST

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

以前に保存したルールセットテンプレートをステージに適用します。

5 ユニット

POST

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

.zdrt ファイルからルールセットテンプレートをインポートします。

5 ユニット

POST

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

インポートした .zdrt ファイルから、ルールセットを直接適用します。

10 ユニット

POST

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

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

2 ユニット

POST

その他の操作

その他の自動化

上記のカテゴリに含まれないその他の自動化やワークフロートリガーを呼び出します。

50 ユニット

POST

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

ワークスペース全体のすべてのパイプラインの一覧を返します。

5 ユニット

GET

 

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

API 頻度制限

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