Usar endpoints privados virtuales para VPC y conectarse de forma privada a IBM Quantum Platform

Usa endpoints privados virtuales (VPE) para Virtual Private Cloud (VPC) para conectarte a IBM Quantum® desde tu red VPC. La conexión usa la dirección IP que especifiques, asignada desde una subred dentro de tu VPC.

Los VPE son interfaces IP virtuales que están vinculadas a un gateway de endpoint creado por servicio. El gateway de endpoint es una función virtualizada que escala horizontalmente, es redundante y de alta disponibilidad, y abarca todas las zonas de disponibilidad de tu VPC. Los gateways de endpoint permiten las comunicaciones entre las instancias de servidor virtual dentro de tu VPC y el servicio IBM Cloud® sobre la red troncal privada. VPE para VPC te permite controlar todo el direccionamiento privado dentro de tu nube. Para obtener más información, consulta Acerca de los gateways de endpoint privado virtual.

Independientemente de si usas VPE, toda la comunicación interna dentro de la red de IBM Quantum Platform siempre usa conexiones privadas en lugar de la internet pública.

Si tu conexión a IBM Quantum Platform en sí es pública o privada depende de si usas un VPE. Conectarte a través de los endpoints públicos transmite todos los datos de solicitud y respuesta a través de la internet pública. En cambio, si te conectas a través de un VPE, ese tráfico se mantiene en la red privada.

Los VPEs solo son compatibles con la API y el SDK de IBM Quantum Platform, como se describe en las siguientes secciones. El sitio web de IBM Quantum Platform no admite VPEs y solo se puede acceder a él a través de la red pública.

Antes de comenzar

Antes de apuntar a un VPE para IBM Quantum Platform, completa los siguientes pasos:

• Crea una nube privada virtual.

• Planifica la topología de red para conectarte a los VPE.

• Configura los controles de acceso para tu VPE.

• Comprende las restricciones del servicio.

• Aprende a ver los detalles del VPE.

Configurar un VPE para IBM Quantum Platform

Hay varias formas de crear un gateway VPE. Si usas la CLI o la API, debes especificar el Nombre de recurso en la nube (CRN) de la región en la que deseas conectarte a IBM Quantum Platform. Consulta la siguiente tabla para ver las regiones y CRN disponibles.

Región	Planes	Nombre de dominio completamente calificado (FQDN)	Nombre de recurso en la nube (CRN)
us-east	Standard	private.us-east.quantum.cloud.ibm.com	crn:v1:bluemix:public:quantum-computing:us-east:::endpoint:private.us-east.quantum.cloud.ibm.com
eu-de	Standard	private.eu-de.quantum.cloud.ibm.com	crn:v1:bluemix:public:quantum-computing:eu-de:::endpoint:private.eu-de.quantum.cloud.ibm.com

Configurar un gateway de endpoint

Para configurar un gateway VPE, sigue estos pasos:

1. Enumera los servicios disponibles, incluidos los servicios de infraestructura de IBM Cloud disponibles (de forma predeterminada) para todos los usuarios de VPC.

2. Crea un gateway de endpoint para IBM Quantum Platform que desees que esté disponible de forma privada en la VPC.

3. Vincula una dirección IP reservada al gateway de endpoint.

4. Consulta los gateways VPE creados asociados con IBM Quantum Platform.

Ahora las instancias de servidor virtual en la VPC pueden acceder a tu instancia de IBM Quantum Platform de forma privada.

Usar tu VPE para IBM Quantum Platform

Después de crear un gateway de endpoint para IBM Quantum Platform, sigue estos pasos:

Usar el VPE con qiskit-ibm-runtime (SDK de Python)

nota

La compatibilidad con VPE requiere qiskit-ibm-runtime v0.24.0 o posterior.

Al instanciar QiskitRuntimeService, especifica private_endpoint=True.

# For `token`, use the 44-character API_KEY you created 
# and saved from the IBM Quantum Platform Home dashboard
service = QiskitRuntimeService(token="your-API_KEY", 
                              instance="INSTANCE_CRN",
                              channel="ibm_cloud",
                              private_endpoint=True)

Usar el VPE con la API de IBM Quantum

Después de crear un gateway de endpoint para IBM Quantum Platform, usa el nombre de dominio completamente calificado (FQDN) del endpoint del servicio para la región de destino de la tabla anterior.

  curl -X POST \
  https://private.us-east.quantum.cloud.ibm.com/api/v1/jobs \
  -H "Authorization: Bearer $BEARER_TOKEN" \
  -H "Service-CRN: $SERVICE_INSTANCE_CRN" \
  -d '{
    "backend": "backend",
    "program_id": "sampler"
  }'