HeadContainer

印刷する
共有
Twitter
Linkedin
Facebook
Email
PDF

記事の要約

この要約は役に立ちましたか?

ご意見ありがとうございます

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

コンテナ(バケット)のメタデータを照会します。

参考

Subaccountの場合、Subaccount専用の External API Gatewayを通じて使用できます。
詳細は、SubAccountのHeadContainer APIをご参照ください。

リクエスト

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

メソッド	URI
HEAD	/v1/AUTH_{project_id}/{container}

リクエストヘッダ

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

フィールド	タイプ	必須の有無	説明
`X-Auth-Token`	String	Required	発行したトークン(Token)の値
`X-Newest`	Boolean	Optional	最新のコピー情報でレスポンスするかどうかを設定 `true` \| `false` `true`: すべてのコピーに対してクエリを行い、最新のコピー情報でレスポンスヘッダが省略された場合、レスポンスが最も早い情報でレスポンス

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

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

フィールド	タイプ	必須の有無	説明
`project_id`	String	Required	プロジェクト ID プロジェクト IDの確認方法は、Archive Storageの概要を参照
`container`	String	Required	照会するコンテナ(バケット)の名前

リクエスト例

リクエストのサンプルコードは次の通りです。

curl -X HEAD "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}"
-H "X-Auth-Token: $token"

レスポンス

レスポンス形式を説明します。

レスポンスヘッダ

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

フィールド	タイプ	必須の有無	説明
`Content-Type`	String	-	レスポンス結果の MIMEタイプ
`Content-Length`	String	-	レスポンス結果の長さ(Byte)
`X-Container-Object-Count`	Integer	-	コンテナ(バケット)のオブジェクトの総数
`X-Container-Bytes-Used`	Integer	-	コンテナ(バケット)が使用する全容量(Byte)
`X-Timestamp`	Integer	-	コンテナ(バケット)が作成された時刻(UNIX timestamp)
`X-Container-Read`	String	-	コンテナ(バケット)の READ ACL(アクセス権限)
`X-Container-Write`	String	-	コンテナ(バケット)の WRITE ACL(アクセス権限)
`Last-Modified`	String	-	コンテナ(バケット)の最終更新時間(UTC)
`Accept-Ranges`	String	-	コンテナ(バケット)が対応する範囲タイプ
`X-Storage-Policy`	String	-	コンテナ(バケット)の Storage Policy値
`X-Trans-Id`	String	-	リクエストのトランザクション ID
`X-Openstack-Request-Id`	String	-	リクエストのトランザクション ID `X-Trans-Id`と同じ
`X-Container-Meta-name`	String	-	コンテナ(バケット)のメタデータヘッダ名の`name`部分がメタデータのキーの役割を果たす
`X-Container-Meta-Quota-Count`	String	-	コンテナ(バケット)のオブジェクト数の制限値
`X-Container-Meta-Quota-Bytes`	String	-	コンテナ(バケット)の容量制限値
`X-Container-Meta-Access-Control-Allow-Origin`	String	-	CORS設定入力されたアクセス可能なドメイン
`X-Container-Meta-Access-Control-Max-Age`	String	-	CORS設定入力された結果キャッシュの最大時間(秒)
`X-Container-Meta-Access-Control-Expose-Headers`	String	-	CORS設定入力されたアクセス許可ヘッダ
`X-Container-Meta-Temp-URL-Key`	String	-	Temporary URLのための Secret Key値
`X-Container-Meta-Temp-URL-Key-2`	String	-	Temporary URLのための2番目の Secret Key値
`X-Container-Sync-Key`	String	-	使用しない
`X-Container-Sync-To`	String	-	使用しない
`X-Versions-Location`	String	-	使用しない
`X-History-Location`	String	-	使用しない
`Date`	String	-	リクエストのレスポンスタイム(UTC)

レスポンス例

レスポンスのサンプルコードは次の通りです。

HTTP/1.1 204 No Content
Content-Length: 0
X-Container-Object-Count: 3
X-Timestamp: 1536631895.01856
Accept-Ranges: bytes
Last-Modified: Tue, 11 Sep 2018 02:11:36 GMT
X-Container-Bytes-Used: 630036
Content-Type: text/plain; charset=utf-8
X-Trans-Id: tx51f8478e8e924403851a4-005b988014
X-Openstack-Request-Id: tx51f8478e8e924403851a4-005b988014
Date: Wed, 12 Sep 2018 02:55:16 GMT

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

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

タグ

Archive Storage