AFD Custom Domains - Get

Hizmet:: Front Door Service

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

Belirtilen abonelik, kaynak grubu ve profil altında belirtilen etki alanı adına sahip mevcut bir AzureFrontDoor etki alanını alır.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
customDomainName	path	True	string	Genel olarak benzersiz olan profilin altındaki etki alanını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 pattern: ^[-\w\._]+$	Azure aboneliğindeki Kaynak grubunun adı.
subscriptionId	path	True	string	Azure Abonelik Kimliği.
api-version	query	True	string	İstemci isteğiyle kullanılacak API'nin sürümü. Geçerli sürüm: 2025-04-15.

Yanıtlar

Name	Tür	Description
200 OK	AFDDomain	TAMAM
Other Status Codes	AfdErrorResponse	İş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

AFDCustomDomains_Get

Örnek isteği

HTTP

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

Örnek yanıt

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

Tanımlar

Name	Description
AfdCertificateType	SSL sertifikasının kaynağını tanımlar.
AfdCipherSuiteSetType	Https için kullanılacak şifreleme paketi kümesi türü
AfdCustomizedCipherSuiteForTls12	TLS 1.2 için şifre paketleri. minimumTlsVersion TLS 1.2'de en az bir tane gerekir.
AfdCustomizedCipherSuiteForTls13	TLS 1.3 için şifre paketleri. minimumTlsVersion TLS 1.2, TLS 1.3'te en az bir tane gereklidir.
AFDDomain	Müşterinin marka bilinci oluşturma amacıyla sağladığı uç nokta ana bilgisayar adıyla kolay etki alanı adı eşlemesi, ör. `www.contoso.com`
AFDDomainHttpsCustomizedCipherSuiteSet	cipherSuiteSetType Özelleştirilmiş olduğunda Https için kullanılacak özelleştirilmiş şifreleme paketi kümesi nesnesi.
AFDDomainHttpsParameters	Bir etki alanının güvenliğini sağlamak için özellikleri içeren JSON nesnesi.
AfdErrorResponse	Hata yanıtı
AfdMinimumTlsVersion	cipherSuiteSetType Özelleştirilmiş olduğunda Https için kullanılacak TLS protokol sürümü.
AfdProvisioningState	Sağlama durumu
DeploymentStatus
DomainValidationProperties	Etki alanını doğrulama özelliklerini içeren JSON nesnesi.
DomainValidationState	Sağlama alt durumu, özel HTTPS etkinleştirme/devre dışı bırakma işleminin ilerleme durumunu adım adım gösterir. DCV, DomainControlValidation anlamına gelir.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
IdentityType	Kaynakları oluşturan/değiştiren kimlik türü
ResourceReference	Başka bir kaynağa başvuru.
SystemData	Salt okunur sistem verileri

AfdCertificateType

Listeleme

SSL sertifikasının kaynağını tanımlar.

Değer	Description
CustomerCertificate
ManagedCertificate
AzureFirstPartyManagedCertificate

AfdCipherSuiteSetType

Listeleme

Https için kullanılacak şifreleme paketi kümesi türü

Değer	Description
Customized
TLS10_2019
TLS12_2022
TLS12_2023

AfdCustomizedCipherSuiteForTls12

Listeleme

TLS 1.2 için şifre paketleri. minimumTlsVersion TLS 1.2'de en az bir tane gerekir.

Değer	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

Listeleme

TLS 1.3 için şifre paketleri. minimumTlsVersion TLS 1.2, TLS 1.3'te en az bir tane gereklidir.

Değer	Description
TLS_AES_128_GCM_SHA256
TLS_AES_256_GCM_SHA384

AFDDomain

Object

Müşterinin marka bilinci oluşturma amacıyla sağladığı uç nokta ana bilgisayar adıyla kolay etki alanı adı eşlemesi, ör. www.contoso.com

Name	Tür	Description
id	string	Kaynak Kimliği.
name	string	Kaynak adı.
properties.azureDnsZone	ResourceReference	Azure DNS bölgesine kaynak başvurusu
properties.deploymentStatus	DeploymentStatus
properties.domainValidationState	DomainValidationState	Sağlama alt durumu, özel HTTPS etkinleştirme/devre dışı bırakma işleminin ilerleme durumunu adım adım gösterir. DCV, DomainControlValidation anlamına gelir.
properties.extendedProperties	object	etki alanları için geçiş özelliklerini temsil eden Key-Value çifti.
properties.hostName	string	Etki alanının ana bilgisayar adı. Etki alanı adı olmalıdır.
properties.preValidatedCustomDomainResourceId	ResourceReference	Özel etki alanı sahipliğinin yaygın hale geldiği Azure kaynağına kaynak başvurusu
properties.profileName	string	Etki alanını barındıran profilin adı.
properties.provisioningState	AfdProvisioningState	Sağlama durumu
properties.tlsSettings	AFDDomainHttpsParameters	AzureFrontDoor tarafından yönetilen sertifika veya kullanıcının kendi sertifikasını kullanarak etki alanı için HTTPS'nin nasıl etkinleştirileceğini belirten yapılandırma. Belirtilmezse ssl etkinleştirildiğinde varsayılan olarak AzureFrontDoor tarafından yönetilen sertifika kullanılır.
properties.validationProperties	DomainValidationProperties	Müşterinin etki alanı sahipliğini doğrulamak için ihtiyaç duyduğu değerler
systemData	SystemData	Salt okunur sistem verileri
type	string	Kaynak türü.

AFDDomainHttpsCustomizedCipherSuiteSet

Object

cipherSuiteSetType Özelleştirilmiş olduğunda Https için kullanılacak özelleştirilmiş şifreleme paketi kümesi nesnesi.

Name	Tür	Description
cipherSuiteSetForTls12	AfdCustomizedCipherSuiteForTls12[]	TLS 1.2 için şifre paketleri. minimumTlsVersion TLS 1.2'de en az bir tane gerekir.
cipherSuiteSetForTls13	AfdCustomizedCipherSuiteForTls13[]	TLS 1.3 için şifre paketleri. minimumTlsVersion TLS 1.2, TLS 1.3'te en az bir tane gereklidir.

AFDDomainHttpsParameters

Object

Bir etki alanının güvenliğini sağlamak için özellikleri içeren JSON nesnesi.

Name	Tür	Description
certificateType	AfdCertificateType	SSL sertifikasının kaynağını tanımlar.
cipherSuiteSetType	AfdCipherSuiteSetType	Https için kullanılacak şifreleme paketi kümesi türü
customizedCipherSuiteSet	AFDDomainHttpsCustomizedCipherSuiteSet	cipherSuiteSetType Özelleştirilmiş olduğunda Https için kullanılacak özelleştirilmiş şifreleme paketleri nesnesi.
minimumTlsVersion	AfdMinimumTlsVersion	cipherSuiteSetType Özelleştirilmiş olduğunda Https için kullanılacak TLS protokol sürümü.
secret	ResourceReference	Gizli diziye kaynak başvurusu. ıe. subs/rg/profile/secret

AfdErrorResponse

Object

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

AfdMinimumTlsVersion

Listeleme

cipherSuiteSetType Özelleştirilmiş olduğunda Https için kullanılacak TLS protokol sürümü.

Değer	Description
TLS10
TLS12
TLS13

AfdProvisioningState

Listeleme

Sağlama durumu

Değer	Description
Succeeded
Failed
Updating
Deleting
Creating

DeploymentStatus

Listeleme

Değer	Description
NotStarted
InProgress
Succeeded
Failed

DomainValidationProperties

Object

Etki alanını doğrulama özelliklerini içeren JSON nesnesi.

Name	Tür	Description
expirationDate	string	Belirtecin süresinin dolduğu tarih saati
validationToken	string	DNS TXT kaydı veya dosya tabanlı doğrulama için kullanılan sınama

DomainValidationState

Listeleme

Sağlama alt durumu, özel HTTPS etkinleştirme/devre dışı bırakma işleminin ilerleme durumunu adım adım gösterir. DCV, DomainControlValidation anlamına gelir.

Değer	Description
Unknown
Submitting
Pending
Rejected
TimedOut
PendingRevalidation
Approved
RefreshingValidationToken
InternalError

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.

IdentityType

Listeleme

Kaynakları oluşturan/değiştiren kimlik türü

Değer	Description
user
application
managedIdentity
key

ResourceReference

Object

Başka bir kaynağa başvuru.

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

SystemData

Object

Salt okunur sistem verileri

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

Aracılığıyla paylaş

AFD Custom Domains - Get

URI Parametreleri

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

AFDCustomDomains_Get

Örnek isteği

Örnek yanıt

Tanımlar

AfdCertificateType

AfdCipherSuiteSetType

AfdCustomizedCipherSuiteForTls12

AfdCustomizedCipherSuiteForTls13

AFDDomain

AFDDomainHttpsCustomizedCipherSuiteSet

AFDDomainHttpsParameters

AfdErrorResponse

AfdMinimumTlsVersion

AfdProvisioningState

DeploymentStatus

DomainValidationProperties

DomainValidationState

ErrorAdditionalInfo

ErrorDetail

IdentityType

ResourceReference

SystemData