VPC の仮想プライベート・エンドポイントを使用して IBM Cloud Logs へのプライベート接続を行う方法

IBM Cloud® Virtual Private Endpoints (VPE) for VPC を使用すると、VPC ネットワークから IBM Cloud Logs に、選択した IP アドレス (VPC 内のサブネットから割り振られるアドレス) を使用して接続することができます。

VPE とは、サービスまたはサービス・インスタンスの単位 (サービスのオペレーション・モデルによって異なります) で作成されたエンドポイント・ゲートウェイにバインドされる仮想 IP インターフェースのことです。エンドポイント・ゲートウェイは仮想化された機能であり、水平方向にスケーリングします。冗長性と高可用性を備え、VPC のすべてのアベイラビリティー・ゾーンにまたがるように構成されます。エンドポイント・ゲートウェイは、プライベート・バックボーンの VPC および IBM Cloud® サービス内の仮想サーバー・インスタンスから通信できるようにします。 VPE for VPC を使用すると、クラウド内のすべてのプライベート・アドレッシングをお客様が管理できるようになります。詳しくは、仮想プライベート・エンドポイント・ゲートウェイについてを参照してください。

仮想プライベート・エンドポイントを使用して IBM Cloud Logs に接続するには、API または CLI を使用する必要があります。 IBM Cloud コンソールの IBM Cloud Logs ダッシュボードには、VPC からパブリック・ネットワークを介してアクセスする必要があります。

IBM Cloud Object Storage バケットおよび IBM Cloud Event Notifications インスタンスとの統合では、統合の構成に基づいてパブリック・インターフェースを使用できます。

開始前に

IBM Cloud Logs の仮想プライベート・エンドポイントをターゲットにする前に、以下のタスクを完了する必要があります。

必ず仮想プライベート・クラウドを作成しておいてください。
仮想プライベート・エンドポイントのプランを作成します。
仮想プライベート・エンドポイントに必ず正しいアクセス権限制御が設定されているようにしてください。
VPCの限界を理解する
仮想プライベート・エンドポイントについての詳細を表示する方法を理解しておいてください。

VPE for IBM Cloud Logs のセットアップ

CLI または API を使用して VPE ゲートウェイを作成する場合は、 IBM Cloud Logs インスタンスのクラウド・リソース名(CRN) をターゲットとして指定する必要があります。

エンドポイント・ゲートウェイの構成

仮想プライベート・エンドポイント・ゲートウェイを構成するには、以下の手順を実行します。

すべての VPC ユーザーが (デフォルトで) 使用できる IBM Cloud インフラストラクチャー・サービスを含め、使用可能なサービスを一覧表示します。
VPCで非公開にしたい IBM Cloud Logs、エンドポイント・ゲートウェイを作成します。
エンドポイント・ゲートウェイに予約済み IP アドレスをバインドします。
IBM Cloud Logs に関連付けた作成済みの VPE ゲートウェイを表示します。詳細については、エンドポイント・ゲートウェイの詳細の表示を参照してください。

VPC 内の仮想サーバー・インスタンスが IBM Cloud Logs インスタンスにプライベートにアクセスできるようになりました。

VPEの用途 IBM Cloud Logs

IBM Cloud Logs 用のエンドポイント・ゲートウェイを作成したら、以下の手順に従ってください：

VPE の CLI の使用

以下の手順を使用して、CLIと IBM Cloud Logs プラグインの最新バージョンに更新します。

IBM Cloud CLI を最新バージョンに更新します。
```
ibmcloud update
```
IBM Cloud Logs CLI プラグインを更新します。
```
ibmcloud plugin install cloud-logs
```
以下のように、すべてのコマンドに対して service-url を設定します。
```
ibmcloud logs config set service-url https://<instance_ID>.api.private.<region>.logs.cloud.ibm.com
```
または、 --service-url https://<instance_ID>.api.private.<region>.logs.cloud.ibm.com を使用して、特定のコマンドのパラメーターとして追加します。

VPE の API の使用

IBM Cloud Logs サービスのエンドポイント・ゲートウェイを作成した後、 URL のサービス・エンドポイント FQDN <instance_ID>.api.private.<region>.logs.cloud.ibm.com を使用してサービスにアクセスする。

SDK での VPE の使用

IBM Cloud Logsのエンドポイント・ゲートウェイを作成した後、 serviceURL <instance_ID>.api.private.<region>.logs.cloud.ibm.com を設定するときにプライベート・エンドポイントの FQDN を使用する必要があります。

VPE の Terraform の使用

Terraform を使用して IBM Cloud Logs サービスにアクセスする予定の場合は、必ず IBMCLOUD_LOGS_API_ENDPOINT 環境変数をプライベート FQDN <instance_ID>.api.private.<region>.logs.cloud.ibm.com に設定してください。以下に例を示します。

export IBMCLOUD_LOGS_API_ENDPOINT=<instance_ID>.api.private.<region>.logs.cloud.ibm.com