put-object

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

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

参考

Sub Accountユーザーがこのコマンドを実行するには、Change/PutObjectアクションの権限が必要です。

構文

put-object構文は次の通りです。

aws s3api put-object \
    --bucket <bucket> \
    --key <key> \
    [--body <body>] \
    [--cache-control <cache-control>] \
    [--content-disposition <content-disposition>] \
    [--content-encoding <content-encoding>] \
    [--content-language <content-language>] \
    [--content-length <content-length>] \
    [--content-md5 <content-md5>] \
    [--content-type <content-type>] \
    [--metadata <metadata>] \
    [--storage-class <storage-class>] \
    [--server-side-encryption <server-side-encryption>] \
    [--sse-customer-algorithm <sse-customer-algorithm>] \
    [--sse-customer-key <sse-customer-key>] \
    [--sse-customer-key-md5 <sse-customer-key-md5>] \
    [--object-lock-mode <object-lock-mode>] \
    [--object-lock-retain-until-date <object-lock-retain-until-date>] \
    [--object-lock-legal-hold-status <object-lock-legal-hold-status>] \
    --endpoint-url <endpoint-url>

参考

単発の PUTで最大5GBサイズのオブジェクトをアップロードできます。5GB以上の大容量ファイルは、マルチパートアップロードをご利用ください。

オプション

put-objectの実行時に指定できるオプションについて説明します。

必須オプション

put-objectの必須オプションです。

オプション	タイプ	必須の有無	説明
`--bucket`	String	Required	バケット名
`--key`	String	Required	オブジェクト名

任意オプション

put-objectの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

オプション	タイプ	必須の有無	説明
`--body`	String	Optional	オブジェクトのパスまたはファイル
`--cache-control`	String	Optional	キャッシュ動作
`--content-disposition`	String	Optional	リクエストデータの表示方法
`--content-encoding`	String	Optional	リクエストデータのエンコード方法
`--content-language`	String	Optional	リクエストデータの言語
`--content-length`	Long	Optional	リクエストデータのサイズ (Byte)
`--content-md5`	String	Optional	リクエストデータの Base64エンコードされた128ビット MD5ハッシュ値リクエストデータの整合性検証に使用未入力の場合、自動計算
`--content-type`	String	Optional	リクエストデータの形式
`--metadata`	String	Optional	オブジェクトと併せて保存するメタデータ
`--storage-class`	String	Optional	ストレージクラス `STANDARD` (デフォルト) \| `ONEZONE_IA` \| `DEEP_ARCHIVE` `STANDARD`: Standard Class `ONEZONE_IA`: One Zone-IA(Infrequent Access) Class `DEEP_ARCHIVE`: Archive Class
`--server-side-encryption`	String	Optional	サーバ側暗号化方式 `AES256` \| `aws:kms` `AES256`: SSE-S3(サーバ管理キー) `aws:kms`: SSE-KMS(KMS管理キー)
`--sse-customer-algorithm`	String	Optional	ユーザー暗号化アルゴリズム (AES256)
`--sse-customer-key`	String	Optional	ユーザー提供の暗号化キー
`--sse-customer-key-md5`	String	Optional	ユーザー提供暗号化キーの MD5
`--object-lock-mode`	String	Optional	オブジェクトのリテンションモード `GOVERNANCE` \| `COMPLIANCE` `GOVERNANCE`: 特別な権限でバイパス可能 `COMPLIANCE`: いかなるユーザーもバイパス不可 `--object-lock-retain-until-date`と併せて指定 Object Lockが有効になっているバケットでのみ使用可能
`--object-lock-retain-until-date`	String	Optional	オブジェクトのリテンション期限 ISO 8601形式 `--object-lock-mode`と併せて指定 Object Lockが有効になっているバケットでのみ使用可能
`--object-lock-legal-hold-status`	String	Optional	リーガルホールドの状態 `ON` \| `OFF` Object Lockが有効になっているバケットでのみ使用可能

共通オプション

awsコマンドで共通して使用するオプションについては、Ncloud Storageのオプションをご参照ください。

例

オブジェクトのアップロードリクエストが成功すると、オブジェクトの識別情報と暗号化情報が返されます。

コマンド

オブジェクトをアップロードするコマンドの例は次の通りです。

aws s3api put-object --bucket my-test-bucket \
    --key img/image.png \
    --body image.png \
    --endpoint-url=https://kr.ncloudstorage.com

Deep Archive Classにオブジェクトをアップロードするコマンドの例は次の通りです。

aws s3api put-object --bucket my-test-bucket \
    --key img/image2.png \
    --body image2.png \
    --storage-class DEEP_ARCHIVE \
    --endpoint-url=https://kr.ncloudstorage.com

出力

オブジェクトをアップロードする出力の例は次の通りです。

{
    "ETag": "\"7cb4883d8f0eede455af0738a2d83b4b\"",
    "ChecksumCRC32": "35sEXg==",
    "ChecksumType": "FULL_OBJECT",
    "ServerSideEncryption": "AES256"
}

Deep Archive Classにオブジェクトをアップロードする出力の例は次の通りです。

{
    "ETag": "\"a7ee607d2e3b234a891a50b33fc12227\"",
    "ChecksumCRC32": "ZfRKhA==",
    "ChecksumType": "FULL_OBJECT",
    "ServerSideEncryption": "AES256"
}