Technology Perspective from Japan

新 Node.js SDK と VS Code で 3-legged アクセストークンを取得

新 Node.js SDK と VS Code で 2-legged アクセストークンを取得 の例に続いて、3-legged 認証フローでのアクセストークン取得を Windows の VS Code 上でテストする例をご紹介したいと思います。 新 Node.js SDK のインストール 新しい Node.js SDK のインストールは、基本的に 新 Node.js SDK と VS Code で 2-legged アクセストークンを取得 と同じです。 https://www.npmjs.com/~aps.sdk（GiiHub リポジトリ：https://github.com/autodesk-platform-services/aps-sdk-node）から Node.js パッケージを次の手順でインストールをおこないます。 MKDIR コマンドで aps-sdk-node フォルダを作成します。（フォルダ名は任意です。） CD コマンドで aps-sdk-node フォルダに移動します。 npm install --save @aps_sdk/autodesk-sdkmanager ... Read more →

新 Node.js SDK と VS Code で 2-legged アクセストークンを取得

新しい Node.js SDK（Beta）と Windows の VS Code を使い、単純にアクセストークンを取得する例をご紹介したいと思います。まずは、2-legged 認証フローでの方法です。 新 Node.js SDK のインストール 新しい Node.js SDK は、Node.js パッケージとして https://www.npmjs.com/~aps.sdk（GiiHub リポジトリ：https://github.com/autodesk-platform-services/aps-sdk-node）されています。ローカル環境で SDK（ここでは SDK Manager と Authentication API パッケージのみ）を利用するのは、コマンド プロンプトを使って、次の手順でインストールをおこないます。 MKDIR コマンドで aps-sdk-node フォルダを作成します。（フォルダ名は任意です。） CD コマンドで aps-sdk-node フォルダに移動します。 npm install --save @aps_sdk/autodesk-sdkmanager... Read more →

VS Code APS エクステンションでの 3-legged OAuth と Project アクセス

過去に VS Code Forge Tools での 3-legged OAuth の記事で VS Code にインストールした Autodesk Platform Services (VSCode Extension) から 3-legged OAuth で Fusion Team や Autodesk Docs（Autodesk Construction Cloud）にアクセスする方法をご紹介しました。その後、Forge から Autodesk Platform Services（APS）への改名にともない、3-legged 認証フローで利用するコールバック URL も変更されているので、改めて、VS Code APS エクステンションでの 3-legged OAuth 運用する手順を記しておきたいと思います。 通常、VS Code 上で Autodesk Platform Services (VSCode Extension) を利用すると、2-legged OAuth で取得したアクセストークンが使用されます。この時、VS Code の画面左下のステータスバーには、それを示す文... Read more →

APS アクセス：2-legged と 3-legged

Autodesk Platform Services（APS）でエンドポイントを呼び出す際には、言うまでもなく アクセストークン（Access Token） が必要となります。アクセストークンは Client ID と Client Seret を元に Authentication API（OAuth API）を使って取得します。そして、アクセストークンの取得フローには、大きく 2-legged 認証と 3-legged 認証の 2 つのフローがあります。 2-legged 認証 "app-context（アプリケーション コンテキスト）" とも呼ばれる認証で、 APS API を利用するアプリが、直接、オートデスクのサーバーからアクセス トークン を取得して、OSS（Object Storage Service） のAPI 共有領域に作成した Bucket にアクセスする際に使用します。 旧 View and Data API で利用していた認証は、この方法によるものです。 2-legged と呼ばれるのは、サービス プロバイダー（オートデスク）とユーザー（APS API を利用する... Read more →

Flow Graph Engine API 一般提供開始

ご案内が遅くなってしまいましたが、Autodesk Flow のグラフ エンジン サービス でご紹介した Flow Graph Engine API が Beta を卒業して一般提供が開始されました。 Flow Graph Engine API は、従来、ローカル環境でしか実現出来なかった Autodesk Maya の Bifrost グラフ ジョブの実行を、クラウドで実行させる演算処理能力を提供します。その意味で、Design Automation API の演算処理に似ていると考えることが出来ます。 今回の一般提供が開始を受けて、稼働状況を示すヘルス ダッシュボード（https://health.autodesk.com/、および、https://health.autodesk.com/?search=APS）に、Flow Graph Engine API が追加されています。 クラウド リソースを利用する演算処理サービスであるため、利用時には Autodesk Flex を使った従量課金の対象となります。消費トークンは、1 時間あたりの処理時間に対して 1.0 トークンとなりま... Read more →

Data Management API：ACC へのファイル アップロードの注意点

Data Management API を使って Fusion Team（含む 旧 BIM 360 Team・A360 Personal）や Autodesk Construction Cloud（Autodesk Docs、旧 BIM 360 Docs）などのオートデスクのストレージ サービスにファイルをアップロードを把握する際、公式ドキュメントの How-to Guide に記載されている Upload a File を参考にされると思います。 同ドキュメントに記載されている手順は、Fusion Team と Autodesk Construction Cloud で共通しています。ただし、Step 7: Create the first version of the uploaded file、Step 8: Update the version of a file で紹介されている cURL 使用のリクエスト ボディの JSON ペイロード内容には注意が必要です。 Step 7 の cURL 呼び出し例の場合： curl -X POST -H "Authorization: B... Read more →

Design Automation：GET WorkItems/:id 呼び出し回数制限 150 回／分

APS Design Automation API を利用するアプリをお持ちで、GET workItems/:id エンドポイントを使用して WorkItem のステータスを高頻度でチェックしている場合は、今後の Rate Limit（呼び出し数制限）の変更についてご留意ください。 2025 年 5 月 1 日以降、GET workitems/:id エンドポイントに対して、Client ID あたり 150 RPM の呼び出し数制限が適用されます。（1 分間の呼び出しは 150 回まで） Rate Limit（呼び出し数制限） Rate Limit は、ネットワークによって送受信されるトラフィックの量を制御するために使用されます。アプリが制限数を超えて呼び出しをおこなうと、制限数に達した後に呼び出しが失敗し、429 レスポンスが返されます。これは、データの流れを改善し、DoS 攻撃などを軽減することでセキュリティを強化する目的で一般的に使用される手法です。 スケーラブルなソリューションのコードを作成時には、この Rate Limit を考慮に入れる必要があります。Rate Limit... Read more →

新しい Vault Data API のアーリアダプターに!!

新しい Vault Data API を紹介できることを嬉しく思います。これらの REST-ful API により、Vault からのデータ拡張が可能になり、Vault 2025.2 リリースで利用できるようになりました。 Vaultとは？ API について説明する前に、Autodesk Vault について少し学んでみましょう。 Autodesk Vault は、設計チームが設計データを整理、追跡、管理するのに役立つ製品データ管理(PDM)ツールです。 Autodesk Vault PDM ソフトウェアは、設計者やエンジニアが設計データを整理し、ドキュメントを管理し、リビジョンを追跡するのに役立ちます。次のようなメリットがあります。 一元化されたデータ ソース: 全員が 1 つの組織化されたデータ ソースから作業できるようにします。 バージョン管理: バージョンを管理し、すべてのファイルのバージョンを保持します。 コラボレーション: チーム間のコラボレーションとコミュニケーションを改善します。 ワークフローの自動化: 設計およびエンジニアリングのプロセスを自動化します。 統合: Au... Read more →

オーストラリア リージョン指定の変更について

オーストラリア データセンター の記事でご案内したオーストラリア データセンターについて、APS API を使用してオーストラリア リージョンに保存されているデータにアクセス、または、アクセスする予定をお持ちの方に重要なお知らせがあります。 既に開発済 / 開発予定のアプリが、オーストラリア リージョンのデータセンターで稼働する Autodesk Construction Cloud（ACC）をサポートする、あるいは、Object Storage Service（OSS）API を使用して Bucket を作成し、オーストラリア リージョンのデータセンターにデータを保存する場合、オーストラリア リージョンのデータにアクセスする一部の API に変更を加えています。 オーストラリア リージョン データのプライマリ ストレージとして、Autodesk Docs、Autodesk Build、Autodesk BIM Collaborate/Pro、および AutodeskTakeoff の一般提供をアナウンスしました。このアナウンスにともない、ACC API、Data Management... Read more →

Autodesk Data Connector for Power BI コネクターの利用

先日ご案内した Autodesk Data Connector for Power BI について、具体的な利用手順に触れておきたいと思います。 Autodesk Data Connector for Power BI は、Autodesk App Store で公開されているので、Autodesk ID（オートデスク アカウント）で App Store にサインインして、インストーラをダウンロードすることが出来ます。もし、Autodesk Data Connector for Power BI が見つけられない場合には、検索ボックスに「data exchange connector」と入力してコネクター一覧から見つけ出すことが出来ると思います。 データ交換時の書き出し手順は、以前ご紹介した Revit Connector を使った Inventor へのデータ交換 と同じです。 Autodesk Construction Cloud（ACC）領域に作成したデータ交換領域に粒状データを書き出した後で、Data Connector for Power BI コネクターをインストールした ... Read more →