Routes - Get

Hizmet:: Front Door Service

API Sürümü:: 2025-04-15

Belirtilen abonelik, kaynak grubu, profil ve AzureFrontDoor uç noktası altında belirtilen yol adına sahip mevcut bir yolu alır.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpointName	path	True	string	Genel olarak benzersiz olan profilin altındaki uç noktanın adı.
profileName	path	True	string minLength: 1 maxLength: 260 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9])$	Kaynak grubu içinde benzersiz olan Azure Front Door Standard veya Azure Front Door Premium'un adı.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
routeName	path	True	string	Yönlendirme kuralının adı.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	Route	Tamam
Other Status Codes	ErrorResponse	İşlemin neden başarısız olduğunu açıklayan Azure Front Door hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Routes_Get

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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"
  }
}

Tanımlar

Name	Description
ActivatedResourceReference	Durumuyla birlikte başka bir kaynağa başvuru.
AFDEndpointProtocols	Müşterinin uç noktası için desteklenen protokoller.
AfdProvisioningState	Sağlama durumu
afdQueryStringCachingBehavior	Frontdoor'un sorgu dizeleri içeren istekleri nasıl önbelleğe aldırdığını tanımlar. Önbelleğe alırken herhangi bir sorgu dizesini yoksayabilir, belirli sorgu dizelerini yoksayabilir, her isteği benzersiz bir URL ile önbelleğe alabilir veya belirli sorgu dizelerini önbelleğe alabilirsiniz.
AfdRouteCacheConfiguration	Önbelleğe alma türü yol için önbelleğe alma ayarları. Önbelleğe almayı devre dışı bırakmak için cacheConfiguration nesnesi sağlamayın.
CompressionSettings	ayarlarına bakın.
createdByType	Kaynağı oluşturan kimliğin türü.
DeploymentStatus
EnabledState	Bu kuralın kullanılmasının etkinleştirilip etkinleştirilmeyileceği. İzin verilen değerler 'Etkin' veya 'Devre Dışı'
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
ForwardingProtocol	Bu kuralın trafiği arka uçlara iletirken kullanacağı protokol.
httpsRedirect	HTTP trafiğinin otomatik olarak HTTPS trafiğine yönlendirilip yönlendirilmeyeceği. Bu kuralı ayarlamanın kolay bir yolu olduğunu ve yürütülecek ilk kural olacağını unutmayın.
LinkToDefaultDomain	bu yolun varsayılan uç nokta etki alanına bağlanıp bağlanmayacağı.
ResourceReference	Başka bir kaynağa başvuru.
Route	Tüm Yollar veya gizli diziyle ilgili bilgilerle eşlenerek Kolay Rotalar adı.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

ActivatedResourceReference

Object

Durumuyla birlikte başka bir kaynağa başvuru.

Name	Tür	Description
id	string	Kaynak Kimliği.
isActive	boolean	Kaynağın etkin mi yoksa etkin değil mi olduğu

AFDEndpointProtocols

Listeleme

Müşterinin uç noktası için desteklenen protokoller.

Değer	Description
Http
Https

AfdProvisioningState

Listeleme

Sağlama durumu

Değer	Description
Succeeded
Failed
Updating
Deleting
Creating

afdQueryStringCachingBehavior

Listeleme

Frontdoor'un sorgu dizeleri içeren istekleri nasıl önbelleğe aldırdığını tanımlar. Önbelleğe alırken herhangi bir sorgu dizesini yoksayabilir, belirli sorgu dizelerini yoksayabilir, her isteği benzersiz bir URL ile önbelleğe alabilir veya belirli sorgu dizelerini önbelleğe alabilirsiniz.

Değer	Description
IgnoreQueryString
UseQueryString
IgnoreSpecifiedQueryStrings
IncludeSpecifiedQueryStrings

AfdRouteCacheConfiguration

Object

Önbelleğe alma türü yol için önbelleğe alma ayarları. Önbelleğe almayı devre dışı bırakmak için cacheConfiguration nesnesi sağlamayın.

Name	Tür	Description
compressionSettings	CompressionSettings	sıkıştırma ayarları.
queryParameters	string	dahil etmek veya dışlamak için sorgu parametreleri (virgülle ayrılmış).
queryStringCachingBehavior	afdQueryStringCachingBehavior	Frontdoor'un sorgu dizeleri içeren istekleri nasıl önbelleğe aldırdığını tanımlar. Önbelleğe alırken herhangi bir sorgu dizesini yoksayabilir, belirli sorgu dizelerini yoksayabilir, her isteği benzersiz bir URL ile önbelleğe alabilir veya belirli sorgu dizelerini önbelleğe alabilirsiniz.

CompressionSettings

Object

ayarlarına bakın.

Name	Tür	Description
contentTypesToCompress	string[]	Sıkıştırmanın uygulandığı içerik türlerinin listesi. Değer geçerli bir MIME türü olmalıdır.
isCompressionEnabled	boolean	AzureFrontDoor'da içerik sıkıştırmanın etkinleştirilip etkinleştirilmediğini gösterir. Varsayılan değer yanlış'tır. Sıkıştırma etkinleştirilirse, kullanıcı sıkıştırılmış bir sürüm için istekte bulunursa içerik sıkıştırılmış olarak sunulur. İstenen içerik 1 bayttan küçük veya 1 MB'tan büyük olduğunda azurefrontdoor'da içerik sıkıştırılamaz.

createdByType

Listeleme

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

DeploymentStatus

Listeleme

Değer	Description
NotStarted
InProgress
Succeeded
Failed

EnabledState

Listeleme

Bu kuralın kullanılmasının etkinleştirilip etkinleştirilmeyileceği. İzin verilen değerler 'Etkin' veya 'Devre Dışı'

Değer	Description
Enabled
Disabled

ErrorAdditionalInfo

Object

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Object

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Object

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

ForwardingProtocol

Listeleme

Bu kuralın trafiği arka uçlara iletirken kullanacağı protokol.

Değer	Description
HttpOnly
HttpsOnly
MatchRequest

httpsRedirect

Listeleme

HTTP trafiğinin otomatik olarak HTTPS trafiğine yönlendirilip yönlendirilmeyeceği. Bu kuralı ayarlamanın kolay bir yolu olduğunu ve yürütülecek ilk kural olacağını unutmayın.

Değer	Description
Enabled
Disabled

LinkToDefaultDomain

Listeleme

bu yolun varsayılan uç nokta etki alanına bağlanıp bağlanmayacağı.

Değer	Description
Enabled
Disabled

ResourceReference

Object

Başka bir kaynağa başvuru.

Name	Tür	Description
id	string	Kaynak Kimliği.

Route

Object

Tüm Yollar veya gizli diziyle ilgili bilgilerle eşlenerek Kolay Rotalar adı.

Name	Tür	Default value	Description
id	string (arm-id)		Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string		Kaynağın adı
properties.cacheConfiguration	AfdRouteCacheConfiguration		Bu yol için önbelleğe alma yapılandırması. Önbelleğe almayı devre dışı bırakmak için cacheConfiguration nesnesi sağlamayın.
properties.customDomains	ActivatedResourceReference[]		Bu uç nokta tarafından başvuruda yer alan etki alanları.
properties.deploymentStatus	DeploymentStatus
properties.enabledState	EnabledState		Bu kuralın kullanılmasının etkinleştirilip etkinleştirilmeyileceği. İzin verilen değerler 'Etkin' veya 'Devre Dışı'
properties.endpointName	string		Yolu tutan uç noktanın adı.
properties.forwardingProtocol	ForwardingProtocol	MatchRequest	Bu kuralın trafiği arka uçlara iletirken kullanacağı protokol.
properties.httpsRedirect	httpsRedirect	Disabled	HTTP trafiğinin otomatik olarak HTTPS trafiğine yönlendirilip yönlendirilmeyeceği. Bu kuralı ayarlamanın kolay bir yolu olduğunu ve yürütülecek ilk kural olacağını unutmayın.
properties.linkToDefaultDomain	LinkToDefaultDomain	Disabled	bu yolun varsayılan uç nokta etki alanına bağlanıp bağlanmayacağı.
properties.originGroup	ResourceReference		Kaynak grubuna başvuru.
properties.originPath	string		AzureFrontDoor'un içerik almak için kullanabildiği kaynakta bir dizin yolu, örneğin contoso.cloudapp.net/originpath.
properties.patternsToMatch	string[]		Kuralın yol desenleri.
properties.provisioningState	AfdProvisioningState		Sağlama durumu
properties.ruleSets	ResourceReference[]		bu uç nokta tarafından başvurulduğunda kural kümeleri.
properties.supportedProtocols	AFDEndpointProtocols[]	[ "Http", "Https" ]	Bu yol için desteklenen protokollerin listesi.
systemData	systemData		createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
type	string		Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

systemData

Object

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

Aracılığıyla paylaş

Routes - Get

URI Parametreleri

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

Routes_Get

Örnek isteği

Örnek yanıt

Tanımlar

ActivatedResourceReference

AFDEndpointProtocols

AfdProvisioningState

afdQueryStringCachingBehavior

AfdRouteCacheConfiguration

CompressionSettings

createdByType

DeploymentStatus

EnabledState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ForwardingProtocol

httpsRedirect

LinkToDefaultDomain

ResourceReference

Route

systemData