OpenAI Terraform provider

内部では Administration API を使い、プロジェクト、ユーザー、グループ、ロール、サービスアカウント、証明書、レート制限、spend alerts(支出アラート)などを扱います。OpenAI API Platform の組織設定を、Terraform の構成ファイルとして管理したい場面に関わる機能です。

OpenAI Terraform provider は、OpenAI が提供する公式の Terraform プロバイダーです。Administration API を通じて、OpenAI の組織リソースをコードで管理します。

扱えるリソースは次のとおりです。

• プロジェクト、関連するプロジェクト設定
• ユーザー、グループ、ロール、アクセス割り当て、招待
• サービスアカウント、証明書
• レート制限(プロジェクト単位)、spend alerts

Administration API のエンドポイントには Admin API キーが必要です。Admin API キーは、管理用以外の OpenAI API エンドポイントでは使えません。

• プロバイダーは既定で環境変数 OPENAI_ADMIN_KEY を読み取ります。
• 任意で OPENAI_ORG_ID と OPENAI_PROJECT_ID を設定すると、API リクエストに OpenAI-Organization ヘッダーと OpenAI-Project ヘッダーが付きます。
• これらの任意の変数を設定しない場合、組織とプロジェクトは API キーから判定されます。

.terraform.lock.hcl をソース管理にコミットしておくと、以後の実行で同じプロバイダーのバージョンが選ばれます。バージョンを上げるときは terraform init -upgrade を実行します。バージョン制約で許される範囲の最新のプロバイダーが選ばれます。

公式の OpenAI Terraform provider は 2026 年 7 月 29 日にリリースされました。対象プランや提供地域は、公式のリリースノートには記載がありません。

プロバイダーは Terraform Registry からインストールします。以下は、プロジェクトを 1 つ作成する流れです。

1. 新しいディレクトリを作り、main.tf を追加します。このファイルで openai/openai プロバイダーを要求し、provider "openai" {} を宣言し、openai_project リソースと project_id の output を定義します。
2. Admin API キーを環境変数に設定します。例: export OPENAI_ADMIN_KEY="<your-admin-api-key>"
3. terraform init で作業ディレクトリを初期化し、terraform fmt と terraform validate で構成を整形・検証します。
4. ロックファイル .terraform.lock.hcl をソース管理にコミットします。以後の実行で同じプロバイダーのバージョンが選ばれます。
5. terraform plan を実行し、Terraform が行う変更を確認します。この例では、追加される openai_project リソースが 1 つ表示されます。
6. 内容を確認したら terraform apply を実行し、確認を求められたら承認します。Terraform がプロジェクトを作成し、project_id の output からその ID を表示します。