delete-object

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

Object Storageに保存したオブジェクトを削除します。

構文

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

aws s3api delete-object \
    --bucket <bucket> \
    --key <key> \
    [--version-id <version-id>] \
    [--bypass-governance-retention | --no-bypass-governance-retention] \
    --endpoint-url <endpoint-url>

オプション

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

必須オプション

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

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

任意オプション

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

オプション	タイプ	必須の有無	説明
`--version-id`	String	Optional	オブジェクトのバージョン ID バージョン管理が適用されたバケットで特定のバージョンのオブジェクトを削除する場合
`--bypass-governance-retention`	Boolean	Optional	`GOVERNANCE`モードリテンション設定のバイパス `GOVERNANCE`リテンションが設定されたオブジェクトバージョンを削除する際に使用バイパス権限が必要
`--no-bypass-governance-retention`	Boolean	Optional	`GOVERNANCE`モードリテンション設定をバイパスしない

共通オプション

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

例

オブジェクトの削除リクエストが成功すると、オブジェクトが削除され、結果は出力されません。

コマンド

コマンドの例は次の通りです。

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