MENU
      Login
          Login
          目次 x
          GetAccount
            目次

            GetAccount

              記事の要約

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

              アカウントに属するコンテナ(バケット)リストとメタデータを照会します。

              リクエスト

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

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

              リクエストヘッダ

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

              フィールドタイプ必須の有無説明
              X-Auth-TokenStringRequired発行したトークン(Token)の値
              X-NewestBooleanOptional最新のコピー情報でレスポンスするかどうかを設定
              • true | false
                • true: すべてのコピーに対してクエリを行い、最新のコピー情報でレスポンス
              • ヘッダが省略された場合、レスポンスが最も早い情報でレスポンス
              AcceptStringOptional呼び出し結果の形式を指定
              • application/json |application/xml |text/xml

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

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

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

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

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

              フィールドタイプ必須の有無説明
              limitIntegerOptional呼び出し結果の最大数制限
              markerStringOptional特定のコンテナ(バケット)以降のリストを返す
              end_markerStringOptional特定のコンテナ(バケット)以前のリストを返す
              formatStringOptional呼び出しの形式を指定(json、xml、plain)
              prefixStringOptionalこの文字列で始まるコンテナ(バケット)リストを返す
              delimiterStringOptionalこの文字列を区切り文字として使用し、コンテナ(バケット)リストを階層構造で表現

              リクエスト例

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

              formatクエリパラメータなしでリクエスト

              formatクエリパラメータなしでリクエストするサンプルコードは次の通りです。

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

              formatクエリパラメータを JSONでリクエスト

              formatクエリパラメータを JSONでリクエストするサンプルコードは次の通りです。

              curl -X GET "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}?format=json"
-H "X-Auth-Token: $token"
              Curl

              formatクエリパラメータを XMLでリクエスト

              formatクエリパラメータを JSONでリクエストするサンプルコードは次の通りです。

              curl -X GET "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}?format=xml"
-H "X-Auth-Token: $token"
              Curl

              レスポンス

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

              レスポンスヘッダ

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

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

              レスポンス構文

              レスポンス構文は次の通りです。

              formatクエリパラメータなしでリクエストした場合、コンテナ(バケット)に属するオブジェクトの名前だけ plainテキスト形式で返します。

              "string"
              Plain text
              [
   {
      "count": "number",
      "last_modified":"string",
      "bytes": "number",
      "name":"string"
   }
]
              JSON
              <?xml version="1.0" encoding="UTF-8"?>
<account name="AUTH_5942771066a0482bb6aaf7f5bc792b00">
   <container>
      <name>"string"</name>
      <count>"number"</count>
      <bytes>"number"</bytes>
      <last_modified>"string"</last_modified>
   </container>
</account>
              XML

              レスポンスボディ

              レスポンスボディの説明は次の通りです。

              フィールドタイプ必須の有無説明
              countInteger-コンテナにあるオブジェクト数
              bytesInteger-コンテナにあるオブジェクトの全容量(Byte)
              nameString-コンテナの名前
              last_modifiedString-最終更新日時

              レスポンスステータスコード

              レスポンスステータスコードを紹介します。

              HTTPステータスコードコードメッセージ説明
              200-OKリクエスト成功
              204-No ContentContent-Typeがplainで、リクエストに該当する内容がない場合に発生

              レスポンス例

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

              formatクエリパラメータなしでリクエストした場合のレスポンス

              formatクエリパラメータなしでリクエストした場合、レスポンスのサンプルコードは次の通りです。

              HTTP/1.1 200 OK
Content-Length: 38
Accept-Ranges: bytes
X-Timestamp: 1535685069.28154
X-Account-Bytes-Used: 0
X-Account-Container-Count: 2
Content-Type: text/plain; charset=utf-8
X-Account-Object-Count: 0
x-account-project-domain-id: default
X-Trans-Id: tx928992622dd248ee9b3e8-005b972569
X-Openstack-Request-Id: tx928992622dd248ee9b3e8-005b972569
Date: Tue, 11 Sep 2018 02:16:09 GMT
              HTTP
              ncloud-container-0
ncloud-container-1
              Plain text

              formatクエリパラメータを JSONでリクエストした場合のレスポンス

              formatクエリパラメータを JSONでリクエストした場合、レスポンスのサンプルコードは次の通りです。

              HTTP/1.1 200 OK
Content-Length: 206
Accept-Ranges: bytes
X-Timestamp: 1535685069.28154
X-Account-Bytes-Used: 0
X-Account-Container-Count: 2
Content-Type: application/json; charset=utf-8
X-Account-Object-Count: 0
x-account-project-domain-id: default
X-Trans-Id: txddbf20f97d1043128d032-005b97260f
X-Openstack-Request-Id: txddbf20f97d1043128d032-005b97260f
Date: Tue, 11 Sep 2018 02:18:55 GMT
              HTTP
              [
   {
      "count":0,
      "last_modified":"2018-09-11T02:11:35.010250",
      "bytes":0,
      "name":"ncloud-container-0"
   },
   {
      "count":0,
      "last_modified":"2018-09-11T02:11:41.481410",
      "bytes":0,
      "name":"ncloud-container-1"
   }
]
              JSON

              formatクエリパラメータを XMLでリクエストした場合のレスポンス

              formatクエリパラメータを JSONでリクエストするサンプルコードは次の通りです。

              HTTP/1.1 200 OK
Content-Length: 392
Accept-Ranges: bytes
X-Timestamp: 1535685069.28154
X-Account-Bytes-Used: 0
X-Account-Container-Count: 2
Content-Type: application/xml; charset=utf-8
X-Account-Object-Count: 0
x-account-project-domain-id: default
X-Trans-Id: tx1a6fca0d191645c186b35-005b9726d3
X-Openstack-Request-Id: tx1a6fca0d191645c186b35-005b9726d3
Date: Tue, 11 Sep 2018 02:22:11 GMT
              HTTP
              <?xml version="1.0" encoding="UTF-8"?>
<account name="AUTH_5942771066a0482bb6aaf7f5bc792b00">
   <container>
      <name>ncloud-container-0</name>
      <count>0</count>
      <bytes>0</bytes>
      <last_modified>2018-09-11T02:11:35.010250</last_modified>
   </container>
   <container>
      <name>ncloud-container-1</name>
      <count>0</count>
      <bytes>0</bytes>
      <last_modified>2018-09-11T02:11:41.481410</last_modified>
   </container>
</account>
              XML
              この記事は役に立ちましたか?
              Change password!
              Changing your password will log you out immediately. Use the new password to log back in.
              Change profile
              Success!
              First name must have atleast 2 characters. Numbers and special characters are not allowed.
              Last name must have atleast 1 characters. Numbers and special characters are not allowed.
              Enter a valid email
              Enter a valid password
              Your profile has been successfully updated.
              Logout