Skip to content

Commit da63d55

Browse files
committed
freshness review
1 parent ef5d289 commit da63d55

File tree

1 file changed

+18
-18
lines changed

1 file changed

+18
-18
lines changed

articles/frontdoor/endpoint.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -6,59 +6,59 @@ services: frontdoor
66
author: duongau
77
ms.service: azure-frontdoor
88
ms.topic: conceptual
9-
ms.date: 08/09/2023
9+
ms.date: 11/13/2024
1010
ms.author: duau
1111
---
1212

1313
# Endpoints in Azure Front Door
1414

15-
In Azure Front Door, an *endpoint* is a logical grouping of one or more routes that are associated with domain names. Each endpoint is [assigned a domain name](#endpoint-domain-names) by Front Door, and you can associate your own custom domains by using routes.
15+
In Azure Front Door, an *endpoint* is a logical grouping of one or more routes associated with domain names. Each endpoint is [assigned a domain name](#endpoint-domain-names) by Front Door, and you can also associate your own custom domains using routes.
1616

1717
## How many endpoints should I create?
1818

19-
A Front Door profile can contain multiple endpoints. However, in many situations you might only need a single endpoint.
19+
A Front Door profile can contain multiple endpoints, but in many cases, a single endpoint might suffice.
2020

21-
When you're planning the endpoints to create, consider the following factors:
21+
Consider the following factors when planning your endpoints:
2222

23-
- If all of your domains use the same or similar route paths, it's probably best to combine them into a single endpoint.
24-
- If you use different routes and route paths for each domain, consider using separate endpoints, such as by having an endpoint for each custom domain.
25-
- If you need to enable or disable all of your domains together, consider using a single endpoint. An entire endpoint can be enabled or disabled together.
23+
- If all your domains use the same or similar route paths, it's likely best to combine them into a single endpoint.
24+
- If you use different routes and route paths for each domain, consider creating separate endpoints, such as one for each custom domain.
25+
- If you need to enable or disable all your domains together, consider using a single endpoint, as an entire endpoint can be enabled or disabled at once.
2626

2727
## Endpoint domain names
2828

2929
Endpoint domain names are automatically generated when you create a new endpoint. Front Door generates a unique domain name based on several components, including:
3030

3131
- The endpoint's name.
32-
- A pseudorandom hash value, which gets determined by Front Door. By using hash values as part of the domain name, Front Door helps to protect against [subdomain takeover](../security/fundamentals/subdomain-takeover.md) attacks.
33-
- The base domain name for your Front Door environment. Generally is `z01.azurefd.net`.
32+
- A pseudorandom hash value determined by Front Door, which helps protect against [subdomain takeover](../security/fundamentals/subdomain-takeover.md) attacks.
33+
- The base domain name for your Front Door environment, generally `z01.azurefd.net`.
3434

35-
For example, suppose you have created an endpoint named `myendpoint`. The endpoint domain name might be `myendpoint-mdjf2jfgjf82mnzx.z01.azurefd.net`.
35+
For example, if you create an endpoint named `myendpoint`, the endpoint domain name might be `myendpoint-mdjf2jfgjf82mnzx.z01.azurefd.net`.
3636

3737
The endpoint domain is accessible when you associate it with a route.
3838

3939
### Reuse of an endpoint domain name
4040

41-
When you delete and redeploy an endpoint, you might expect to get the same pseudorandom hash value, and therefore the same endpoint domain name. Front Door enables you to control how the pseudorandom hash values are reused on an endpoint-by-endpoint basis.
41+
When you delete and redeploy an endpoint, you might expect to get the same pseudorandom hash value and, therefore, the same endpoint domain name. Front Door allows you to control how these pseudorandom hash values are reused on an endpoint-by-endpoint basis.
4242

4343
An endpoint's domain can be reused within the same tenant, subscription, or resource group scope level. You can also choose to not allow the reuse of an endpoint domain. By default, Front Door allows reuse of the endpoint domain within the same Microsoft Entra tenant.
4444

45-
You can use Bicep, an Azure Resource Manager template (ARM template), the Azure CLI, or Azure PowerShell to configure the scope level of the endpoint's domain reuse behavior. You can also configure it for all Front Door endpoints in your whole organization by using Azure Policy. The Azure portal uses the scope level you define through the command line once it has been changed.
45+
You can configure the scope level of the endpoint's domain reuse behavior using Bicep, an Azure Resource Manager (ARM) template, the Azure CLI, or Azure PowerShell. Additionally, you can configure it for all Front Door endpoints in your organization using Azure Policy. The Azure portal uses the scope level you define through the command line once it has been changed.
4646

4747
The following table lists the allowable values for the endpoint's domain reuse behavior:
4848

4949
| Value | Description |
5050
|--|--|
5151
| `TenantReuse` | This is the default value. Endpoints with the same name in the same Microsoft Entra tenant receive the same domain label. |
5252
| `SubscriptionReuse` | Endpoints with the same name in the same Azure subscription receive the same domain label. |
53-
| `ResourceGroupReuse` | Endpoints with the same name in the same resource group receives the same domain label. |
53+
| `ResourceGroupReuse` | Endpoints with the same name in the same resource group receive the same domain label. |
5454
| `NoReuse` | Endpoints always receive a new domain label. |
5555

5656
> [!NOTE]
57-
> You can't modify the reuse behavior of an existing Front Door endpoint. The reuse behavior only applies to newly created endpoints.
57+
> The reuse behavior cannot be modified for an existing Front Door endpoint. It only applies to newly created endpoints.
5858
59-
The following example shows how to create a new Front Door endpoint with a reuse scope of `SubscriptionReuse`:
59+
The following examples demonstrate how to create a new Front Door endpoint with the reuse scope set to `SubscriptionReuse`:
6060

61-
# [Azure CLI](#tab/azurecli)
61+
### Azure CLI
6262

6363
```azurecli
6464
az afd endpoint create \
@@ -68,7 +68,7 @@ az afd endpoint create \
6868
--name-reuse-scope SubscriptionReuse
6969
```
7070

71-
# [Azure PowerShell](#tab/azurepowershell)
71+
### Azure PowerShell
7272

7373
```azurepowershell
7474
New-AzFrontDoorCdnEndpoint `
@@ -79,7 +79,7 @@ New-AzFrontDoorCdnEndpoint `
7979
-AutoGeneratedDomainNameLabelScope SubscriptionReuse
8080
```
8181

82-
# [Bicep](#tab/bicep)
82+
### Bicep
8383

8484
```bicep
8585
resource endpoint 'Microsoft.Cdn/profiles/afdEndpoints@2021-06-01' = {

0 commit comments

Comments
 (0)