Nota:

Este tutorial requiere acceso a Oracle Cloud. Para registrarse en una cuenta gratuita, consulte Introducción a Oracle Cloud Infrastructure Free Tier.
Utiliza valores de ejemplo para las credenciales, el arrendamiento y los compartimentos de Oracle Cloud Infrastructure. Al finalizar el laboratorio, sustituya estos valores por otros específicos de su entorno en la nube.

Utilice un tema de OCI Streaming privado detrás de un gateway de API mediante una llamada de API de REST de OCI.

Introducción

El servicio de transmisión de Oracle Cloud Infrastructure (OCI) proporciona una solución duradera, ampliable y totalmente gestionada para la ingestión y el consumo de flujos de datos de gran volumen en tiempo real. Utilice OCI Streaming para cualquier caso de uso en el que se produzcan y procesen datos de forma continua y secuencial en un modelo de mensajería de publicación-suscripción.

En este escenario, necesitamos exponer y consumir un tema de OCI Streaming privado mediante un gateway de API público para controlar y proteger el acceso.

Objetivo

En este tutorial se muestra cómo consumir el tema de OCI Streaming mediante llamadas de API de REST de gateway de API.

Requisitos

Cuenta de Oracle con permisos de acceso de nivel de administrador
Un compartimento para crear los recursos
Configuración local de OCI-CLI. Si necesita ayuda, consulte Instalación del tutorial de la CLI
VCN con dos subredes (privadas y públicas), consulte Creación del tutorial de red
Asegúrese de que sus subredes tienen las reglas de entrada adecuadas para el gateway de servicio y el puerto 443 para las subredes públicas y privadas.
Tema de OCI Streaming Crear tutorial de OCI Stream
Python local versión 3 instalado para pruebas

Tarea 1: Obtenga detalles de OCI Streaming

Vaya al flujo y observe el OCID, haga clic en Análisis e IA en Mensajería, haga clic en Flujo y seleccione el flujo.
Anote el OCID y el punto final del mensaje, lo necesitará para su gateway de API.

Tarea 2: Creación de un gateway de API público

Haga clic en Servicios de desarrollador, en Gestión de API, haga clic en Gateways y, a continuación, en Crear gateway.

Tarea 3: Creación de un despliegue para el gateway de API

Seleccione el gateway de API creado en la tarea 2, haga clic en Despliegues y, a continuación, haga clic en Crear despliegue.
Ahora, cree el prefijo sustituyendo your_ocid_for_stream por su OCID de flujo a continuación, rellene el nombre como publicTopic.
```
/20180418/streams/your_ocid_for_stream
```
Haga clic en Siguiente.
Haga clic en Siguiente.
Creación de la ruta 1 para groupCursors: cree la URL mediante el punto final y el OCID de flujo que ha recopilado en la tarea 2 de este tutorial y cree la URL.
```
<streaming_endpoint>/20180418/streams/<stream_ocid>/groupCursors
```
Nota: Para consumir el flujo, la API de REST de OCI para el flujo utiliza dos puntos finales groupCursors y mensajes, debe crear esas dos rutas. Ahora proporcione la información necesaria, como Ruta, Métodos, Tipo de backend, como se muestra a continuación:
Haga clic en +Another route y agregue Route 2 para messages: utilizando la misma URL pero con el punto final diferente al final que /messages.
Vaya a publicTopic y observe el punto final de gateway de API.

Tarea 4: Generación de mensajes de prueba en el flujo

Vaya a la página Streaming y haga clic en Producir mensaje de prueba.
Estos mensajes se consumirán en la tarea 5.

Tarea 5: Uso de OCI Streaming mediante API de REST detrás del gateway de API

Descargue el código de consumo de Python de ejemplo consume_rest_api_oci_lab.py.
Cambie los valores del punto final de API Gateway y el OCID de flujo como se indica con los valores recopilados anteriormente en este tutorial.
Ejecute el código Python para verificar que funciona.
```
python3 consume_rest_api_oci_lab.py
```

Confirmaciones

Autor: Joao Tarla (ingenier de soluciones de equipos A de LAD de Oracle)

Más recursos de aprendizaje

Explore otros laboratorios en docs.oracle.com/learn o acceda a más contenido de aprendizaje gratuito en el canal YouTube de Oracle Learning. Además, visite education.oracle.com/learning-explorer para convertirse en un explorador de Oracle Learning.

Para obtener documentación sobre los productos, visite Oracle Help Center.

Título e Información de Copyright

Consume a private OCI Streaming topic behind an API Gateway using OCI REST API call

F80887-01

April 2023