Nota:

Questa esercitazione richiede l'accesso a Oracle Cloud. Per iscriversi a un account gratuito, consulta Inizia a utilizzare Oracle Cloud Infrastructure Free Tier.
Utilizza valori di esempio per le credenziali, la tenancy e i compartimenti di Oracle Cloud Infrastructure. Al termine del laboratorio, sostituisci questi valori con quelli specifici del tuo ambiente cloud.

Utilizza un argomento di streaming OCI privato dietro un gateway API utilizzando una chiamata API REST OCI

Introduzione

Il servizio di streaming di Oracle Cloud Infrastructure (OCI) offre una soluzione completamente gestita, scalabile e duratura per l'inclusione e il consumo di flussi di dati a elevato volume in tempo reale. Utilizza OCI Streaming per qualsiasi caso d'uso in cui i dati vengono prodotti ed elaborati in maniera continua e sequenziale in un modello di messaggistica di pubblicazione/sottoscrizione.

In questo scenario, è necessario esporre e utilizzare un argomento di streaming OCI privato utilizzando un gateway API pubblico per controllare e proteggere l'accesso.

Obiettivo

Questa esercitazione descrive la procedura per utilizzare l'argomento relativo allo streaming OCI utilizzando le chiamate API REST del gateway API.

Prerequisiti

Account Oracle con autorizzazioni di accesso a livello di amministratore
Un compartimento per creare le risorse
Impostazione OCI-CLI locale, per assistenza, vedere Installazione dell'esercitazione CLI
VCN con due subnet (Privata e pubblica), consulta la sezione relativa alla creazione dell'esercitazione sulla rete
Assicurarsi che le subnet dispongano delle regole di entrata appropriate per il gateway di servizi e la porta 443 sia per le subnet private che per quelle pubbliche.
Argomento streaming OCI Creazione di un tutorial su OCI Stream
Python versione 3 locale installato per il test

Task 1: ottenere i dettagli dallo streaming OCI

Andare al flusso e prendere nota dell'OCID, fare clic su Analisi e intelligenza artificiale in Messaggistica, fare clic su Streaming e selezionare il flusso.
Ricorda che l'OCID e l'endpoint dei messaggi ne avrai bisogno per il tuo gateway API.

Task 2: Creare un gateway API pubblico

Fare clic su Servizi per sviluppatori, in Gestione API, fare clic su Gateway, quindi fare clic su Crea gateway.

Task 3: creare una distribuzione per il gateway API

Selezionare il gateway API creato nel task 2, fare clic su Distribuzioni, quindi fare clic su Crea distribuzione.
A questo punto, creare il prefisso sostituendo your_ocid_for_stream con l'OCID del flusso riportato di seguito. Immettere il nome publicTopic.
```
/20180418/streams/your_ocid_for_stream
```
Fare clic su Avanti.
Fare clic su Avanti.
Creazione di Instradamento 1 per groupCursors: creare l'URL utilizzando l'endpoint e l'OCID del flusso raccolti nel task 2 di questa esercitazione e creare l'URL.
```
<streaming_endpoint>/20180418/streams/<stream_ocid>/groupCursors
```
Nota: per utilizzare il flusso, l'API REST OCI per lo streaming utilizza due endpoint groupCursors e messaggi, è necessario creare questi due instradamenti. A questo punto, fornire le informazioni necessarie, ad esempio Percorso, Metodi, Tipo di backend, come indicato di seguito.
Fare clic su +Another instradamento e aggiungere Instradamento 2 per messaggi: utilizzando lo stesso URL ma con l'endpoint diverso alla fine come /messaggi.
Vai all'indirizzo publicTopic e prendi nota dell'endpoint del gateway API .

Task 4: generare messaggi di test sul flusso

Andare alla pagina Streaming e fare clic su Produci messaggio di test.
Questi messaggi verranno utilizzati nel task 5.

Task 5: utilizza lo streaming OCI tramite l'API REST dietro il gateway API

Scarica il codice di consumo Python di esempio consume_rest_api_oci_lab.py.
Modificare i valori per l'endpoint API Gateway e l'OCID del flusso come indicato dai valori raccolti in precedenza in questa esercitazione.
Esegui il codice Python per verificare il funzionamento.
```
python3 consume_rest_api_oci_lab.py
```

Conferme

Autore - Joao Tarla (Oracle LAD A-Team Solution Engineer)

Altre risorse di apprendimento

Esplora altri laboratori su docs.oracle.com/learn o accedi a contenuti di formazione gratuiti sul canale YouTube di Oracle Learning. Inoltre, visitare education.oracle.com/learning-explorer per diventare Explorer di Oracle Learning.

Per la documentazione sul prodotto, visitare il sito Oracle Help Center.

Titolo e informazioni sul copyright

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

F80887-01

April 2023