カタログ
OLP CLI は、次のものをサポートしています。
カタログリスト
アクセスできるすべてのカタログを一覧表示し、別の行にカタログ名を返します。 表示されるカタログのリストは 、リクエストの範囲によって異なります。
- リクエストに有効範囲が含まれていない場合は、アクセスできるすべてのカタログ(アクセスできるすべてのプロジェクト内のカタログを含む)が応答に含まれます。
- リクエストにスコープとしてプロジェクト HERE リソースネーム が含まれている場合、そのプロジェクトの一部であるカタログのみが応答に含まれます。
カタログの詳細については 、 show コマンドを参照してください。
olp catalog list [filter] [command options]
オプションのパラメータ :
-
[filter]
カタログリストのフィルタリングに使用される freeform テキスト。 フィルタ filter
は、カタログ HERE リソースネーム に文字列が含まれているかどうかを確認します。 -
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、ポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 --json
コマンドの結果を JSON 形式で表示します。 -
--quiet
カタログ HRNS を新しい行に表示します。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
注
olp catalog list
このコマンドは、アプリ権限に基づいてアプリからアクセスできるすべてのカタログを返します。 アプリは、直接権限(アプリが所有または共有するカタログ)、または間接権限(グループメンバーシップまたはレルム全体のポリシーによってアプリに権限が付与されている場合など)に基づいてカタログにアクセスできます。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
フィルタリングの例 :
olp catalog list "first-catalog-example-id" --json
出力 :
{"results": {"items": [
{"hrn": "hrn:here:data::org:first-catalog-example-id"}
]}}
フィルタリングのない例 :
olp catalog list --json
出力 :
{"results": {"items": [
{"hrn": "hrn:here:data::org:first-catalog-example-id"},
{"hrn": "hrn:here:data::org:second-catalog-example-id"}
]}}
カタログを作成します
プラットフォームに空のカタログを作成します。 作成されたカタログへのアクセス権は 、リクエストの範囲によって異なります。
- リクエストにスコープが含まれていない場合、呼び出し元のアプリには、他のユーザーと共有する機能を含む、カタログへのフルアクセス権が付与されます。
- リクエストにプロジェクト HERE リソースネーム が範囲として含まれている場合、カタログはプロジェクトの内部に作成され、そのカタログへのアクセス権がプロジェクトへのアクセス権を持つすべてのユーザーおよびアプリに自動的に付与されます。
olp catalog create <catalog ID> <catalog name> --summary <catalog summary> [command options]
警告
カタログ ID は カタログ HERE リソースネーム の一部であり、一般に公開されています。 カタログ ID を指定する場合は、非公開または会社の機密情報を含めないでください。 非公開情報および機密情報を含める必要がある場合は、既定で非公開になっているので、代わりにカタログ名フィールドを使用してください。
必須パラメータ :
-
<catalog ID>
プラットフォームがカタログ HERE リソースネーム の生成に使用するカタログの ID 。 -
<catalog name>
カタログの読み取り可能な名前。 --config
コマンド ラインを介してパラメータで指定された値を上書きします。 --description <catalog description>
カタログおよびその内容の詳細な説明。 説明は引用符で囲んでください。 -
--summary <catalog summary>
カタログの内容の概要を 1 行で示します。 --config
コマンド ラインを介してパラメータで指定された値を上書きします。
注
--config
オプションで参照されている設定ファイルを使用して、カタログの概要を指定することもできます。
オプションのパラメータ :
-
--config <path to config file>
新しいカタログの設定が含まれているローカルファイルへのパス。
注
構成ファイル内のカタログ HERE リソースネーム は無視されます。これは、プラットフォームがカタログ ID および現在のアプリ資格情報に基づいて新しい HERE リソースネーム を自動的に生成するためです。
-
--tags <tag1 tag2 ...>
検索の検索に使用されるカタログキーワード。 -
--notifications
true に設定すると、カタログのバージョンが変更されるたびに通知ストリーム レイヤーに通知が書き込まれます。 デフォルト値は false です。 --skip-sharing-with-user
関連付けられているユーザーアカウントとのカタログ権限の共有を禁止します。 CLI がユーザーアカウントと権限を共有するため、デフォルト値は false です。 このオプションを使用すると、関連付けられているユーザーアカウントが、作成できるリソースの上限に達しないようにできます。 リクエストで範囲が指定されている場合、このオプションは true であることが必要で、 true の値であると見なされます。 値 false は無視されます。 -
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 -
--json
カタログ HERE リソースネーム を JSON 形式で表示します。 -
--quiet
カタログ HERE リソースネーム を表示します。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。 -
--replication
サポートされているレプリケーションリージョンのスペース区切りのリスト。 最初の値はプライマリリージョン、 2 番めの値(渡された場合)はセカンダリレプリケーションリージョンです。 このパラメータは任意ですが、渡された場合はプライマリリージョンを指定する必要があります。 指定する場合、セカンダリリージョンをプライマリリージョンと同じにすることはできません。 複数リージョンのサポートの詳細については、「データのセキュリティと耐久性」を参照してください。
注
--replication
パラメーターが渡されない場合、パラメーター replication
で渡されたJSONファイルから構成を使用してカタログが作成 --config <config file>
されます。
replication
次のプロパティのサンプル JSON ファイル :
{
. . .
"replication": {
"regions": [
{
"role": "primary",
"id": "us-oregon"
},
{
"role": "secondary",
"id": "eu-ireland"
}
]
},
. . .
}
-
--auto-version-deletion <number of latest versions to keep>
一度に保持するカタログバージョンの最大数を定義します。 この上限に達して新しいバージョンが作成されると、最も古いカタログバージョンが自動的に削除されます。 デフォルトでは、カタログの自動バージョン削除は無効になっています。タイプ long
は <number of latest versions to keep>
である必要があります。 --config
コマンド ラインを介してパラメータで指定された値を上書きします。
注
このパラメータは --config <config file>
、に <config file>
少なくとも 1 つのバージョン付レイヤーの定義が含まれている場合に、パラメータとともにのみ適用されます。
自動バージョン削除を無効に するには、カタログ更新コマンドを参照してください。
-
--retry <number of retries>
ステータス 403
コードと These credentials do not authorize access
エラーでカタログの作成に失敗した場合の再試行回数を定義します。 デフォルト値はです 0
。これは、再試行がないことを意味します。 最初の再試行までのタイムアウトは 5 秒です。 次回の再試行ごとに、タイムアウト値が 2 倍になります。 5 秒、 10 秒、 20 秒、 40 秒などです。
例 :
次のコマンド first-catalog-example
を使用すると、プラットフォーム に空のカタログが作成され、出力にカタログの HERE リソースネーム が表示されます。
olp catalog create first-catalog-example-id first-catalog-example --summary "A new summary"
複数の引数を受け取るパラメーターに渡すには、引数をスペースで区切ります。
例 :
次のコマンド を使用すると、プラットフォーム に 2 つのタグ(tag1
および tag2
)がある空のカタログ second-catalog-example
が作成され、コンソール出力にカタログの HERE リソースネーム が表示されます。
olp catalog create second-catalog-example-id second-catalog-example --tags tag1 tag2 --summary "A new summary"
例 :
次のコマンドを実行すると、 third-catalog-example
プライマリレプリケーションリージョンを持つ空のカタログが作成されます。
olp catalog create third-catalog-example-id third-catalog-example --replication eu-ireland --summary "A new summary"
例 :
次のコマンドを実行すると、 fourth-catalog-example
プライマリおよびセカンダリのレプリケーションリージョンを含む空のカタログが作成されます。
olp catalog create fourth-catalog-example-id fourth-catalog-example --replication eu-ireland us-oregon --summary "A new summary"
上記の例では、カタログ名 first-catalog-example
および類似の名前がプレースホルダーとして機能し、独自のカタログの名前を渡す必要があります。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
カタログの更新
プラットフォーム内の既存のカタログを、設定ファイルで指定された設定で更新します。
olp catalog update <catalog HRN> [command options]
警告
カタログ設定の変更
プラットフォームでは、カタログのレイヤー設定を変更できません。
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。
オプションのパラメータ :
-
--config <path to config file>
更新された設定を含むファイルのパス。 -
--name <catalog name>
カタログの読み取り可能な名前。 --config
コマンド ラインを介してに提供された値を上書きします。 -
--summary <catalog summary>
カタログの内容の概要を 1 行で示します。 --config
コマンド ラインを介してに提供された値を上書きします。 --description <catalog description>
カタログおよびその内容の詳細な説明。 説明は引用符で囲んでください。 -
--tags <tag1 tag2 ...>
検索の検索に使用されるカタログキーワード。 タグを設定解除するには、を使用 --tags []
します。 -
--notifications
true に設定すると、カタログのバージョンが変更されるたびに通知ストリーム レイヤーに通知が書き込まれます。 デフォルト値はです false
。 -
--marketplace-ready <true|false>
true
に設定さ れている場合、カタログは「マーケットプレイスで使用可能」としてマークされます。 false
に設定さ れている場合、カタログはマーケットプレイスで使用可能としてマークされません。 -
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 -
--quiet
空の出力を追加情報なしで表示します。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。 -
--auto-version-deletion <number of latest versions to keep | off>
一度に保持するカタログバージョンの最大数を定義します。 この上限に達して新しいバージョンが作成されると、最も古いカタログバージョンが自動的に削除されます。 デフォルトでは、カタログの自動バージョン削除は無効になっています。 <number of latest versions to keep | off>
カタログから自動バージョン削除を削除するタイプ long
またはキーワード off
を指定できます。 --config
コマンド ラインを介してパラメータで指定された値を上書きします。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
olp catalog update hrn:here:data::org:first-catalog-example-id --config path/to/config.json
ボラタイル レイヤーを使用したカタログの設定例 :
{
"name": "volatile-volatile-catalog",
"summary": "A short summary",
"description": "A longer description about what the catalog contains",
"tags": [
"tag1",
"tag2"
],
"layers": [
{
"id": "volatile-layer",
"name": "volatile-layer",
"summary": "A short summary",
"description": "A longer description about what the layer contains",
"layerType": "volatile",
"partitioningScheme": "generic",
"partitioning": {
"scheme": "generic"
},
"volume": {
"volumeType": "volatile"
},
"contentType": "application/x-protobuf"
}
]
}
バージョン付レイヤーを使用したカタログの設定例 :
{
"name": "versioned-durable-catalog",
"summary": "A short summary",
"description": "A longer description about what the catalog contains",
"tags": [
"tag1",
"tag2"
],
"layers": [
{
"id": "versioned-layer",
"name": "versioned-layer",
"summary": "A short summary",
"description": "A longer description about what the layer contains",
"layerType": "versioned",
"partitioningScheme": "generic",
"partitioning": {
"scheme": "generic"
},
"volume": {
"volumeType": "durable"
},
"contentType": "application/x-protobuf",
"crc": "CRC-32C",
"digest": "MD5"
}
]
}
ストリーム レイヤーを使用したカタログの設定例 :
{
"name": "stream-durable-catalog",
"summary": "A short summary",
"description": "A longer description about what the catalog contains",
"tags": [
"tag1",
"tag2"
],
"layers": [
{
"id": "stream-layer",
"name": "stream-layer",
"summary": "A short summary",
"description": "A longer description about what the layer contains",
"layerType": "stream",
"partitioningScheme": "generic",
"partitioning": {
"scheme": "generic"
},
"volume": {
"volumeType": "durable"
},
"contentType": "application/x-protobuf"
}
]
}
インタラクティブなマップ レイヤーを使用したカタログの設定例:
{
"name": "interactive-map-catalog",
"summary": "A short summary",
"description": "A longer description about what the catalog contains",
"tags": [
"tag1",
"tag2"
],
"layers": [
{
"id": "interactive-map-layer",
"name": "interactive-map-layer",
"summary": "A short summary",
"description": "A longer description about what the layer contains",
"layerType": "interactivemap",
"volume": {
"volumeType": "durable"
},
"contentType": "application/geo+json",
"partitioning": {},
"interactiveMapProperties": {
"searchableProperties": [
"property-1",
"property-2"
]
}
}
]
}
追加のパラメータを使用した例 :
olp catalog update hrn:here:data::org:first-catalog-example-id --name first-catalog-example-updated \
--summary "Updated summary" --description "Updated description"
olp catalog update hrn:here:data::org:first-catalog-example-id --name first-catalog-example-updated ^
--summary "Updated summary" --description "Updated description"
カタログの自動バージョン削除の例 :
olp catalog update hrn:here:data::org:first-catalog-example-id --auto-version-deletion off
olp catalog update hrn:here:data::org:first-catalog-example-id --auto-version-deletion off
カタログ設定の詳細について は、 Data API を参照してください。
カタログ表示
カタログの設定を表示します。
olp catalog show <catalog HRN> [command options]
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム
オプションのパラメータ :
-
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 --json
コマンドの結果を JSON 形式で表示します。 -
--quiet
カタログのレイヤータイプとレイヤー ID をスペースで区切って表示します。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
olp catalog show hrn:here:data::org:first-catalog-example-id --json
注
catalog show --json
コマンド出力には、設定 API 応答に存在するカタログおよびレイヤーの hrn
フィールドの coverage
AND contacts
フィールドは含まれません。 catalog show --json
コマンド出力には、メタデータ API から受信した metadataVersion
AND metadataMinimumVersion
フィールドが含まれます。 つまり、 catalog show --json
コマンド出力には設定 API およびメタデータ API からのマージされた応答が含まれています。
出力には、 JSON 形式のカタログの構成が含まれています。
{
"summary": "",
"owner": {
"creator": {"id": "mzLcb1rL8nskvDQpCFEF"},
"organisation": {"id": "org"}
},
"billingTags": [],
"hrn": "hrn:here:data::org:first-catalog-example-id",
"created": "2018-03-02T10:41:09.309Z",
"name": "first-catalog-example",
"layers": [
{
"summary": "Summary",
"volume": {"volumeType": "durable"},
"layerType": "versioned",
"billingTags": [],
"crc": "CRC-32C",
"name": "Test Layer",
"contentEncoding": "gzip",
"description": "some description",
"partitioningScheme": "generic",
"partitioning": {"scheme": "generic"},
"id": "test-layer",
"contentType": "application/octet-stream",
"digest": "SHA-1",
"tags": []
},
{
"summary": "Summary",
"volume": {"volumeType": "durable"},
"layerType": "versioned",
"billingTags": [],
"crc": "CRC-32C",
"name": "Test Layer1",
"description": "some description",
"partitioningScheme": "generic",
"partitioning": {"scheme": "generic"},
"id": "test-layer1",
"contentType": "application/octet-stream",
"tags": []
}
],
"description": "",
"notifications": {
"enabled": false
},
"marketplaceReady": false,
"automaticVersionDeletion": {"numberOfVersionsToKeep": 100},
"id": "first-catalog-example-id",
"version": 4,
"metadataVersion": 21
"metadataMinimumVersion": 0
"tags": []
}
カタログを削除します
プラットフォームからカタログを削除します。
olp catalog delete <catalog HRN> [command options]
警告
カタログを削除しています
このコマンドは、カタログを完全に削除します。このカタログは復元できません。
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。
オプションのパラメータ :
-
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 -
--quiet
空の出力を追加情報なしで表示します。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
注
マーケットプレイスの準備完了とマークされました
「 Ready for Marketplace 」と記されたカタログは削除できません。
例 :
olp catalog delete hrn:here:data::org:first-catalog-example-id
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
カタログの依存関係リスト
特定のバージョンのすべてのカタログの依存関係を一覧表示します。
olp catalog dependency list <catalog HRN>
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。
オプションのパラメータ :
-
--version <catalog version>
カタログのバージョン。 デフォルト値は最新バージョンです。 -
--direct-only
有効にすると、直接の依存関係のみが表示されます。 無効にすると、直接と間接の両方の依存関係が表示されます。 デフォルトでは無効になっています -
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 --json
コマンドの結果を JSON 形式で表示します。 -
--quiet
カタログの依存関係の HRNS を新しい行に表示します。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
次のコマンド hrn:here:data::org:first-catalog-example-id
は、 JSON 形式でカタログの直接の依存関係をすべて一覧表示します。
olp catalog dependency list hrn:here:data::org:first-catalog-example-id --direct-only --json
カタログ権限リスト
カタログに関連付けられているすべての組織のユーザー、アプリ、およびグループの権限を一覧表示します。
olp catalog permission list <catalog HRN> [command options]
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。
オプションのパラメータ :
-
--type <app|group|user>
一覧表示するエンティティのタイプを指定します。 -
--limit <max number of entities>
結果に返されるエンティティの最大数を指定します(デフォルトは 100 )。 -
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 --json
コマンドの結果を JSON 形式で表示します。 --quiet
エンティティの HRNS を新しい行に表示します。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
olp catalog permission list hrn:here:data::org:first-catalog-example-id \
--json
olp catalog permission list hrn:here:data::org:first-catalog-example-id ^
--json
出力 :
{"entityGrants": [
{
"entityId": {
"id": "HERE-05966c89-aaf1-4ae2-b0e4-3676b3f8b8c3",
"hrn": "hrn:here:account::org:user/HERE-05966c89-aaf1-4ae2-b0e4-3676b3f8b8c3",
"realmHrn": "hrn:here:account::org:realm/org",
"type": "user"
},
"permissions": [
{
"id": "PERM-7heTYzsR05VR_p3IeyaZKDdlVPb1zJJUmzLI9JUEDcc",
"action": "read",
"effect": "allow",
"resource": "hrn:here:data::org:first-catalog-example-id",
"serviceId": "SERVICE-b9acbead-4666-487e-88b0-cfb64ed0ac6a"
},
{
"id": "PERM-7heTYzsR0RV5_p3IeyaZKDdlVPb1zJJUmzLI9JUDEbb",
"action": "write",
"effect": "allow",
"resource": "hrn:here:data::org:first-catalog-example-id",
"serviceId": "SERVICE-b9acbead-4666-487e-88b0-cfb64ed0ac6a"
}
]
},
{
"entityId": {
"id": "my-app-1234",
"hrn": "hrn:here:account::org:app/my-app-1234",
"realmHrn": "hrn:here:account::org:realm/org",
"type": "app"
},
"permissions": [
{
"id": "PERM-7heTYzsR05VR_p3IeyaZKDdlVPb1zJJUmzKJ9JUECdd",
"action": "manage",
"effect": "allow",
"resource": "hrn:here:data::org:first-catalog-example-id",
"serviceId": "SERVICE-b9acbead-4666-487e-88b0-cfb64ed0ac6a"
}
]
}
]
}
カタログ権限の付与
注
プロジェクトで作成されたカタログは、リソースリンクの使用可能性コマンドを使用して、他のプロジェクトにリンクできます。 詳細について は、「プロジェクトリソースの可用性の管理」を参照してください。
次のコマンドは、プロジェクト外で作成されたカタログにのみ適用されます。
ユーザー、アプリ、またはグループのカタログで指定したアクションを実行する権限を付与します。
olp catalog permission grant <catalog HRN> [command options]
警告
カタログ内のレイヤーに関連付けられているスキーマもすべて共有されます。
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。 - 次のいずれかの受取人 :
-
--group <groupID1 groupID2 ...>
カタログへのアクセス権を付与するグループ ID のリスト。スペースで区切ります。 -
--user <userID1 userID2 ...>
カタログへのアクセス権を付与するユーザー ID のリスト。スペースで区切ります。 この情報は .here/credentials.properties
、ファイル、ユーザーのホームディレクトリ、 または自分のプロファイルから見つけることができます。 -
--app <appID1 appID2 ...>
カタログへのアクセス権を付与するアプリケーション ID のリスト。スペースで区切ります。
- 次のいずれかの権限が必要です。
-
--manage
カタログへのアクセス権を管理および共有できます。 -
--read
カタログへの読み取りアクセス権を付与します。 -
--write
カタログへの書き込みアクセス権を付与します。 -
--share
カタログへの共有アクセス権を付与します。
注
対応する --group
、 --user
、、、または --app
の --manage
--read
--write
share
パラメータを少なくとも 1 つ指定する必要があります。
オプションのパラメータ :
--cross-realm
ユーザー --read
--write
--manage
--share
、アプリ、 または、異なるレルムのグループ。 -
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 -
--quiet
空の出力を追加情報なしで表示します。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
olp catalog permission grant hrn:here:data::org:first-catalog-example-id --group \
GROUP-example-group-id --read --write --manage --share
olp catalog permission grant hrn:here:data::org:first-catalog-example-id --group ^
GROUP-example-group-id --read --write --manage --share
応答 :
Granted read, write, manage, share access for a group GROUP-example-group-id to the catalog hrn:here:data::org:first-catalog-example-id
カタログ権限の削除
注
プロジェクトで作成されたカタログは、リソースリンクの使用可能性コマンドを使用して他のプロジェクトにリンクできなくなります。 詳細について は、「プロジェクトリソースの可用性の管理」を参照してください。
次のコマンドは、プロジェクト外で作成されたカタログにのみ適用されます
ユーザー、アプリ、またはグループのカタログで指定したアクションを実行する権限を削除します。
olp catalog permission revoke <catalog HRN> [command options]
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。 - 次のいずれかの受取人 :
-
--app <appID1 appID2 ...>
カタログへのアクセス権を削除するアプリケーション ID のリストです。スペースで区切ります。 -
--user <userID1 userID2 ...>
カタログへのアクセス権を削除するユーザー ID のリスト。スペースで区切ります。 この情報は .here/credentials.properties
、ファイル、ユーザーのホームディレクトリ、 または自分のプロファイルから見つけることができます。 -
--group <groupID1 groupID2 ...>
カタログへのアクセス権を削除するグループ ID のリスト。スペースで区切ります。
- 次のいずれかの権限が必要です。
-
--manage
削除すると、カタログへのアクセス権が管理および共有されます。 -
--read
カタログへの読み取りアクセス権を削除します。 -
--write
カタログへの書き込みアクセス権を削除します。 -
--share
削除すると、カタログへの共有アクセス権が削除されます。
注
対応する --group
、 --user
、、、または --app
の --manage
--read
--write
share
パラメータを少なくとも 1 つ指定する必要があります。
オプションのパラメータ :
--cross-realm
ユーザー --read
--write
--manage
--share
、アプリ、 または、異なるレルムのグループ。 注
--cross-realm
が渡された場合、 catalog permission revoke
コマンドは --read|--write|--manage|--share
フラグを受け入れません。
-
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 -
--quiet
空の出力を追加情報なしで表示します。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
olp catalog permission revoke hrn:here:data::org:first-catalog-example-id \
--group GROUP-example-group-id --read --write --manage --share
olp catalog permission revoke hrn:here:data::org:first-catalog-example-id ^
--group GROUP-example-group-id --read --write --manage --share
応答 :
Revoked read, write, manage, share access for a group GROUP-example-group-id to the catalog hrn:here:data::org:first-catalog-example-id
カタログバージョンが削除されました
指定したバージョンよりも小さいカタログバージョンを削除し、新しい最小バージョンを設定します。 現在の最小バージョンを確認するに は、 JSON 出力のmetadataMinimumVersion
の値およびolp catalog show
コマンドの詳細出力metadata minimum version
を参照してください。
注
カタログバージョン
このコマンドのカタログバージョンは、カタログ内のすべてのバージョン化されたレイヤーの単一バージョンを表します。
olp catalog version delete <catalog HRN> <version> [command options]
警告
データ損失のリスク
削除 コマンドの結果は元に戻すことができません。 データが削除されると、復元できません。
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。 -
<version>
削除されない最も古いカタログバージョン。
オプションのパラメータ :
-
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 -
--quiet
空の出力を追加情報なしで表示します。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
例 :
olp catalog version delete hrn:here:data::org:first-catalog-example-id 4
レスポンス :
Successfully deleted catalog versions less than 4
カタログ検査
外部ブラウザを開き、プラットフォームポータルのカタログ概要ページに移動します。 カタログにアクセスできない場合、コマンドは失敗します。
特定のレイヤーを検査 olp catalog layer inspect
するには、コマンドを参照してください。
olp catalog inspect <catalog HRN> [command options]
オプションのパラメータ :
-
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 -
--quiet
空の出力を追加情報なしで表示します。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
注
olp catalog inspect
このコマンドは、カタログがアプリからアクセス可能かどうかをアプリの権限に従って確認します。 ただし、ポータルでカタログを表示するには、ユーザーもカタログに対する読み取り権限を持っている必要があります。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。