manage get-physical-locations

IBM Software Hubのインスタンスに関連付けられている 1 つ以上の物理ロケーションに関する情報を取得します。

必要な役割
このコマンドを実行するには、IBM Cloud Pak for Dataの 1 次インスタンス (ハブ) で 物理ロケーションの管理 (manage_locations) 権限が必要です。

詳細説明

Cloud Pak for Dataのインスタンスに関連付けられている特定のリモート物理ロケーションまたはすべてのリモート物理ロケーションに関する情報を取得できます。

オプションで、リモート物理ロケーションが含まれているデータ・プレーンに関する情報を取得できます。

構文

cpd-cli manage get-physical-locations \
--cpd_hub_url=<route> \
--cpd_hub_api_key=<base64-encoded-API-key> \
--name=<name-of-a-physical-location> \
--all \
--include_data_planes=true|false

引数

get-physical-locations コマンドには引数はありません。

オプション

表 1: コマンド・オプション
オプション 説明
--all IBM Software Hubのインスタンスに関連付けられているすべての物理ロケーションに関する情報を取得するには、このオプションを使用します。
状況
オプションです。

このオプションを使用しない場合は、--name オプションを使用する必要があります。

構文
--all
デフォルト値
該当なし。
有効値
該当なし。
--cpd_hub_api_key 接続先の IBM Software Hub の 1 次インスタンスの base64-encoded API キー。
状況
必須。
構文
--cpd_hub_api_key=<base64-encoded-API-key>
デフォルト値
No default.
有効値
リモート物理ロケーションの作成時に指定した API キー。
--cpd_hub_url 接続先の IBM Software Hub の 1 次インスタンスへの経路。
状況
必須。
構文
--cpd_hub_url=<route>
デフォルト値
No default.
有効値
リモート物理ロケーションの作成時に指定した経路。
--include_data_planes 1 つの物理ロケーションを複数のデータ・プレーンに追加することができます。 物理ロケーションが含まれているデータ・プレーンのリストを返すかどうかを指定します。
状況
オプションです。
構文
--include_dependency=true|false
デフォルト値
false
有効値
false
データ・プレーンのリストを含めないでください。
true
データ・プレーンのリストを含めます。
--name 特定の物理ロケーションに関する情報を取得する場合は、このオプションを使用します。
状況
オプションです。

このオプションを使用しない場合は、--all オプションを使用する必要があります。

構文
--name=<name-of-a-physical-location>
デフォルト値
No default.
有効値
リモート物理ロケーションの名前。

注: 以下の例では、推奨されるインストール環境変数を使用しています。

リモートの物理的な場所に合った正しい値を持つ環境変数を作成するには、スクリプトを使用することを強くお勧めします。 詳しくは、リモート物理ロケーションの環境変数のセットアップを参照してください。

Cloud Pak for Dataのインスタンスに関連付けられているすべてのリモート物理ロケーションに関する情報を取得します

各リモート物理ロケーションのデータ・プレーンのリストを返します。

cpd-cli manage get-physical-locations \
--cpd_hub_url=${CPD_HUB_URL} \
--cpd_hub_api_key=${CPD_HUB_API_KEY} \
--include_data_planes=true \
--all
特定のリモート物理ロケーションに関する情報の取得
cpd-cli manage get-physical-locations \
--cpd_hub_url=${CPD_HUB_URL} \
--cpd_hub_api_key=${CPD_HUB_API_KEY} \
--name=${REMOTE_PHYSICAL_LOCATION_ID}