カタログレイヤーオブジェクト
OLP CLI は、次のものをサポートしています。
- オブジェクト ストア レイヤーから blob を取得します
- blob をオブジェクト ストア レイヤーに追加します
- オブジェクト ストア レイヤーで blob をコピーします
- オブジェクト ストア レイヤーから blob を削除します
- オブジェクト ストア レイヤーのオブジェクトストアアイテムを一覧表示します
カタログレイヤーオブジェクト GET
--key
カタログオブジェクト ストア レイヤーのパラメータで指定された blob をダウンロードします。 このコマンドは、 blob の内容を標準出力に取得します。
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 リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
次のコマンドは、キー someDir/someObject
の下の blob コンテンツを catalog1
の objectstore-layer1
オブジェクト ストア レイヤーから標準出力にダウンロードします。
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 が指定した出力ファイルにダウンロードされます。
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 バイトのバイトをダウンロードするには、次のコマンドを使用します。
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
カタログレイヤーオブジェクトが配置されました
指定したキーの下にあるファイルをオブジェクト ストア レイヤーにアップロードします。
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 リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
以下のコマンドは、データの application/json
コンテンツタイプおよび gzip
コンテンツエンコード形式を使用して、オブジェクトキー someDir/someObject
の下の指定された入力ファイルからオブジェクト ストア レイヤー objectstore-layer1
catalog1
にデータをアップロードします。
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
にデータをアップロードします。
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
を取得して標準出力にするときに、 get
と put
コマンドの両方をチェーン化できます。 詳細について は、「カタログレイヤーオブジェクトの取得」を参照してください。
例 :
次のコマンドは、 catalog1
のオブジェクト ストア レイヤー objectstore-layer1
からキー someDir/someObject
の下にある blob をダウンロードし、オブジェクトキー someDir/someOtherObject
の下にある catalog2
のオブジェクト ストア レイヤー objectstore-layer2
にデータをアップロードします。
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 をオブジェクト ストア レイヤーの宛先キーにコピーします。
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 リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
次のコマンドを実行すると、オブジェクト ストア レイヤー objectstore-layer1
In catalog1
の blob がソースオブジェクトキー someDir/someObject
から宛先キー someDir/destinationObject
にコピーされます。
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 をオブジェクト ストア レイヤーから削除します。
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 リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
次のコマンドを実行すると、オブジェクトキー someDir/someObject
の下にあるオブジェクト ストア レイヤー objectstore-layer1
catalog1
から blob が削除されます。
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
カタログレイヤーのオブジェクトリスト
指定した親キーの下に、オブジェクト ストア レイヤーからのオブジェクトストアアイテムを一覧表示します。
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 リソースネーム を指定します。 で指定された値 --scope
は here.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