> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Go SDK: ファイルのアップロードと commit

> c.Apps.Create で zip からアプリケーションを作成し、c.Apps.Commit で既存のアプリケーションにファイルを送信します。任意の io.Reader からストリーミングされます。

以下の各スニペットは、このプログラムの中で単独で動作します。1 つずつ `main` に貼り付けて `goimports` を実行してください ([サンプルの実行](https://docs.squarecloud.app/ja/sdks/go/client.md#サンプルの実行)を参照)。

```go theme={"system"}
package main

import (
	"context"
	"os"

	"github.com/squarecloudofc/sdk-api-go/v3"
)

var (
	ctx   = context.Background()
	c     = squarecloud.New(os.Getenv("SQUARECLOUD_API_KEY"))
	appID = "abc123def456abc123def456"
)

func main() {
	// Paste one snippet here, then run goimports.
}
```

## 受け付ける入力

`Apps.Create` と `Apps.Commit` は任意の `io.Reader` を受け取り、メモリに読み込むことなく `multipart/form-data` としてストリーミングします:

| 入力 | 備考 |
| - | - |
| `*os.File` | `Content-Length` 付きでディスクからストリーミングされます。ベース名がファイル名として使われます。503 `UPLOAD_BUSY` の際にリトライできます |
| `*bytes.Reader`、`*strings.Reader` (`io.Seeker` でもある任意の `io.ReaderAt`) | `Content-Length` 付きで送信されます。503 `UPLOAD_BUSY` の際にリトライできます |
| その他の `io.Reader` (パイプ、レスポンスボディなど) | チャンク形式で 1 回の試行で送信されます。再送はできません |

アップロードは **100 MB までに制限**されています。それより大きいファイルはローカルで `FILE_TOO_LARGE` (ステータス `0`) として失敗します。サイズがわかっている場合は何も送信する前に、そうでない場合はストリームが 100 MB を超えた時点で失敗します。アップロードには**デフォルトの期限がありません**。`ctx` でキャンセルしてください。

## アプリケーションの作成

`Apps.Create(ctx, zip)` は、ルートに [`squarecloud.app`](https://docs.squarecloud.app/ja/getting-started/config-file) 設定ファイルを含む `.zip` を deploy します。

```go theme={"system"}
f, err := os.Open("bot.zip")
if err != nil {
	log.Fatal(err)
}
defer f.Close()

app, err := c.Apps.Create(ctx, f)
if err != nil {
	log.Fatal(err)
}

fmt.Println(app.ID, app.Name, app.RAM, app.CPU, app.Language.Name, app.Language.Version)
fmt.Println(app.Domain)  // "<subdomain>.squareweb.app" for web apps, "" otherwise
fmt.Println(app.Cluster) // the cluster the app was placed on
```

| フィールド | 説明 |
| - | - |
| `ID` (`id`) | 新しいアプリの ID |
| `Name` (`name`) | 設定ファイルに記載された名前 |
| `Description` (`description`) | 設定されていない場合は `""` |
| `Domain` (`domain`) | 完全な `<subdomain>.squareweb.app` ホスト。Web 以外のアプリでは `""` |
| `Cluster` (`cluster`) | アプリが配置されたクラスター |
| `RAM` / `CPU` (`ram` / `cpu`) | 割り当てられたリソース (`CPU` は `float64`) |
| `Language` (`language`) | `Name` と `Version` |

## アプリケーションへの commit

`Apps.Commit(ctx, appID, r, path, filename)` は、既存のアプリにファイルをアップロードします:

* `.zip` は `path` に**展開**されます (アプリのルートには `""`)。
* その他のファイルは `path/<filename>` に配置されます。

ファイル名は `filename`、なければリーダー自身の名前 (`*os.File` のベース名)、それもなければ `commit.zip` になります。デフォルトを使うには `""` を渡します。

```go theme={"system"}
// Unpack a zip at the root
build, err := os.Open("build.zip")
if err != nil {
	log.Fatal(err)
}
defer build.Close()
if err := c.Apps.Commit(ctx, appID, build, "", ""); err != nil {
	log.Fatal(err)
}

// Unpack a zip into /src
patch, err := os.Open("patch.zip")
if err != nil {
	log.Fatal(err)
}
defer patch.Close()
if err := c.Apps.Commit(ctx, appID, patch, "/src", ""); err != nil {
	log.Fatal(err)
}

// A single file from memory: /src/index.js
code := strings.NewReader(`console.log("Hello from Square Cloud");`)
if err := c.Apps.Commit(ctx, appID, code, "/src", "index.js"); err != nil {
	log.Fatal(err)
}
```

commit してもアプリは再起動されません。反映するには [`Apps.Restart`](https://docs.squarecloud.app/ja/sdks/go/managing_application) を呼び出してください。

## アップロードのキャンセル

```go theme={"system"}
ctx, cancel := context.WithTimeout(context.Background(), 120*time.Second)
defer cancel()

f, err := os.Open("bot.zip")
if err != nil {
	log.Fatal(err)
}
defer f.Close()

_, err = c.Apps.Create(ctx, f)
if errors.Is(err, context.DeadlineExceeded) {
	fmt.Println("the upload took too long")
}
```

キャンセルされたアップロードは `*APIError` (`ctx` がキャンセルされた場合は `NETWORK_ERROR`、期限を過ぎた場合は `TIMEOUT`) を返し、`context.Canceled` または `context.DeadlineExceeded` にアンラップされます。

## エラー

| ステータス | コード | 発生条件 |
| - | - | - |
| 0 | `FILE_TOO_LARGE` | ファイルが 100 MB を超えている (ローカルでチェック) |
| 400 | `INVALID_FILE`, `INVALID_FILENAME` | ファイルがない、またはファイル名にパス区切り文字、`..`、制御文字が含まれている |
| 400 | `INVALID_PATH` | `path` にトラバーサルやシェルのメタ文字が含まれている (commit) |
| 400 | `INSUFFICIENT_MEMORY` | プランの利用可能メモリが 256 MB 未満 (create) |
| 400 | `COMMIT_FAILED` | commit を適用できなかった (commit) |
| 400 | `UPLOAD_FAILED`, `STORAGE_UPLOAD_FAILED`, `CLUSTER_SELECTION_FAILED` | アップロードを処理できなかった (create) |
| 503 | `CLUSTER_MAINTENANCE_TRY_LATER` | メンテナンスのためプロビジョニングが一時停止している (create) |
| 503 | `UPLOAD_BUSY` | 進行中のアップロードが多すぎる。リーダーを再送できる場合は自動的にリトライされます |

ファイルを開くのはあなたのコードの役割なので、`os.Open` のエラーが SDK に届くことはありません。`nil` のリーダーは `*APIError` ではなく通常のエラーを返します。完全な一覧は[エラー](https://docs.squarecloud.app/ja/sdks/go/errors.md)を参照してください。

## 次のステップ

> [card] [ファイルの管理](https://docs.squarecloud.app/ja/sdks/go/managing_files.md)
>
> アプリのファイルを一覧、読み取り、書き込み、移動、削除します。

> [card] [アップロード API リファレンス](https://docs.squarecloud.app/ja/api-reference/endpoint/apps/upload.md)
>
> これらのメソッドが呼び出す REST endpoint。

> [card] [CLI からアップロード](https://docs.squarecloud.app/ja/cli-reference/deploy.md)
>
> 同じ操作をターミナルから行います。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.