Edits

Author: gsteve88

articles/iot-hub/how-to-file-upload.md

@@ -16,7 +16,7 @@ ms.custom: [amqp, mqtt, "Role: Cloud Development", "Role: IoT Device"]
 
 This article demonstrates how to:
 
-* Use [file upload capabilities of IoT Hub](iot-hub-devguide-file-upload.md) to upload a file to [Azure blob storage](../storage/index.yml), using an Azure IoT device and service SDKs.
+* Use [file upload capabilities of IoT Hub](iot-hub-devguide-file-upload.md) to upload a file to [Azure Blob Storage](../storage/index.yml), using an Azure IoT device and service SDKs.
 * Notify IoT Hub that the file was successfully uploaded and create a backend service to receive file upload notifications from IoT Hub.
 
 The [Send telemetry from a device to an IoT hub](../iot/tutorial-send-telemetry-iot-hub.md?toc=/azure/iot-hub/toc.json&bc=/azure/iot-hub/breadcrumb/toc.json&pivots=programming-language-csharp) quickstart and [Send cloud-to-device messages with IoT Hub](c2d-messaging-dotnet.md) article show the basic device-to-cloud and cloud-to-device messaging functionality of IoT Hub. The [Configure Message Routing with IoT Hub](tutorial-routing.md) article shows a way to reliably store device-to-cloud messages in Microsoft Azure blob storage. However, in some scenarios, you can't easily map the data your devices send into the relatively small device-to-cloud messages that IoT Hub accepts. For example:
@@ -32,8 +32,8 @@ For more information, see:
 
 * [Overview of file uploads with IoT Hub](iot-hub-devguide-file-upload.md)
 * [Configure IoT Hub file uploads](iot-hub-configure-file-upload.md)
-* [Azure blob storage documentation](../storage/blobs/storage-blobs-introduction.md)
-* [Azure blob storage API reference](../storage/blobs/reference.md)
+* [Azure Blob Storage documentation](../storage/blobs/storage-blobs-introduction.md)
+* [Azure Blob Storage API reference](../storage/blobs/reference.md)
 * [Azure IoT SDKs](iot-hub-devguide-sdks.md)
 
 [!INCLUDE [iot-hub-include-x509-ca-signed-file-upload-support-note](../../includes/iot-hub-include-x509-ca-signed-file-upload-support-note.md)]

includes/iot-hub-howto-file-upload-dotnet.md

@@ -11,20 +11,23 @@ ms.date: 07/01/2024
 ms.custom: mqtt, devx-track-csharp, devx-track-dotnet
 ---
 
+This how-to contains two sections:
+
+* Upload a file from a device application
+* Receive file upload notification in a backend application
+
 ## Upload a file from a device application
 
-Follow this procedure for uploading a file from a device to IoT Hub:
+Follow this procedure to upload a file from a device to IoT Hub:
 
 * Connect to IoT Hub
 * Get a SAS URI from IoT Hub
 * Upload the file to Azure storage
 * Notify IoT Hub that it completed the upload
 
-The [DeviceClient](/dotnet/api/microsoft.azure.devices.client.deviceclient) class contains methods that a device can use to upload files to IoT Hub.
-
 ### Connect to IoT Hub
 
-Supply the IoT Hub primary connection string to `DeviceClient` using the [CreateFromConnectionString](/dotnet/api/microsoft.azure.devices.client.deviceclient.createfromconnectionstring?#microsoft-azure-devices-client-deviceclient-createfromconnectionstring(system-string)) method. `AMQP` is the default transport protocol.
+Supply the IoT Hub primary connection string to [DeviceClient](/dotnet/api/microsoft.azure.devices.client.deviceclient) using the [CreateFromConnectionString](/dotnet/api/microsoft.azure.devices.client.deviceclient.createfromconnectionstring?#microsoft-azure-devices-client-deviceclient-createfromconnectionstring(system-string)) method. `AMQP` is the default transport protocol.
 
 ``` csharp
 static string connectionString = "{IoT Hub connection string}";
@@ -35,8 +38,6 @@ deviceClient = DeviceClient.CreateFromConnectionString(connectionString);
 
 Call [GetFileUploadSasUriAsync](/dotnet/api/microsoft.azure.devices.client.deviceclient.getfileuploadsasuriasync) to get a file upload SAS URI, which the Azure Storage SDK can use to upload a file to blob for this device.
 
-For example:
-
 ```csharp
 const string filePath = "TestPayload.txt";
 using var fileStreamSource = new FileStream(filePath, FileMode.Open);
@@ -54,11 +55,11 @@ Uri uploadUri = sasUri.GetBlobUri();
 
 Create a [blockBlobClient](/dotnet/api/azure.storage.blobs.specialized.blockblobclient) object, passing a file upload URI.
 
-Use the [UploadAsync](/dotnet/api/azure.storage.blobs.specialized.blockblobclient.uploadasync?#azure-storage-blobs-specialized-blockblobclient-uploadasync(system-io-stream-azure-storage-blobs-models-blobuploadoptions-system-threading-cancellationtoken)) method to upload a file to Azure storage, passing the SAS URI.
+Use the [UploadAsync](/dotnet/api/azure.storage.blobs.specialized.blockblobclient.uploadasync?#azure-storage-blobs-specialized-blockblobclient-uploadasync(system-io-stream-azure-storage-blobs-models-blobuploadoptions-system-threading-cancellationtoken)) method to upload a file to Blob Storage, passing the SAS URI.
 
-The Azure blob client always uses HTTPS as the protocol to upload the file Azure storage.
+The Azure Blob client always uses HTTPS as the protocol to upload the file to Azure Storage.
 
-In this example, `BlockBlobClient` is passed the SAS URI to create an Azure storage block blob client and uploads the file:
+In this example, `BlockBlobClient` is passed the SAS URI to create an Azure Storage block blob client and uploads the file:
 
 ```csharp
 var blockBlobClient = new BlockBlobClient(uploadUri);
@@ -110,9 +111,9 @@ static string connectionString = "{IoT Hub connection string}";
 serviceClient = ServiceClient.CreateFromConnectionString(connectionString);
 ```
 
-### Receive the file upload notification
+### Receive file upload notification in a backend application
 
-You can create a separate backend service to receive file upload notifications.
+You can create a separate backend application to receive file upload notifications.
 
 The [ServiceClient](/dotnet/api/microsoft.azure.devices.serviceclient) class contains methods that services can use to receive file upload notification.
 

includes/iot-hub-howto-file-upload-java.md

@@ -11,31 +11,34 @@ ms.date: 07/01/2024
 ms.custom: amqp, mqtt, devx-track-java, devx-track-extended-java
 ---
 
-## Upload a file from a device
+This how-to contains two sections:
 
-Follow this procedure for uploading a file from a device to IoT Hub:
+* Upload a file from a device application
+* Receive file upload notification in a backend application
+
+## Upload a file from a device application
+
+Follow this procedure to upload a file from a device to IoT Hub:
 
 * Connect to IoT Hub
 * Get a SAS URI from IoT Hub
 * Upload the file to Azure Storage
 * Send file upload status notification to IoT Hub
 
-The [DeviceClient](/java/api/com.microsoft.azure.sdk.iot.device.deviceclient) class contains methods that a device can use to upload files to IoT Hub.
-
 ### Connection protocol
 
-File upload operations always use HTTPS. `DeviceClient` can define the `IotHubClientProtocol` for other services like telemetry, device method, and device twin.
-
-For example:
+File upload operations always use HTTPS, but [DeviceClient](/java/api/com.microsoft.azure.sdk.iot.device.deviceclient) can define the [IotHubClientProtocol](/java/api/com.microsoft.azure.sdk.iot.device.iothubclientprotocol) for other services like telemetry, device method, and device twin.
 
 ```java
 IotHubClientProtocol protocol = IotHubClientProtocol.MQTT;
 ```
 
 ### Connect to IoT Hub
 
+Instantiate the DeviceClient to connect to IoT hub using the connection string and protocol parameters.
+
 ```java
-String connString = "Your device connection string here";
+String connString = "IoT hub connection string";
 DeviceClient client = new DeviceClient(connString, protocol);
 ```
 
@@ -45,10 +48,12 @@ Call [getFileUploadSasUri](/java/api/com.microsoft.azure.sdk.iot.device.devicecl
 
 `FileUploadSasUriResponse` includes these methods and return values. The return values can be passed to file upload methods.
 
-* `getCorrelationId())` - Correlation ID
-* `getContainerName())` - Container name
-* `getBlobName())` - Blob name
-* `getBlobUri())` - Blob URI
+| Method                | Return value   |
+| --------------------- | -------------- |
+| `getCorrelationId()`  | Correlation ID |
+| `getContainerName()`  | Container name |
+| `getBlobName()`       | Blob name      |
+| `getBlobUri()`        | Blob URI       |
 
 For example:
 
@@ -103,9 +108,9 @@ Free the `client` resources.
 client.closeNow();
 ```
 
-## Receive a file upload notification
+## Receive a file upload notification in a backend application
 
-You can create an application to receive file upload notifications.
+You can create a backend application to receive file upload notifications.
 
 The [ServiceClient](/java/api/com.azure.core.annotation.serviceclient) class contains methods that services can use to receive file upload notifications.
 
@@ -116,7 +121,7 @@ Create a `IotHubServiceClientProtocol` object. The connection uses the `AMQPS` p
 Call `createFromConnectionString` to connect to IoT hub.
 
 ```java
-private static final String connectionString = "{Your service connection string here}";
+private static final String connectionString = "{IoT hub service connection string}";
 private static final IotHubServiceClientProtocol protocol = IotHubServiceClientProtocol.AMQPS;
 ServiceClient sc = ServiceClient.createFromConnectionString(connectionString, protocol);
 ```

includes/iot-hub-howto-file-upload-node.md

@@ -11,25 +11,32 @@ ms.date: 07/01/2024
 ms.custom: mqtt, devx-track-js
 ---
 
+This how-to contains two sections:
+
+* Upload a file from a device application
+* Receive file upload notification in a backend application
+
 ## Upload a file from a device application
 
-### Install the Node.js packages
+### Install SDK packages
 
-Run these commands to install the **azure-iot-device** Device SDK, the **azure-iot-device-mqtt**, and the **@azure/storage-blob** packages: on your development machine:
+Run this command to install the **azure-iot-device** device SDK, the **azure-iot-device-mqtt**, and the **@azure/storage-blob** packages: on your development machine:
 
 ```cmd/sh
 npm install azure-iot-device azure-iot-device-mqtt @azure/storage-blob --save
 ```
 
-The [azure-iot-device](/javascript/api/azure-iot-device) package contains objects that interface with IoT devices. This article describes `Client` class code.
+The [azure-iot-device](/javascript/api/azure-iot-device) package contains objects that interface with IoT devices.
 
-## Receive messages in the device application
+Follow this procedure for uploading a file from a device to IoT Hub:
 
-This section describes how to upload a file from a device using the [azure-iot-device](/javascript/api/azure-iot-device) package in the Azure IoT SDK for Node.js.
+* Get Blob shared access signatures
+* Upload the file to Azure Storage
+* Send file upload status notification to IoT Hub
 
 ### Create modules
 
-Create Client, Protocol, errors, and path modules using the packages installed in the previous step.
+Create Client, Protocol, errors, and path modules using the installed packages.
 
 ```javascript
 const Client = require('azure-iot-device').Client;
@@ -38,27 +45,25 @@ const errors = require('azure-iot-common').errors;
 const path = require('path');
 ```
 
-### Get blob shared access signatures
+### Get a SAS URI from IoT Hub
 
-Use [getBlobSharedAccessSignature](/javascript/api/azure-iot-device/client?#azure-iot-device-client-getblobsharedaccesssignature) to get the linked storage account SAS Token from IoT Hub.
+Use [getBlobSharedAccessSignature](/javascript/api/azure-iot-device/client?#azure-iot-device-client-getblobsharedaccesssignature) to get the linked storage account SAS token from IoT Hub.
 
 For example:
 
 ```javascript
 // make sure you set these environment variables prior to running the sample.
-const deviceConnectionString = process.env.DEVICE_CONNECTION_STRING;
 const localFilePath = process.env.PATH_TO_FILE;
 const storageBlobName = path.basename(localFilePath);
-
 const blobInfo = await client.getBlobSharedAccessSignature(storageBlobName);
 if (!blobInfo) {
 throw new errors.ArgumentError('Invalid upload parameters');
 }
 ```
 
-### Upload the file to IoT Hub
+### Upload the file to IoT hub
 
-To upload a file to IoT Hub:
+To upload a file to IoT hub:
 
 1. Create a stream pipeline.
 2. Construct the blob URL.
@@ -112,13 +117,13 @@ console.log('uploadStreamToBlockBlob success');
     console.log(err);
   }
 
-// Notify the blob upload status
+// Send file upload status notification to IoT hub
 await client.notifyBlobUploadStatus(blobInfo.correlationId, isSuccess, statusCode, statusDescription);
 ```
 
-## Receive a file upload notification
+## Receive file upload notification in a backend application
 
-You can create a separate application to check the IoT Hub service client for device file upload notifications.
+You can create a backend application to check the IoT Hub service client for device file upload notifications.
 
 ### Connect to the IoT Hub service client
 
@@ -133,7 +138,8 @@ const serviceClient = Client.fromConnectionString(connectionString);
 ### Check for a file upload notification
 
 To check for file upload notifications:
-* [Open](/javascript/api/azure-iothub/client?#azure-iothub-client-open-1) the connection to IoT Hub
+
+* [Open](/javascript/api/azure-iothub/client?#azure-iothub-client-open-1) the connection to IoT hub.
 * Call [getFileNotificationReceiver](/javascript/api/azure-iothub/client?#azure-iothub-client-getfilenotificationreceiver). Supply the name of a file upload callback method that will be called when notification messages are received.
 * Process file upload notifications in the callback method.
 
@@ -170,4 +176,4 @@ serviceClient.open(function (err) {
 
 ### Sample
 
-The SDK include an [upload to blob advanced](https://github.com/Azure/azure-iot-sdk-node/blob/main/device/samples/javascript/upload_to_blob_advanced.js) sample.
+The SDK includes an [upload to blob advanced](https://github.com/Azure/azure-iot-sdk-node/blob/main/device/samples/javascript/upload_to_blob_advanced.js) sample.

includes/iot-hub-howto-file-upload-python.md

@@ -11,9 +11,9 @@ ms.date: 07/01/2024
 ms.custom: mqtt, devx-track-python, py-fresh-zinc
 ---
 
-## SDK libraries
+## Install device library
 
-The azure-iot-device SDK library must be installed before calling any related code.
+The azure-iot-device library must be installed before calling any related code.
 
 ```cmd/sh
 pip install azure-iot-device
@@ -27,13 +27,13 @@ pip install azure.storage.blob
 
 ## Upload file from a device application
 
-Follow this procedure for uploading a file from a device to IoT hub:
+Follow this procedure to upload a file from a device to IoT hub:
 
 * Connect the client to IoT hub and get storage information
-* Upload the file to BloB Storage
+* Upload the file to Blob Storage
 * Notify IoT hub of upload status
 
-### Import statements
+### Connect the client to IoT hub and get storage information
 
 The [IoTHubDeviceClient](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient) class contains methods that a device can use to upload a file to IoT Hub.
 
@@ -44,8 +44,6 @@ from azure.core.exceptions import AzureError
 from azure.storage.blob import BlobClient
 ```
 
-### Connect the client to IoT hub and get storage information
-
 Call [create_from_connection_string](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-create-from-connection-string) to connect to IoT hub.
 
 For example:
@@ -57,17 +55,13 @@ device_client = IoTHubDeviceClient.create_from_connection_string(CONNECTION_STRI
 
 Call [connect](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-connect) to connect the device client to an Azure IoT hub.
 
-For example:
-
 ```python
 # Connect the client
 device_client.connect()
 ```
 
 Call [get_storage_info_for_blob](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-get-storage-info-for-blob) to get information from an IoT hub about a linked Storage Account. This information includes the hostname, container name, blob name, and a SAS token. The storage info is passed to the `store_blob` function (created in the previous step), so that the `BlobClient` in that function can authenticate with Azure storage. The `get_storage_info_for_blob` method also returns a `correlation_id`, which is used in the notify_blob_upload_status method. The correlation_id is IoT Hub's way of marking which blob you're working on.
 
-For example:
-
 ```python
 # Get the storage info for the blob
 PATH_TO_FILE = "[Full path to local file]"