Skip to Content
APIリファレンスプロジェクトプロジェクトの作成

プロジェクトの作成

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原因
400bad_requestリクエストボディの形式や値が正しくない
401console_authentication_failedマネジメントトークンが正しくない、または有効期限が切れている
403console_authorization_denied操作する権限がない、または組織やプロジェクトが有効な状態ではない
404not_foundリソースが見つからない、またはIDの形式が正しくない
409project_creation_conflict同じ idempotencyKey を、別の displayName で指定している
409project_creation_quota_exceededプロジェクト数の上限に達している
429rate_limitedレート制限を超えている
503console_projects_unavailableサービスが一時的に利用できない