Routes - Get
지정된 구독, 리소스 그룹, 프로필 및 AzureFrontDoor 엔드포인트에서 지정된 경로 이름을 가진 기존 경로를 가져옵니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}/routes/{routeName}?api-version=2023-05-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
endpoint
|
path | True |
string |
전역적으로 고유한 프로필 아래의 엔드포인트 이름입니다. |
profile
|
path | True |
string |
리소스 그룹 내에서 고유한 Azure Front Door 표준 또는 Azure Front Door 프리미엄 프로필의 이름입니다. |
resource
|
path | True |
string |
Azure 구독 내의 리소스 그룹 이름입니다. Regex pattern: |
route
|
path | True |
string |
라우팅 규칙의 이름입니다. |
subscription
|
path | True |
string |
Azure 구독 ID입니다. |
api-version
|
query | True |
string |
클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2023-05-01입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
정상 |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 Azure Front Door 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | 사용자 계정 가장 |
예제
Routes_Get
Sample Request
GET https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/afdEndpoints/endpoint1/routes/route1?api-version=2023-05-01
Sample Response
{
"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"
}
}
정의
Name | Description |
---|---|
Activated |
해당 상태와 함께 다른 리소스에 대한 참조입니다. |
AFDEndpoint |
고객의 엔드포인트에 대해 지원되는 프로토콜입니다. |
Afd |
오류 응답 |
Afd |
프로비전 상태 |
afd |
Frontdoor가 쿼리 문자열을 포함하는 요청을 캐시하는 방법을 정의합니다. 캐싱할 때 쿼리 문자열을 무시하거나, 특정 쿼리 문자열을 무시하거나, 고유한 URL로 모든 요청을 캐시하거나, 특정 쿼리 문자열을 캐시할 수 있습니다. |
Afd |
캐싱 형식 경로에 대한 캐싱 설정입니다. 캐싱을 사용하지 않도록 설정하려면 cacheConfiguration 개체를 제공하지 마세요. |
Compression |
압축을 위한 설정입니다. |
Deployment |
|
Enabled |
이 규칙의 사용을 활성화할지 여부입니다. 허용되는 값은 'Enabled' 또는 'Disabled'입니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Forwarding |
이 규칙이 트래픽을 백 엔드로 전달할 때 사용하는 프로토콜입니다. |
https |
HTTP 트래픽을 자동으로 HTTPS 트래픽으로 리디렉션할지 여부를 결정합니다. 이 규칙을 쉽게 설정할 수 있으며 첫 번째 규칙이 실행됩니다. |
Identity |
리소스를 만들/수정하는 ID 유형 |
Link |
이 경로가 기본 엔드포인트 도메인에 연결될지 여부입니다. |
Resource |
다른 리소스에 대한 참조입니다. |
Route |
경로 또는 비밀 관련 정보에 대한 식별 경로 이름 매핑입니다. |
System |
시스템 데이터만 읽기 |
ActivatedResourceReference
해당 상태와 함께 다른 리소스에 대한 참조입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스 ID입니다. |
isActive |
boolean |
리소스가 활성 상태인지 비활성 상태인지 여부 |
AFDEndpointProtocols
고객의 엔드포인트에 대해 지원되는 프로토콜입니다.
Name | 형식 | Description |
---|---|---|
Http |
string |
|
Https |
string |
AfdErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
Error 개체. |
AfdProvisioningState
프로비전 상태
Name | 형식 | Description |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
afdQueryStringCachingBehavior
Frontdoor가 쿼리 문자열을 포함하는 요청을 캐시하는 방법을 정의합니다. 캐싱할 때 쿼리 문자열을 무시하거나, 특정 쿼리 문자열을 무시하거나, 고유한 URL로 모든 요청을 캐시하거나, 특정 쿼리 문자열을 캐시할 수 있습니다.
Name | 형식 | Description |
---|---|---|
IgnoreQueryString |
string |
|
IgnoreSpecifiedQueryStrings |
string |
|
IncludeSpecifiedQueryStrings |
string |
|
UseQueryString |
string |
AfdRouteCacheConfiguration
캐싱 형식 경로에 대한 캐싱 설정입니다. 캐싱을 사용하지 않도록 설정하려면 cacheConfiguration 개체를 제공하지 마세요.
Name | 형식 | Description |
---|---|---|
compressionSettings |
압축 설정. |
|
queryParameters |
string |
포함하거나 제외할 쿼리 매개 변수(쉼표로 구분됨). |
queryStringCachingBehavior |
Frontdoor가 쿼리 문자열을 포함하는 요청을 캐시하는 방법을 정의합니다. 캐싱할 때 쿼리 문자열을 무시하거나, 특정 쿼리 문자열을 무시하거나, 고유한 URL로 모든 요청을 캐시하거나, 특정 쿼리 문자열을 캐시할 수 있습니다. |
CompressionSettings
압축을 위한 설정입니다.
Name | 형식 | Description |
---|---|---|
contentTypesToCompress |
string[] |
압축이 적용되는 콘텐츠 형식 목록입니다. 값은 유효한 MIME 형식이어야 합니다. |
isCompressionEnabled |
boolean |
AzureFrontDoor에서 콘텐츠 압축을 사용할 수 있는지 여부를 나타냅니다. 기본값은 false입니다. 압축을 사용하도록 설정하면 사용자가 압축된 버전을 요청하는 경우 콘텐츠가 압축된 상태로 제공됩니다. 요청된 콘텐츠가 1바이트보다 작거나 1MB보다 크면 AzureFrontDoor에서 콘텐츠가 압축되지 않습니다. |
DeploymentStatus
Name | 형식 | Description |
---|---|---|
Failed |
string |
|
InProgress |
string |
|
NotStarted |
string |
|
Succeeded |
string |
EnabledState
이 규칙의 사용을 활성화할지 여부입니다. 허용되는 값은 'Enabled' 또는 'Disabled'입니다.
Name | 형식 | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ForwardingProtocol
이 규칙이 트래픽을 백 엔드로 전달할 때 사용하는 프로토콜입니다.
Name | 형식 | Description |
---|---|---|
HttpOnly |
string |
|
HttpsOnly |
string |
|
MatchRequest |
string |
httpsRedirect
HTTP 트래픽을 자동으로 HTTPS 트래픽으로 리디렉션할지 여부를 결정합니다. 이 규칙을 쉽게 설정할 수 있으며 첫 번째 규칙이 실행됩니다.
Name | 형식 | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
IdentityType
리소스를 만들/수정하는 ID 유형
Name | 형식 | Description |
---|---|---|
application |
string |
|
key |
string |
|
managedIdentity |
string |
|
user |
string |
LinkToDefaultDomain
이 경로가 기본 엔드포인트 도메인에 연결될지 여부입니다.
Name | 형식 | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ResourceReference
다른 리소스에 대한 참조입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스 ID입니다. |
Route
경로 또는 비밀 관련 정보에 대한 식별 경로 이름 매핑입니다.
Name | 형식 | 기본값 | Description |
---|---|---|---|
id |
string |
리소스 ID입니다. |
|
name |
string |
리소스 이름입니다. |
|
properties.cacheConfiguration |
이 경로에 대한 캐싱 구성입니다. 캐싱을 사용하지 않도록 설정하려면 cacheConfiguration 개체를 제공하지 마세요. |
||
properties.customDomains |
이 엔드포인트에서 참조하는 도메인입니다. |
||
properties.deploymentStatus | |||
properties.enabledState |
이 규칙의 사용을 활성화할지 여부입니다. 허용되는 값은 'Enabled' 또는 'Disabled'입니다. |
||
properties.endpointName |
string |
경로를 보유하는 엔드포인트의 이름입니다. |
|
properties.forwardingProtocol | MatchRequest |
이 규칙이 트래픽을 백 엔드로 전달할 때 사용하는 프로토콜입니다. |
|
properties.httpsRedirect | Disabled |
HTTP 트래픽을 자동으로 HTTPS 트래픽으로 리디렉션할지 여부를 결정합니다. 이 규칙을 쉽게 설정할 수 있으며 첫 번째 규칙이 실행됩니다. |
|
properties.linkToDefaultDomain | Disabled |
이 경로가 기본 엔드포인트 도메인에 연결될지 여부입니다. |
|
properties.originGroup |
원본 그룹에 대한 참조입니다. |
||
properties.originPath |
string |
AzureFrontDoor에서 콘텐츠를 검색하는 데 사용할 수 있는 원본의 디렉터리 경로(예: contoso.cloudapp.net/originpath). |
|
properties.patternsToMatch |
string[] |
규칙의 경로 패턴입니다. |
|
properties.provisioningState |
프로비전 상태 |
||
properties.ruleSets |
이 엔드포인트에서 참조하는 규칙 집합입니다. |
||
properties.supportedProtocols | [ "Http", "Https" ] |
이 경로를 지원하는 프로토콜 목록입니다. |
|
systemData |
시스템 데이터만 읽기 |
||
type |
string |
리소스 종류. |
SystemData
시스템 데이터만 읽기
Name | 형식 | Description |
---|---|---|
createdAt |
string |
리소스 만들기 타임스탬프(UTC) |
createdBy |
string |
리소스를 만든 ID의 식별자 |
createdByType |
리소스를 만든 ID 유형 |
|
lastModifiedAt |
string |
리소스 마지막 수정의 타임스탬프(UTC) |
lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID의 식별자 |
lastModifiedByType |
리소스를 마지막으로 수정한 ID 유형 |