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

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

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

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

APIユニット

Zoho DataPrepの各APIメソッドには、所定のユニットコストが設定されています。アプリが消費する合計ユニット数は、使用したAPIメソッドの種類と頻度に基づいて毎日計算されます。Zoho DataPrepの各料金プランには、1日あたりのユニット割り当てが含まれています。この上限を超えて使用するには、アドオンの購入が必要です。

ユニット消費量に加えて、一部のAPIの種類には頻度(レート)制限が適用され、利用可能なユニット数にかかわらず、一定時間内に許可されるリクエスト数が制限されます。

プラン別のAPIユニット

次のテーブルは、Zoho DataPrepの各プランに割り当てられる1日あたりのユニット数をまとめたものです。

プラン

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

無料

スタンダード/試用版

1,000ユニット/day

エンタープライズ/試用版

4,000ユニット/day


アドオンユニットの料金

APIユニットはまとめて追加購入できます。次のテーブルに、利用可能なアドオンの区分と米ドル建ての料金を示します。

 

APIユニット(アドオン容量)

料金(米ドル)

1,000ユニットあたりの料金

1K

$18

$18.00

2K

$30

$15.00

5K

$60

$12.00

10K

$90

$9.00

25K

$150

$6.00

 

Notes
メモ:アドオンユニットは、スタンダードプランとエンタープライズプランでのみ利用できます。無料プランではAPIにアクセスできません。

APIユニットの消費量

次のテーブルに、利用可能なすべてのREST APIメソッド、その説明、1回の実行あたりのユニットコスト、使用するHTTPメソッドを示します。

 

API名

説明

ユニット数

メソッド

パイプライン操作

処理ステータスの取得

パイプライン処理の現在のステータスを返します。

5ユニット

GET

パイプライン内のすべての処理の取得

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

5ユニット

GET

パイプライン情報の取得

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

5ユニット

GET

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

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

5ユニット

GET

パイプラインの作成

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

2ユニット

POST

パイプラインの複製

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

50ユニット

POST

ワークスペースの複製

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

50 × Nユニット

POST

パイプラインのスケジュール設定

設定済みの時間と頻度でパイプラインが自動的に実行されるようスケジュールを設定します。

2ユニット

POST

ウェブフックによる実行

ウェブフックの呼び出しによってパイプラインを即時実行します。

50ユニット

POST

パイプラインの名前の変更

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

1ユニット

PUT

パイプラインのごみ箱への移動

パイプラインをごみ箱に移動します。後で復元できます。

1ユニット

POST

パイプラインの完全削除

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

1単位

DELETE

ワークスペースの操作

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

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

5単位

GET

組織IDの取得

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

1単位

GET

ワークスペースの作成

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

2単位

POST

ワークスペース名の変更

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

1単位

PUT

ワークスペースのごみ箱への移動

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

1単位

POST

ワークスペースの完全削除

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

1単位

DELETE

ステージの操作

ステージの作成

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

2単位

POST

派生ステージの作成

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

2単位

POST

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

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

5単位

GET

サンプルの読み込み

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

2ユニット

GET

準備完了の設定

パイプラインを実行できるよう、データセットステージを準備完了に設定します。

2ユニット

PUT

ステージ名の変更

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

1ユニット

PUT

ステージの削除

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

1ユニット

DELETE

データソースの操作

接続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

追加する

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

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件に制限されます。これらの制限は、毎日のユニット割り当てとは別に適用されます。

API頻度制限

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

関連情報