AFD Custom Domains - Get

Layanan:: Front Door Service

Versi API:: 2025-04-15

Mendapatkan domain AzureFrontDoor yang sudah ada dengan nama domain yang ditentukan di bawah langganan, grup sumber daya, dan profil yang ditentukan.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
customDomainName	path	True	string	Nama domain di bawah profil yang unik secara global.
profileName	path	True	string minLength: 1 maxLength: 260 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9])$	Nama Azure Front Door Standard atau Azure Front Door Premium yang unik dalam grup sumber daya.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Nama grup Sumber Daya dalam langganan Azure.
subscriptionId	path	True	string	ID Langganan Azure.
api-version	query	True	string	Versi API yang akan digunakan dengan permintaan klien. Versi saat ini adalah 2025-04-15.

Respons

Nama	Jenis	Deskripsi
200 OK	AFDDomain	OKE
Other Status Codes	AfdErrorResponse	Respons kesalahan Azure Front Door yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

AFDCustomDomains_Get

Permintaan sampel

HTTP

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

Respon sampel

Kode status:: 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"
  }
}

Definisi

Nama	Deskripsi
AfdCertificateType	Menentukan sumber sertifikat SSL.
AfdCipherSuiteSetType	jenis set rangkaian sandi yang akan digunakan untuk Https
AfdCustomizedCipherSuiteForTls12	Suite cipher untuk TLS 1.2. Diperlukan setidaknya satu dalam minimumTlsVersion TLS 1.2.
AfdCustomizedCipherSuiteForTls13	Suite cipher untuk TLS 1.3. Diperlukan setidaknya satu dalam minimumTlsVersion TLS 1.2, TLS 1.3.
AFDDomain	Pemetaan nama domain yang ramah ke nama host titik akhir yang disediakan pelanggan untuk tujuan branding, misalnya `www.contoso.com`.
AFDDomainHttpsCustomizedCipherSuiteSet	Objek set cipher suite yang dikustomisasi yang akan digunakan untuk Https saat cipherSuiteSetType disesuaikan.
AFDDomainHttpsParameters	Objek JSON yang berisi properti untuk mengamankan domain.
AfdErrorResponse	Tanggapan kesalahan
AfdMinimumTlsVersion	Versi protokol TLS yang akan digunakan untuk Https saat cipherSuiteSetType Disesuaikan.
AfdProvisioningState	Status penyediaan
DeploymentStatus
DomainValidationProperties	Objek JSON yang berisi properti untuk memvalidasi domain.
DomainValidationState	Substat provisi menunjukkan kemajuan HTTPS kustom yang mengaktifkan/menonaktifkan proses langkah demi langkah. DCV adalah singkatan DomainControlValidation.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
IdentityType	Jenis identitas yang membuat/memodifikasi sumber daya
ResourceReference	Referensi ke sumber daya lain.
SystemData	Membaca hanya data sistem

AfdCertificateType

Enumeration

Menentukan sumber sertifikat SSL.

Nilai	Deskripsi
CustomerCertificate
ManagedCertificate
AzureFirstPartyManagedCertificate

AfdCipherSuiteSetType

Enumeration

jenis set rangkaian sandi yang akan digunakan untuk Https

Nilai	Deskripsi
Customized
TLS10_2019
TLS12_2022
TLS12_2023

AfdCustomizedCipherSuiteForTls12

Enumeration

Suite cipher untuk TLS 1.2. Diperlukan setidaknya satu dalam minimumTlsVersion TLS 1.2.

Nilai	Deskripsi
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

Enumeration

Suite cipher untuk TLS 1.3. Diperlukan setidaknya satu dalam minimumTlsVersion TLS 1.2, TLS 1.3.

Nilai	Deskripsi
TLS_AES_128_GCM_SHA256
TLS_AES_256_GCM_SHA384

AFDDomain

Objek

Pemetaan nama domain yang ramah ke nama host titik akhir yang disediakan pelanggan untuk tujuan branding, misalnya www.contoso.com.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
name	string	Nama sumber daya.
properties.azureDnsZone	ResourceReference	Referensi sumber daya ke zona Azure DNS
properties.deploymentStatus	DeploymentStatus
properties.domainValidationState	DomainValidationState	Substat provisi menunjukkan kemajuan HTTPS kustom yang mengaktifkan/menonaktifkan proses langkah demi langkah. DCV adalah singkatan DomainControlValidation.
properties.extendedProperties	object	pasangan Key-Value mewakili properti migrasi untuk domain.
properties.hostName	string	Nama host domain. Harus berupa nama domain.
properties.preValidatedCustomDomainResourceId	ResourceReference	Referensi sumber daya ke sumber daya Azure tempat kepemilikan domain kustom divalidasi sebelumnya
properties.profileName	string	Nama profil yang menyimpan domain.
properties.provisioningState	AfdProvisioningState	Status penyediaan
properties.tlsSettings	AFDDomainHttpsParameters	Konfigurasi yang menentukan cara mengaktifkan HTTPS untuk domain - menggunakan sertifikat terkelola AzureFrontDoor atau sertifikat pengguna sendiri. Jika tidak ditentukan, mengaktifkan ssl menggunakan sertifikat terkelola AzureFrontDoor secara default.
properties.validationProperties	DomainValidationProperties	Nilai yang dibutuhkan pelanggan untuk memvalidasi kepemilikan domain
systemData	SystemData	Membaca hanya data sistem
type	string	Jenis sumber daya.

AFDDomainHttpsCustomizedCipherSuiteSet

Objek

Objek set cipher suite yang dikustomisasi yang akan digunakan untuk Https saat cipherSuiteSetType disesuaikan.

Nama	Jenis	Deskripsi
cipherSuiteSetForTls12	AfdCustomizedCipherSuiteForTls12[]	Suite cipher untuk TLS 1.2. Diperlukan setidaknya satu dalam minimumTlsVersion TLS 1.2.
cipherSuiteSetForTls13	AfdCustomizedCipherSuiteForTls13[]	Suite cipher untuk TLS 1.3. Diperlukan setidaknya satu dalam minimumTlsVersion TLS 1.2, TLS 1.3.

AFDDomainHttpsParameters

Objek

Objek JSON yang berisi properti untuk mengamankan domain.

Nama	Jenis	Deskripsi
certificateType	AfdCertificateType	Menentukan sumber sertifikat SSL.
cipherSuiteSetType	AfdCipherSuiteSetType	jenis set rangkaian sandi yang akan digunakan untuk Https
customizedCipherSuiteSet	AFDDomainHttpsCustomizedCipherSuiteSet	Objek cipher suites yang disesuaikan yang akan digunakan untuk Https saat cipherSuiteSetType disesuaikan.
minimumTlsVersion	AfdMinimumTlsVersion	Versi protokol TLS yang akan digunakan untuk Https saat cipherSuiteSetType Disesuaikan.
secret	ResourceReference	Referensi sumber daya ke rahasia. Ie. subs/rg/profile/secret

AfdErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

AfdMinimumTlsVersion

Enumeration

Versi protokol TLS yang akan digunakan untuk Https saat cipherSuiteSetType Disesuaikan.

Nilai	Deskripsi
TLS10
TLS12
TLS13

AfdProvisioningState

Enumeration

Status penyediaan

Nilai	Deskripsi
Succeeded
Failed
Updating
Deleting
Creating

DeploymentStatus

Enumeration

Nilai	Deskripsi
NotStarted
InProgress
Succeeded
Failed

DomainValidationProperties

Objek

Objek JSON yang berisi properti untuk memvalidasi domain.

Nama	Jenis	Deskripsi
expirationDate	string	Waktu tanggal kedaluwarsa token
validationToken	string	Tantangan yang digunakan untuk catatan TXT DNS atau validasi berbasis file

DomainValidationState

Enumeration

Substat provisi menunjukkan kemajuan HTTPS kustom yang mengaktifkan/menonaktifkan proses langkah demi langkah. DCV adalah singkatan DomainControlValidation.

Nilai	Deskripsi
Unknown
Submitting
Pending
Rejected
TimedOut
PendingRevalidation
Approved
RefreshingValidationToken
InternalError

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

IdentityType

Enumeration

Jenis identitas yang membuat/memodifikasi sumber daya

Nilai	Deskripsi
user
application
managedIdentity
key

ResourceReference

Objek

Referensi ke sumber daya lain.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.

SystemData

Objek

Membaca hanya data sistem

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC)
createdBy	string	Pengidentifikasi untuk identitas yang membuat sumber daya
createdByType	IdentityType	Jenis identitas yang membuat sumber daya
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Pengidentifikasi untuk identitas yang terakhir mengubah sumber daya
lastModifiedByType	IdentityType	Jenis identitas yang terakhir mengubah sumber daya

Bagikan melalui

AFD Custom Domains - Get

Parameter URI

Respons

Keamanan

azure_auth

Cakupan

Contoh

AFDCustomDomains_Get

Permintaan sampel

Respon sampel

Definisi

AfdCertificateType

AfdCipherSuiteSetType

AfdCustomizedCipherSuiteForTls12

AfdCustomizedCipherSuiteForTls13

AFDDomain

AFDDomainHttpsCustomizedCipherSuiteSet

AFDDomainHttpsParameters

AfdErrorResponse

AfdMinimumTlsVersion

AfdProvisioningState

DeploymentStatus

DomainValidationProperties

DomainValidationState

ErrorAdditionalInfo

ErrorDetail

IdentityType

ResourceReference

SystemData