Design Automation API v3 リリース でご案内のとおり、2019 年 10 月 28 日（日本時間 29 日）に Design Automation API v3 が正式にリリースにリリースされています。クラウドクレジットでの課金は、コアエンジン毎に Revit、Inventor、3ds Max が 1 CPU 時間当たり 6 クラウド クレジット、AutoCAD コアエンジンのみ、従来通り、 4 クラウド クレジットになっています。
※ 2022年3月29日のクラウドクレジット価格改定に合わせて、消費クラウドクレジット数はコアエンジンに関係なく、一律 2 クラウドクレジットに変更されました。
計測方法は？
それでは、この課金方法となるコアエンジンの「1 CPU 時間当たり」とは、具体的にどのように計測しているのでしょうか？
Design Automation API への課金時間は、処理時に実行されることになる WorkItem（ワークアイテム）の成功時の処理時間（秒数）に基づいて算出されています。 WorkItem の処理が完了すると、onComplete コールバック、または、GET Workitem のレスポインスに開始時刻と終了時刻が次のようにレポートとして記されます。
“timeQueued”: “2019-11-13T20:22:26.1972643Z”,
“timeDownloadStarted”: “2019-11-13T20:22:25.587368Z”,
“timeInstructionsStarted”: “2019-11-13T20:24:01.3217437Z”,
“timeInstructionsEnded”: “2019-11-13T20:24:35.4545907Z”,
“timeUploadEnded”: “2019-11-13T20:26:03.3608278Z”,
コストの算出に必要な数値は、timeDownloadStarted と timeUploadEnded の値です。 この例では、合計時間は 217 秒になり、この時間に相当するクラウド クレジットが、お手持ちのクラウド クレジット残高から減算されることになります。
なお、現在のところ、Forge ポータル（https://forge.autodesk.com/）の Usage Analytics で表示されるのは、消費したクラウド クレジットの累計が 1 クラウド クレジット以上になった場合です。０ と表示された場合でも、消費したクラウド クレジットは保持しています。
ファイルのダウンロード時間とアップロード時間？
レポートには、ファイルのダウンロードやアップロードにかかった正確な時間も表示されるはずです。ここで注意していただきたいのは、AppBundle（アプリバンドル ＝ コアエンジンにロード・実行させるアドイン パッケージ）が、WorkItem が実行時に使用する 素材ファイルのダウンロードと、成果ファイルのアップロードにかかる時間もカウントされる点です。
素材ファイルのダウンロードと成果ファイルのアップロードには、任意に用意したクラウド ストレージを利用することになりますが、どのストレージをどのように選択するかによって、課金対象となる WorkItem の処理時間に影響を与える可能性があります。
オートデスクがテストした限りでは、主要な AWS S3、Azure Blob Storage、Forge OSS（BIM 360 Docsでも使用）では、大きな違いはありませんでした。世界中のさまざまな地域にホストされているファイルでテストしましたが、結果は同様です。ただし、インターネットトラフィックによる変動が大きくなっています。例えば、400MBファイルのテストでは、ファイルを Design Automation API サーバーにダウンロードするのに約 30 〜 40 秒かかり、ファイルを開いて操作を開始するのに 3 〜 4 秒かかりました。
オンプレミスなサーバーとともにファイルのダウンロードやアップロードをおこなう場合や、非常に大きなファイルを扱う場合などは、さらに時間を要することが予想されます。出来れば、より高可用性なストレージの利用をご検討いただくことをお勧めします。
もう一点、考慮すべき点があります。ストレージ サービス利用時のファイル転送のコストです。 少なくとも、ファイルが Forge OSS Bucket や BIM 360 Docs、Fusion Team などにホストされている場合には、それらのアクセス（ダウンロード/アップロード）に費用はかかりません。
実行に 1 時間必要なアドイン アプリケーションの単一処理というのは、一般的に、あまり多くない印象がありますが、WorkItem 内でクラウドストレージからの素材ファイルのダウンロードと成果物となるファイルの保存（アップロード）に要する時間も、クラウドクレジットによる課金対象となっていますのでご承知おきください。
By Toshiaki Isezaki
Subscribe
コメント