PutObject

Classic/VPC環境で利用できます。

Ncloud Storageバケットにオブジェクトを保存します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド	URI
PUT	/{Key}

リクエストヘッダ

リクエストヘッダの説明は次の通りです。

参考

Ncloud Storage APIで共通して使用されるヘッダの詳細は、Ncloud Storageのリクエストヘッダをご参照ください。

フィールド	必須の有無	説明
`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=

<object.csv binary data>

レスポンス

レスポンス形式を説明します。

レスポンスヘッダ

レスポンスヘッダの説明は次の通りです。

参考

Ncloud Storage APIで共通して使用されるヘッダの詳細は、Ncloud Storageのレスポンスヘッダをご参照ください。

フィールド	必須の有無	説明
`x-amz-checksum-*`	-	保存されているオブジェクトのチェックサム値リクエストにチェックサムを指定した場合に表示キーの`*`は使用したアルゴリズム(`crc32`\|`crc32c`\|`sha1`\|`sha256`\|`crc64nvme`)
`x-amz-checksum-type`	-	チェックサムタイプ `FULL_OBJECT` \| `COMPOSITE` リクエストにチェックサムを指定した場合に表示

レスポンスステータスコード

Ncloud Storage APIで共通して使用されるレスポンスステータスコードの詳細は、Ncloud Storageのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

HTTP/1.1 200 OK
ETag: "2dd********************4f6181"
x-amz-checksum-sha256: 2ecf9f32d97***********39aed87829=
x-amz-object-size: 17423