delete-objects

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

Ncloud Storageバケットに保存されている2つ以上のオブジェクトを一括削除します。

参考

Sub Accountユーザーがこのコマンドを実行するには、Change/DeleteObjectアクションの権限が必要です。GOVERNANCEモードのリテンションをバイパスして削除する場合(--bypass-governance-retention)、Change/BypassGovernanceRetentionアクションの権限が追加で必要になります。

構文

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

aws s3api delete-objects \
    --bucket <bucket> \
    --delete <delete> \
    [--bypass-governance-retention | --no-bypass-governance-retention] \
    --endpoint-url <endpoint-url>

オプション

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

必須オプション

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

オプション	タイプ	必須の有無	説明
`--bucket`	String	Required	バケット名
`--delete`	String	Required	削除対象のオブジェクトリスト構文を参照

`--delete`構文

Shorthand構文

Objects=[{Key=string,VersionId=string,ETag=string,LastModifiedTime=timestamp,Size=long},{Key=string,VersionId=string,ETag=string,LastModifiedTime=timestamp,Size=long}],Quiet=boolean

JSON構文

{
  "Objects": [
    {
      "Key": "string",
      "VersionId": "string",
      "ETag": "string",
      "LastModifiedTime": timestamp,
      "Size": long
    }
    ...
  ],
  "Quiet": true|false
}

任意オプション

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

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

共通オプション

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

例

オブジェクトの削除リクエストが成功すると、削除された各オブジェクトの識別情報が返されます。

コマンド

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

aws s3api delete-objects --bucket my-test-bucket \
    --delete '{"Objects":[{"Key":"synced/report.txt"}],"Quiet":false}' \
    --endpoint-url=https://kr.ncloudstorage.com

出力

出力の例は次の通りです。

{
    "Deleted": [
        {
            "Key": "synced/report.txt"
        }
    ]
}