Routes - Get

지정된 구독, 리소스 그룹, 프로필 및 AzureFrontDoor 엔드포인트에서 지정된 경로 이름을 가진 기존 경로를 가져옵니다.

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

URI 매개 변수

Name In Required Type Description
endpointName
path True
  • string

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

profileName
path True
  • string

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

resourceGroupName
path True
  • string

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

Regex pattern: ^[-\w\._\(\)]+$

routeName
path True
  • string

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

subscriptionId
path True
  • string

Azure 구독 ID입니다.

api-version
query True
  • string

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

응답

Name Type Description
200 OK

확인

Other Status Codes

작업이 실패한 이유를 설명하는 오류 응답을 CDN.

보안

azure_auth

OAuth2 Flow Azure Active Directory.

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=2021-06-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"
  }
}

정의

ActivatedResourceReference

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

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 Type Description
id
  • string

리소스 ID입니다.

isActive
  • boolean

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

AfdErrorResponse

오류 응답

Name Type Description
error

오류 개체입니다.

AfdProvisioningState

프로비전 상태

Name Type Description
Creating
  • string
Deleting
  • string
Failed
  • string
Succeeded
  • string
Updating
  • string

afdQueryStringCachingBehavior

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

Name Type Description
IgnoreQueryString
  • string
IgnoreSpecifiedQueryStrings
  • string
IncludeSpecifiedQueryStrings
  • string
UseQueryString
  • string

AfdRouteCacheConfiguration

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

Name Type Description
compressionSettings

압축 설정입니다.

queryParameters
  • string

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

queryStringCachingBehavior

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

CompressionSettings

압축을 위한 설정입니다.

Name Type Description
contentTypesToCompress
  • string[]

압축이 적용되는 콘텐츠 형식 목록입니다. 값은 유효한 MIME 형식이어야 합니다.

isCompressionEnabled
  • boolean

AzureFrontDoor에서 콘텐츠 압축을 사용할 수 있는지 여부를 나타냅니다. 기본값은 false입니다. 압축을 사용하도록 설정하면 사용자가 압축된 버전을 요청하는 경우 콘텐츠가 압축으로 제공됩니다. 요청된 콘텐츠가 1바이트보다 작거나 1MB보다 큰 경우 AzureFrontDoor에서 콘텐츠가 압축되지 않습니다.

DeploymentStatus

Name Type Description
Failed
  • string
InProgress
  • string
NotStarted
  • string
Succeeded
  • string

EnabledState

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

Name Type Description
Disabled
  • string
Enabled
  • string

ErrorAdditionalInfo

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

Name Type Description
info
  • object

추가 정보입니다.

type
  • string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name Type Description
additionalInfo

오류 추가 정보입니다.

code
  • string

오류 코드입니다.

details

오류 세부 정보입니다.

message
  • string

오류 메시지입니다.

target
  • string

오류 대상입니다.

ForwardingProtocol

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

Name Type Description
HttpOnly
  • string
HttpsOnly
  • string
MatchRequest
  • string

httpsRedirect

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

Name Type Description
Disabled
  • string
Enabled
  • string

IdentityType

리소스를 만들거나 수정하는 ID의 형식입니다.

Name Type Description
application
  • string
key
  • string
managedIdentity
  • string
user
  • string

LinkToDefaultDomain

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

Name Type Description
Disabled
  • string
Enabled
  • string

ResourceReference

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

Name Type Description
id
  • string

리소스 ID입니다.

Route

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

Name Type Description
id
  • string

리소스 ID입니다.

name
  • string

리소스 이름입니다.

properties.cacheConfiguration

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

properties.customDomains

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

properties.deploymentStatus
properties.enabledState

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

properties.endpointName
  • string

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

properties.forwardingProtocol

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

properties.httpsRedirect

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

properties.linkToDefaultDomain

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

properties.originGroup

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

properties.originPath
  • string

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

properties.patternsToMatch
  • string[]

규칙의 경로 패턴입니다.

properties.provisioningState

프로비전 상태

properties.ruleSets

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

properties.supportedProtocols
  • string[]

이 경로에 대해 지원되는 프로토콜 목록입니다.

systemData

시스템 데이터만 읽기

type
  • string

리소스 종류.

SystemData

시스템 데이터만 읽기

Name Type Description
createdAt
  • string

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

createdBy
  • string

리소스를 만든 ID의 식별자입니다.

createdByType

리소스를 만든 ID의 형식입니다.

lastModifiedAt
  • string

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

lastModifiedBy
  • string

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

lastModifiedByType

리소스를 마지막으로 수정한 ID의 형식입니다.