オブジェクト ストア レイヤー のオブジェクトキーを一覧表示します

blobv2 REST API へのリクエストを作成することで、アップロードされたobject keysすべてのリクエストを一覧表示できます。

キー一覧表の一般的なフローは、次の手順で構成されています。

1. 認可トークンを取得します。
2. API ベースの URL を取得します。
3. キーを一覧表示します。

認可トークン を取得します

HTTP 要求の認可トークンを取得します。 手順について は、『 Identity & Access Management Guide 』を参照してください。

API ベースの URL を取得します

API ルックアップサービスを使用して、データを取得するカタログのblobv2 API の API エンドポイントを取得します。 手順については 、『 API Lookup 開発者ガイド』を参照してください。

キーを一覧表示します

オブジェクトキーを一覧表示するには、次のリクエストを使用します。

GET /<Base path for the blob API from the API Lookup Service>/layers/<Layer ID>/keys HTTP/1.1
Host: <Hostname for the blob API from the API Lookup Service>
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache

応答では、仮想ファイルシステムを表す方法で構造化されたキーのリストが指定されます。 この仮想ファイルシステムでは、一般的なプレフィックスはフォルダーおよびオブジェクトとファイルに似ています。

{
  "pageToken": "string",
  "items": [
    {
      "name": "file1.txt",
      "size": 1024,
      "lastModified": "2019-12-10T12:20:54Z",
      "type": "object"
    },
    {
      "name": "example",
      "type": "commonPrefix"
    },
  ]
}

応答にが含まれている場合 pageTokenは、この値を含むリクエストを指定して、残りのキーにアクセスします。

GET /<Base path for the blob API from the API Lookup Service>/layers/<Layer ID>/keys?pageToken=<Page Token> HTTP/1.1
Host: <Hostname for the blob API from the API Lookup Service>
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache

typecommonPrefixの戻り値は、このプレフィックスに 1 つ以上のキーが存在することを意味します。これらのキーにアクセスするには、nameフィールドをparent引数として使用して要求します。

GET /<Base path for the blob API from the API Lookup Service>/layers/<Layer ID>/keys?parent=<Common Prefix Name> HTTP/1.1
Host: <Hostname for the blob API from the API Lookup Service>
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache

typeobjectcommonPrefixのすべてのキーを一覧表示する場合 は、deep=true引数を指定してリクエストを実行します。

GET /<Base path for the blob API from the API Lookup Service>/layers/<Layer ID>/keys?deep=true HTTP/1.1
Host: <Hostname for the blob API from the API Lookup Service>
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache