AFD Custom Domains - Get

서비스:: Front Door Service

API 버전:: 2025-04-15

지정된 구독, 리소스 그룹 및 프로필 아래에 지정된 도메인 이름을 가진 기존 AzureFrontDoor 도메인을 가져옵니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
customDomainName	path	True	string	전역적으로 고유한 프로필 아래의 도메인 이름입니다.
profileName	path	True	string minLength: 1 maxLength: 260 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9])$	리소스 그룹 내에서 고유한 Azure Front Door 표준 또는 Azure Front Door Premium의 이름입니다.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Azure 구독 내의 리소스 그룹의 이름입니다.
subscriptionId	path	True	string	Azure 구독 ID입니다.
api-version	query	True	string	클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2025-04-15입니다.

응답

Name	형식	Description
200 OK	AFDDomain	그래
Other Status Codes	AfdErrorResponse	작업이 실패한 이유를 설명하는 Azure Front Door 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

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

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

AFDCustomDomains_Get

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/customDomains/domain1?api-version=2025-04-15

샘플 응답

상태 코드:: 200

{
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/customdomains/domain1",
  "name": "domain1",
  "type": "Microsoft.Cdn/profiles/customdomains",
  "properties": {
    "profileName": "profile1",
    "hostName": "www.contoso.com",
    "tlsSettings": {
      "certificateType": "ManagedCertificate",
      "cipherSuiteSetType": "Customized",
      "minimumTlsVersion": "TLS12",
      "customizedCipherSuiteSet": {
        "cipherSuiteSetForTls12": [
          "ECDHE_RSA_AES128_GCM_SHA256"
        ],
        "cipherSuiteSetForTls13": [
          "TLS_AES_128_GCM_SHA256",
          "TLS_AES_256_GCM_SHA384"
        ]
      },
      "secret": {
        "id": ""
      }
    },
    "azureDnsZone": {
      "id": ""
    },
    "preValidatedCustomDomainResourceId": {
      "id": ""
    },
    "validationProperties": {
      "validationToken": "8c9912db-c615-4eeb-8465",
      "expirationDate": "2009-06-15T13:45:43.0000000Z"
    },
    "domainValidationState": "Pending",
    "provisioningState": "Updating",
    "deploymentStatus": "NotStarted"
  }
}

정의

Name	Description
AfdCertificateType	SSL 인증서의 원본을 정의합니다.
AfdCipherSuiteSetType	Https에 사용할 암호 그룹 집합 형식
AfdCustomizedCipherSuiteForTls12	TLS 1.2용 암호 그룹. minimumTlsVersion TLS 1.2에서 하나 이상 필요합니다.
AfdCustomizedCipherSuiteForTls13	TLS 1.3용 암호 그룹. minimumTlsVersion TLS 1.2, TLS 1.3에서 하나 이상 필요합니다.
AFDDomain	고객이 브랜딩 목적으로 제공하는 엔드포인트 호스트 이름에 대한 친숙한 도메인 이름 매핑(예: `www.contoso.com`.
AFDDomainHttpsCustomizedCipherSuiteSet	cipherSuiteSetType이 사용자 지정될 때 Https에 사용할 사용자 지정된 암호 그룹 집합 개체입니다.
AFDDomainHttpsParameters	도메인을 보호하는 속성을 포함하는 JSON 개체입니다.
AfdErrorResponse	오류 응답
AfdMinimumTlsVersion	cipherSuiteSetType이 사용자 지정될 때 Https에 사용되는 TLS 프로토콜 버전입니다.
AfdProvisioningState	프로비전 상태
DeploymentStatus
DomainValidationProperties	도메인의 유효성을 검사하는 속성을 포함하는 JSON 개체입니다.
DomainValidationState	프로비전 하위 상태는 사용자 지정 HTTPS 사용/비활성화 프로세스의 진행률을 단계별로 보여 줍니다. DCV는 DomainControlValidation을 의미합니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
IdentityType	리소스를 만들거나 수정하는 ID의 형식입니다.
ResourceReference	다른 리소스에 대한 참조입니다.
SystemData	시스템 데이터 읽기 전용

AfdCertificateType

열거형

SSL 인증서의 원본을 정의합니다.

값	Description
CustomerCertificate
ManagedCertificate
AzureFirstPartyManagedCertificate

AfdCipherSuiteSetType

열거형

Https에 사용할 암호 그룹 집합 형식

값	Description
Customized
TLS10_2019
TLS12_2022
TLS12_2023

AfdCustomizedCipherSuiteForTls12

열거형

TLS 1.2용 암호 그룹. minimumTlsVersion TLS 1.2에서 하나 이상 필요합니다.

값	Description
ECDHE_RSA_AES128_GCM_SHA256
ECDHE_RSA_AES256_GCM_SHA384
DHE_RSA_AES256_GCM_SHA384
DHE_RSA_AES128_GCM_SHA256
ECDHE_RSA_AES128_SHA256
ECDHE_RSA_AES256_SHA384

AfdCustomizedCipherSuiteForTls13

열거형

TLS 1.3용 암호 그룹. minimumTlsVersion TLS 1.2, TLS 1.3에서 하나 이상 필요합니다.

값	Description
TLS_AES_128_GCM_SHA256
TLS_AES_256_GCM_SHA384

AFDDomain

Object

고객이 브랜딩 목적으로 제공하는 엔드포인트 호스트 이름에 대한 친숙한 도메인 이름 매핑(예: www.contoso.com.

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.azureDnsZone	ResourceReference	Azure DNS 영역에 대한 리소스 참조
properties.deploymentStatus	DeploymentStatus
properties.domainValidationState	DomainValidationState	프로비전 하위 상태는 사용자 지정 HTTPS 사용/비활성화 프로세스의 진행률을 단계별로 보여 줍니다. DCV는 DomainControlValidation을 의미합니다.
properties.extendedProperties	object	도메인의 마이그레이션 속성을 나타내는 Key-Value 쌍입니다.
properties.hostName	string	도메인의 호스트 이름입니다. 도메인 이름이어야 합니다.
properties.preValidatedCustomDomainResourceId	ResourceReference	사용자 지정 도메인 소유권이 사전 검증된 Azure 리소스에 대한 리소스 참조
properties.profileName	string	도메인을 보유하는 프로필의 이름입니다.
properties.provisioningState	AfdProvisioningState	프로비전 상태
properties.tlsSettings	AFDDomainHttpsParameters	AzureFrontDoor 관리 인증서 또는 사용자 고유의 인증서를 사용하여 도메인에 대해 HTTPS를 사용하도록 설정하는 방법을 지정하는 구성입니다. 지정하지 않으면 ssl을 사용하도록 설정하면 기본적으로 AzureFrontDoor 관리 인증서가 사용됩니다.
properties.validationProperties	DomainValidationProperties	고객이 도메인 소유권의 유효성을 검사하는 데 필요한 값
systemData	SystemData	시스템 데이터 읽기 전용
type	string	리소스 종류입니다.

AFDDomainHttpsCustomizedCipherSuiteSet

Object

cipherSuiteSetType이 사용자 지정될 때 Https에 사용할 사용자 지정된 암호 그룹 집합 개체입니다.

Name	형식	Description
cipherSuiteSetForTls12	AfdCustomizedCipherSuiteForTls12[]	TLS 1.2용 암호 그룹. minimumTlsVersion TLS 1.2에서 하나 이상 필요합니다.
cipherSuiteSetForTls13	AfdCustomizedCipherSuiteForTls13[]	TLS 1.3용 암호 그룹. minimumTlsVersion TLS 1.2, TLS 1.3에서 하나 이상 필요합니다.

AFDDomainHttpsParameters

Object

도메인을 보호하는 속성을 포함하는 JSON 개체입니다.

Name	형식	Description
certificateType	AfdCertificateType	SSL 인증서의 원본을 정의합니다.
cipherSuiteSetType	AfdCipherSuiteSetType	Https에 사용할 암호 그룹 집합 형식
customizedCipherSuiteSet	AFDDomainHttpsCustomizedCipherSuiteSet	cipherSuiteSetType이 사용자 지정될 때 Https에 사용할 사용자 지정된 암호 그룹 개체입니다.
minimumTlsVersion	AfdMinimumTlsVersion	cipherSuiteSetType이 사용자 지정될 때 Https에 사용되는 TLS 프로토콜 버전입니다.
secret	ResourceReference	비밀에 대한 리소스 참조입니다. 즉, subs/rg/profile/secret

AfdErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

AfdMinimumTlsVersion

열거형

cipherSuiteSetType이 사용자 지정될 때 Https에 사용되는 TLS 프로토콜 버전입니다.

값	Description
TLS10
TLS12
TLS13

AfdProvisioningState

열거형

프로비전 상태

값	Description
Succeeded
Failed
Updating
Deleting
Creating

DeploymentStatus

열거형

값	Description
NotStarted
InProgress
Succeeded
Failed

DomainValidationProperties

Object

도메인의 유효성을 검사하는 속성을 포함하는 JSON 개체입니다.

Name	형식	Description
expirationDate	string	토큰이 만료되는 날짜 시간입니다.
validationToken	string	DNS TXT 레코드 또는 파일 기반 유효성 검사에 사용되는 과제

DomainValidationState

열거형

프로비전 하위 상태는 사용자 지정 HTTPS 사용/비활성화 프로세스의 진행률을 단계별로 보여 줍니다. DCV는 DomainControlValidation을 의미합니다.

값	Description
Unknown
Submitting
Pending
Rejected
TimedOut
PendingRevalidation
Approved
RefreshingValidationToken
InternalError

ErrorAdditionalInfo

Object

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

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

IdentityType

열거형

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

값	Description
user
application
managedIdentity
key

ResourceReference

Object

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

Name	형식	Description
id	string	리소스 ID입니다.

SystemData

Object

시스템 데이터 읽기 전용

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)
createdBy	string	리소스를 만든 ID의 식별자입니다.
createdByType	IdentityType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID의 식별자입니다.
lastModifiedByType	IdentityType	리소스를 마지막으로 수정한 ID의 형식입니다.

다음을 통해 공유

AFD Custom Domains - Get

URI 매개 변수

응답

보안

azure_auth

범위

예제

AFDCustomDomains_Get

샘플 요청

샘플 응답

정의

AfdCertificateType

AfdCipherSuiteSetType

AfdCustomizedCipherSuiteForTls12

AfdCustomizedCipherSuiteForTls13

AFDDomain

AFDDomainHttpsCustomizedCipherSuiteSet

AFDDomainHttpsParameters

AfdErrorResponse

AfdMinimumTlsVersion

AfdProvisioningState

DeploymentStatus

DomainValidationProperties

DomainValidationState

ErrorAdditionalInfo

ErrorDetail

IdentityType

ResourceReference

SystemData