Routes - Get

Service:: Front Door Service

API-versie:: 2025-04-15

Hiermee haalt u een bestaande route op met de opgegeven routenaam onder het opgegeven abonnement, de resourcegroep, het profiel en het AzureFrontDoor-eindpunt.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}/routes/{routeName}?api-version=2025-04-15

URI-parameters

Name	In	Vereist	Type	Description
endpointName	path	True	string	Naam van het eindpunt onder het profiel dat wereldwijd uniek is.
profileName	path	True	string minLength: 1 maxLength: 260 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9])$	De naam van de Azure Front Door Standard of Azure Front Door Premium die uniek is binnen de resourcegroep.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
routeName	path	True	string	Naam van de routeringsregel.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	Route	OK
Other Status Codes	ErrorResponse	Azure Front Door-foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Routes_Get

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/afdEndpoints/endpoint1/routes/route1?api-version=2025-04-15

Voorbeeldrespons

Statuscode:: 200

{
  "name": "route1",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/afdendpoints/endpoint1/routes/route1",
  "type": "Microsoft.Cdn/profiles/afdendpoints/routes",
  "properties": {
    "customDomains": [
      {
        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/customDomains/domain1"
      }
    ],
    "originGroup": {
      "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/originGroups/originGroup1"
    },
    "originPath": null,
    "ruleSets": [
      {
        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/ruleSets/ruleSet1"
      }
    ],
    "supportedProtocols": [
      "Https",
      "Http"
    ],
    "patternsToMatch": [
      "/*"
    ],
    "cacheConfiguration": {
      "compressionSettings": {
        "contentTypesToCompress": [
          "text/html",
          "application/octet-stream"
        ],
        "isCompressionEnabled": true
      },
      "queryStringCachingBehavior": "IgnoreQueryString",
      "queryParameters": null
    },
    "forwardingProtocol": "MatchRequest",
    "linkToDefaultDomain": "Enabled",
    "httpsRedirect": "Enabled",
    "enabledState": "Enabled",
    "provisioningState": "Succeeded",
    "deploymentStatus": "NotStarted"
  }
}

Definities

Name	Description
ActivatedResourceReference	Verwijzing naar een andere resource samen met de status.
AFDEndpointProtocols	Ondersteunde protocollen voor het eindpunt van de klant.
AfdProvisioningState	Beheerstatus
afdQueryStringCachingBehavior	Hiermee definieert u hoe Frontdoor aanvragen die queryreeksen bevatten, in de cache opgeslagen. U kunt queryreeksen negeren tijdens het opslaan in cache, specifieke queryreeksen negeren, elke aanvraag in de cache opslaan met een unieke URL of specifieke queryreeksen in de cache opslaan.
AfdRouteCacheConfiguration	Cache-instellingen voor een route van het type caching. Als u caching wilt uitschakelen, geeft u geen cacheConfiguration-object op.
CompressionSettings	instellingen voor compressie.
createdByType	Het type identiteit waarmee de resource is gemaakt.
DeploymentStatus
EnabledState	Of u deze regel wilt gebruiken. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
ForwardingProtocol	Protocol dat door deze regel wordt gebruikt bij het doorsturen van verkeer naar back-ends.
httpsRedirect	Of http-verkeer automatisch moet worden omgeleid naar HTTPS-verkeer. Houd er rekening mee dat dit een eenvoudige manier is om deze regel in te stellen en dit is de eerste regel die wordt uitgevoerd.
LinkToDefaultDomain	of deze route wordt gekoppeld aan het standaardeindpuntdomein.
ResourceReference	Verwijzing naar een andere resource.
Route	Beschrijvende routesnaamtoewijzing aan alle routes of geheime gerelateerde informatie.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

ActivatedResourceReference

Object

Verwijzing naar een andere resource samen met de status.

Name	Type	Description
id	string	Resource-id.
isActive	boolean	Of de resource actief of inactief is

AFDEndpointProtocols

Inventarisatie

Ondersteunde protocollen voor het eindpunt van de klant.

Waarde	Description
Http
Https

AfdProvisioningState

Inventarisatie

Beheerstatus

Waarde	Description
Succeeded
Failed
Updating
Deleting
Creating

afdQueryStringCachingBehavior

Inventarisatie

Hiermee definieert u hoe Frontdoor aanvragen die queryreeksen bevatten, in de cache opgeslagen. U kunt queryreeksen negeren tijdens het opslaan in cache, specifieke queryreeksen negeren, elke aanvraag in de cache opslaan met een unieke URL of specifieke queryreeksen in de cache opslaan.

Waarde	Description
IgnoreQueryString
UseQueryString
IgnoreSpecifiedQueryStrings
IncludeSpecifiedQueryStrings

AfdRouteCacheConfiguration

Object

Cache-instellingen voor een route van het type caching. Als u caching wilt uitschakelen, geeft u geen cacheConfiguration-object op.

Name	Type	Description
compressionSettings	CompressionSettings	compressie-instellingen.
queryParameters	string	queryparameters die moeten worden opgenomen of uitgesloten (door komma's gescheiden).
queryStringCachingBehavior	afdQueryStringCachingBehavior	Hiermee definieert u hoe Frontdoor aanvragen die queryreeksen bevatten, in de cache opgeslagen. U kunt queryreeksen negeren tijdens het opslaan in cache, specifieke queryreeksen negeren, elke aanvraag in de cache opslaan met een unieke URL of specifieke queryreeksen in de cache opslaan.

CompressionSettings

Object

instellingen voor compressie.

Name	Type	Description
contentTypesToCompress	string[]	Lijst met inhoudstypen waarop compressie van toepassing is. De waarde moet een geldig MIME-type zijn.
isCompressionEnabled	boolean	Geeft aan of inhoudscompressie is ingeschakeld in AzureFrontDoor. De standaardwaarde is onwaar. Als compressie is ingeschakeld, wordt inhoud geleverd als gecomprimeerd als gebruikers aanvragen voor een gecomprimeerde versie. Inhoud wordt niet gecomprimeerd in AzureFrontDoor wanneer aangevraagde inhoud kleiner is dan 1 byte of groter is dan 1 MB.

createdByType

Inventarisatie

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

DeploymentStatus

Inventarisatie

Waarde	Description
NotStarted
InProgress
Succeeded
Failed

EnabledState

Inventarisatie

Of u deze regel wilt gebruiken. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld

Waarde	Description
Enabled
Disabled

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

ForwardingProtocol

Inventarisatie

Protocol dat door deze regel wordt gebruikt bij het doorsturen van verkeer naar back-ends.

Waarde	Description
HttpOnly
HttpsOnly
MatchRequest

httpsRedirect

Inventarisatie

Of http-verkeer automatisch moet worden omgeleid naar HTTPS-verkeer. Houd er rekening mee dat dit een eenvoudige manier is om deze regel in te stellen en dit is de eerste regel die wordt uitgevoerd.

Waarde	Description
Enabled
Disabled

LinkToDefaultDomain

Inventarisatie

of deze route wordt gekoppeld aan het standaardeindpuntdomein.

Waarde	Description
Enabled
Disabled

ResourceReference

Object

Verwijzing naar een andere resource.

Name	Type	Description
id	string	Resource-id.

Route

Object

Beschrijvende routesnaamtoewijzing aan alle routes of geheime gerelateerde informatie.

Name	Type	Default value	Description
id	string (arm-id)		Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
name	string		De naam van de resource
properties.cacheConfiguration	AfdRouteCacheConfiguration		De cacheconfiguratie voor deze route. Als u caching wilt uitschakelen, geeft u geen cacheConfiguration-object op.
properties.customDomains	ActivatedResourceReference[]		Naar domeinen waarnaar wordt verwezen door dit eindpunt.
properties.deploymentStatus	DeploymentStatus
properties.enabledState	EnabledState		Of u deze regel wilt gebruiken. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld
properties.endpointName	string		De naam van het eindpunt dat de route bevat.
properties.forwardingProtocol	ForwardingProtocol	MatchRequest	Protocol dat door deze regel wordt gebruikt bij het doorsturen van verkeer naar back-ends.
properties.httpsRedirect	httpsRedirect	Disabled	Of http-verkeer automatisch moet worden omgeleid naar HTTPS-verkeer. Houd er rekening mee dat dit een eenvoudige manier is om deze regel in te stellen en dit is de eerste regel die wordt uitgevoerd.
properties.linkToDefaultDomain	LinkToDefaultDomain	Disabled	of deze route wordt gekoppeld aan het standaardeindpuntdomein.
properties.originGroup	ResourceReference		Een verwijzing naar de oorspronkelijke groep.
properties.originPath	string		Een mappad op de oorsprong waaruit AzureFrontDoor kan gebruiken om inhoud op te halen, bijvoorbeeld contoso.cloudapp.net/originpath.
properties.patternsToMatch	string[]		De routepatronen van de regel.
properties.provisioningState	AfdProvisioningState		Beheerstatus
properties.ruleSets	ResourceReference[]		regelsets waarnaar wordt verwezen door dit eindpunt.
properties.supportedProtocols	AFDEndpointProtocols[]	[ "Http", "Https" ]	Lijst met ondersteunde protocollen voor deze route.
systemData	systemData		Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
type	string		Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

Delen via

Routes - Get

URI-parameters

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

Routes_Get

Voorbeeldaanvraag

Voorbeeldrespons

Definities

ActivatedResourceReference

AFDEndpointProtocols

AfdProvisioningState

afdQueryStringCachingBehavior

AfdRouteCacheConfiguration

CompressionSettings

createdByType

DeploymentStatus

EnabledState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ForwardingProtocol

httpsRedirect

LinkToDefaultDomain

ResourceReference

Route

systemData