Forge の Data Management API で利用するストレージ上にフォルダを作成する際には、BIM 360 Docs、Autodesk Docs、Fusion Team など、あらゆる種類のオートデスク SaaS プロジェクトで使用することが可能な POST projects/:project_id/folders endpointの利用をお勧めしています。BIM 360 Docs にフォルダを作成する POST Command CreateFolder endpoint も利用することが出来ますが、現在、この endpoint は非推奨扱いとなっていますのでご注意ください。
POST Command CreateFolder endpoint のドキュメントでは、次のような記載が開始されています。
「2022 年 1 月 10 日にシステムから削除される予定です。代替として、フォルダ作成には POST projects/:project_id/folders endpoint をお使いください。」
上記のとおり、POST Command CreateFolder endpoint は、2022 年 1 月初旬まで既存のアプリケーションで動作しますが、お早目に POST projects/:project_id/folders endpointへの移行されることをお勧めします。
両 endpoint の重要な違いは、POST projects/:project_id/folders endpoint には endpoint 毎の特定の レート制限（Rate Limit）が適用されているのに対し、POST Command には可能なすべてのコマンドに対する全般的な レート制限（Rate Limit）が適用され点です。
POST projects/:project_id/folders endpoint は各フォルダに対して 1 つの呼び出しとなってしまうめ、POST Command CreateFolder endpoint から移行する場合には、コードのロジック調整が必要になる場合があります。詳細については、同 endpoint のドキュメントをご確認してください。
POST projects/:project_id/folders endpoint の使用方法、レート制限についてのご質問 やご相談がございましたら、forge.help@autodesk.com までご連絡ください。
By Toshiaki Isezaki
You must be logged in to post a comment.