Virtual Private Endpoints
IBM Cloud
IBM Cloud® Virtual Private Endpoints (VPE) for VPC enables you to connect to supported IBM Cloud® services from your VPC network by using the IP addresses of your choosing, allocated from a subnet within your VPC. See more details here.
This document applies to watsonx Assistant, Discovery, Speech to Text, and Text to Speech. Virtual Private Endpoints (VPEs) are available for these services in the Dallas, Washington, Frankfurt, London, Sydney, and Tokyo locations.
Prerequisites
-
Have a Virtual Private Cloud (VPC)
-
Have private endpoints enabled for your service instance
Instructions
-
Creation of the VPEG is confirmed when an IP address is set in the details view of the VPEG page in the UI, CLI output of the
endpoint-gateway
command, or API details call.
You can verify by running nslookup <endpoint>
on the private service endpoint of the Watson service from your VPC, for example:
# nslookup api.private.us-south.assistant.watson.cloud.ibm.com
Server: 127.0.0.53
Address: 127.0.0.53#53
Non-authoritative answer:
Name: api.private.us-south.assistant.watson.cloud.ibm.com
Address: 10.240.0.9 <---- your VPE IP address
To make requests using the assigned IP address instead of just the private service endpoint as suggested here, you must do your own hostname resolution. For example:
curl -X POST "https://api.private.us-south.assistant.watson.cloud.ibm.com/v2/assistants" --connect ::10.240.0.9
curl -X POST "https://api.private.us-south.assistant.watson.cloud.ibm.com/v2/assistants" --resolve api.private.us-south.assistant.watson.cloud.ibm.com:443:10.240.0.9