다음을 통해 공유


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
endpointName
path True

string

전역적으로 고유한 프로필 아래의 엔드포인트 이름입니다.

profileName
path True

string

리소스 그룹 내에서 고유한 Azure Front Door 표준 또는 Azure Front Door 프리미엄 프로필의 이름입니다.

resourceGroupName
path True

string

Azure 구독 내의 리소스 그룹 이름입니다.

regex 패턴: ^[-\w\._\(\)]+$

routeName
path True

string

라우팅 규칙의 이름입니다.

subscriptionId
path True

string

Azure 구독 ID입니다.

api-version
query True

string

클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2023-05-01입니다.

응답

Name 형식 Description
200 OK

Route

정상

Other Status Codes

AfdErrorResponse

작업이 실패한 이유를 설명하는 Azure Front Door 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Routes_Get

샘플 요청

GET https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/afdEndpoints/endpoint1/routes/route1?api-version=2023-05-01

샘플 응답

{
  "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
ActivatedResourceReference

해당 상태와 함께 다른 리소스에 대한 참조입니다.

AFDEndpointProtocols

고객의 엔드포인트에 대해 지원되는 프로토콜입니다.

AfdErrorResponse

오류 응답

AfdProvisioningState

프로비전 상태

afdQueryStringCachingBehavior

Frontdoor가 쿼리 문자열을 포함하는 요청을 캐시하는 방법을 정의합니다. 캐싱할 때 쿼리 문자열을 무시하거나, 특정 쿼리 문자열을 무시하거나, 고유한 URL로 모든 요청을 캐시하거나, 특정 쿼리 문자열을 캐시할 수 있습니다.

AfdRouteCacheConfiguration

캐싱 형식 경로에 대한 캐싱 설정입니다. 캐싱을 사용하지 않도록 설정하려면 cacheConfiguration 개체를 제공하지 마세요.

CompressionSettings

압축을 위한 설정입니다.

DeploymentStatus
EnabledState

이 규칙의 사용을 활성화할지 여부입니다. 허용되는 값은 'Enabled' 또는 'Disabled'입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ForwardingProtocol

이 규칙이 트래픽을 백 엔드로 전달할 때 사용하는 프로토콜입니다.

httpsRedirect

HTTP 트래픽을 자동으로 HTTPS 트래픽으로 리디렉션할지 여부를 결정합니다. 이 규칙을 쉽게 설정할 수 있으며 첫 번째 규칙이 실행됩니다.

IdentityType

리소스를 만들/수정하는 ID 유형

LinkToDefaultDomain

이 경로가 기본 엔드포인트 도메인에 연결될지 여부입니다.

ResourceReference

다른 리소스에 대한 참조입니다.

Route

경로 또는 비밀 관련 정보에 대한 식별 경로 이름 매핑입니다.

SystemData

시스템 데이터만 읽기

ActivatedResourceReference

해당 상태와 함께 다른 리소스에 대한 참조입니다.

Name 형식 Description
id

string

리소스 ID입니다.

isActive

boolean

리소스가 활성 상태인지 비활성 상태인지 여부

AFDEndpointProtocols

고객의 엔드포인트에 대해 지원되는 프로토콜입니다.

Name 형식 Description
Http

string

Https

string

AfdErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

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

CompressionSettings

압축 설정.

queryParameters

string

포함하거나 제외할 쿼리 매개 변수(쉼표로 구분됨).

queryStringCachingBehavior

afdQueryStringCachingBehavior

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

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

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 형식 Default value Description
id

string

리소스 ID입니다.

name

string

리소스 이름입니다.

properties.cacheConfiguration

AfdRouteCacheConfiguration

이 경로에 대한 캐싱 구성입니다. 캐싱을 사용하지 않도록 설정하려면 cacheConfiguration 개체를 제공하지 마세요.

properties.customDomains

ActivatedResourceReference[]

이 엔드포인트에서 참조하는 도메인입니다.

properties.deploymentStatus

DeploymentStatus

properties.enabledState

EnabledState

이 규칙의 사용을 활성화할지 여부입니다. 허용되는 값은 'Enabled' 또는 'Disabled'입니다.

properties.endpointName

string

경로를 보유하는 엔드포인트의 이름입니다.

properties.forwardingProtocol

ForwardingProtocol

MatchRequest

이 규칙이 트래픽을 백 엔드로 전달할 때 사용하는 프로토콜입니다.

properties.httpsRedirect

httpsRedirect

Disabled

HTTP 트래픽을 자동으로 HTTPS 트래픽으로 리디렉션할지 여부를 결정합니다. 이 규칙을 쉽게 설정할 수 있으며 첫 번째 규칙이 실행됩니다.

properties.linkToDefaultDomain

LinkToDefaultDomain

Disabled

이 경로가 기본 엔드포인트 도메인에 연결될지 여부입니다.

properties.originGroup

ResourceReference

원본 그룹에 대한 참조입니다.

properties.originPath

string

AzureFrontDoor에서 콘텐츠를 검색하는 데 사용할 수 있는 원본의 디렉터리 경로(예: contoso.cloudapp.net/originpath).

properties.patternsToMatch

string[]

규칙의 경로 패턴입니다.

properties.provisioningState

AfdProvisioningState

프로비전 상태

properties.ruleSets

ResourceReference[]

이 엔드포인트에서 참조하는 규칙 집합입니다.

properties.supportedProtocols

AFDEndpointProtocols[]

[ "Http", "Https" ]

이 경로를 지원하는 프로토콜 목록입니다.

systemData

SystemData

시스템 데이터만 읽기

type

string

리소스 종류.

SystemData

시스템 데이터만 읽기

Name 형식 Description
createdAt

string

리소스 만들기 타임스탬프(UTC)

createdBy

string

리소스를 만든 ID의 식별자

createdByType

IdentityType

리소스를 만든 ID 유형

lastModifiedAt

string

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy

string

리소스를 마지막으로 수정한 ID의 식별자

lastModifiedByType

IdentityType

리소스를 마지막으로 수정한 ID 유형