Skip to content

Commit 50ce5c4

Browse files
Learn Build Service GitHub AppLearn Build Service GitHub App
authored andcommitted
Merging changes synced from https://github.com/MicrosoftDocs/azure-docs-pr (branch live)
2 parents 05ab0db + 19ccdcf commit 50ce5c4

File tree

79 files changed

+873
-1369
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

79 files changed

+873
-1369
lines changed

.openpublishing.publish.config.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@
7070
},
7171
{
7272
"path_to_root": "azure_cli_scripts",
73-
"url": "https://github.com/Azure-Samples/azure-cli-samples",
73+
"url": "https://github.com/ggailey777/azure-cli-samples",
7474
"branch": "master",
7575
"branch_mapping": {}
7676
},

articles/api-management/applications.md

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: dlepow
77

88
ms.service: azure-api-management
99
ms.topic: how-to
10-
ms.date: 05/19/2025
10+
ms.date: 07/11/2025
1111
ms.author: danlep
1212
ms.custom:
1313
- build-2025
@@ -22,9 +22,9 @@ API Management now supports built-in OAuth 2.0 application-based access to produ
2222
> Applications are currently in limited preview. To sign up, fill [this form](https://aka.ms/apimappspreview).
2323
2424
With this feature:
25-
2625
* API managers set a product property to enable application-based access.
2726
* API managers register client applications in Microsoft Entra ID to limit access to specific products.
27+
* Developers can access client application credentials using the API Management developer portal.
2828
* Using the OAuth 2.0 client credentials flow, developers or apps obtain tokens that they can include in API requests
2929
* Tokens presented in API requests are validated by the API Management gateway to authorize access to the product's APIs.
3030

@@ -61,7 +61,8 @@ Follow these steps to enable **Application based access** for a product. A produ
6161

6262
The following example uses the **Starter** product, but choose any published product that has at least one API assigned to it.
6363

64-
1. Sign in to the [portal](https://portal.azure.com) and navigate to your API Management instance.
64+
1. Sign in to the portal at the following custom URL for the applications feature: [https://portal.azure.com/?feature.customPortal=false&Microsoft_Azure_ApiManagement=applications](https://portal.azure.com/?feature.customPortal=false&Microsoft_Azure_ApiManagement=applications)
65+
1. Navigate to your API Management instance.
6566
1. In the left menu, under **APIs**, select **Products**.
6667
1. Choose the product that you want to configure, such as the **Starter** product.
6768
1. In the left menu, under **Product**, select **Properties**.
@@ -103,10 +104,13 @@ To review application settings in **App registrations**:
103104
Now register a client application that limits access to one or more products.
104105

105106
* A product must have **Application based access** enabled to be associated with a client application.
106-
* Each client application has a single user (owner) in the API Management instance. One the owner can access product APIs through the application.
107+
* Each client application has a single user (owner) in the API Management instance. Only the owner can access product APIs through the application.
107108
* A product can be associated with more than one client application.
108109

109-
1. Sign in to the [portal](https://portal.azure.com) and navigate to your API Management instance.
110+
To register a client application:
111+
112+
1. Sign in to the portal at the following custom URL for the applications feature: [https://portal.azure.com/?feature.customPortal=false&Microsoft_Azure_ApiManagement=applications](https://portal.azure.com/?feature.customPortal=false&Microsoft_Azure_ApiManagement=applications)
113+
1. Navigate to your API Management instance.
110114
1. In the left menu, under **APIs**, select **Applications** > **+ Register application**.
111115
1. In the **Register an application** page, enter the following application settings:
112116
* **Name**: Enter a name for the application.
@@ -152,6 +156,16 @@ To review application settings in **App registrations**:
152156

153157
:::image type="content" source="media/applications/client-api-permissions.png" alt-text="Screenshot of API permissions in the portal.":::
154158

159+
## Get application settings in developer portal
160+
161+
Users can sign in to the developer portal to view the client applications that they own.
162+
163+
1. Sign in to the developer portal (`https://<your-apim-instance-name>.developer.azure-api.net`) using a user account that was set as the owner of a client application.
164+
1. In the top navigation menu, select **Applications**.
165+
1. Applications that the user owns appear in the list.
166+
1. Select an application to view its details, such as the **Client ID**, **Client secret**, and **Scope**. These values are needed to generate a token to call the product APIs.
167+
168+
:::image type="content" source="media/applications/applications-developer-portal.png" alt-text="Screenshot of client applications in the developer portal.":::
155169

156170
## Create token and use with API call
157171

@@ -204,6 +218,16 @@ Write-Host "Response:"
204218
$getresponse | ConvertTo-Json -Depth 5
205219
```
206220

221+
## Troubleshooting
222+
223+
### Internal server error when registering applications in the portal
224+
225+
If you're unable to list applications, or you receive an internal server error when registering applications in the portal, check the following:
226+
227+
* The **Application Administrator** role is assigned to the API Management instance's managed identity in Microsoft Entra ID.
228+
* You're signed in to the portal at the following custom URL for the applications feature: [https://portal.azure.com/?feature.customPortal=false&Microsoft_Azure_ApiManagement=applications](https://portal.azure.com/?feature.customPortal=false&Microsoft_Azure_ApiManagement=applications). This URL is required to access the applications feature in API Management.
229+
230+
207231
## Related content
208232

209233
* [Create and publish a product](api-management-howto-add-products.md)
25.5 KB
Loading
10 Bytes
Loading

articles/azure-functions/TOC.yml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@
3232
href: create-first-function-vs-code-csharp.md
3333
- name: Command line
3434
displayName: C#, quickstart, get started
35-
href: create-first-function-cli-csharp.md
35+
href: how-to-create-function-azure-cli.md?pivots=programming-language-csharp
3636
- name: Azure Developer CLI
3737
displayName: C#, quickstart, get started, Flex Consumption plan
3838
href: create-first-function-azure-developer-cli.md?pivots=programming-language-csharp
@@ -49,7 +49,7 @@
4949
href: functions-create-maven-intellij.md
5050
- name: Maven
5151
displayName: Java, quickstart, get started
52-
href: create-first-function-cli-java.md
52+
href: how-to-create-function-azure-cli.md?pivots=programming-language-java
5353
- name: Quarkus
5454
displayName: Java, quickstart, get started
5555
href: functions-create-first-quarkus.md
@@ -69,7 +69,7 @@
6969
href: create-first-function-vs-code-node.md
7070
- name: Command line
7171
displayName: JavaScript, quickstart, get started
72-
href: create-first-function-cli-node.md
72+
href: how-to-create-function-azure-cli.md?pivots=programming-language-javascript
7373
- name: Azure Developer CLI
7474
displayName: JavaScript, quickstart, get started, Flex Consumption plan
7575
href: create-first-function-azure-developer-cli.md?pivots=programming-language-javascript
@@ -80,7 +80,7 @@
8080
href: create-first-function-vs-code-powershell.md
8181
- name: Command line
8282
displayName: PowerShell, quickstart, get started
83-
href: create-first-function-cli-powershell.md
83+
href: how-to-create-function-azure-cli.md?pivots=programming-language-powershell
8484
- name: Azure Developer CLI
8585
displayName: PowerShell, quickstart, get started, Flex Consumption plan
8686
href: create-first-function-azure-developer-cli.md?pivots=programming-language-powershell
@@ -91,7 +91,7 @@
9191
href: create-first-function-vs-code-python.md
9292
- name: Command line
9393
displayName: Python, quickstart, get started
94-
href: create-first-function-cli-python.md
94+
href: how-to-create-function-azure-cli.md?pivots=programming-language-python
9595
- name: Azure Developer CLI
9696
displayName: Python, quickstart, get started, Flex Consumption plan
9797
href: create-first-function-azure-developer-cli.md?pivots=programming-language-python
@@ -102,7 +102,7 @@
102102
href: create-first-function-vs-code-typescript.md
103103
- name: Command line
104104
displayName: TypeScript, quickstart, get started
105-
href: create-first-function-cli-typescript.md
105+
href: how-to-create-function-azure-cli.md?pivots=programming-language-typescript
106106
- name: Azure Developer CLI
107107
displayName: TypeScript, quickstart, get started, Flex Consumption plan
108108
href: create-first-function-azure-developer-cli.md?pivots=programming-language-typescript

articles/azure-functions/configure-monitoring.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -290,7 +290,7 @@ For a function app to send data to Application Insights, it needs to connect to
290290
| **[`APPLICATIONINSIGHTS_CONNECTION_STRING`](functions-app-settings.md#applicationinsights_connection_string)** | This setting is recommended and is required when your Application Insights instance runs in a sovereign cloud. The connection string supports other [new capabilities](/azure/azure-monitor/app/migrate-from-instrumentation-keys-to-connection-strings#new-capabilities). |
291291
| **[`APPINSIGHTS_INSTRUMENTATIONKEY`](functions-app-settings.md#appinsights_instrumentationkey)** | Legacy setting, which Application Insights has deprecated in favor of the connection string setting. |
292292

293-
When you create your function app in the [Azure portal](./functions-get-started.md) from the command line by using [Azure Functions Core Tools](./create-first-function-cli-csharp.md) or [Visual Studio Code](./create-first-function-vs-code-csharp.md), Application Insights integration is enabled by default. The Application Insights resource has the same name as your function app, and is created either in the same region or in the nearest region.
293+
When you create your function app in the [Azure portal](./functions-get-started.md) from the command line by using [Azure Functions Core Tools](./how-to-create-function-azure-cli.md?pivots=programming-language-csharp) or [Visual Studio Code](./create-first-function-vs-code-csharp.md), Application Insights integration is enabled by default. The Application Insights resource has the same name as your function app, and is created either in the same region or in the nearest region.
294294

295295
### Require Microsoft Entra authentication
296296

articles/azure-functions/create-first-function-azure-developer-cli.md

Lines changed: 1 addition & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -25,28 +25,8 @@ By default, the Flex Consumption plan follows a _pay-for-what-you-use_ billing m
2525

2626
+ [Azure Functions Core Tools](functions-run-local.md#install-the-azure-functions-core-tools).
2727

28-
::: zone pivot="programming-language-csharp"
29-
+ [.NET 8.0 SDK](https://dotnet.microsoft.com/download)
30-
31-
+ [Azurite storage emulator](../storage/common/storage-use-azurite.md?tabs=npm#install-azurite)
32-
::: zone-end
33-
::: zone pivot="programming-language-java"
34-
+ [Java 17 Developer Kit](/azure/developer/java/fundamentals/java-support-on-azure)
35-
+ If you use another [supported version of Java](supported-languages.md?pivots=programming-language-java#languages-by-runtime-version), you must update the project's pom.xml file.
36-
+ The `JAVA_HOME` environment variable must be set to the install location of the correct version of the JDK.
37-
+ [Apache Maven 3.8.x](https://maven.apache.org)
38-
::: zone-end
39-
::: zone pivot="programming-language-javascript,programming-language-typescript"
40-
+ [Node.js 20](https://nodejs.org/)
41-
::: zone-end
42-
::: zone pivot="programming-language-powershell"
43-
+ [PowerShell 7.2](/powershell/scripting/install/installing-powershell-core-on-windows)
28+
[!INCLUDE [functions-requirements-azure-cli](../../includes/functions-requirements-azure-cli.md)]
4429

45-
+ [.NET 6.0 SDK](https://dotnet.microsoft.com/download)
46-
::: zone-end
47-
::: zone pivot="programming-language-python"
48-
+ [Python 3.11](https://www.python.org/).
49-
::: zone-end
5030
+ A [secure HTTP test tool](functions-develop-local.md#http-test-tools) for sending requests with JSON payloads to your function endpoints. This article uses `curl`.
5131

5232
## Initialize the project

0 commit comments

Comments
 (0)