Skip to content

Commit 28d8056

Browse files
author
gitName
committed
draft complete
1 parent ee530a2 commit 28d8056

File tree

1 file changed

+7
-9
lines changed

1 file changed

+7
-9
lines changed

articles/api-management/api-management-debug-policies.md

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -38,11 +38,11 @@ Azure API Management policies are a sequence of statements that address cross-cu
3838

3939
## Restrictions and limitations
4040

41-
* Policy debugging uses the built-in (service-level) all-access subscription (display name "Built-in all-access subscription") .
41+
* Policy debugging is currently supported in the API Management Developer tier
4242

43-
[!INCLUDE [api-management-tracing-alert](../../includes/api-manaement-tracing-alert.md)]
44-
45-
## Create polices using GitHub Copilot
43+
* Policy debugging uses the built-in (service-level) all-access subscription (display name "Built-in all-access subscription") and enables tracing for the duration of the debugging session.
44+
45+
## Create policies using GitHub Copilot
4646
The Azure API Management extension integrates with GitHub Copilot for Azure to help you create a draft of a policy. With AI assistance, create and edit policies in a user-friendly way.
4747

4848
To create a policy:
@@ -91,9 +91,6 @@ To receive an explanation:
9191
9292
The Azure API Management extension for Visual Studio Code provides a debugging experience that allows you to step through the policy pipeline or set a breakpoint when you send a request to the gateway.
9393
94-
> [!IMPORTANT]
95-
> Policy debugging in the Visual Studio Code extension is only supported in the API Management Developer tier.
96-
9794
### Initiate a debugging session
9895
9996
1. Open the API Management extension in Visual Studio Code.
@@ -112,7 +109,7 @@ At this point, the extension starts to establish a debugging session with the AP
112109
113110
When the debugging session is established, the REST Client extension opens a new editor that allows you to create and send a test HTTP request to the gateway.
114111
115-
You will notice the **Ocp-Apim-Debug** header has already been added to the request. This header is required and the value must be set to the service-level, all-access subscription key to trigger the debugging functionality in the API Management gateway.
112+
The **Ocp-Apim-Debug** header is added automatically to the request. This header is required and the value must be set to the service-level, all-access subscription key to trigger the debugging functionality in the API Management gateway.
116113
117114
Modify the HTTP request in the editor according to your test scenario. Then click **Send Request** to send the test request to the API Management gateway.
118115
@@ -134,10 +131,11 @@ If there is an error during policy execution, you will see the details of the er
134131
135132
:::image type="content" source="media/api-management-debug-policies/exception.png" alt-text="Screenshot of a policy exception in Visual Studio Code.":::
136133
134+
To review the request trace, select the value of the `Ocp-Apim-Trace-Location` header that is provided in the HTTP response.
135+
137136
> [!TIP]
138137
> Exit the debugging session by clicking the **Stop** button when you are finished.
139138
140-
141139
## Related content
142140
143141
+ Learn more about the [API Management extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-apimanagement).

0 commit comments

Comments
 (0)