Metadata and filename refresh -- file upload

kgremban · kgremban · commit ef27282834ef · 2023-03-15T13:51:10.000-07:00
diff --git a/articles/iot-hub/.openpublishing.redirection.iot-hub.json b/articles/iot-hub/.openpublishing.redirection.iot-hub.json
@@ -105,6 +105,26 @@
       "redirect_url": "/azure/iot-hub/c2d-messaging-ios",
       "redirect_document_id": true
     },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-java-java-file-upload.md",
+      "redirect_url": "/azure/iot-hub/file-upload-java",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-python-python-file-upload.md",
+      "redirect_url": "/azure/iot-hub/file-upload-python",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-node-node-file-upload.md",
+      "redirect_url": "/azure/iot-hub/file-upload-node",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-csharp-csharp-file-upload.md",
+      "redirect_url": "/azure/iot-hub/file-upload-dotnet",
+      "redirect_document_id": true
+    },
     {
       "source_path_from_root": "/articles/iot-hub/iot-hub-devguide-glossary.md",
       "redirect_url": "/azure/iot-fundamentals/iot-glossary/",
diff --git a/articles/iot-hub/TOC.yml b/articles/iot-hub/TOC.yml
@@ -327,17 +327,17 @@
         - name: Upload files from devices
           items:
             - name: .NET
-              displayName: Azure Storage, file upload
-              href: iot-hub-csharp-csharp-file-upload.md
+              displayName: file upload, upload files, csharp, C#
+              href: file-upload-dotnet.md
             - name: Python
-              displayName: Azure Storage, file upload
-              href: iot-hub-python-python-file-upload.md
+              displayName: file upload, upload files
+              href: file-upload-python.md
             - name: Node.js
-              displayName: Azure Storage, file upload
-              href: iot-hub-node-node-file-upload.md
+              displayName: file upload, upload files
+              href: file-upload-node.md
             - name: Java
-              displayName: Azure Storage, file upload
-              href: iot-hub-java-java-file-upload.md
+              displayName: file upload, upload files
+              href: file-upload-java.md
         - name: Get started with device twins
           items:
             - name: CLI
diff --git a/articles/iot-hub/c2d-messaging-node.md b/articles/iot-hub/c2d-messaging-node.md
@@ -6,7 +6,7 @@ author: kgremban
 
 ms.author: kgremban
 ms.service: iot-hub
-ms.devlang: javascript
+ms.devlang: nodejs
 ms.topic: how-to
 ms.date: 06/16/2017
 ms.custom: [amqp, mqtt, devx-track-js]
diff --git a/articles/iot-hub/file-upload-dotnet.md b/articles/iot-hub/file-upload-dotnet.md
@@ -1,22 +1,22 @@
 ---
-title: Upload files from devices to Azure IoT Hub with .NET | Microsoft Docs
+title: Upload files from devices to Azure IoT Hub (.NET)
+titleSuffix: Azure IoT Hub
 description: How to upload files from a device to the cloud using Azure IoT device SDK for .NET. Uploaded files are stored in an Azure storage blob container.
 author: kgremban
 
+ms.author: kgremban
 ms.service: iot-hub
-services: iot-hub
 ms.devlang: csharp
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 08/24/2021
-ms.author: kgremban
 ms.custom: "mqtt, devx-track-csharp"
 ---
 
-# Upload files from your device to the cloud with IoT Hub (.NET)
+# Upload files from your device to the cloud with Azure IoT Hub (.NET)
 
 [!INCLUDE [iot-hub-file-upload-language-selector](../../includes/iot-hub-file-upload-language-selector.md)]
 
-This article demonstrates how to [file upload capabilities of IoT Hub](iot-hub-devguide-file-upload.md) upload a file to [Azure blob storage](../storage/index.yml), using an Azure IoT .NET device and service SDKs. 
+This article demonstrates how to [file upload capabilities of IoT Hub](iot-hub-devguide-file-upload.md) upload a file to [Azure blob storage](../storage/index.yml), using an Azure IoT .NET device and service SDKs.
 
 The [Send telemetry from a device to an IoT hub](../iot-develop/quickstart-send-telemetry-iot-hub.md?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:
 
@@ -29,9 +29,9 @@ These files are typically batch processed in the cloud, using tools such as [Azu
 
 At the end of this article, you run two .NET console apps:
 
-* **FileUploadSample**. This device app uploads a file to storage using a SAS URI provided by your IoT hub. You'll run this app from the Azure IoT C# SDK repository that you download in the prerequisites.
+* **FileUploadSample**. This device app uploads a file to storage using a SAS URI provided by your IoT hub. This sample is from the Azure IoT C# SDK repository that you download in the prerequisites.
 
-* **ReadFileUploadNotification**. This service app receives file upload notifications from your IoT hub. You'll create this app.
+* **ReadFileUploadNotification**. This service app receives file upload notifications from your IoT hub. You create this app.
 
 > [!NOTE]
 > IoT Hub supports many device platforms and languages (including C, Java, Python, and JavaScript) through Azure IoT device SDKs. Refer to the [Azure IoT Developer Center](https://azure.microsoft.com/develop/iot) to learn how to connect your device to Azure IoT Hub.
@@ -89,7 +89,7 @@ Examine the code in **FileUpLoadSample.cs**. This file contains the main sample
     await blockBlobClient.UploadAsync(fileStreamSource, new BlobUploadOptions());
     ```
 
-1. The code notifies the IoT hub that it has completed the upload. This tells the IoT hub that it can release resources associated with the upload (the SAS URI). If file upload notifications are enabled, the IoT hub will send a notification message to backend services.
+1. The code notifies the IoT hub that it has completed the upload. This tells the IoT hub that it can release resources associated with the upload (the SAS URI). If file upload notifications are enabled, the IoT hub sends a notification message to backend services.
 
     ```csharp
     var successfulFileUploadCompletionNotification = new FileUploadCompletionNotification
@@ -110,11 +110,11 @@ Examine the code in **FileUpLoadSample.cs**. This file contains the main sample
     await _deviceClient.CompleteFileUploadAsync(successfulFileUploadCompletionNotification);
     ```
 
-If you examine the **parameter.cs** file, you'll see that:
+If you examine the **parameter.cs** file, you see that:
 
 - The sample requires you to pass a parameter, *p*, which takes a device connection string. 
 
-- By default, the device sample uses the MQTT protocol to communicate with IoT Hub. You can use the parameter *t* to change this transport protocol. Be aware that, regardless of this selection, the Azure blob client always uses HTTPS as the protocol to upload the file Azure storage.
+- By default, the device sample uses the MQTT protocol to communicate with IoT Hub. You can use the parameter *t* to change this transport protocol. Regardless of this selection, the Azure blob client always uses HTTPS as the protocol to upload the file Azure storage.
 
 ## Get the IoT hub connection string
 
diff --git a/articles/iot-hub/file-upload-java.md b/articles/iot-hub/file-upload-java.md
@@ -1,18 +1,18 @@
 ---
-title: Upload files from devices to Azure IoT Hub with Java | Microsoft Docs
+title: Upload files from devices to Azure IoT Hub (Java)
+titleSuffix: Azure IoT Hub
 description: How to upload files from a device to the cloud using Azure IoT device SDK for Java. Uploaded files are stored in an Azure storage blob container.
 author: kgremban
 
 ms.author: kgremban
 ms.service: iot-hub
-services: iot-hub
 ms.devlang: java
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 07/18/2021
 ms.custom: [amqp, mqtt, devx-track-java]
 ---
 
-# Upload files from your device to the cloud with IoT Hub (Java)
+# Upload files from your device to the cloud with Azure IoT Hub (Java)
 
 [!INCLUDE [iot-hub-file-upload-language-selector](../../includes/iot-hub-file-upload-language-selector.md)]
 
@@ -291,7 +291,7 @@ mvn exec:java -Dexec.mainClass="com.mycompany.app.App"
 
 You can use the portal to view the uploaded file in the storage container you configured:
 
-:::image type="content" source="media/iot-hub-java-java-upload/uploaded-file.png" alt-text="Screenshot showing a file that had been uploaded to your storage container." lightbox="media/iot-hub-java-java-upload/uploaded-file.png":::
+:::image type="content" source="media/iot-hub-java-java-upload/uploaded-file.png" alt-text="Screenshot showing a file that was uploaded to your storage container." lightbox="media/iot-hub-java-java-upload/uploaded-file.png":::
 
 ## Receive a file upload notification
 
@@ -458,7 +458,7 @@ In this section, you create a Java console app that receives file upload notific
     ```
 ## Run the application
 
-Now you are ready to run the application.
+Now you're ready to run the application.
 
 At a command prompt in the `my-app` folder, run the following command:
 
diff --git a/articles/iot-hub/file-upload-node.md b/articles/iot-hub/file-upload-node.md
@@ -1,18 +1,18 @@
 ---
-title: Upload files from devices to Azure IoT Hub with Node | Microsoft Docs
+title: Upload files from devices to Azure IoT Hub (Node)
+titleSuffix: Azure IoT Hub
 description: How to upload files from a device to the cloud using Azure IoT device SDK for Node.js. Uploaded files are stored in an Azure storage blob container.
 author: kgremban
 
 ms.author: kgremban
 ms.service: iot-hub
-services: iot-hub
-ms.devlang: javascript
-ms.topic: conceptual
+ms.devlang: nodejs
+ms.topic: how-to
 ms.date: 07/27/2021
 ms.custom: mqtt, devx-track-js
 ---
 
-# Upload files from your device to the cloud with IoT Hub (Node.js)
+# Upload files from your device to the cloud with Azure IoT Hub (Node.js)
 
 This article demonstrates how to [file upload capabilities of IoT Hub](iot-hub-devguide-file-upload.md) upload a file to [Azure blob storage](../storage/index.yml), using Node.js.
 
diff --git a/articles/iot-hub/file-upload-python.md b/articles/iot-hub/file-upload-python.md
@@ -1,17 +1,18 @@
 ---
-title: Upload files from devices to Azure IoT Hub with Python | Microsoft Docs
+title: Upload files from devices to Azure IoT Hub (Python)
+titleSuffix: Azure IoT Hub
 description: How to upload files from a device to the cloud using Azure IoT device SDK for Python. Uploaded files are stored in an Azure storage blob container.
 author: kgremban
+
+ms.author: kgremban
 ms.service: iot-hub
-services: iot-hub
 ms.devlang: python
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 12/28/2022
-ms.author: kgremban
 ms.custom: mqtt, devx-track-python, py-fresh-zinc
 ---
 
-# Upload files from your device to the cloud with IoT Hub (Python)
+# Upload files from your device to the cloud with Azure IoT Hub (Python)
 
 [!INCLUDE [iot-hub-file-upload-language-selector](../../includes/iot-hub-file-upload-language-selector.md)]
 
diff --git a/articles/iot-hub/iot-hub-configure-file-upload-cli.md b/articles/iot-hub/iot-hub-configure-file-upload-cli.md
@@ -223,5 +223,5 @@ az iot hub update --name {your iot hub name} \
 
 * [Upload files from a device overview](iot-hub-devguide-file-upload.md)
 * [IoT Hub support for managed identities](./iot-hub-managed-identity.md)
-* [File upload how-to guides](./iot-hub-csharp-csharp-file-upload.md)
+* [File upload how-to guides](./file-upload-dotnet.md)
 * Azure CLI [az iot hub update](/cli/azure/iot/hub#az-iot-hub-update), [az iot hub identity show](/cli/azure/iot/hub/identity#az-iot-hub-identity-show), and [az iot hub create](/cli/azure/iot/hub#az-iot-hub-create) commands
diff --git a/articles/iot-hub/iot-hub-configure-file-upload-powershell.md b/articles/iot-hub/iot-hub-configure-file-upload-powershell.md
@@ -139,4 +139,4 @@ Set-AzIotHub `
 
 * [Upload files from a device overview](iot-hub-devguide-file-upload.md)
 * [IoT Hub support for managed identities](./iot-hub-managed-identity.md)
-* [File upload how-to guides](./iot-hub-csharp-csharp-file-upload.md)
+* [File upload how-to guides](./file-upload-dotnet.md)
diff --git a/articles/iot-hub/iot-hub-configure-file-upload.md b/articles/iot-hub/iot-hub-configure-file-upload.md
@@ -55,4 +55,4 @@ To use the [file upload functionality in IoT Hub](iot-hub-devguide-file-upload.m
 
 * [Upload files from a device overview](iot-hub-devguide-file-upload.md)
 * [IoT Hub support for managed identities](./iot-hub-managed-identity.md)
-* [File upload how-to guides](./iot-hub-csharp-csharp-file-upload.md)
+* [File upload how-to guides](./file-upload-dotnet.md)
diff --git a/articles/iot-hub/iot-hub-devguide-file-upload.md b/articles/iot-hub/iot-hub-devguide-file-upload.md
@@ -89,10 +89,10 @@ The following how-to guides provide complete, step-by-step instructions to uploa
 
 | How-to guide | Device SDK example | Service SDK example |
 |---------|--------|---------|
-| [.NET](iot-hub-csharp-csharp-file-upload.md) | Yes | Yes |
-| [Java](iot-hub-java-java-file-upload.md) | Yes | Yes |
-| [Node.js](iot-hub-node-node-file-upload.md) | Yes | Yes |
-| [Python](iot-hub-python-python-file-upload.md) | Yes | No (not supported) |
+| [.NET](./file-upload-dotnet.md) | Yes | Yes |
+| [Java](./file-upload-java.md) | Yes | Yes |
+| [Node.js](./file-upload-node.md) | Yes | Yes |
+| [Python](./file-upload-python.md) | Yes | No (not supported) |
 
 > [!NOTE]
 > The C device SDK uses a single call on the device client to perform file uploads. For more information, see [IoTHubDeviceClient_UploadToBlobAsync()](https://github.com/Azure/azure-iot-sdk-c/blob/main/iothub_client/inc/iothub_device_client.h#L328) and [IoTHubDeviceClient_UploadMultipleBlocksToBlobAsync()](https://github.com/Azure/azure-iot-sdk-c/blob/main/iothub_client/inc/iothub_device_client.h#L350). These functions perform all aspects of the file upload in a single call: initiating the upload, uploading the file to Azure storage, and notifying IoT Hub when it completes. This interaction means that, in addition to whatever protocol the device is using to communicate with IoT Hub, the device also needs to be able to communicate over HTTPS with Azure storage as these functions make calls to the Azure storage APIs.
@@ -236,7 +236,7 @@ Services can use notifications to manage uploads. For example, they can trigger
 
 ## Next steps
 
-* [File upload how-to guides](iot-hub-csharp-csharp-file-upload.md)
+* [File upload how-to guides](./file-upload-dotnet.md)
 
 * [How to configure file uploads on IoT Hub](iot-hub-configure-file-upload.md)
 
