Routes - Get

Tjänst:: Front Door Service

API-version:: 2025-04-15

Hämtar en befintlig väg med det angivna vägnamnet under den angivna prenumerationen, resursgruppen, profilen och AzureFrontDoor-slutpunkten.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpointName	path	True	string	Namnet på slutpunkten under profilen som är unik globalt.
profileName	path	True	string minLength: 1 maxLength: 260 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9])$	Namnet på Azure Front Door Standard eller Azure Front Door Premium som är unikt i resursgruppen.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
routeName	path	True	string	Namn på routningsregeln.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Svar

Name	Typ	Description
200 OK	Route	OKEJ
Other Status Codes	ErrorResponse	Azure Front Door-felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Routes_Get

Exempelbegäran

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

Exempelsvar

Statuskod:: 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"
  }
}

Definitioner

Name	Description
ActivatedResourceReference	Referens till en annan resurs tillsammans med dess tillstånd.
AFDEndpointProtocols	Protokoll som stöds för kundens slutpunkt.
AfdProvisioningState	Provisioneringsstatus
afdQueryStringCachingBehavior	Definierar hur Frontdoor cachelagrar begäranden som innehåller frågesträngar. Du kan ignorera alla frågesträngar när du cachelagrar, ignorera specifika frågesträngar, cachelagra varje begäran med en unik URL eller cachelagra specifika frågesträngar.
AfdRouteCacheConfiguration	Cachelagringsinställningar för en väg av cachelagringstyp. Om du vill inaktivera cachelagring ska du inte ange ett cacheConfiguration-objekt.
CompressionSettings	inställningar för komprimering.
createdByType	Den typ av identitet som skapade resursen.
DeploymentStatus
EnabledState	Om du vill aktivera användning av den här regeln. Tillåtna värden är "Aktiverade" eller "Inaktiverade"
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
ForwardingProtocol	Protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelar.
httpsRedirect	Om HTTP-trafik ska omdirigeras automatiskt till HTTPS-trafik. Observera att det här är ett enkelt sätt att konfigurera den här regeln och att det blir den första regeln som körs.
LinkToDefaultDomain	om den här vägen ska länkas till standardslutpunktsdomänen.
ResourceReference	Referens till en annan resurs.
Route	Namnmappning av egna vägar till eventuell information om vägar eller hemligheter.
systemData	Metadata som rör skapande och senaste ändring av resursen.

ActivatedResourceReference

Objekt

Referens till en annan resurs tillsammans med dess tillstånd.

Name	Typ	Description
id	string	Resurs-ID.
isActive	boolean	Om resursen är aktiv eller inaktiv

AFDEndpointProtocols

Uppräkning

Protokoll som stöds för kundens slutpunkt.

Värde	Description
Http
Https

AfdProvisioningState

Uppräkning

Provisioneringsstatus

Värde	Description
Succeeded
Failed
Updating
Deleting
Creating

afdQueryStringCachingBehavior

Uppräkning

Definierar hur Frontdoor cachelagrar begäranden som innehåller frågesträngar. Du kan ignorera alla frågesträngar när du cachelagrar, ignorera specifika frågesträngar, cachelagra varje begäran med en unik URL eller cachelagra specifika frågesträngar.

Värde	Description
IgnoreQueryString
UseQueryString
IgnoreSpecifiedQueryStrings
IncludeSpecifiedQueryStrings

AfdRouteCacheConfiguration

Objekt

Cachelagringsinställningar för en väg av cachelagringstyp. Om du vill inaktivera cachelagring ska du inte ange ett cacheConfiguration-objekt.

Name	Typ	Description
compressionSettings	CompressionSettings	komprimeringsinställningar.
queryParameters	string	frågeparametrar som ska inkluderas eller exkluderas (kommaavgränsade).
queryStringCachingBehavior	afdQueryStringCachingBehavior	Definierar hur Frontdoor cachelagrar begäranden som innehåller frågesträngar. Du kan ignorera alla frågesträngar när du cachelagrar, ignorera specifika frågesträngar, cachelagra varje begäran med en unik URL eller cachelagra specifika frågesträngar.

CompressionSettings

Objekt

inställningar för komprimering.

Name	Typ	Description
contentTypesToCompress	string[]	Lista över innehållstyper som komprimering gäller för. Värdet ska vara en giltig MIME-typ.
isCompressionEnabled	boolean	Anger om innehållskomprimering är aktiverat på AzureFrontDoor. Standardvärdet är "falsk". Om komprimering är aktiverat kommer innehållet att fungera som komprimerat om användaren begär en komprimerad version. Innehållet komprimeras inte på AzureFrontDoor när begärt innehåll är mindre än 1 byte eller större än 1 MB.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

DeploymentStatus

Uppräkning

Värde	Description
NotStarted
InProgress
Succeeded
Failed

EnabledState

Uppräkning

Om du vill aktivera användning av den här regeln. Tillåtna värden är "Aktiverade" eller "Inaktiverade"

Värde	Description
Enabled
Disabled

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

ForwardingProtocol

Uppräkning

Protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelar.

Värde	Description
HttpOnly
HttpsOnly
MatchRequest

httpsRedirect

Uppräkning

Om HTTP-trafik ska omdirigeras automatiskt till HTTPS-trafik. Observera att det här är ett enkelt sätt att konfigurera den här regeln och att det blir den första regeln som körs.

Värde	Description
Enabled
Disabled

LinkToDefaultDomain

Uppräkning

om den här vägen ska länkas till standardslutpunktsdomänen.

Värde	Description
Enabled
Disabled

ResourceReference

Objekt

Referens till en annan resurs.

Name	Typ	Description
id	string	Resurs-ID.

Route

Objekt

Namnmappning av egna vägar till eventuell information om vägar eller hemligheter.

Name	Typ	Standardvärde	Description
id	string (arm-id)		Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string		Namnet på resursen
properties.cacheConfiguration	AfdRouteCacheConfiguration		Cachelagringskonfigurationen för den här vägen. Om du vill inaktivera cachelagring ska du inte ange ett cacheConfiguration-objekt.
properties.customDomains	ActivatedResourceReference[]		Domäner som refereras av den här slutpunkten.
properties.deploymentStatus	DeploymentStatus
properties.enabledState	EnabledState		Om du vill aktivera användning av den här regeln. Tillåtna värden är "Aktiverade" eller "Inaktiverade"
properties.endpointName	string		Namnet på slutpunkten som innehåller vägen.
properties.forwardingProtocol	ForwardingProtocol	MatchRequest	Protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelar.
properties.httpsRedirect	httpsRedirect	Disabled	Om HTTP-trafik ska omdirigeras automatiskt till HTTPS-trafik. Observera att det här är ett enkelt sätt att konfigurera den här regeln och att det blir den första regeln som körs.
properties.linkToDefaultDomain	LinkToDefaultDomain	Disabled	om den här vägen ska länkas till standardslutpunktsdomänen.
properties.originGroup	ResourceReference		En referens till ursprungsgruppen.
properties.originPath	string		En katalogsökväg på ursprunget som AzureFrontDoor kan använda för att hämta innehåll från, t.ex. contoso.cloudapp.net/originpath.
properties.patternsToMatch	string[]		Regelns vägmönster.
properties.provisioningState	AfdProvisioningState		Provisioneringsstatus
properties.ruleSets	ResourceReference[]		regeluppsättningar som refereras av den här slutpunkten.
properties.supportedProtocols	AFDEndpointProtocols[]	[ "Http", "Https" ]	Lista över protokoll som stöds för den här vägen.
systemData	systemData		Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
type	string		Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

Dela via

Routes - Get

URI-parametrar

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

Routes_Get

Exempelbegäran

Exempelsvar

Definitioner

ActivatedResourceReference

AFDEndpointProtocols

AfdProvisioningState

afdQueryStringCachingBehavior

AfdRouteCacheConfiguration

CompressionSettings

createdByType

DeploymentStatus

EnabledState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ForwardingProtocol

httpsRedirect

LinkToDefaultDomain

ResourceReference

Route

systemData