Azure AI プロジェクト REST API リファレンス

Azure AI Projects REST API を使用すると、Azure AI Foundry のモデル、データ、ツール、テレメトリをまとめる中心的なリソースである AI プロジェクトを操作できます。 使い慣れた HTTP 動詞を使用して、プロジェクトを作成したり、他の Azure サービスへのセキュリティで保護された 接続 を構成したり、推論、エージェント、評価などのためにすぐに使用できるエンドポイントを取得したりできます。 アタッチするすべてのサービスは 1 つのプロジェクト接続文字列の背後にあるため、アプリケーションは 1 つの資格情報と 1 つのベース URL を知っているだけで、必要なものすべてに到達できます。

Authentication

Azure AI Projects REST API では、認証用の Microsoft Entra ID トークンがサポートされています。 Azure リソース キーはまだサポートされていません。

アクセスは、Azure ロールベースのアクセス制御 (RBAC) によって制御されます。 詳細については、「 Azure ロールベースのアクセス制御 (Azure RBAC)とは 」および 「Azure AI Foundry のロールベースのアクセス制御」を参照してください。

バージョン管理

Azure AI Projects REST API には、次の 2 種類のバージョン管理が用意されています。

1. 進化するバージョン: これらのバージョンは v# の形式に従います (例: v1、v2、v3)。 名前が示すように、進化するバージョンには、要求への省略可能なパラメーターの追加や応答への新しいプロパティの追加など、コントラクトに 互換性を伴わない 変更が組み込まれています。 これらのバージョンを使用するクライアントは、追加の変更を処理するように設計する必要があります。
2. ピン留めされたバージョン: これらは、契約の変更を含まない日付ベースのバージョンです。 次の表は、これらのバージョンがどのように機能するかを示しています。

非破壊的変更

非破壊的変更は、次のように定義されます。

• REST API と SDK への新しいリソース (URL) の追加
• 新しいオプションの API パラメータの追加
• JSON レスポンスオブジェクトまたはイベントデータへの新しいプロパティの追加
• JSON 応答オブジェクト内のプロパティの順序の変更
• 不透明な文字列(リソース識別子やUUIDなど)の長さや形式の変更
• 新しいイベントタイプの追加(ストリーミングまたはRealtime API)

こちらも参照ください

• Azure AI Foundry の概要
• プロジェクトを始める
• Azure AI Foundry での接続