Skip to content

Commit 80c6050

Browse files
Merge pull request #293862 from satvu/satvu/add-binding-name-docs
Add documentation for functions binding names
2 parents 8865ffe + 5a86860 commit 80c6050

File tree

1 file changed

+19
-17
lines changed

1 file changed

+19
-17
lines changed

articles/azure-functions/functions-triggers-bindings.md

Lines changed: 19 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Binding to a function is a way of declaratively connecting your functions to oth
1818

1919
You can mix and match different bindings to suit your function's specific scenario. Bindings are optional and a function might have one or multiple input and/or output bindings.
2020

21-
Triggers and bindings let you avoid hardcoding access to other services. Your function receives data (for example, the content of a queue message) in function parameters. You send data (for example, to create a queue message) by using the return value of the function.
21+
Triggers and bindings let you avoid hardcoding access to other services. Your function receives data (for example, the content of a queue message) in function parameters. You send data (for example, to create a queue message) by using the return value of the function.
2222

2323
Consider the following examples of how you could implement different functions.
2424

@@ -41,6 +41,8 @@ A function has a single trigger and one or more bindings. The type of binding is
4141

4242
Triggers and bindings are defined differently depending on the development language. Make sure to select your language at the [top](#top) of the article.
4343

44+
Trigger and binding names are limited to alphanumeric characters and `_`, the underscore.
45+
4446
This example shows an HTTP triggered function with an output binding that writes a message to an Azure Storage queue.
4547

4648
::: zone pivot="programming-language-csharp"
@@ -52,7 +54,7 @@ The HTTP trigger (`HttpTrigger`) is defined on the `Run` method for a function n
5254

5355
:::code language="csharp" source="~/functions-docs-csharp/functions-add-output-binding-storage-queue-isolated/HttpExample.cs" range="11-14":::
5456

55-
This example shows the `MultiResponse` object definition which both returns an `HttpResponse` to the HTTP request and also writes a message to a storage queue using a `QueueOutput` binding:
57+
This example shows the `MultiResponse` object definition which both returns an `HttpResponse` to the HTTP request and also writes a message to a storage queue using a `QueueOutput` binding:
5658

5759
:::code language="csharp" source="~/functions-docs-csharp/functions-add-output-binding-storage-queue-isolated/HttpExample.cs" range="33-38":::
5860

@@ -90,13 +92,13 @@ In Node.js for Functions version 3, you configure triggers and bindings in a fun
9092

9193
---
9294

93-
::: zone-end
95+
::: zone-end
9496
This example is an HTTP triggered function that creates a queue item for each HTTP request received.
9597

96-
::: zone pivot="programming-language-javascript"
98+
::: zone pivot="programming-language-javascript"
9799
### [v4](#tab/node-v4)
98100

99-
The `http` method on the exported `app` object defines an HTTP trigger, and the `storageQueue` method on `output` defines an output binding on this trigger.
101+
The `http` method on the exported `app` object defines an HTTP trigger, and the `storageQueue` method on `output` defines an output binding on this trigger.
100102

101103
:::code language="javascript" source="~/azure-functions-nodejs-v4/js/src/functions/storageQueueOutput1.js" :::
102104

@@ -131,8 +133,8 @@ This example `function.json` file defines the HTTP trigger function that returns
131133

132134
---
133135

134-
::: zone-end
135-
::: zone pivot="programming-language-typescript"
136+
::: zone-end
137+
::: zone pivot="programming-language-typescript"
136138
### [v4](#tab/node-v4)
137139

138140
The `http` method on the exported `app` object defines an HTTP trigger, and the `storageQueue` method on `output` defines an output binding on this trigger.
@@ -168,20 +170,20 @@ This example `function.json` file defines the HTTP trigger function that returns
168170
}
169171
```
170172

171-
::: zone-end
172-
::: zone pivot="programming-language-powershell"
173+
::: zone-end
174+
::: zone pivot="programming-language-powershell"
173175
This example `function.json` file defines the function:
174176

175177
:::code language="json" source="~/functions-docs-powershell/functions-add-output-binding-storage-queue-cli/HttpExample/function.json" range="3-26":::
176178

177179
For more information, see the [PowerShell developer guide](functions-reference-powershell.md#bindings).
178-
::: zone-end
179-
::: zone pivot="programming-language-python"
180+
::: zone-end
181+
::: zone pivot="programming-language-python"
180182
The way that the function is defined depends on the version of Python for Functions:
181183

182184
### [v2](#tab/python-v2)
183185

184-
In Python for Functions version 2, you define the function directly in code using decorators.
186+
In Python for Functions version 2, you define the function directly in code using decorators.
185187

186188
:::code language="python" source="~/functions-docs-python-v2/function_app.py" range="4-9" :::
187189

@@ -194,25 +196,25 @@ In Python for Functions version 1, this example `function.json` file defines an
194196

195197
---
196198

197-
::: zone-end
199+
::: zone-end
198200

199201
## Add bindings to a function
200202

201-
You can connect your function to other services by using input or output bindings. Add a binding by adding its specific definitions to your function. To learn how, see [Add bindings to an existing function in Azure Functions](add-bindings-existing-function.md).
203+
You can connect your function to other services by using input or output bindings. Add a binding by adding its specific definitions to your function. To learn how, see [Add bindings to an existing function in Azure Functions](add-bindings-existing-function.md).
202204

203-
Azure Functions supports multiple bindings, which must be configured correctly. For example, a function can read data from a queue (input binding) and write data to a database (output binding) simultaneously.
205+
Azure Functions supports multiple bindings, which must be configured correctly. For example, a function can read data from a queue (input binding) and write data to a database (output binding) simultaneously.
204206

205207
## Supported bindings
206208

207209
[!INCLUDE [Full bindings table](../../includes/functions-bindings.md)]
208210

209-
For information about which bindings are in preview or are approved for production use, see [Supported languages](supported-languages.md).
211+
For information about which bindings are in preview or are approved for production use, see [Supported languages](supported-languages.md).
210212

211213
Specific binding extension versions are only supported while the underlying service SDK is supported. Changes to support in the underlying service SDK version affect the support for the consuming extension.
212214

213215
## Bindings code examples
214216

215-
Use the following table to find more examples of specific binding types that show you how to work with bindings in your functions. First, choose the language tab that corresponds to your project.
217+
Use the following table to find more examples of specific binding types that show you how to work with bindings in your functions. First, choose the language tab that corresponds to your project.
216218

217219
[!INCLUDE [functions-bindings-code-example-chooser](../../includes/functions-bindings-code-example-chooser.md)]
218220

0 commit comments

Comments
 (0)