Skip to content

Commit 77acdc6

Browse files
committed
Address build blocking issues
1 parent 519e55d commit 77acdc6

2 files changed

Lines changed: 15 additions & 15 deletions

File tree

articles/azure-functions/functions-bindings-event-iot-trigger.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -14,24 +14,24 @@ This article explains how to work with Azure Functions bindings for IoT Hub. The
1414
For information on setup and configuration details, see the [overview](functions-bindings-event-iot.md).
1515

1616
> [!IMPORTANT]
17-
> While the following code samples use the Event Hub API, the given syntax is applicable for IoT Hub functions.
17+
> While the following code samples use the Event Hubs API, the given syntax is applicable for IoT Hub functions.
1818
1919
[!INCLUDE [functions-bindings-event-hubs](../../includes/functions-bindings-event-hubs-trigger.md)]
2020

2121
## Connections
2222

23-
The `connection` property is a reference to environment configuration that contains name of an application setting containing a connection string. You can get this connection string by selecting the **Connection Information** button for the [namespace](../event-hubs/event-hubs-create.md#create-an-event-hubs-namespace). The connection string must be for an Event Hubs namespace, not the event hub itself.
23+
The `connection` property references environment configuration that contains the name of an application setting with a connection string. You get this connection string by selecting the **Connection Information** button for the [namespace](../event-hubs/event-hubs-create.md#create-an-event-hubs-namespace). The connection string must be for an Event Hubs namespace, not the event hub itself.
2424

25-
The connection string must have at least "read" permissions to activate the function.
25+
The connection string must have at least **read** permissions to activate the function.
2626

27-
This connection string should be stored in an application setting with a name matching the value specified by the `connection` property of the binding configuration.
27+
Store this connection string in an application setting with a name that matches the value you specify in the `connection` property of the binding configuration.
2828

2929
> [!NOTE]
30-
> Identity-based connections aren't supported by the IoT Hub trigger. If you need to use managed identities end-to-end, you can instead use IoT Hub Routing to send data to an event hub you control. In that way, outbound routing can be authenticated with managed identity the event can be read [from that event hub using managed identity](functions-bindings-event-hubs-trigger.md?tabs=identity-based#connections).
30+
> The IoT Hub trigger doesn't support identity-based connections. If you need to use managed identities end-to-end, you can instead use IoT Hub Routing to send data to an event hub you control. In that way, outbound routing can be authenticated by using managed identity and the event is read [from that event hub using managed identity](functions-bindings-event-hubs-trigger.md?tabs=identity-based#connections).
3131
3232
## host.json properties
3333

34-
The [host.json](functions-host-json.md#eventhub) file contains settings that control Event Hub trigger behavior. See the [host.json settings](functions-bindings-event-iot.md#hostjson-settings) section for details regarding available settings.
34+
The [host.json](functions-host-json.md#eventhub) file contains settings that control Event Hubs trigger behavior. See the [host.json settings](functions-bindings-event-iot.md#hostjson-settings) section for details regarding available settings.
3535

3636
## Next steps
3737

includes/functions-service-bus-connections.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -8,19 +8,19 @@ ms.author: glenga
88

99
## Connections
1010

11-
The `connection` property is a reference to environment configuration which specifies how the app should connect to Service Bus. It may specify:
11+
The `connection` property references environment configuration that specifies how the app connects to Service Bus. It can specify:
1212

1313
- The name of an application setting containing a connection string.
14-
- The name of a shared prefix for multiple application settings, together defining a managed identity connection.
14+
- The name of a shared prefix for multiple application settings that together define a managed identity connection.
1515

1616
If the configured value is both an exact match for a single setting and a prefix match for other settings, the exact match is used.
1717

1818
> [!TIP]
19-
> Managed identity connections are recommended over connection strings for improved security. Connection strings include credentials that could be exposed, while managed identities eliminate the need to manage secrets.
19+
> Use managed identity connections instead of connection strings for better security. Connection strings include credentials that could be exposed, while managed identities eliminate the need to manage secrets.
2020
2121
### [Managed identity](#tab/identity-based)
2222

23-
If you are using [version 5.x or higher of the extension](../articles/azure-functions/functions-bindings-service-bus.md?extensionv5), instead of using a connection string with a secret, you can have the app use a [Microsoft Entra identity](../articles/active-directory/fundamentals/active-directory-whatis.md). To do this, you would define settings under a common prefix which maps to the `connection` property in the trigger and binding configuration.
23+
If you're using [version 5.x or higher of the extension](../articles/azure-functions/functions-bindings-service-bus.md?extensionv5), instead of using a connection string with a secret, you can have the app use a [Microsoft Entra identity](../articles/active-directory/fundamentals/active-directory-whatis.md). To use managed identities, define settings under a common prefix that maps to the `connection` property in the trigger and binding configuration.
2424

2525
In this mode, the extension requires the following application settings:
2626

@@ -32,7 +32,7 @@ In this mode, the extension requires the following application settings:
3232

3333
The value that you replace `<CONNECTION_NAME_PREFIX>` with is treated by the binding extension as the name of the connection setting.
3434

35-
For example, if your binding configuration specifies `connection = "ServiceBusConnection"` with a user-assigned managed identity, you would configure the following application settings:
35+
For example, if your binding configuration specifies `connection = "ServiceBusConnection"` with a user-assigned managed identity, you configure the following application settings:
3636

3737
```json
3838
{
@@ -45,7 +45,7 @@ For example, if your binding configuration specifies `connection = "ServiceBusCo
4545
> [!TIP]
4646
> Use user-assigned managed identities for production scenarios where you need fine-grained control over identity permissions across multiple resources.
4747
48-
You can use additional settings in the template to further customize the connection. See [Common properties for identity-based connections](../articles/azure-functions/functions-reference.md#common-properties-for-identity-based-connections).
48+
You can use other settings in the template to further customize the connection. See [Common properties for identity-based connections](../articles/azure-functions/functions-reference.md#common-properties-for-identity-based-connections).
4949

5050
> [!NOTE]
5151
> When using [Azure App Configuration](../articles/azure-app-configuration/quickstart-azure-functions-csharp.md) or [Key Vault](/azure/key-vault/general/overview) to provide settings for Managed Identity connections, setting names should use a valid key separator such as `:` or `/` in place of the `__` to ensure names are resolved correctly.
@@ -58,10 +58,10 @@ You can use additional settings in the template to further customize the connect
5858

5959
### [Connection string](#tab/connection-string)
6060

61-
Obtain this connection string by following the steps shown at [Get the management credentials](../articles/service-bus-messaging/service-bus-dotnet-get-started-with-queues.md#get-the-connection-string). The connection string must be for a Service Bus namespace, not limited to a specific queue or topic.
61+
Get this connection string by following the steps in [Get the management credentials](../articles/service-bus-messaging/service-bus-dotnet-get-started-with-queues.md#get-the-connection-string). You need a connection string for a Service Bus namespace, not one that's limited to a specific queue or topic.
6262

63-
This connection string should be stored in an application setting with a name matching the value specified by the `connection` property of the binding configuration.
63+
Store this connection string in an app setting with a name that matches the value you specify in the `connection` property of the binding configuration.
6464

65-
If the app setting name begins with "AzureWebJobs", you can specify only the remainder of the name. For example, if you set `connection` to "MyServiceBus", the Functions runtime looks for an app setting that is named "AzureWebJobsMyServiceBus." If you leave `connection` empty, the Functions runtime uses the default Service Bus connection string in the app setting that is named "AzureWebJobsServiceBus".
65+
If the app setting name starts with `AzureWebJobs`, you only need to specify the rest of the name. For example, if you set `connection` to `MyServiceBus`, the Functions runtime looks for an app setting named `AzureWebJobsMyServiceBus`. If you leave `connection` empty, the Functions runtime uses the default Service Bus connection string in the app setting named `AzureWebJobsServiceBus`.
6666

6767
---

0 commit comments

Comments
 (0)