Usare l'API REST per creare e gestire applicazioni IoT Central

Articolo
06/13/2023

È possibile usare l'API REST del piano di controllo per creare e gestire applicazioni IoT Central. È anche possibile usare l'API REST per aggiungere un'identità gestita all'applicazione.

Per usare questa API, è necessario un token di connessione per la management.azure.com risorsa. Per ottenere un token di connessione, è possibile usare l'interfaccia della riga di comando di Azure:

az account get-access-token --resource https://management.azure.com

Per informazioni su come gestire l'applicazione IoT Central usando l'interfaccia utente di IoT Central, vedere Creare un'applicazione IoT Central.

Elencare le applicazioni

Per ottenere un elenco delle applicazioni IoT Central in una sottoscrizione:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.IoTCentral/iotApps?api-version=2021-06-01

Per ottenere un elenco delle applicazioni IoT Central in un gruppo di risorse:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps?api-version=2021-06-01

È possibile recuperare i dettagli di una singola applicazione:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{applicationName}?api-version=2021-06-01

Creazione di un'applicazione IoT Central

Per creare un'applicazione IoT Central con un'identità gestita assegnata dal sistema:

PUT https://management.azure.com/subscriptions/<your subscription id>/resourceGroups/<your resource group name>/providers/Microsoft.IoTCentral/iotApps/<your application name>?api-version=2021-06-01

Il payload seguente illustra la configurazione per la nuova applicazione, inclusa l'identità gestita:

{
  "location": "eastus",
  "sku": {
    "name": "ST2"
  },
  "properties": {
    "displayName": "Contoso IoT Central App",
    "subdomain": "my-iot-central-app",
    "template": "iotc-pnp-preview@1.0.0"
  },
  "identity": {
    "type": "SystemAssigned"
  }
}

Modificare un'applicazione IoT Central

È possibile modificare un'applicazione IoT Central esistente. L'esempio seguente illustra come modificare il nome visualizzato e abilitare l'identità gestita assegnata dal sistema:

PATCH https://management.azure.com/subscriptions/<your subscription id>/resourceGroups/<your resource group name>/providers/Microsoft.IoTCentral/iotApps/<your application name>?api-version=2021-06-01

Usare il payload seguente per modificare il nome visualizzato e abilitare l'identità gestita assegnata dal sistema:

{
  "properties": {
    "displayName": "Contoso IoT Central App"
  },
  "identity": {
    "type": "SystemAssigned"
  }
}

Nota

È possibile aggiungere un'identità gestita solo a un'applicazione IoT Central creata in un'area. Tutte le nuove applicazioni vengono create in un'area.

Eliminare un'applicazione IoT Central

Per eliminare un'applicazione IoT Central, usare:

DELETE https://management.azure.com/subscriptions/<your subscription id>/resourceGroups/<your resource group name>/providers/Microsoft.IoTCentral/iotApps/<your application name>?api-version=2021-06-01

Passaggi successivi

Ora che si è appreso come creare e gestire applicazioni Azure IoT Central usando l'API REST, ecco il passaggio successivo suggerito:

Come usare l'API REST IoT Central per gestire utenti e ruoli

Share via