Skip to content

Commit 9bc3a24

Browse files
RaphHaddadggailey777
authored andcommitted
Cherry-pick customer PR
1 parent d262aff commit 9bc3a24

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

articles/azure-functions/functions-reference.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -303,21 +303,24 @@ The Azure Functions host uses the storage connection set in [`AzureWebJobsStorag
303303
>
304304
> In addition, your function app might be reusing `AzureWebJobsStorage` for other storage connections in their triggers, bindings, and/or function code. Make sure that all uses of `AzureWebJobsStorage` are able to use the identity-based connection format before changing this connection from a connection string.
305305
306-
To use an identity-based connection for `AzureWebJobsStorage`, configure the following app settings:
306+
These app settings are used to define an identity-based connection `AzureWebJobsStorage`:
307307

308-
| Setting | Description | Example value |
308+
| Setting | Description | Example value |
309309
|-----------------------------------------------------|--------------------------------------------|------------------------------------------------|
310+
| `AzureWebJobsStorage__accountName` | The account name of a storage account, valid only if the account isn't in a sovereign cloud and doesn't have a custom DNS. This syntax is unique to `AzureWebJobsStorage` and can't be used for other identity-based connections. | <storage_account_name> |
310311
| `AzureWebJobsStorage__blobServiceUri`| The data plane URI of the blob service of the storage account, using the HTTPS scheme. | https://<storage_account_name>.blob.core.windows.net |
311312
| `AzureWebJobsStorage__queueServiceUri` | The data plane URI of the queue service of the storage account, using the HTTPS scheme. | https://<storage_account_name>.queue.core.windows.net |
312313
| `AzureWebJobsStorage__tableServiceUri` | The data plane URI of a table service of the storage account, using the HTTPS scheme. | https://<storage_account_name>.table.core.windows.net |
313314

314315
[Common properties for identity-based connections](#common-properties-for-identity-based-connections) may also be set as well.
315316

316-
If you're configuring `AzureWebJobsStorage` using a storage account that uses the default DNS suffix and service name for global Azure, following the `https://<accountName>.[blob|queue|file|table].core.windows.net` format, you can instead set `AzureWebJobsStorage__accountName` to the name of your storage account. The endpoints for each storage service are inferred for this account. This doesn't work when the storage account is in a sovereign cloud or has a custom DNS.
317+
When you're configuring `AzureWebJobsStorage` using a storage account that uses the default DNS suffix and service name for global Azure, following the `https://<accountName>.[blob|queue|file|table].core.windows.net` format, you can instead set `AzureWebJobsStorage__accountName` to the name of your storage account. The endpoints for each storage service are inferred for this account. This doesn't work when the storage account is in a sovereign cloud or has a custom DNS.
317318

318319
| Setting | Description | Example value |
319320
|-----------------------------------------------------|--------------------------------------------|------------------------------------------------|
320-
| `AzureWebJobsStorage__accountName` | The account name of a storage account, valid only if the account isn't in a sovereign cloud and doesn't have a custom DNS. This syntax is unique to `AzureWebJobsStorage` and can't be used for other identity-based connections. | <storage_account_name> |
321+
322+
| `AzureWebJobsStorage__credential` | Recommended only when specifying a user-assigned managed identity, when it should be set to `managedidentity`. This is only valid when hosted in the Azure Functions service. | managedidentity |
323+
| `AzureWebJobsStorage__clientId` | When `credential` is set to "managedidentity", this property specifies the user-assigned identity to be used when obtaining a token. The property accepts a client ID corresponding to a user-assigned identity assigned to the application. If not specified, the system-assigned identity will be used. This property is used differently in [local development scenarios](#local-development-with-identity-based-connections), when `credential` should not be set. | 02f9a4bc-0a67-4691-a732-aa51cfc04d8e |
321324

322325
[!INCLUDE [functions-azurewebjobsstorage-permissions](../../includes/functions-azurewebjobsstorage-permissions.md)]
323326

0 commit comments

Comments
 (0)