head-bucket

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

Ncloud Storageバケットのメタデータを照会します。

参考

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

構文

head-bucket構文は次の通りです。

aws s3api head-bucket \
    --bucket <bucket> \
    --endpoint-url <endpoint-url>

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

head-bucketの必須オプションです。

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

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

バケットの照会リクエストが成功すると、バケットのリージョン情報が返されます。

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

aws s3api head-bucket --bucket my-test-bucket \
    --endpoint-url=https://kr.ncloudstorage.com

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

{
    "BucketRegion": "kr",
    "AccessPointAlias": false
}