get-object-legal-hold

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

Ncloud Storageオブジェクトに設定されているリーガルホールドの状態を照会します。

参考

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

構文

get-object-legal-hold構文は次の通りです。

aws s3api get-object-legal-hold \
    --bucket <bucket> \
    --key <key> \
    [--version-id <version-id>] \
    --endpoint-url <endpoint-url>

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

get-object-legal-holdの必須オプションです。

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

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

オプション	タイプ	必須の有無	説明
`--version-id`	String	Optional	オブジェクトバージョン ID

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

リーガルホールドの照会リクエストが成功すると、オブジェクトのリーガルホールドの状態が返されます。

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

aws s3api get-object-legal-hold --bucket my-locked-bucket \
    --key locked.txt \
    --endpoint-url=https://kr.ncloudstorage.com

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

{
    "LegalHold": {
        "Status": "ON"
    }
}