# アップロード完了を確認

アップロード済みのクラウドストレージファイルを確定します。
- **前提条件**：ファイルのレコードが自チームのものであり、オブジェクトが既にストレージ上にあること — サービスは ETag と長さを読み取って検証します。サイズは 0 より大きく 2 GB 未満である必要があります。
- **副作用**：チームのストレージ容量を原子的に計上し、レコードをアップロード済みにして実際のサイズを保存します。これが成功するまで、そのファイルは**`/cloudstorage/file/page` に現れず**、100 件の未確定枠のうち 1 つを占有し続けます。
- **失敗するとアップロード済みオブジェクトは削除されます。** 早すぎる呼び出し、サイズ上限超過、容量不足のいずれでもストレージから実データが削除され、レコードは未確定のまま残ります。復旧は本エンドポイントのリトライではなく、`/cloudstorage/upload/init` からのやり直しと再アップロードです。
- **完了シグナル**：同期的で、一度成功すれば冪等です — 2 回目の呼び出しは容量を再計上せずに同じファイルを返します。
- **補足**：確定されないままのレコードは 24 時間後に自動で整理されます。

文書化されたビジネスエラー: `39001`, `39011`, `39014`, `39041`, `39046`, `39047`。 各コードの意味は [Error Codes](../Getting%20Started/error-codes.md) を参照してください。どの操作でも共通コードが返る場合があります。

Endpoint: POST /api/cloudstorage/upload/complete
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)
    署名付きアップロード URL の API が返したクラウドストレージのファイル ID。
    Example: 1800000000000001

## Response 200 fields (application/json):

  - `code` (integer, required)
    結果コード。`0` は成功を意味し、それ以外は異常を示します。
    Example: 0

  - `msg` (string | null, required)
    エラーメッセージ。
    Example: null

  - `requestId` (string)
    操作リクエスト ID。リクエストが API ゲートウェイを経由した場合に付与されることがあります。
    Example: 1d4f3ea968664593860b94b35d4ebf5e

  - `data` (object, required)

  - `data.id` (string)
    クラウドストレージのファイル ID。
    Example: 1800000000001001

  - `data.fileName` (string)
    ファイル名（拡張子なし）。
    Example: example

  - `data.fileExt` (string)
    拡張子。
    Example: jpg

  - `data.fileSize` (string)
    ファイルサイズ（バイト）。
    Example: 204800

  - `data.fileType` (integer)
    ファイル種別：0 = 画像、1 = 動画、2 = アプリケーション、3 = 音声、4 = ドキュメント、5 = その他。
    Example: 0

  - `data.tagInfo` (array)
    ファイルに付いているタグの詳細。

  - `data.tagInfo.id` (string)
    タグ ID。
    Example: 1800000000000101

  - `data.tagInfo.tagSource` (string)
    タグのソース。例：ENV、PROXY。
    Example: ENV

  - `data.tagInfo.tagName` (string)
    タグ名。
    Example: Invoice

  - `data.tagInfo.tagType` (string)
    タグ種別：TAG または GROUP。
    Example: TAG

  - `data.tagInfo.tagIcon` (string)
    タグのアイコン。

  - `data.createDate` (string)
    アップロード日時。

  - `data.updateDate` (string)
    更新日時。