review-1

Author: v-thpra

learn-pr/azure/improve-api-performance-with-apim-caching-policy/3-knowledge-check.yml

@@ -1,50 +1,50 @@
-### YamlMime:ModuleUnit
-uid: learn.azure.improve-api-performance-with-apim-caching-policy.3-knowledge-check
-title: Knowledge check
-metadata:
-  title: Knowledge check
-  description: In this unit, you will answer questions based on a scenario.
-  ms.date: 07/12/2023
-  author: dlepow
-  ms.author: danlep
-  ms.topic: unit
-durationInMinutes: 5
-content: |
-  [!include[](includes/3-knowledge-check.md)]
-quiz:
-  title: Knowledge check
-  questions:
-  - content: "Which policy would you use to ensure that the Board Pricing API sends all its responses in XML format?"
-    choices:
-    - content: "JSONP"
-      isCorrect: false
-      explanation: "This policy permits JSON with padding, which is a cross-domain request technique and has nothing to do with XML. To ensure XML output, use Convert JSON to XML."
-    - content: "Convert JSON to XML"
-      isCorrect: true
-      explanation: "This policy recodes any response in JSON format as XML text."
-    - content: "Find and replace string in body"
-      isCorrect: false
-      explanation: "This policy finds a specified string and replaces it with another. To ensure XML output, use Convert JSON to XML."
-  - content: 'Where would you configure your policy to ensure XML responses?'
-    choices:
-    - content: "Inbound"
-      isCorrect: false
-      explanation: "Set this policy in the Outbound tag, because you want to modify responses as they are sent to users."
-    - content: "Outbound"
-      isCorrect: true
-      explanation: "Set this policy in the Outbound tag, because you want to modify responses as they are sent to users."
-    - content: "On-error"
-      isCorrect: false
-      explanation: "Set this policy in the Outbound tag, because you want to modify responses as they are sent to users."
-  - content: "What scope would you use for the policy that ensures XML responses?"
-    choices:
-    - content: "Global scope for the API Management instance"
-      isCorrect: false
-      explanation: "Do not use the `<json-to-xml>` policy with global scope, because this change would force all responses from the Sales API to use XML, but the website expects JSON responses."
-    - content: "Product scope for the Sales product"
-      isCorrect: false
-      explanation: "Do not use the `<json-to-xml>` policy with product scope, because this change would force all responses from the Sales API to use XML, but the website expects JSON responses. Also, this scope does not apply to the Board Pricing API, which is not part of the Sales product."
-    - content: "API scope for the Board Pricing API"
-      isCorrect: true
-      explanation: "Use the `<json-to-xml>` policy with API scope for the Board Pricing API to ensure that all responses are sent in XML, even if developers coded them to return JSON."
-
+### YamlMime:ModuleUnit
+uid: learn.azure.improve-api-performance-with-apim-caching-policy.3-knowledge-check
+title: Knowledge check
+metadata:
+  title: Knowledge check
+  description: In this unit, you answer questions based on a scenario.
+  ms.date: 07/12/2023
+  author: dlepow
+  ms.author: danlep
+  ms.topic: unit
+durationInMinutes: 5
+content: |
+  [!include[](includes/3-knowledge-check.md)]
+quiz:
+  title: Knowledge check
+  questions:
+  - content: "Which policy would you use to ensure that the Board Pricing API sends all its responses in XML format?"
+    choices:
+    - content: "JSONP"
+      isCorrect: false
+      explanation: "This policy permits JSON with padding, which is a cross-domain request technique and has nothing to do with XML. To ensure XML output, use Convert JSON to XML."
+    - content: "Convert JSON to XML"
+      isCorrect: true
+      explanation: "This policy recodes any response in JSON format as XML text."
+    - content: "Find and replace string in body"
+      isCorrect: false
+      explanation: "This policy finds a specified string and replaces it with another. To ensure XML output, use Convert JSON to XML."
+  - content: 'Where would you configure your policy to ensure XML responses?'
+    choices:
+    - content: "Inbound"
+      isCorrect: false
+      explanation: "Set this policy in the Outbound tag, because you want to modify responses as they're sent to users."
+    - content: "Outbound"
+      isCorrect: true
+      explanation: "Set this policy in the Outbound tag, because you want to modify responses as they're sent to users."
+    - content: "On-error"
+      isCorrect: false
+      explanation: "Set this policy in the Outbound tag, because you want to modify responses as they're sent to users."
+  - content: "What scope would you use for the policy that ensures XML responses?"
+    choices:
+    - content: "Global scope for the API Management instance"
+      isCorrect: false
+      explanation: "Don't use the `<json-to-xml>` policy with global scope, because this change would force all responses from the Sales API to use XML, but the website expects JSON responses."
+    - content: "Product scope for the Sales product"
+      isCorrect: false
+      explanation: "Don't use the `<json-to-xml>` policy with product scope, because this change would force all responses from the Sales API to use XML, but the website expects JSON responses. Also, this scope doesn't apply to the Board Pricing API, which isn't part of the Sales product."
+    - content: "API scope for the Board Pricing API"
+      isCorrect: true
+      explanation: "Use the `<json-to-xml>` policy with API scope for the Board Pricing API to ensure that all responses are sent in XML, even if developers coded them to return JSON."
+

learn-pr/azure/improve-api-performance-with-apim-caching-policy/includes/1-introduction.md

@@ -1,16 +1,16 @@
-Many organizations use APIs to publish data and services. Customers and partners can call these APIs from a client: desktop applications, mobile apps, web apps, and other systems. If your API is popular, you may need to optimize its performance to guarantee service to users.
+Many organizations use APIs to publish data and services. Customers and partners can call these APIs from a client: desktop applications, mobile apps, web apps, and other systems. If your API is popular, you might need to optimize its performance to guarantee service to users.
 
-Suppose you're a developer for a board game company. A product line your company produces has recently become popular. The volume of requests from your retail partners to your inventory API is growing quickly - much faster than the rate your inventory changes. You'd like your API to respond to requests rapidly without incurring load on your API.
+Suppose you're a developer for a board game company. A product line your company produces has recently become popular. The volume of requests from your retail partners to your inventory API is growing quickly - more quickly than the rate your inventory changes. You'd like your API to respond to requests rapidly without incurring load on your API.
 
-You use Azure API Management to host your API. You're considering using an API Management policy to cache compiled responses to requests. You think that this technique will be a way to optimize performance. You want to learn how to write API Management policies and how to use them to set up and control a cache. Then you want to write policies that accelerate responses to users.
+You use Azure API Management to host your API. You're considering using an API Management policy to cache compiled responses to requests. You think that this technique could be a way to optimize performance. You want to learn how to write API Management policies and how to use them to set up and control a cache. Then you want to write policies that accelerate responses to users.
 
 ## Learning objectives
 
 In this module, you'll:
 
-- Identify whether or not a policy exists for the desired behavior
-- Choose a policy scope
-- Configure and apply a caching policy in the Azure portal
+- Identify whether or not a policy exists for the desired behavior.
+- Choose a policy scope.
+- Configure and apply a caching policy in the Azure portal.
 
 ## Prerequisites
 

learn-pr/azure/improve-api-performance-with-apim-caching-policy/includes/2-choose-the-right-api-management-policy.md

@@ -6,7 +6,7 @@ First, let's look at what you can use policies to do.
 
 ## What are policies?
 
-In Azure API Management, administrators can use policies to alter the behavior of APIs through configuration. The primary functionality and behavior of an API is designed by the developers who write the code. However, administrators can use policies to set limits, convert response formats, or enforce security requirements. In this module, we'll concentrate on using policies to set up and control a cache.
+In Azure API Management, administrators can use policies to alter the behavior of APIs through configuration. The primary functionality and behavior of an API is designed by the developers who write the code. However, administrators can use policies to set limits, convert response formats, or enforce security requirements. In this module, we concentrate on using policies to set up and control a cache.
 
 Policies are made up of individual statements, which are executed in order. The policy documents are XML structures, which contain elements that you can use to control the behavior of the API.
 
@@ -47,7 +47,7 @@ This policy also translates any outbound responses in JSON format into XML.
 
 ## Policy scopes
 
-A policy's scope determines how broadly it will be applied. The following are policy scopes from which you can choose:
+A policy's scope determines how broadly it's applied. The following are policy scopes from which you can choose:
 
 - Global
 - Product
@@ -84,7 +84,7 @@ Policies applied at the API scope affect only a single API. To set a policy at t
 
 ### Operation
 
-Policies applied at the operation scope affect only one operation within the API. In the example below, the administrator has selected the **GetSpeaker** operation within the **Demo Conference API** and can set inbound, outbound, or backend policies that apply only to that operation:
+Policies applied at the operation scope affect only one operation within the API. In the following example, the administrator selects the **GetSpeaker** operation within the **Demo Conference API** and can set inbound, outbound, or backend policies that apply only to that operation:
 
 :::image type="content" source="../media/2-operation-scope.png" alt-text="Screenshot of the operation scope in the portal.":::
 
@@ -124,7 +124,7 @@ To allow or deny calls from specific IP addresses or ranges of IP addresses, use
 
 Several policies enable you to control authentication. For example:
 
-Use the **Authenticate with Basic** policy to enable authentication in plain text. This form of authentication is broadly supported, but remember that you should protect it with SSL encryption; otherwise, a malicious attack can intercept the credentials as they cross the network.
+Use the **Authenticate with Basic** policy to enable authentication in plain text. This form of authentication is broadly supported, but remember that you should protect it with SSL encryption. Otherwise, a malicious attack can intercept the credentials as they cross the network.
 
 Use the **Authenticate with client certificate** policy to enable clients to authenticate by supplying a client certificate.
 
@@ -144,7 +144,7 @@ To convert to and from JSON and XML, use the **Convert JSON to XML** and **Conve
 
 Sometimes you want to keep a response in XML, but alter its schema. In such cases, use the **Transform XML** policy to apply an XSLT template.
 
-Use **Find and replace string in body** to execute a string substitution. For example, if a brand name has changed, you could use this policy to ensure that the change is reflected in all responses, even if the underlying data still includes references to the old name.
+Use **Find and replace string in body** to execute a string substitution. For example, if a brand name changes, you could use this policy to ensure that the change is reflected in all responses, even if the underlying data still includes references to the old name.
 
 The **Mask URLs in content** policy can rewrite any links in the response body so that they point to a different location. This policy is useful when a website or web API has moved.
 
@@ -154,13 +154,13 @@ If you want to modify an incoming HTTP request or outgoing response, you can use
 
 ### Advanced policies
 
-These policies can be of use in scenarios when you want non-standard behavior.
+These policies can be of use in scenarios when you want nonstandard behavior.
 
 For example, if you want to apply a policy only when the response passes a specific test, use the **Control flow** policy.
 
 Use the **Forward request** policy to forward a request to a backend server.
 
-To control what happens when an action fails, use the **Retry** policy. Policy statements enclosed in **Retry** will execute repeatedly until a condition is met. Execution will repeat at the specified time intervals up until the retry count value is reached.
+To control what happens when an action fails, use the **Retry** policy. Policy statements enclosed in **Retry** will execute repeatedly until a condition is met. Execution repeats at the specified time intervals up until the retry count value is reached.
 
 The **Send one-way request** policy can send a request to a URL without waiting for a response.
 

learn-pr/azure/improve-api-performance-with-apim-caching-policy/includes/3-knowledge-check.md

@@ -4,6 +4,6 @@ You're planning API Management policies for your board games company. You have t
 - **The Stock Management API**: Your staff uses a mobile app that calls this API to determine the stock level of your company's games.
 - **The Sales API**: The website uses this API to place orders from customers for your company's games.
 
-You've added the Stock Management API and the Sales API to an API Management product named **Sales**.
+You added the Stock Management API and the Sales API to an API Management product named **Sales**.
 
-For the Board Pricing API, you want to make sure that all responses are sent in XML, even though developers have written some operations to generate JSON text. The mobile app expects responses in XML, and the website expects responses in JSON.
+For the Board Pricing API, you want to make sure that all responses are sent in XML, even though developers wrote some operations to generate JSON text. The mobile app expects responses in XML, and the website expects responses in JSON.