--- title: "PutObject" slug: "ncloudstorage-putobject" updated: 2026-10-08T07:18:16Z published: 2026-10-08T07:18:16Z canonical: "api.ncloud-docs.com/ncloudstorage-putobject" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # PutObject Classic/VPC環境で利用できます。 Ncloud Storageバケットにオブジェクトを保存します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | PUT | /{Key} | ### リクエストヘッダ リクエストヘッダの説明は次の通りです。 参考 Ncloud Storage APIで共通して使用されるヘッダの詳細は、[Ncloud Storageのリクエストヘッダ](/docs/ja/storage-ncloudstorage#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 | フィールド | 必須の有無 | 説明 | | --- | --- | --- | | `Cache-Control` | Optional | キャッシュ動作 | | `Content-Disposition` | Optional | リクエストデータの表示方法 | | `Content-Encoding` | Optional | リクエストデータのエンコード方法 | | `Content-Language` | Optional | リクエストデータの言語 | | `Content-Type` | Optional | リクエストデータの形式 | | `Content-MD5` | Optional | リクエストボディ(オブジェクトデータ)の Base64エンコードされた128ビットMD5ハッシュ値 - オブジェクトデータの整合性検証に使用 | | `x-amz-checksum-*` | Optional | チェックサムのハッシュ値 - キーの`*`で使用したアルゴリズムを入力 - 対応するアルゴリズム: `crc32` \| `crc32c` \| `sha1` \| `sha256` \| `crc64nvme` - オブジェクトデータの整合性検証に使用 - 指定できるアルゴリズムは1つだけ | | `x-amz-storage-class` | Optional | ストレージクラス - `STANDARD` (デフォルト) \| `ONEZONE_IA` \| `DEEP_ARCHIVE` - `STANDARD`: Standard Class - `ONEZONE_IA`: One Zone-IA(Infrequent Access) Class - `DEEP_ARCHIVE`: Archive Class | | `x-amz-server-side-encryption` | Optional | サーバ側の暗号化方式 - `AES256`: SSE-S3 (サーバ管理キー) - `aws:kms`: SSE-KMS (KMS管理キー) | | `x-amz-server-side-encryption-customer-algorithm` | Optional | ユーザー暗号化アルゴリズム (AES256) | | `x-amz-server-side-encryption-customer-key` | Optional | ユーザー提供の暗号化キー | | `x-amz-server-side-encryption-customer-key-MD5` | Optional | ユーザー提供暗号化キーの MD5 | | `x-amz-object-lock-mode` | Optional | オブジェクトのリテンションモード - `GOVERNANCE` \| `COMPLIANCE` - `GOVERNANCE`: 特別な権限でバイパス可能 - `COMPLIANCE`: いかなるユーザーもバイパス不可 - `x-amz-object-lock-retain-until-date`と併せて指定 - Object Lockが有効になっているバケットでのみ使用可能 | | `x-amz-object-lock-retain-until-date` | Optional | オブジェクトのリテンション期限 - ISO 8601形式 - `x-amz-object-lock-mode`と併せて指定 - Object Lockが有効になっているバケットでのみ使用可能 | | `x-amz-object-lock-legal-hold` | Optional | リーガルホールドの状態 - `ON` \| `OFF` - Object Lockが有効になっているバケットでのみ使用可能 | ### リクエストパスパラメータ リクエストパスパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `Key` | String | Required | オブジェクト名 - バケット内フォルダに保存する場合、`{フォルダ名}/{ファイル名}`形式で入力 | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` PUT /object.csv HTTP/1.1 Host: {Bucket}.kr.ncloudstorage.com Content-Length: 17423 x-amz-checksum-sha256: 2ecf9f32d97***********39aed87829= ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスヘッダ レスポンスヘッダの説明は次の通りです。 参考 Ncloud Storage APIで共通して使用されるヘッダの詳細は、[Ncloud Storageのレスポンスヘッダ](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)をご参照ください。 | フィールド | 必須の有無 | 説明 | | --- | --- | --- | | `x-amz-checksum-*` | - | 保存されているオブジェクトのチェックサム値 - リクエストにチェックサムを指定した場合に表示 - キーの`*`は使用したアルゴリズム(`crc32`\|`crc32c`\|`sha1`\|`sha256`\|`crc64nvme`) | | `x-amz-checksum-type` | - | チェックサムタイプ - `FULL_OBJECT` \| `COMPOSITE` - リクエストにチェックサムを指定した場合に表示 | ### レスポンスステータスコード Ncloud Storage APIで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud Storageのレスポンスステータスコード](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 ``` HTTP/1.1 200 OK ETag: "2dd********************4f6181" x-amz-checksum-sha256: 2ecf9f32d97***********39aed87829= x-amz-object-size: 17423 ```