Cenário: Enviando Dados Não Estruturados Usando HTTPs

Use o comando oci iot domain-group create, o <compartment-OCID> e os parâmetros necessários do <domain-group-name> para criar um grupo de domínios do IoT em um compartimento específico. Substitua a <compartment-OCID> pelo OCID do compartimento no qual você deseja criar o grupo de domínios. Substitua a <domain-group-name> pelo nome do grupo de domínios e, opcionalmente, substitua a <your-sample-description> por uma descrição:

oci iot domain-group create --compartment-id <compartment-OCID> --display-name <domain-group-name> --description <your-sample-description>

A criação de um grupo de domínios IoT pode levar alguns minutos. Este exemplo de resposta mostra que o grupo de domínios está criando e usa este URL do host de dados:

wtmn2xs4ifkba.data.iot.us-phoenix-1.oci.oraclecloud.com

id curto do grupo de domínios: wtmn2xs4ifkba

data-host:<domain-group-short-id>.data.iot.<region>.oci.oraclecloud.com

{
  "data": {
    "compartment-id": "<compartment-OCID>",
    "data-host": "wtmn2xs4ifkba.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-14T16:43:02.950Z"
      }
    },
    "description": "<your-domain-group-description>",
    "display-name": "<your-domain-group-name>",
    "freeform-tags": {},
    "id": "<domain-group-OCID>",
    "lifecycle-state": "CREATING",
    "system-tags": {},
    "time-created": "2025-08-14T16:43:03.307000+00:00",
    "time-updated": "2025-08-14T16:43:03.307000+00:00"
  },
  "etag": "<unique-id>",
  "opc-work-request-id": "<work-request-OCID>"
}
        

Use o comando oci iot domain create e os parâmetros <domain-group-OCID> e <compartment-OCID> necessários para criar um domínio do Internet of Things. Substitua o <domain-group-OCID> pelo OCID do grupo de domínios que você deseja associar a esse domínio IoT. Substitua <your-sample-description> por uma descrição para seu domínio IoT.

oci iot domain create --compartment-id <compartment-OCID> --iot-domain-group-id <domain-group-OCID> --display-name <your-iot-domain-name> --description <your-iot-domain-description>

A criação de um domínio pode levar alguns minutos. Neste exemplo de resposta, você vê a URL do host do dispositivo com o id curto do domínio:

"device-host": "cuay2mrhlgrrg.device.iot.<region>.oci.oraclecloud.com"

id curto do domínio: cuay2mrhlgrrg

"device-host": "<domain-short-id>.device.iot.<region>.oci.oraclecloud.com"

{
  "data": {
    "compartment-id": "<compartment-OCID>",
    "data-retention-periods-in-days": {
      "historized-data": 30,
      "raw-command-data": 16,
      "raw-data": 16,
      "rejected-data": 16
    },
    "db-allow-listed-identity-group-names": null,
    "db-allowed-identity-domain-host": null,
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-08-14T16:57:03.140Z"
      }
    },
    "description": "<your-iot-domain-description>",
    "device-host": "cuay2mrhlgrrg.device.iot.<region>.oci.oraclecloud.com",
    "display-name": "<your-iot-domain-name>",
    "freeform-tags": {},
    "id": "<iot-domain-OCID>",
    "iot-domain-group-id": "<iot-domain-group-OCID>",
    "lifecycle-state": "CREATING",
    "system-tags": {},
    "time-created": "2025-08-14T16:57:03.384000+00:00",
    "time-updated": "2025-08-14T16:57:03.384000+00:00"
  },
  "etag": "<unique-id>",
  "opc-work-request-id": "<work-request-OCID>"
}

Use o comando oci iot digital-twin-instance create e o parâmetro <iot-domain-OCID> necessário para criar uma instância de gêmeo digital para um domínio IoT associado. Quando você cria uma instância de gêmeo digital, é necessário um ID de autenticação. Use um certificado ou um segredo. Consulte Criando um Segredo.

oci iot digital-twin-instance create --iot-domain-id <iot-domain-OCID> --auth-id <vault-secret-OCID> --display-name <display-name>

{
  "data": {
    "auth-id": "<vault-secret-OCID>",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-08-14T06:12:43.393Z"
      }
    },
    "description": null,
    "digital-twin-adapter-id": "<iot-digital-twin-adapter-OCID>",
    "digital-twin-model-id": "<iot-digital-twin-model-OCID>",
    "digital-twin-model-spec-uri": "dtmi:com:oracle:example:core:Space:sp;1",
    "display-name": "device for conference room 103",
    "external-key": "<unique-id>",
    "freeform-tags": {},
    "id": "<iot-digital-twin-instance-OCID>",
    "iot-domain-id": "<iot-domain-OCID>",
    "lifecycle-state": "ACTIVE",
    "system-tags": {},
    "time-created": "2025-09-11T06:12:44.178000+00:00",
    "time-updated": "2025-09-11T06:12:44.178000+00:00"
  },
  "etag": "<unique-id>"
}

Envie dados usando o URL do host do dispositivo da etapa anterior.

Você pode enviar quantos dados quiser. Este exemplo mostra o envio de 2 mensagens de dados de texto simples. O primeiro exemplo mostra o comando usando valores deste cenário. O segundo comando mostra os nomes dos valores. Para obter mais informações, consulte Usando cURL.

Substitua o <domain-short-id> e o <region> pelos valores do seu ambiente:

https://<domain-short-id>.device.iot.<region>.oci.oraclecloud.com/sampletopic

curl -u '9K7F8Y3HJGX1FA1GFG9QVV9E2C<vault-secret-OCID>' https://<domain-short-id>.device.iot.us-phoenix-1.oci.oraclecloud.com/sampletopic -H 'Content-Type: plain-text' -d "sample data 2"

curl -u '<external-key>:<vault-secret-OCID>' https://<domain-short-id>.device.iot.<region>.oci.oraclecloud.com/sampletopic -H 'Content-Type: plain-text' -d "sample data 1"

Para exibir seus dados no APEX, é necessário configurar o acesso para exibir seus dados IoT no APEX. Uma etapa desse processo usa o comando a seguir para adicionar a senha do APEX ao domínio IoT para que ele possa acessar o APEX.

oci iot domain configure-apex-data-access --iot-domain-id <iot-domain-OCID> --db-workspace-admin-initial-password <your-inital-apex-password>

Exemplo de resposta:

{
  "opc-work-request-id": "<work-request-OCID>"
}

1. Use o id short de domínio proveniente do host do dispositivo para fazer log-in no APEX:

   https://<domain-group-short-id-from-data-host>.data.iot.<region>.oci.oraclecloud.com/ords/r/apex

   device-host:<domain-short-id>.device.iot.<region>.oci.oraclecloud.com

   No APEX, faça log-in usando:

   • Banco de Dados: <domain-short-id-from-device-host>__WKSP
   • Nome de usuário:<domain-short-id-from-device-host>__WKSP
   • Senha inicial definida quando você usou o comando da CLI para configurar o acesso aos dados de um domínio IoT para o APEX: <initial-apex-password>

   Observação
   
   Observe os dois sublinhados: __WKSP e __IOT.
2. Para consultar os dados do IoT, selecione o esquema do <domain-short-id-from-device-host>__IOT. Selecione SQL Workshop e, em seguida, Object Browser.

   URL do SQL workshop:

   https://<domain-group-short-id-from-data-host>.data.iot.<region>.oci.oraclecloud.com/ords/r/apex/sql-workshop

3. Consulte os dados IoT informando e executando um comando SQL. Confirme se você selecionou o esquema correto para a tabela de banco de dados que deseja consultar. Execute o seguinte comando:

   select * from RAW_DATA

   Agora, você pode ver as views de banco de dados, esquemas e dados brutos do seu dispositivo conectado à Internet of Things.

   Para ver uma captura de tela maior, clique com o botão direito do mouse e abra a imagem em uma nova janela do navegador.