Updates

Author: gsteve88

articles/iot-hub/how-to-module-twins.md

@@ -21,8 +21,8 @@ ms.custom: mqtt, devx-track-csharp, devx-track-dotnet
 
 This article shows you how to develop two types of applications:
 
-* Device apps that view and update reported properties and handle requests to update module desired properties.
-* Service apps that can add modules, and read and set desired properties.
+* Device apps that view and update module identity twin reported properties and handle requests to update desired properties.
+* Service apps that can read and set module identity desired properties.
 
 > [!NOTE]
 > This article is meant to complement [Azure IoT SDKs](iot-hub-devguide-sdks.md) samples that are referenced from within this article. You can use SDK tools to build both device and back-end applications.

includes/iot-hub-howto-module-twins-dotnet.md

@@ -17,15 +17,13 @@ This article describes how to use the [Azure IoT SDK for .NET](https://github.co
 
 ## Create a device application
 
-Device applications can read and write module identity twin reported properties, and be notified of desired module identity twin property changes that are set by a backend application or IoT Hub.
-
 This section describes how to use device application code to:
 
-* Retrieve module identity twin and examine reported properties
+* Retrieve a module identity twin and examine reported properties
 * Update reported module identity twin properties
 * Create a module desired property update callback handler
 
-### Add device NuGet Package
+### Required device NuGet package
 
 Device client applications written in C# require the **Microsoft.Azure.Devices.Client** NuGet package.
 
@@ -40,26 +38,26 @@ using Microsoft.Azure.Devices.Shared;
 
 ### Connect to a device
 
-The [ModuleClient](/dotnet/api/microsoft.azure.devices.client.moduleclient) class exposes all the methods required to interact with module identity twins from the device.
+The [ModuleClient](/dotnet/api/microsoft.azure.devices.client.moduleclient) class exposes all methods required to interact with module identity twins from the device.
 
 Connect to the device using the [CreateFromConnectionString](/dotnet/api/microsoft.azure.devices.client.moduleclient.createfromconnectionstring) method with the module connection string.
-For example:
 
 Calling `CreateFromConnectionString` without a transport parameter connects using the default AMQP transport.
 
+This example connects to the device using the default AMQP transport.
+
 ```csharp
 static string ModuleConnectionString = "{Device module identity connection string}";
 private static ModuleClient _moduleClient = null;
 
-_moduleClient = ModuleClient.CreateFromConnectionString(ModuleConnectionString, 
-   null);
+_moduleClient = ModuleClient.CreateFromConnectionString(ModuleConnectionString, null);
 ```
 
 ### Retrieve a module identity twin and examine properties
 
 Call [GetTwinAsync](/dotnet/api/microsoft.azure.devices.client.moduleclient.gettwinasync?#microsoft-azure-devices-client-moduleclient-gettwinasync) to retrieve the current module identity twin properties into a [Twin](/dotnet/api/microsoft.azure.devices.shared.twin?) object.
 
-This example retrieves and displays module identity twin properties.
+This example retrieves and displays module identity twin properties in JSON format.
 
 ```csharp
 Console.WriteLine("Retrieving twin...");
@@ -95,7 +93,7 @@ catch (Exception ex)
 
 ### Create a desired property update callback handler
 
-Create a desired property update callback handler that executes when a desired property is changed in the module identity twin by passing the callback handler method name to [SetDesiredPropertyUpdateCallbackAsync](/dotnet/api/microsoft.azure.devices.client.moduleclient.setdesiredpropertyupdatecallbackasync).
+ Pass the callback handler method name to [SetDesiredPropertyUpdateCallbackAsync](/dotnet/api/microsoft.azure.devices.client.moduleclient.setdesiredpropertyupdatecallbackasync) to create a desired property update callback handler that executes when a desired property is changed in the module identity twin.
 
 For example, this call sets up the system to notify a method named `OnDesiredPropertyChangedAsync` whenever a desired module property is changed.
 
@@ -140,12 +138,9 @@ The Azure IoT SDK for .NET provides working samples of device apps that handle m
 
 The [RegistryManager](/dotnet/api/microsoft.azure.devices.registrymanager) class exposes all methods required to create a backend application to interact with module identity twins from the service.
 
-This section describes how to create backend application code to:
+This section describes how to read and update module identity fields.
 
-* Add a module
-* Read and update module fields
-
-### Add service NuGet Package
+### Required service NuGet package
 
 Backend service applications require the **Microsoft.Azure.Devices** NuGet package.
 
@@ -177,33 +172,7 @@ static string connectionString = "{IoT hub shared access policy connection strin
 registryManager = RegistryManager.CreateFromConnectionString(connectionString);
 ```
 
-### Add a module
-
-Call [AddModuleAsync](/dotnet/api/microsoft.azure.devices.registrymanager.addmoduleasync) to add a module to a device.
-
-In this example, the code calls `AddModuleAsync` to add a module named **myFirstModule** to a device named **myFirstDevice**. if the module already exists, the code calls [GetModuleAsync](/dotnet/api/microsoft.azure.devices.registrymanager.getmoduleasync) to fetch the module data into a [Module](/dotnet/api/microsoft.azure.devices.module) object.
-
-```csharp
-const string deviceID = "myFirstDevice";
-const string moduleID = "myFirstModule";
-Module module;
-
-// Add the module
-try
-{
-  module = 
-      await registryManager.AddModuleAsync(new Module(deviceID, moduleID));
-}
-catch (ModuleAlreadyExistsException)
-{
-  Console.WriteLine("ModuleID already exists for this device.");
-}
-
-// Show the module primary key
-Console.WriteLine("Generated module key: {0}", module.Authentication.SymmetricKey.PrimaryKey);
-```
-
-### Read and update module fields
+### Read and update module identity fields
 
  Call [GetModuleAsync](/dotnet/api/microsoft.azure.devices.registrymanager.getmoduleasync) to retrieve current module identity twin fields into a [Module](/dotnet/api/microsoft.azure.devices.module) object.
 

includes/iot-hub-howto-module-twins-node.md

@@ -110,7 +110,7 @@ client.open(function(err) {
 
 Call [getTwin](/javascript/api/azure-iot-device/client?#azure-iot-device-client-gettwin-1) to retrieve current module identity twin information into a [Twin](/javascript/api/azure-iot-device/twin) object.
 
-Device code can then access the twin properties.
+Device code can then access the module identity twin properties.
 
 For example:
 
@@ -306,7 +306,7 @@ The Azure IoT SDK for Node.js provides working samples of a device apps that han
 
 This section describes how to create a backend application that retrieves a module identity twin and update desired properties.
 
-### Install service SDK packages
+### Install service SDK package
 
 Run this command to install **azure-iothub** on your development machine:
 

includes/iot-hub-howto-module-twins-python.md

@@ -41,9 +41,9 @@ Device applications can read and write module identity twin reported properties,
 
 This section describes how to use device application code to:
 
-* Retrieve module identity twin and examine reported properties
-* Update reported module identity twin properties
-* Create a module desired property update callback handler
+* Retrieve a module identity twin and examine reported properties
+* Update module identity twin reported properties
+* Create a module identity twin desired property update callback handler
 
 ### Import statements
 
@@ -78,9 +78,9 @@ device_client = IoTHubDeviceClient.create_from_connection_string(conn_str)
 await device_client.connect()
 ```
 
-### Retrieve a device twin and examine reported properties
+### Retrieve a module identity twin and examine reported properties
 
-Call [get_twin](/python/api/azure-iot-device/azure.iot.device.iothubmoduleclient?#azure-iot-device-iothubmoduleclient-get-twin) to retrieve the module identity twin from the Azure IoT Hub service. The twin information is placed into a variable that can be printed or examined.
+Call [get_twin](/python/api/azure-iot-device/azure.iot.device.iothubmoduleclient?#azure-iot-device-iothubmoduleclient-get-twin) to retrieve the module identity twin from the Azure IoT Hub service. The twin information is placed into a variable that can be examined.
 
 This example retrieves the device twin and uses the `print` command to view the device twin in JSON format.
 
@@ -91,7 +91,7 @@ print("Twin document:")
 print("{}".format(twin))
 ```
 
-### Patch device reported twin properties
+### Update module identity twin reported properties
 
 You can apply a patch to update module identity twin reported properties in JSON format.
 
@@ -100,8 +100,6 @@ To apply a patch to update reported properties:
 1. Assign a reported property JSON patch to a variable.
 1. Call [patch_twin_reported_properties](/python/api/azure-iot-device/azure.iot.device.iothubmoduleclient?#azure-iot-device-iothubmoduleclient-patch-twin-reported-properties) to apply the JSON patch to reported properties.
 
-If `patch_twin_reported_properties` returns an error, this function raises the corresponding error.
-
 For example:
 
 ```python
@@ -112,7 +110,7 @@ print("Setting reported temperature to {}".format(reported_properties["temperatu
 await device_client.patch_twin_reported_properties(reported_properties)
 ```
 
-### Incoming desired properties patch handler
+### Create a module identity twin desired property update callback handler
 
 Call [on_twin_desired_properties_patch_received](/python/api/azure-iot-device/azure.iot.device.iothubmoduleclient?#azure-iot-device-iothubmoduleclient-on-twin-desired-properties-patch-received) to create a handler function or coroutine that is called when a module identity twin desired properties patch is received. The handler takes one argument, which is the twin patch in the form of a JSON dictionary object.
 
@@ -148,10 +146,7 @@ The Azure IoT SDK for Python includes the following samples:
 
 ## Create a backend application
 
-This section describes how to create a backend application to:
-
-* Create a module
-* Update desired properties
+This section describes how to create a backend application to retrieve and update module identity twin desired properties.
 
 The [IoTHubRegistryManager](/python/api/azure-iot-hub/azure.iot.hub.iothubregistrymanager) class exposes all methods required to create a backend application to interact with module identity twins from the service.
 
@@ -184,38 +179,14 @@ IOTHUB_CONNECTION_STRING = "{IoT hub shared access policy connection string}"
 iothub_registry_manager = IoTHubRegistryManager.from_connection_string(IOTHUB_CONNECTION_STRING)
 ```
 
-### Create a module
-
-Use [create_module_with_sas](/python/api/azure-iot-hub/azure.iot.hub.iothubregistrymanager?#azure-iot-hub-iothubregistrymanager-create-module-with-sas) to create a device identity module using a shared access key.
-
-This example creates a new module named `myFirstModule` for device `myFirstDevice`. If the module already exists, the code calls [get_module](/python/api/azure-iot-hub/azure.iot.hub.iothubregistrymanager?#azure-iot-hub-iothubregistrymanager-get-module) to retrieve the device identity module from IoT Hub.
-
-```python
-DEVICE_ID = "myFirstDevice"
-MODULE_ID = "myFirstModule"
-
-try:
-    # CreateModule - let IoT Hub assign keys
-    primary_key = ""
-    secondary_key = ""
-    managed_by = ""
-    new_module = iothub_registry_manager.create_module_with_sas(
-        DEVICE_ID, MODULE_ID, managed_by, primary_key, secondary_key
-    )
-except HttpOperationError as ex:
-    if ex.response.status_code == 409:
-        # 409 indicates a conflict. This happens because the module already exists.
-        new_module = iothub_registry_manager.get_module(DEVICE_ID, MODULE_ID)
-    else:
-        raise
-```
+### Retrieve and update module identity twin desired properties
 
-### Update desired properties
+You can update desired properties from a backend application using [update_module_twin](/python/api/azure-iot-hub/azure.iot.hub.iothubregistrymanager?#azure-iot-hub-iothubregistrymanager-update-module-twin).
 
-You can update both module identity twin tags and desired properties from a backend application at the same time using [update_module_twin](/python/api/azure-iot-hub/azure.iot.hub.iothubregistrymanager?#azure-iot-hub-iothubregistrymanager-update-module-twin).
+To retrieve and update module identity twin desired properties:
 
-1. Call [get_module_twin](/python/api/azure-iot-hub/azure.iot.hub.iothubregistrymanager?#azure-iot-hub-iothubregistrymanager-get-module-twin) to get the current version of the module identity twin
-1. Use the [Twin](/python/api/azure-iot-hub/azure.iot.hub.protocol.models.twin(class)) class to add module tags and properties in JSON format.
+1. Call [get_module_twin](/python/api/azure-iot-hub/azure.iot.hub.iothubregistrymanager?#azure-iot-hub-iothubregistrymanager-get-module-twin) to get the current version of the module identity twin.
+1. Use the [Twin](/python/api/azure-iot-hub/azure.iot.hub.protocol.models.twin(class)) class to add desired properties in JSON format.
 1. Call `update_module_twin` to apply the patch to the device twin. You can also use [replace_module_twin](/python/api/azure-iot-hub/azure.iot.hub.iothubregistrymanager?#azure-iot-hub-iothubregistrymanager-replace-module-twin) to replace desired properties and tags for a module identity twin.
 
 This example updates the `telemetryInterval` desired property to `122`.