リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド	URI
HEAD	/{containerName}

リクエストヘッダ

ヘッダの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`x-ncp-apigw-timestamp`	String	Required	タイムスタンプの値 1970年1月1日 00:00:00協定世界時(UTC)からの経過時間をミリ秒で表したもの API Gatewayサーバとの時間差が5分以上の場合は有効ではないリクエストとみなす
`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で暗号化した署名 HMACの暗号化アルゴリズムは HmacSHA256を使用
`x-ncp-region_code`	String	Required	コンテナのリージョンコード <例> 韓国: `KR` \| シンガポール: `SGN`

リクエストパスパラメータ

パラメータの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`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-Trans-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

この記事は役に立ちましたか?

リクエスト
レスポンス
- レスポンスヘッダ
- レスポンス例

タグ

Archive Storage