HeadAccount

Prev Next

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

アカウントのメタデータを照会します。

リクエスト

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

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

リクエストヘッダ

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

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

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

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

フィールド タイプ 必須の有無 説明
project_id String Required プロジェクト ID

リクエスト例

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

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

レスポンス

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

レスポンスヘッダ

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

フィールド タイプ 必須の有無 説明
Content-Type String - レスポンス結果の MIMEタイプ
Content-Length String - レスポンス結果の長さ(Byte)
X-Account-Container-Count Integer - アカウントにあるのコンテナ(バケット)の総数
X-Account-Object-Count Integer - アカウントのオブジェクトの総数
X-Account-Bytes-Used Integer - アカウントが使用する全容量(Byte)
X-Timestamp Integer - アカウントが作成された時刻(Unix Timestamp)
X-Account-Storage-Policy-name-Container-Count Integer - ヘッダ名のnameに該当する storage policyのコンテナ(バケット)の総数
X-Account-Storage-Policy-name-Object-Count Integer - ヘッダ名のnameに該当する storage policyのオブジェクトの総数
X-Account-Storage-Policy-name-Bytes-Used Integer - ヘッダ名の nameに該当する storage policyの全容量(Bytes)
X-Account-Meta-name String Optional アカウントのメタデータ
  • ヘッダ名のname部分がメタデータのキーの役割を果たす
X-Account-Meta-Temp-URL-Key String Optional temporary URLのための Secret Key値
X-Account-Meta-Temp-URL-Key-2 String Optional temporary URLのための2番目の Secret Key値
Accept-Ranges String - アカウントが対応する Rangeタイプ
x-account-project-domain-id String - API利用時に必要な Domain ID
X-Trans-Id String - リクエストのトランザクション ID
X-Openstack-Request-Id String - リクエストのトランザクション ID
  • X-Trans-Idと同じ
X-Account-Meta-Quota-Bytes String Optional アカウントの容量制限値(Byte)
Date String - リクエストのレスポンスタイム(UTC)

レスポンス例

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

HTTP/1.1 204 No Content
Content-Length: 0
Accept-Ranges: bytes
X-Account-Meta-Book: ncloud-test-book
X-Timestamp: 1535685069.28154
X-Account-Bytes-Used: 420024
X-Account-Container-Count: 2
Content-Type: text/plain; charset=utf-8
X-Account-Object-Count: 2
x-account-project-domain-id: default
X-Trans-Id: tx9001d378488c4e5dbc64a-005b975d96
X-Openstack-Request-Id: tx9001d378488c4e5dbc64a-005b975d96
Date: Tue, 11 Sep 2018 06:15:50 GMT