Classic/VPC環境で利用できます。
コンテナ(バケット)のメタデータを照会します。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
| メソッド | URI |
|---|---|
| HEAD | /{containerName} |
リクエストヘッダ
ヘッダの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
x-ncp-apigw-timestamp |
String | Required | タイムスタンプの値
|
x-ncp-iam-access-key |
String | Required | NAVERクラウドプラットフォームで発行された API Keyまたは Sub Accountで発行された Access Key |
x-ncp-apigw-signature-v2 |
String | Required | Bodyを Access Key IDとマッピングする Secret Keyで暗号化した署名
|
x-ncp-region_code |
String | Required | コンテナのリージョンコード
|
リクエストパスパラメータ
パラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
containerName |
String | Required | 照会するコンテナ(バケット)の名前 |
リクエスト例
リクエストのサンプルコードは次の通りです。
curl -X HEAD "https://archivestorage.apigw.ntruss.com/swift/v1/{containerName}" -H "accept: application/json" -H "x-ncp-region-code: {regionCode}"
-H "x-ncp-iam-access-key: {AccessKey} "
-H "x-ncp-apigw-timestamp: {current timestamp}"
-H "x-ncp-apigw-signature-v2: {generated signature}"
レスポンス
レスポンス形式を説明します。
レスポンスヘッダ
ヘッダの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
Server |
String | - | レスポンスサーバ |
Date |
String | - | リクエストのレスポンスタイム(UTC) |
Connection |
String | - | クライアントとサーバ間の TCP接続状態 |
X-Storage-Policy |
Integer | - | コンテナ(バケット)の Storage Policy値 |
X-Timestamp |
Integer | - | コンテナ(バケット)が作成された時刻(Unix Timestamp) |
X-Container-Bytes-Used |
Integer | - | コンテナ(バケット)が使用する全容量(Byte) |
X-Trans-Id |
String | - | リクエストのトランザクション ID |
X-Openstack-Request-Id |
String | - | リクエストのトランザクション ID
|
X-Container-Object-Count |
Integer | - | コンテナ(バケット)のオブジェクトの総数 |
Referrer-Policy |
String | - | HTTP Referrerヘッダの処理方式 |
x-ncp-apigw-response-origin |
String | - | レスポンスの原本の出典 |
x-ncp-trace-id |
String | - | トランザクショントレース用 ID |
レスポンス例
レスポンスのサンプルコードは次の通りです。
HTTP/1.1 200 OK
Server: nginx
Date: Mon, 15 Apr 2024 23:43:11 GMT
Connection: keep-alive
X-Storage-Policy: standard00
X-Timestamp: 1711960998.26335
X-Container-Bytes-Used: 16969
X-Openstack-Request-Id: tx4b43dc3e46d2471daaafb-00661dbb8f
X-Container-Object-Count: 2
X-Trans-Id: tx4b43dc3e46d2471daaafb-00661dbb8f
Referrer-Policy: unsafe-url
x-ncp-trace-id: 6cd9l6lj66d356cchgc4rjcc1o
x-ncp-apigw-response-origin: ENDPOINT