Integrated in review feedback

gsteve88 · gsteve88 · commit 48f3a2b0b7a7 · 2024-08-13T16:29:55.000-07:00
diff --git a/articles/iot-hub/how-to-file-upload.md b/articles/iot-hub/how-to-file-upload.md
@@ -16,8 +16,8 @@ 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.
-* Notify IoT Hub that the file was successfully uploaded and create a backend service to receive file upload notifications from IoT Hub.
+* Use file upload capabilities of IoT Hub to upload a file to Azure Blob Storage, 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, using the Azure IoT service SDKs.
 
 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. The file upload capabilities in IoT Hub enable you to move large or complex data to the cloud. For example:
 
@@ -33,21 +33,20 @@ This article is meant to complement runnable SDK samples that are referenced fro
 For more information, see:
 
 * [Overview of file uploads with IoT Hub](iot-hub-devguide-file-upload.md)
-* [Configure IoT Hub file uploads using the Azure portal](iot-hub-configure-file-upload.md)
 * [Introduction to Azure Blob Storage](../storage/blobs/storage-blobs-introduction.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)]
 
 ## Prerequisites
 
-* **An IoT hub**. Create one using the [Azure portal, CLI, or PowerShell](create-hub.md). Some SDK calls require the IoT Hub connection string, so make a note of the connection string.
+* **An IoT hub**. Some SDK calls require the IoT Hub primary connection string, so make a note of the connection string.
 
-* **A registered device**. Register one in the [Azure portal](create-connect-device.md).
+* **A registered device**. Some SDK calls require the device primary connection string, so make a note of the connection string.
 
-* IoT Hub **Service Connect**  permission - To receive file upload notification messages, your backend service needs the **Service Connect** permission. By default, every IoT Hub is created with a shared access policy named **service** that grants this permission. For more information, see [Connect to an IoT hub](/azure/iot-hub/create-hub?&tabs=portal#connect-to-an-iot-hub).
+* IoT Hub **Service Connect** permission - To receive file upload notification messages, your backend service needs the **Service Connect** permission. By default, every IoT Hub is created with a shared access policy named **service** that grants this permission. For more information, see [Connect to an IoT hub](/azure/iot-hub/create-hub?&tabs=portal#connect-to-an-iot-hub).
 
-* Configure file upload in your IoT hub by linking an **Azure Storage account** and **Azure Blob Storage container** associated with IoT Hub. You can configure these using the [Azure portal](/azure/iot-hub/iot-hub-configure-file-upload), [Azure CLI](/azure/iot-hub/iot-hub-configure-file-upload-cli), or [Azure PowerShell](/azure/iot-hub/iot-hub-configure-file-upload-powershell).
+* Configure file upload in your IoT hub by linking an **Azure Storage account** and **Azure Blob Storage container**. You can configure these using the [Azure portal](/azure/iot-hub/iot-hub-configure-file-upload), [Azure CLI](/azure/iot-hub/iot-hub-configure-file-upload-cli), or [Azure PowerShell](/azure/iot-hub/iot-hub-configure-file-upload-powershell).
 
 :::zone pivot="programming-language-csharp"
 
diff --git a/includes/iot-hub-howto-file-upload-dotnet.md b/includes/iot-hub-howto-file-upload-dotnet.md
@@ -24,14 +24,14 @@ This section describes how to upload a file from a device to an IoT hub using th
 
 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 of the file upload status
+1. Connect to IoT hub
+1. Get a SAS URI from IoT hub
+1. Upload the file to Azure storage
+1. Notify IoT hub of the file upload status
 
 ### Connect to the device
 
-Call [CreateFromConnectionString](/dotnet/api/microsoft.azure.devices.client.deviceclient.createfromconnectionstring?#microsoft-azure-devices-client-deviceclient-createfromconnectionstring(system-string)) to connect to the device. See the prerequisites section for how to look up the device primary connection string.
+Call [CreateFromConnectionString](/dotnet/api/microsoft.azure.devices.client.deviceclient.createfromconnectionstring?#microsoft-azure-devices-client-deviceclient-createfromconnectionstring(system-string)) to connect to the device. Pass the device primary connection string.
 
 `AMQP` is the default transport protocol.
 
@@ -61,9 +61,9 @@ Uri uploadUri = sasUri.GetBlobUri();
 
 To upload a file to Azure storage:
 
-* Create a [blockBlobClient](/dotnet/api/azure.storage.blobs.specialized.blockblobclient) object, passing a file upload URI
+1. 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 Blob Storage, passing the SAS URI. You can optionally add Blob upload options and cancellation token parameters.
+1. 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. You can optionally add Blob upload options and cancellation token parameters.
 
 The Azure Blob client always uses HTTPS as the protocol to upload the file to Azure Storage.
 
@@ -111,10 +111,10 @@ The [ServiceClient](/dotnet/api/microsoft.azure.devices.serviceclient) class con
 
 To receive file upload notification:
 
-* Call [CreateFromConnectionString](/dotnet/api/microsoft.azure.devices.serviceclient.createfromconnectionstring) to connect to IoT hub. Pass the IoT hub connection string. See the prerequisites section for how to look up the IoT hub primary connection string.
-* Create a [CancellationToken](/dotnet/api/azure.core.httpmessage.cancellationtoken?#azure-core-httpmessage-cancellationtoken).
-* Call [GetFileNotificationReceiver](/dotnet/api/microsoft.azure.devices.serviceclient.getfilenotificationreceiver?#microsoft-azure-devices-serviceclient-getfilenotificationreceiver) to create a notification receiver.
-* Use a loop with [ReceiveAsync](/dotnet/api/microsoft.azure.devices.receiver-1.receiveasync?#microsoft-azure-devices-receiver-1-receiveasync(system-threading-cancellationtoken)) to wait for the file upload notification.
+1. Call [CreateFromConnectionString](/dotnet/api/microsoft.azure.devices.serviceclient.createfromconnectionstring) to connect to IoT hub. Pass the IoT hub primary connection string.
+1. Create a [CancellationToken](/dotnet/api/azure.core.httpmessage.cancellationtoken?#azure-core-httpmessage-cancellationtoken).
+1. Call [GetFileNotificationReceiver](/dotnet/api/microsoft.azure.devices.serviceclient.getfilenotificationreceiver?#microsoft-azure-devices-serviceclient-getfilenotificationreceiver) to create a notification receiver.
+1. Use a loop with [ReceiveAsync](/dotnet/api/microsoft.azure.devices.receiver-1.receiveasync?#microsoft-azure-devices-receiver-1-receiveasync(system-threading-cancellationtoken)) to wait for the file upload notification.
 
 For example:
 
diff --git a/includes/iot-hub-howto-file-upload-java.md b/includes/iot-hub-howto-file-upload-java.md
@@ -24,10 +24,10 @@ This section describes how to upload a file from a device to an IoT hub using th
 
 Follow this procedure to upload a file from a device to IoT hub:
 
-* Connect to the device
-* Get a SAS URI from IoT hub
-* Upload the file to Azure Storage
-* Send file upload status notification to IoT hub
+1. Connect to the device
+1. Get a SAS URI from IoT hub
+1. Upload the file to Azure Storage
+1. Send file upload status notification to IoT hub
 
 ### Connection protocol
 
@@ -39,7 +39,7 @@ IotHubClientProtocol protocol = IotHubClientProtocol.MQTT;
 
 ### Connect to the device
 
-Instantiate the `DeviceClient` to connect to the device using the device primary connection string. See the prerequisites section for how to look up the device primary connection string.
+Instantiate the `DeviceClient` to connect to the device using the device primary connection string.
 
 ```java
 String connString = "{IoT hub connection string}";
@@ -118,16 +118,16 @@ You can create a backend application to receive file upload notifications.
 
 To create a file upload notification application:
 
-* Connect to the IoT hub service client
-* Check for a file upload notification
+1. Connect to the IoT hub service client
+1. Check for a file upload notification
 
 The [ServiceClient](/java/api/com.azure.core.annotation.serviceclient) class contains methods that services can use to receive file upload notifications.
 
 ### Connect to the IoT hub service client
 
 Create a `IotHubServiceClientProtocol` object. The connection uses the `AMQPS` protocol.
 
-Call `createFromConnectionString` to connect to IoT hub. Pass the IoT hub primary connection string. See the prerequisites section for how to look up the IoT hub primary connection string.
+Call `createFromConnectionString` to connect to IoT hub. Pass the IoT hub primary connection string.
 
 ```java
 private static final String connectionString = "{IoT hub primary connection string}";
@@ -139,9 +139,9 @@ ServiceClient sc = ServiceClient.createFromConnectionString(connectionString, pr
 
 To check for file upload status:
 
-* Create a [getFileUploadNotificationReceiver](/java/api/com.microsoft.azure.sdk.iot.service.fileuploadnotificationreceiver) object
-* Use [open](/java/api/com.microsoft.azure.sdk.iot.service.fileuploadnotificationreceiver?#com-microsoft-azure-sdk-iot-service-fileuploadnotificationreceiver-open()) to connect to IoT hub
-* Call [receive](/java/api/com.microsoft.azure.sdk.iot.service.fileuploadnotificationreceiver?#com-microsoft-azure-sdk-iot-service-fileuploadnotificationreceiver-receive()) to check for the file upload status. This method returns a [fileUploadNotification](/java/api/com.microsoft.azure.sdk.iot.service.fileuploadnotification) object. If an upload notice is received, you can view upload status fields using [fileUploadNotification](/java/api/com.microsoft.azure.sdk.iot.service.fileuploadnotification) methods.
+1. Create a [getFileUploadNotificationReceiver](/java/api/com.microsoft.azure.sdk.iot.service.fileuploadnotificationreceiver) object
+1. Use [open](/java/api/com.microsoft.azure.sdk.iot.service.fileuploadnotificationreceiver?#com-microsoft-azure-sdk-iot-service-fileuploadnotificationreceiver-open()) to connect to IoT hub
+1. Call [receive](/java/api/com.microsoft.azure.sdk.iot.service.fileuploadnotificationreceiver?#com-microsoft-azure-sdk-iot-service-fileuploadnotificationreceiver-receive()) to check for the file upload status. This method returns a [fileUploadNotification](/java/api/com.microsoft.azure.sdk.iot.service.fileuploadnotification) object. If an upload notice is received, you can view upload status fields using [fileUploadNotification](/java/api/com.microsoft.azure.sdk.iot.service.fileuploadnotification) methods.
 
 For example:
 
diff --git a/includes/iot-hub-howto-file-upload-node.md b/includes/iot-hub-howto-file-upload-node.md
@@ -34,9 +34,9 @@ The [azure-iot-device](/javascript/api/azure-iot-device) package contains object
 
 Follow this procedure for uploading a file from a device to IoT hub:
 
-* Get Blob shared access signatures
-* Upload the file to Azure Storage
-* Send file upload status notification to IoT hub
+1. Get Blob shared access signatures
+1. Upload the file to Azure Storage
+1. Send file upload status notification to IoT hub
 
 ### Create modules
 
@@ -131,18 +131,18 @@ You can create a backend application to check the IoT hub service client for dev
 
 To create a file upload notification application:
 
-* Connect to the IoT hub service client
-* Check for a file upload notification
+1. Connect to the IoT hub service client
+1. Check for a file upload notification
 
 ### Connect to the IoT hub service client
 
 The [ServiceClient](/javascript/api/azure-iothub/client) class contains methods that services can use to receive file upload notifications.
 
-Connect to IoT hub using [fromConnectionString](/javascript/api/azure-iothub/client?#azure-iothub-client-fromconnectionstring). See the prerequisites section for how to look up the IoT hub primary connection string.
+Connect to IoT hub using [fromConnectionString](/javascript/api/azure-iothub/client?#azure-iothub-client-fromconnectionstring). Pass the IoT hub primary connection string.
 
 ```javascript
 const Client = require('azure-iothub').Client;
-const connectionString = "{IoT hub connection string}";
+const connectionString = "{IoT hub primary connection string}";
 const serviceClient = Client.fromConnectionString(connectionString);
 ```
 
@@ -161,8 +161,8 @@ serviceClient.open(function (err) {
 
 To check for file upload notifications:
 
-* Call [getFileNotificationReceiver](/javascript/api/azure-iothub/client?#azure-iothub-client-getfilenotificationreceiver). Supply the name of a file upload callback method that are called when notification messages are received.
-* Process file upload notifications in the callback method.
+1. Call [getFileNotificationReceiver](/javascript/api/azure-iothub/client?#azure-iothub-client-getfilenotificationreceiver). Supply the name of a file upload callback method that are called when notification messages are received.
+1. Process file upload notifications in the callback method.
 
 This example sets up a `receiveFileUploadNotification` notification  callback receiver. The receiver interprets the file upload status information and prints a status message to the console.
 
diff --git a/includes/iot-hub-howto-file-upload-python.md b/includes/iot-hub-howto-file-upload-python.md
@@ -31,10 +31,10 @@ This section describes how to upload a file from a device to an IoT hub using th
 
 Follow this procedure to upload a file from a device to IoT hub:
 
-* Connect to the device
-* Get Blob Storage information
-* Upload the file to Blob Storage
-* Notify IoT hub of upload status
+1. Connect to the device
+1. Get Blob Storage information
+1. Upload the file to Blob Storage
+1. Notify IoT hub of upload status
 
 ### Import libraries
 
@@ -47,9 +47,11 @@ from azure.storage.blob import BlobClient
 
 ### Connect to the device
 
-Call [create_from_connection_string](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-create-from-connection-string) to add the device primary connection string. See the prerequisites section for how to look up the device primary connection string.
+To connect to the device:
 
-Then call [connect](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-connect) to connect the device client.
+1. Call [create_from_connection_string](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-create-from-connection-string) to add the device primary connection string.
+
+1. Call [connect](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-connect) to connect the device client.
 
 For example:
 
@@ -77,8 +79,8 @@ blob_info = device_client.get_storage_info_for_blob(blob_name)
 
 To upload a file into Blob Storage:
 
-* Use [from_blob_url](/python/api/azure-storage-blob/azure.storage.blob.blobclient?#azure-storage-blob-blobclient-from-blob-url) to create a [BlobClient](/python/api/azure-storage-blob/azure.storage.blob.blobclient?#azure-storage-blob-blobclient-from-blob-url) object from a blob URL.
-* Call [upload_blob](/python/api/azure-storage-blob/azure.storage.blob.blobclient?#azure-storage-blob-blobclient-upload-blob) to upload the file into the Blob Storage.
+1. Use [from_blob_url](/python/api/azure-storage-blob/azure.storage.blob.blobclient?#azure-storage-blob-blobclient-from-blob-url) to create a [BlobClient](/python/api/azure-storage-blob/azure.storage.blob.blobclient?#azure-storage-blob-blobclient-from-blob-url) object from a blob URL.
+1. Call [upload_blob](/python/api/azure-storage-blob/azure.storage.blob.blobclient?#azure-storage-blob-blobclient-upload-blob) to upload the file into the Blob Storage.
 
 This example parses the `blob_info` structure to create a URL that it uses to initialize an [BlobClient](/python/api/azure-storage-blob/azure.storage.blob.blobclient). Then it calls `upload_blob` to upload the file into Blob Storage.
 
