プロジェクトの作成
POST
/console/v1/accounts/{accountId}/projectsプロジェクトを作成します。
作成した直後の state は preparing(準備中)です。
プロジェクト一覧で state が ready になったことを確認してから、APIキーの発行などを行います。
認証
Authorizationstring必須Bearer <マネジメントトークン> の形式で指定します。
詳しくは認証を参照してください。
パスパラメーター
accountIdstring必須組織のID。
コンソールのURLの /accounts/ に続く部分です。
リクエストボディ
displayNamestring必須プロジェクトの名前。 1〜100文字で指定します。
idempotencyKeystring必須重複して作成されるのを防ぐためのUUID。
クライアントで生成します。
同じ値と同じ displayName で再送すると、新しく作成せずに、作成済みのプロジェクトを 200 で返します。
レスポンス
projectobject作成したプロジェクト。
フィールドを表示フィールドを非表示
projectIdstringプロジェクトのID。
displayNamestringプロジェクトの名前。
statusstring有効か無効か。
active(有効)または disable(無効)です。
statestringプロジェクトの状態。
preparing(準備中)、ready(利用できる)、failed(準備に失敗)、disabled(無効)のいずれかです。
teamExternalRefstring | null準備が完了するまでは null です。
エラー
エラーの形式はエラーを参照してください。
| ステータスコード | error | 原因 |
|---|---|---|
400 | bad_request | リクエストボディの形式や値が正しくない |
401 | console_authentication_failed | マネジメントトークンが正しくない、または有効期限が切れている |
403 | console_authorization_denied | 操作する権限がない、または組織やプロジェクトが有効な状態ではない |
404 | not_found | リソースが見つからない、またはIDの形式が正しくない |
409 | project_creation_conflict | 同じ idempotencyKey を、別の displayName で指定している |
409 | project_creation_quota_exceeded | プロジェクト数の上限に達している |
429 | rate_limited | レート制限を超えている |
503 | console_projects_unavailable | サービスが一時的に利用できない |