Edits

Author: gsteve88

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

@@ -20,23 +20,23 @@ This how-to contains two sections:
 
 ## Upload a file from a device application
 
-Follow this procedure to upload 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
+* 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
 
-### Connect to IoT Hub
+### Connect to IoT hub
 
-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.
+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 primary connection string}";
+static string connectionString = "{IoT hub primary connection string}";
 deviceClient = DeviceClient.CreateFromConnectionString(connectionString);
 ```
 
-### Get a SAS URI from IoT Hub
+### Get a SAS URI from IoT hub
 
 Call [GetFileUploadSasUriAsync](/dotnet/api/microsoft.azure.devices.client.deviceclient.getfileuploadsasuriasync) to get a file upload details. The SAS URI is used in the next step to upload a file from a device to Blob Storage.
 
@@ -72,9 +72,9 @@ await blockBlobClient.UploadAsync(fileStreamSource, new BlobUploadOptions());
 
 ### Notify IoT hub of the file upload status
 
-Use [CompleteFileUploadAsync](/dotnet/api/microsoft.azure.devices.client.deviceclient.completefileuploadasync) to notify IoT Hub that the device client completed the upload, passing a [FileUploadCompletionNotification](/dotnet/api/microsoft.azure.devices.client.transport.fileuploadcompletionnotification) object. The `IsSuccess` flag indicates whether or not the upload was successful. After being notified, IoT Hub will release resources associated with the upload (the SAS URI).
+Use [CompleteFileUploadAsync](/dotnet/api/microsoft.azure.devices.client.deviceclient.completefileuploadasync) to notify IoT hub that the device client completed the upload, passing a [FileUploadCompletionNotification](/dotnet/api/microsoft.azure.devices.client.transport.fileuploadcompletionnotification) object. The `IsSuccess` flag indicates whether or not the upload was successful. After being notified, IoT hub will release resources associated with the upload (the SAS URI).
 
-If file upload notifications are enabled, IoT Hub sends a file upload notification message to backend services that are configured for file upload notification.
+If file upload notifications are enabled, IoT hub sends a file upload notification message to backend services that are configured for file upload notification.
 
 ```csharp
 var successfulFileUploadCompletionNotification = new FileUploadCompletionNotification
@@ -97,7 +97,7 @@ await _deviceClient.CompleteFileUploadAsync(successfulFileUploadCompletionNotifi
 
 ## Receive a file upload notification in a backend application
 
-You can create a backend service to receive file upload notification messages from IoT Hub.
+You can create a backend service to receive file upload notification messages from IoT hub.
 
 The [ServiceClient](/dotnet/api/microsoft.azure.devices.serviceclient) class contains methods that services can use to receive file upload notifications.
 
@@ -110,7 +110,7 @@ To receive file upload notification:
 ```csharp
 using Microsoft.Azure.Devices;
 static ServiceClient serviceClient;
-static string connectionString = "{IoT Hub connection string}";
+static string connectionString = "{IoT hub connection string}";
 serviceClient = ServiceClient.CreateFromConnectionString(connectionString);
 
 // Define the cancellation token

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

@@ -20,12 +20,12 @@ This how-to contains two sections:
 
 ## Upload a file from a device application
 
-Follow this procedure to upload 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
+* 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
+* Send file upload status notification to IoT hub
 
 ### Connection protocol
 
@@ -35,16 +35,16 @@ File upload operations always use HTTPS, but [DeviceClient](/java/api/com.micros
 IotHubClientProtocol protocol = IotHubClientProtocol.MQTT;
 ```
 
-### Connect to IoT Hub
+### Connect to IoT hub
 
-Instantiate the DeviceClient to connect to IoT hub using the Iot hub primary connection string and protocol parameters.
+Instantiate the `DeviceClient` to connect to IoT hub using the IoT hub primary connection string and protocol parameters.
 
 ```java
 String connString = "{IoT hub connection string}";
 DeviceClient client = new DeviceClient(connString, protocol);
 ```
 
-### Get a SAS URI from Iot Hub
+### Get a SAS URI from IoT hub
 
 Call [getFileUploadSasUri](/java/api/com.microsoft.azure.sdk.iot.device.deviceclient?#com-microsoft-azure-sdk-iot-device-deviceclient-getfileuploadsasuri(com-microsoft-azure-sdk-iot-deps-serializer-fileuploadsasurirequest)) to obtain a [FileUploadSasUriResponse](/java/api/com.microsoft.azure.sdk.iot.deps.serializer.fileuploadsasuriresponse) object.
 
@@ -62,7 +62,7 @@ For example:
 ```java
 FileUploadSasUriResponse sasUriResponse = client.getFileUploadSasUri(new FileUploadSasUriRequest(file.getName()));
 
-System.out.println("Successfully got SAS URI from IoT Hub");
+System.out.println("Successfully got SAS URI from IoT hub");
 System.out.println("Correlation Id: " + sasUriResponse.getCorrelationId());
 System.out.println("Container name: " + sasUriResponse.getContainerName());
 System.out.println("Blob name: " + sasUriResponse.getBlobName());
@@ -87,13 +87,13 @@ String fullFileName = "Path of the file to upload";
 blobClient.uploadFromFile(fullFileName);
 ```
 
-## Send file upload status notification to IoT Hub
+## Send file upload status notification to IoT hub
 
 Send an upload status notification to IoT hub after a file upload attempt.
 
 Create a [FileUploadCompletionNotification](/java/api/com.microsoft.azure.sdk.iot.deps.serializer.fileuploadcompletionnotification?#com-microsoft-azure-sdk-iot-deps-serializer-fileuploadcompletionnotification-fileuploadcompletionnotification(java-lang-string-java-lang-boolean)) object. Pass the `correlationId` and `isSuccess` file upload success status. Pass an `isSuccess` `true` value when file upload was successful, `false` when not.
 
-`FileUploadCompletionNotification` must be called even when the file upload fails. IoT Hub has a fixed number of SAS URI allowed to be active at any given time. Once you're done with the file upload, you should free your SAS URI so that other SAS URI can be generated. If a SAS URI isn't freed through this API, then it frees itself eventually based on how long SAS URI are configured to live on an IoT Hub.
+`FileUploadCompletionNotification` must be called even when the file upload fails. IoT hub has a fixed number of SAS URI allowed to be active at any given time. Once you're done with the file upload, you should free your SAS URI so that other SAS URI can be generated. If a SAS URI isn't freed through this API, then it frees itself eventually based on how long SAS URI are configured to live on an IoT hub.
 
 This example passes a successful status.
 
@@ -116,7 +116,7 @@ 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
+* Connect to the IoT hub service client
 * 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.
@@ -138,7 +138,7 @@ 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
+* 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.
 
 For example:

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

@@ -30,11 +30,11 @@ 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.
 
-Follow this procedure for uploading a file from a device to IoT Hub:
+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
+* Send file upload status notification to IoT hub
 
 ### Create modules
 
@@ -47,9 +47,9 @@ const errors = require('azure-iot-common').errors;
 const path = require('path');
 ```
 
-### Get a SAS URI from IoT Hub
+### 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:
 
@@ -71,7 +71,7 @@ To upload a file from a device to IoT hub:
 2. Construct the blob URL
 3. Create a [BlockBlobClient](/javascript/api/@azure/storage-blob/blockblobclient) for file upload to Blob Storage
 4. Call [uploadFile](/javascript/api/@azure/storage-blob/blockblobclient?#@azure-storage-blob-blockblobclient-uploadfile) to upload the file to Blob Storage
-5. Call [notifyBlobUploadStatus](/javascript/api/azure-iot-device/client?#azure-iot-device-client-notifyblobuploadstatus) to notify IoT Hub that the upload succeeded or failed
+5. Call [notifyBlobUploadStatus](/javascript/api/azure-iot-device/client?#azure-iot-device-client-notifyblobuploadstatus) to notify IoT hub that the upload succeeded or failed
 
 For example:
 
@@ -107,7 +107,7 @@ console.log('uploadStreamToBlockBlob success');
     statusCode = uploadStatus._response.status;
     statusDescription = uploadStatus._response.bodyAsText;
 
-    // Notify IoT Hub of upload to blob status (success)
+    // Notify IoT hub of upload to blob status (success)
     console.log('notifyBlobUploadStatus success');
   }
   catch (err) {
@@ -125,7 +125,7 @@ await client.notifyBlobUploadStatus(blobInfo.correlationId, isSuccess, statusCod
 
 ## Receive file upload notification in a backend application
 
-You can create a backend 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.
 
 To create a file upload notification application:
 

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

@@ -96,7 +96,7 @@ try:
             return (True, result)
 
 except FileNotFoundError as ex:
-    # catch file not found and add an HTTP status code to return in notification to IoT Hub
+    # catch file not found and add an HTTP status code to return in notification to IoT hub
     ex.status_code = 404
     return (False, ex)
 
@@ -107,7 +107,7 @@ except AzureError as ex:
 
 ### Notify IoT hub of upload status
 
-Use [notify_blob_upload_status](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-notify-blob-upload-status) to notify IoT hub of the status of the Blob Storage operation. Pass the `correlation_id` obtained by the `get_storage_info_for_blob` method. The `correlation_id` is used by IoT Hub to notify any service that might be listening for a notification regarding the status of the file upload task.
+Use [notify_blob_upload_status](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-notify-blob-upload-status) to notify IoT hub of the status of the Blob Storage operation. Pass the `correlation_id` obtained by the `get_storage_info_for_blob` method. The `correlation_id` is used by IoT hub to notify any service that might be listening for a notification regarding the status of the file upload task.
 
 This example notifies IoT hub of a successful file upload: