カタログレイヤーオブジェクト

OLP CLI は、次のものをサポートしています。

  • オブジェクト ストア レイヤーから blob を取得します
  • blob をオブジェクト ストア レイヤーに追加します
  • オブジェクト ストア レイヤーで blob をコピーします
  • オブジェクト ストア レイヤーから blob を削除します
  • オブジェクト ストア レイヤーのオブジェクトストアアイテムを一覧表示します

カタログレイヤーオブジェクト GET

--key カタログオブジェクト ストア レイヤーのパラメータで指定された blob をダウンロードします。 このコマンドは、 blob の内容を標準出力に取得します。

Linux
olp catalog layer object get <catalog HRN> <layer ID> \
    --key <object key> [command options]
olp catalog layer object get <catalog HRN> <layer ID> ^
    --key <object key> [command options]

必須パラメータ :

  • <catalog HRN> カタログの HERE リソースネーム 。
  • <layer ID> レイヤーの ID 。
  • --key <object key> 取得するオブジェクトのキー。

オプションのパラメータ :

  • --range <byte range> オブジェクトの指定したバイト範囲をダウンロードします ( 例 : bytes=0-bytes=10-200) 。 パラメータ値はパターンに準拠している必要 bytes={rangeStart | required}-{rangeEnd | optional}があります。 {rangeStart} いずれかまたは両方の値を指定する必要があります。 HTTP Range ヘッダーの詳細について は、 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35 を参照してください。
  • --profile <profile name> olpcli.ini ファイルから使用する資格情報プロファイルの名前。
  • --quiet 空の出力を追加情報なしで表示します。
  • --scope <project HRN> リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scopehere.token.scope 、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。

資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。

例 :

次のコマンドは、キー someDir/someObject の下の blob コンテンツを catalog1objectstore-layer1 オブジェクト ストア レイヤーから標準出力にダウンロードします。

Linux
olp catalog layer object get hrn:here:data::org:catalog1 objectstore-layer1 \
   --key someDir/someObject
olp catalog layer object get hrn:here:data::org:catalog1 objectstore-layer1 ^
   --key someDir/someObject

例 :

次のコマンドを実行すると、オブジェクト ストア レイヤー objectstore-layer1 catalog1 からのキー someDir/someObject の下の blob が指定した出力ファイルにダウンロードされます。

Linux
olp catalog layer object get hrn:here:data::org:catalog1 objectstore-layer1 \
   --key someDir/someObject > <output_file_path>
olp catalog layer object get hrn:here:data::org:catalog1 objectstore-layer1 ^
   --key someDir/someObject > <output_file_path>

例 :

blob からバイト範囲をダウンロードするに --rangeは、任意のパラメータを指定します。 たとえば、 10 ~ 100 バイトのバイトをダウンロードするには、次のコマンドを使用します。

Linux
olp catalog layer object get hrn:here:data::org:catalog1 objectstore-layer1 \
   --key someDir/someObject --range bytes=10-100
olp catalog layer object get hrn:here:data::org:catalog1 objectstore-layer1 ^
   --key someDir/someObject --range bytes=10-100

カタログレイヤーオブジェクトが配置されました

指定したキーの下にあるファイルをオブジェクト ストア レイヤーにアップロードします。

Linux
olp catalog layer object put <catalog HRN> <layer ID> \
    --key <object key> [command options]
olp catalog layer object put <catalog HRN> <layer ID> ^
    --key <object key> [command options]

必須パラメータ :

  • <catalog HRN> カタログの HERE リソースネーム 。
  • <layer ID> レイヤーの ID 。
  • --key <object key> アップロード操作が開始されたオブジェクトのキー。

オプションのパラメータ :

  • --data <path to input file> オブジェクトの入力ファイルにデータが保存されます。 ファイルが指定されていない場合、コマンドは標準出力からデータを読み取ります。
  • --content-type <content type> application/json および text/plain など、アップロードするデータのコンテンツタイプ。 デフォルト値はです application/octet-stream
  • --content-encoding <encoding type> アップロードするデータのコンテンツエンコード。 このパラメータを指定すると、 OLP CLI は指定されたアルゴリズムを使用してデータを圧縮し、圧縮されたデータをオブジェクト ストア レイヤー にアップロードします。 使用できるエンコードタイプはだけ gzipです。 デフォルト値はです Uncompressed。つまり、圧縮は行われません。 olp catalog layer object get コマンドを実行すると、 OLP CLI は自動的に非圧縮データを返します。
  • --profile <profile name> olpcli.ini ファイルから使用する資格情報プロファイルの名前。
  • --quiet 空の出力を追加情報なしで表示します。
  • --scope <project HRN> リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scopehere.token.scope 、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。

資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。

例 :

以下のコマンドは、データの application/json コンテンツタイプおよび gzip コンテンツエンコード形式を使用して、オブジェクトキー someDir/someObject の下の指定された入力ファイルからオブジェクト ストア レイヤー objectstore-layer1 catalog1 にデータをアップロードします。

Linux
olp catalog layer object put hrn:here:data::org:catalog1 objectstore-layer1 \
   --key someDir/someObject --data <input_file_path> --content-type application/json --content-encoding gzip
olp catalog layer object put hrn:here:data::org:catalog1 objectstore-layer1 ^
   --key someDir/someObject --data <input_file_path> --content-type application/json --content-encoding gzip

例 :

以下のコマンドは、指定された入力ファイルからパイプされたデータを標準出力から読み取り、オブジェクトキー someDir/someObject の下のオブジェクト ストア レイヤー objectstore-layer1 catalog1 にデータをアップロードします。

Linux
olp catalog layer object put hrn:here:data::org:catalog1 objectstore-layer1 \
   --key someDir/someObject < <input_file_path>
olp catalog layer object put hrn:here:data::org:catalog1 objectstore-layer1 ^
   --key someDir/someObject < <input_file_path>

OLP CLI では、コンテンツ get を取得して標準出力にするときに、 getput コマンドの両方をチェーン化できます。 詳細について は、「カタログレイヤーオブジェクトの取得」を参照してください。

例 :

次のコマンドは、 catalog1 のオブジェクト ストア レイヤー objectstore-layer1 からキー someDir/someObject の下にある blob をダウンロードし、オブジェクトキー someDir/someOtherObject の下にある catalog2 のオブジェクト ストア レイヤー objectstore-layer2 にデータをアップロードします。

Linux
olp catalog layer object get hrn:here:data::org:catalog1 objectstore-layer1 \
   --key someDir/someObject | olp catalog layer object put hrn:here:data::org:catalog2 \
   objectstore-layer2 --key someDir/someOtherObject
olp catalog layer partition get hrn:here:data::org:catalog1 objectstore-layer1 ^
   --key someDir/someObject | olp catalog layer object put hrn:here:data::org:catalog2 ^
   objectstore-layer2 --key someDir/someOtherObject

資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。

カタログレイヤーオブジェクトのコピー

指定したソースキーの下の blob をオブジェクト ストア レイヤーの宛先キーにコピーします。

Linux
olp catalog layer object copy <catalog HRN> <layer ID> \
    --source <source object key> --key <object key> [command options]
olp catalog layer object copy <catalog HRN> <layer ID> ^
    --source <source object key> --key <object key> [command options]

必須パラメータ :

  • <catalog HRN> カタログの HERE リソースネーム 。
  • <layer ID> レイヤーの ID 。
  • --source <source object key> コピー操作が開始されたオブジェクトのソースキー。
  • --key <object key> コピー操作が開始された宛先キー。

オプションのパラメータ :

  • --profile <profile name> olpcli.ini ファイルから使用する資格情報プロファイルの名前。
  • --quiet 空の出力を追加情報なしで表示します。
  • --scope <project HRN> リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scopehere.token.scope 、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。

資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。

例 :

次のコマンドを実行すると、オブジェクト ストア レイヤー objectstore-layer1 In catalog1 の blob がソースオブジェクトキー someDir/someObject から宛先キー someDir/destinationObject にコピーされます。

Linux
olp catalog layer object copy hrn:here:data::org:catalog1 objectstore-layer1 \
   --source someDir/someObject --key someDir/destinationObject
olp catalog layer object copy hrn:here:data::org:catalog1 objectstore-layer1 ^
   --source someDir/someObject --key someDir/destinationObject

カタログレイヤーオブジェクトが削除されました

指定したキーの下の blob をオブジェクト ストア レイヤーから削除します。

Linux
olp catalog layer object delete <catalog HRN> <layer ID> \
    --key <object key> [command options]
olp catalog layer object delete <catalog HRN> <layer ID> ^
    --key <object key> [command options]

必須パラメータ :

  • <catalog HRN> カタログの HERE リソースネーム 。
  • <layer ID> レイヤーの ID 。
  • --key <object key> 削除操作が開始されたオブジェクトのキー。

オプションのパラメータ :

  • --profile <profile name> olpcli.ini ファイルから使用する資格情報プロファイルの名前。
  • --quiet 空の出力を追加情報なしで表示します。
  • --scope <project HRN> リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scopehere.token.scope 、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。

資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。

例 :

次のコマンドを実行すると、オブジェクトキー someDir/someObject の下にあるオブジェクト ストア レイヤー objectstore-layer1 catalog1 から blob が削除されます。

Linux
olp catalog layer object delete hrn:here:data::org:catalog1 objectstore-layer1 \
   --key someDir/someObject
olp catalog layer object delete hrn:here:data::org:catalog1 objectstore-layer1 ^
   --key someDir/someObject

カタログレイヤーのオブジェクトリスト

指定した親キーの下に、オブジェクト ストア レイヤーからのオブジェクトストアアイテムを一覧表示します。

Linux
olp catalog layer object list <catalog HRN> <layer ID> \
    --key <parent key> [command options]
olp catalog layer object list <catalog HRN> <layer ID> ^
    --key <parent key> [command options]

オブジェクトストアアイテムのプロパティ :

  • name オブジェクトストアアイテムの名前。 親キーが指定されている場合、そのキーと一致するオブジェクトキーの子孫プレフィックスの一部。 親キーが指定されていない場合は、オブジェクトキーの最初の部分が表示されます。 オブジェクト ストア レイヤーに保存されているオブジェクトの共通の接頭辞、または完全なオブジェクトキーが含まれています。
  • keyType name プロパティで指定されたプレフィックスのタイプ。 使用可能 keyType な値のセット :
    • commonPrefix オブジェクトストアアイテムの名前には、親キーまたはオブジェクトキーの最初の部分の下に共通の接頭辞が含まれています。
    • object オブジェクトストアアイテムの名前には、オブジェクトのフルキーが含まれています。
  • lastModified オブジェクトが変更された日付。 object タイプのアイテムにのみ使用できます。
  • size オブジェクトのサイズ。 object タイプのアイテムにのみ使用できます。

必須パラメータ :

  • <catalog HRN> カタログの HERE リソースネーム 。
  • <layer ID> レイヤーの ID 。

オプションのパラメータ :

  • --key <parent key> リスト操作が開始されたオブジェクトアイテムの親キー。
  • --deep 指定した親キーから再帰的にアイテムを一覧表示します。
  • --credentials <path to credentials file> コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。
  • --profile <profile name> olpcli.ini ファイルから使用する資格情報プロファイルの名前。
  • --json コマンドの結果を JSON 形式で表示します。
  • --quiet 新しい行にパーティション名を表示します。
  • --scope <project HRN> リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scopehere.token.scope 、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。

資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。

例 :

以下のコマンドは layer1 、カタログ内のすべてのオブジェクトストア項目を一覧表示 catalog1します。


olp catalog layer object list hrn:here:data::org:catalog1 layer1

出力 :


name                                    keyType                       lastModified                                      size
tmpDir                                  commonPrefix

Use olp catalog layer object get <catalog HRN> <layer ID>  --key=<objectKey> to read BLOBs from the object store layer

例 :

以下のコマンドは、共通の親キーの接頭辞 tempDir/commonPrefix に一致する、カタログ catalog1 内の layer1 すべてのオブジェクトストア項目を一覧表示します。


olp catalog layer object list hrn:here:data::org:catalog1 layer1 --key tempDir/commonPrefix

出力 :


Available object store items:

name                                    keyType                       lastModified                                      size
tmpDir/commonPrefix/file1               object                        2020-07-21T13:28:02.769Z                          48
tmpDir/commonPrefix/file2               object                        2020-07-21T13:28:07.423Z                          48

Total size: 96 B
Use olp catalog layer object get <catalog HRN> <layer ID> --key=<objectKey> to read BLOBs from the object store layer

」に一致する結果は 件です

    」に一致する結果はありません