Scenario: utilizzo di un gruppo di domini IoT
Questo scenario spiega il workflow di un gruppo di domini IoT.
Task
- Creare un gruppo di domini IoT
- Facoltativa. Aggiungere una VCN a un gruppo di domini IoT per stabilire una connessione diretta al database
- Facoltativa. Confermare i dettagli del gruppo di domini
- Facoltativa. Ottenere le richieste di lavoro del gruppo di domini per controllare lo stato, i log o trovare eventuali errori che possono verificarsi.
Questo scenario mostra come completare i task dei gruppi di domini mediante l'interfaccia CLI. In alternativa, è possibile completare questi task utilizzando la console o l'API. Per ulteriori informazioni, vedere IoT Gruppi di domini.
Prima di iniziare
Un amministratore deve aggiungere un criterio alla tenancy e ai compartimenti che si desidera utilizzare. Per esempi di criteri e prerequisiti, vedere Dettagli criteri per la piattaforma Internet of Things (IoT) e IoT Prerequisiti.
Oracle limita la creazione di un massimo di 2 domini IoT in ogni gruppo di domini IoT. Il numero massimo di gruppi di domini IoT è 5 e il numero massimo di domini IoT è 10 per ogni area della tenancy.
Per un elenco dei limiti delle risorse applicabili e delle istruzioni per richiedere un aumento dei limiti, vedere Limiti sulle risorse Internet of Things.
Passo 1: creazione di un gruppo di domini IoT
Prima di creare un dominio è necessario impostare un gruppo di domini. Ogni gruppo di domini IoT utilizza un'istanza di database dedicata, condivisa da tutti i domini IoT associati al gruppo di domini IoT.
oci iot create-domain-group
e il parametro <compartment-OCID>
richiesto per creare un gruppo di domini nel compartimento specifico. Facoltativamente, è possibile includere il nome visualizzato. oci iot domain-group create --compartment-id <compartment-OCID> --display-name <your-iot-domain-group-name>
La risposta di esempio mostra che il gruppo di domini sta creando e contiene l'URL dell'host dati con un ID breve del gruppo di domini. Utilizzare l'URL dell'host dati per accedere ai metadati e ai dati associati a un gruppo di domini IoT specifico contenente tutti i dispositivi per il dominio IoT associato.
data-host:<domain-group-short-id>.data.iot.<region>.oci.oraclecloud.com
Notare che i dettagli di connessione al database sono null
. Dopo la creazione del gruppo di domini, a seconda della posizione in cui si desidera visualizzare i dati, è necessario configurare l'accesso ai dati del dominio IoT associato per aggiungere i dettagli di autenticazione per il dominio IoT per connettersi a un altro sistema.
{
"data": {
"compartment-id": "<compartment-OCID>",
"data-host": "<domain-group-short-id>.data-iot.<region>.oci.oraclecloud.com,
"db-allow-listed-vcn-ids": null,
"db-connection-string": null,
"db-token-scope": null,
"defined-tags": {
"Oracle-Tags": {
"CreatedBy": "default/user@oracle.com",
"CreatedOn": "2025-08-05T18:15:41.260Z"
}
},
"description": null,
"display-name": "<your-iot-domain-group-name>",
"freeform-tags": {},
"id": "<domain-group-OCID>",
"lifecycle-state": "CREATING",
"system-tags": {},
"time-created": "2025-08-05T18:15:43.054000+00:00",
"time-updated": "2025-08-05T18:15:43.054000+00:00"
},
"etag": "<unique-id>",
"opc-work-request-id": "<work-request-OCID>"
}
Facoltativamente, durante questo processo di utilizzo di un gruppo di domini, è possibile monitorare la richiesta di lavoro di ogni operazione per verificare se è riuscita prima di procedere all'operazione successiva. È possibile utilizzare le richieste di lavoro per controllare i log o i messaggi di errore.
Utilizzare "opc-work-request-id": "<work-request-OCID>"
da qualsiasi operazione per ottenere la richiesta di lavoro correlata per l'operazione specifica. Ad esempio:
Facoltativamente, durante il tempo necessario per creare un gruppo di domini, è possibile ottenere la richiesta di lavoro per visualizzare lo stato del processo di creazione di un gruppo di domini IoT.
- Utilizzare il comando
oci iot work-request get
per ottenere la richiesta di lavoro per la creazione di un gruppo di domini. Sostituire il file<work-request-OCID>
con l'OCID per la richiesta di lavoro nella risposta del passo precedente:oci iot work-request get --work-request-id <work-request-OCID>
- Se si riceve la richiesta di lavoro durante l'elaborazione del gruppo di domini IoT di creazione, viene visualizzato un esempio di risposta che mostra come il processo di creazione di un gruppo di domini sia stato accettato e avviato correttamente, osservare i parametri riportati di seguito nell'esempio.
"operationType": "CREATE_IOT_DOMAIN_GROUP"
"actionType": "IN_PROGRESS"
"status": "ACCEPTED"
In questo esempio viene descritto come ottenere una richiesta di lavoro utilizzando l'interfaccia CLI. In alternativa, puoi anche utilizzare la console o le API REST per ottenere l'OCID della richiesta di lavoro. Per ulteriori informazioni, vedere Richieste di lavoro per i domini IoT e i gruppi di domini. È possibile trovare l'OCID della richiesta di lavoro nella pagina dei dettagli del gruppo di domini utilizzando la console. Per ulteriori informazioni, vedere Recupero dei dettagli di una richiesta di lavoro.{ "data": { "compartment-id": "<compartment-OCID>", "id": "<iot-work-request-OCID>", "operation-type": "CREATE_IOT_DOMAIN_GROUP", "percent-complete": 50.0, "resources": [ { "action-type": "IN_PROGRESS", "entity-type": "iotDomainGroup", "entity-uri": "/20250531/iotDomainGroups/<iot-domain-group-OCID>", "identifier": "<iot-domain-group-OCID>", "metadata": null } ], "status": "ACCEPTED", "time-accepted": "2025-09-08T09:29:22.505000+00:00", "time-finished": null, "time-started": null, "time-updated": "2025-09-08T09:29:57.532000+00:00" }, "etag": "<unique-id>" }
Facoltativamente, è possibile utilizzare il comando oci iot work-request list-logs
per verificare se la richiesta di lavoro di creazione di un gruppo di domini visualizza il processo di creazione di un gruppo di domini descritto nei log.
oci iot work-request list-logs --work-request-id <work-request-OCID>
{
"data": {
"items": [
{
"message": "Generating database credentials",
"timestamp": "2025-09-08T09:29:48.410000+00:00"
},
{
"message": "Creating database",
"timestamp": "2025-09-08T09:29:54.543000+00:00"
},
{
"message": "Provisioning database",
"timestamp": "2025-09-08T09:29:57.532000+00:00"
}
]
}
}
Facoltativamente, utilizzare il comando oci iot work-request list-errors
per elencare eventuali errori per la creazione di una richiesta di lavoro del gruppo di domini.
oci iot work-request list-errors --work-request-id <work-request-OCID>
Se esistono voci di log delle richieste di lavoro per un gruppo di domini, si tratta di una risposta di esempio. La risposta di questo esempio non contiene errori:
{
"data": {
"items": []
}
}
Al termine dell'operazione di creazione di un gruppo di domini, utilizzare il comando oci iot work-request get
per confermare che il gruppo di domini è stato creato correttamente e per confermare che il gruppo di domini è attivo.
oci iot work-request get --work-request-id <work-request-OCID>
"actionType": "CREATED"
e "status": "SUCCEEDED"
, confermando che il gruppo di domini è stato creato correttamente.{
"data": {
"compartment-id": "<compartment-OCID>",
"id": "<iot-work-request-OCID>",
"operation-type": "CREATE_IOT_DOMAIN_GROUP",
"percent-complete": 100.0,
"resources": [
{
"action-type": "CREATED",
"entity-type": "iotDomainGroup",
"entity-uri": "/20250531/iotDomainGroups/<iot-domain-group-OCID>",
"identifier": "<iot-domain-group-OCID>",
"metadata": null
}
],
"status": "SUCCEEDED",
"time-accepted": "2025-09-08T09:29:22.505000+00:00",
"time-finished": "2025-09-08T09:38:01.360000+00:00",
"time-started": "2025-09-08T09:29:48.402000+00:00",
"time-updated": "2025-09-08T09:38:01.360000+00:00"
},
"etag": "<unique-id>"
}
oci iot work-request list-logs --work-request-id <work-request-OCID>
Questa risposta di esempio mostra tutti i passi completati per l'operazione di creazione di un gruppo di domini IoT.{
"data": {
"items": [
{
"message": "Generating database credentials",
"timestamp": "2025-09-08T09:29:48.410000+00:00"
},
{
"message": "Creating database",
"timestamp": "2025-09-08T09:29:54.543000+00:00"
},
{
"message": "Provisioning database",
"timestamp": "2025-09-08T09:29:57.532000+00:00"
},
{
"message": "Enabling data guard",
"timestamp": "2025-09-08T09:33:59.906000+00:00"
},
{
"message": "Configuring admin secret rotation ",
"timestamp": "2025-09-08T09:37:03.396000+00:00"
},
{
"message": "Generating DNS record(s)",
"timestamp": "2025-09-08T09:37:08.842000+00:00"
},
{
"message": "Configuring routing policy",
"timestamp": "2025-09-08T09:37:09.903000+00:00"
},
{
"message": "Finishing work request",
"timestamp": "2025-09-08T09:38:01.360000+00:00"
}
]
}
}
Passo 2: recupero dei dettagli per un gruppo di domini IoT prima dell'aggiunta dei dettagli della VCN
oci iot domain-group get --iot-domain-group-id <iot-domain-group-OCID>
Questa risposta di esempio mostra che la VCN non è configurata per il gruppo di domini IoT:
{
"data": {
"compartment-id": "<compartment-OCID>",
"data-host": "<domain-group-short-id>.data.iot.us-phoenix-1.oci.oraclecloud.com",
"db-allow-listed-vcn-ids": null,
"db-connection-string": null,
"db-token-scope": null,
"defined-tags": {
"Oracle-Tags": {
"CreatedBy": "default/user@oracle.com",
"CreatedOn": "2025-09-08T09:29:22.092Z"
}
},
"description": null,
"display-name": "Demo Domain Group",
"freeform-tags": {},
"id": "<iot-domain-group-OCID>",
"lifecycle-state": "ACTIVE",
"system-tags": {},
"time-created": "2025-09-08T09:29:22.449000+00:00",
"time-updated": "2025-09-08T09:38:01.413000+00:00"
},
"etag": "<unique-id>"
}
Facoltativo: aggiunta di una VCN al gruppo di domini IoT per stabilire una connessione diretta al database
Dopo che un gruppo di domini IoT è attivo, se si desidera stabilire una connessione diretta al database per visualizzare i dati direttamente nel database o se si desidera connettere i dati per utilizzare Oracle Analytics Cloud, nell'ambito di tale configurazione è necessario aggiungere una VCN o VCN per consentire l'accesso ai dati IoT per questo gruppo di domini.
Per completare i passi riportati di seguito, l'utente deve disporre almeno dell'accesso in lettura alle reti VCN o VCN che si desidera aggiungere al gruppo di domini IoT. Per verificare se hai accesso in lettura alla VCN, consulta la sezione relativa alla acquisizione dei dettagli di una VCN per visualizzare le VCN a cui hai accesso. Se non si dispone dell'accesso in lettura per la VCN, chiedere a un amministratore di aggiungere il criterio correlato per i dettagli, vedere Prerequisiti IoT.
Utilizzare il comando oci iot domain-group configure-data-access per configurare le VCN o le VCN che si desidera consentire l'accesso al database per il gruppo di domini.
Sostituire ["vcn-OCID-1","vcn-OCID-2"]
con gli OCID VCN configurati per l'ambiente in uso. Sostituire <domain-group-OCID>
con l'OCID del gruppo di domini che si desidera utilizzare:
oci iot domain-group configure-data-access --db-allow-listed-vcn-ids '["vcn-OCID-1","vcn-OCID-2"]' --iot-domain-group-id <domain-group-OCID>
Il numero massimo di VCN che è possibile associare a un gruppo di domini IoT è 5.
Per ulteriori informazioni, vedere Configurazione dell'accesso ai dati per un gruppo di domini IoT.
Passo 3: recupero dei dettagli del gruppo di domini IoT dopo l'aggiunta dei dettagli della VCN
Quando si utilizza un gruppo di domini IoT, è possibile utilizzare questo comando per ottenere i dettagli del gruppo di domini. Nella risposta è possibile verificare i dettagli di connessione al database definiti per questo gruppo di domini IoT. Sostituire <iot-domain-group-OCID>
con l'OCID per il gruppo di domini IoT specifico:
oci iot iot-domain-group get --iot-domain-group-id <iot-domain-group-OCID>
Questa risposta di esempio mostra che il gruppo di domini è attivo, "lifecycleState": "ACTIVE"
. Se configurata, questa risposta include i dettagli di connessione al database e l'host dati per il gruppo di domini:
db-allow-listed-vcn-ids
db-connection-string
db-token-scope
{
"data": {
"compartment-id": "<compartment-OCID>",
"data-host": "<domain-group-short-id>.iot-data.<region>.oci.oraclecloud.com",
"db-allow-listed-vcn-ids": [
"<vcn-OCID>"
],
"db-connection-string": "tcps:adb.<region>.oraclecloud.com:1521/<unique-id>.adb.oraclecloud.com?retry_count=20&retry_delay=3",
"db-token-scope": "urn:oracle:db::id::ocid1.<database-compartment-OCID>",
"defined-tags": {
"Oracle-Tags": {
"CreatedBy": "default/user@oracle.com",
"CreatedOn": "2025-08-11T19:21:24.791Z"
}
},
"description": "<your-domain-group-description>",
"display-name": "<your-domain-group-name>",
"freeform-tags": {},
"id": "<iot-domain-group-OCID>",
"lifecycle-state": "ACTIVE",
"system-tags": {},
"time-created": "2025-08-11T19:21:26.411000+00:00",
"time-updated": "2025-08-12T02:17:02.763000+00:00"
},
"etag": "<unique-id>"
}
Successivamente, creare un dominio IoT e associare il dominio a un gruppo di domini IoT.