AFD Custom Domains - Get

Service:: Front Door Service

API-versie:: 2025-04-15

Hiermee haalt u een bestaand AzureFrontDoor-domein op met de opgegeven domeinnaam onder het opgegeven abonnement, de resourcegroep en het opgegeven profiel.

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

URI-parameters

Name	In	Vereist	Type	Description
customDomainName	path	True	string	De naam van het domein onder het profiel dat wereldwijd uniek is.
profileName	path	True	string minLength: 1 maxLength: 260 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9])$	De naam van de Azure Front Door Standard of Azure Front Door Premium die uniek is binnen de resourcegroep.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Naam van de resourcegroep binnen het Azure-abonnement.
subscriptionId	path	True	string	Azure-abonnements-id.
api-version	query	True	string	Versie van de API die moet worden gebruikt met de clientaanvraag. De huidige versie is 2025-04-15.

Antwoorden

Name	Type	Description
200 OK	AFDDomain	OK
Other Status Codes	AfdErrorResponse	Azure Front Door-foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

AFDCustomDomains_Get

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 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"
  }
}

Definities

Name	Description
AfdCertificateType	Definieert de bron van het SSL-certificaat.
AfdCipherSuiteSetType	settype coderingssuite dat wordt gebruikt voor Https
AfdCustomizedCipherSuiteForTls12	Coderingssuites voor TLS 1.2. Vereist ten minste één in minimumTlsVersion TLS 1.2.
AfdCustomizedCipherSuiteForTls13	Coderingssuites voor TLS 1.3. Vereist ten minste één in minimumTlsVersion TLS 1.2, TLS 1.3.
AFDDomain	Vriendelijke domeinnaamtoewijzing aan de endpoint-hostnaam die de klant opgeeft voor merkdoeleinden, bijv. `www.contoso.com`.
AFDDomainHttpsCustomizedCipherSuiteSet	Aangepaste setobject voor coderingssuites dat wordt gebruikt voor Https wanneer cipherSuiteSetType is aangepast.
AFDDomainHttpsParameters	Het JSON-object dat de eigenschappen bevat om een domein te beveiligen.
AfdErrorResponse	Foutreactie
AfdMinimumTlsVersion	TLS-protocolversie die wordt gebruikt voor Https wanneer cipherSuiteSetType is aangepast.
AfdProvisioningState	Inrichtingsstatus
DeploymentStatus
DomainValidationProperties	Het JSON-object dat de eigenschappen bevat om een domein te valideren.
DomainValidationState	De inrichtingssubstate toont de voortgang van aangepaste HTTPS die proces stap voor stap inschakelt/uitschakelt. DCV staat voor DomainControlValidation.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
IdentityType	Het type identiteit waarmee resources worden gemaakt/gewijzigd
ResourceReference	Verwijzing naar een andere resource.
SystemData	Alleen-lezen systeemgegevens

AfdCertificateType

Inventarisatie

Definieert de bron van het SSL-certificaat.

Waarde	Description
CustomerCertificate
ManagedCertificate
AzureFirstPartyManagedCertificate

AfdCipherSuiteSetType

Inventarisatie

settype coderingssuite dat wordt gebruikt voor Https

Waarde	Description
Customized
TLS10_2019
TLS12_2022
TLS12_2023

AfdCustomizedCipherSuiteForTls12

Inventarisatie

Coderingssuites voor TLS 1.2. Vereist ten minste één in minimumTlsVersion TLS 1.2.

Waarde	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

Inventarisatie

Coderingssuites voor TLS 1.3. Vereist ten minste één in minimumTlsVersion TLS 1.2, TLS 1.3.

Waarde	Description
TLS_AES_128_GCM_SHA256
TLS_AES_256_GCM_SHA384

AFDDomain

Object

Vriendelijke domeinnaamtoewijzing aan de endpoint-hostnaam die de klant opgeeft voor merkdoeleinden, bijv. www.contoso.com.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.azureDnsZone	ResourceReference	Resourcereferentie naar de Azure DNS-zone
properties.deploymentStatus	DeploymentStatus
properties.domainValidationState	DomainValidationState	De inrichtingssubstate toont de voortgang van aangepaste HTTPS die proces stap voor stap inschakelt/uitschakelt. DCV staat voor DomainControlValidation.
properties.extendedProperties	object	Key-Value paar dat migratie-eigenschappen voor domeinen vertegenwoordigt.
properties.hostName	string	De hostnaam van het domein. Moet een domeinnaam zijn.
properties.preValidatedCustomDomainResourceId	ResourceReference	Resourceverwijzing naar de Azure-resource waarbij het eigendom van aangepaste domeinen vooraf is gevalideerd
properties.profileName	string	De naam van het profiel dat het domein bevat.
properties.provisioningState	AfdProvisioningState	Inrichtingsstatus
properties.tlsSettings	AFDDomainHttpsParameters	De configuratie die aangeeft hoe HTTPS voor het domein moet worden ingeschakeld, met behulp van een door AzureFrontDoor beheerd certificaat of een eigen certificaat van de gebruiker. Als dit niet is opgegeven, gebruikt het inschakelen van SSL standaard het beheerde AzureFrontDoor-certificaat.
properties.validationProperties	DomainValidationProperties	Waarden die de klant nodig heeft om het eigendom van het domein te valideren
systemData	SystemData	Alleen-lezen systeemgegevens
type	string	Resourcetype.

AFDDomainHttpsCustomizedCipherSuiteSet

Object

Aangepaste setobject voor coderingssuites dat wordt gebruikt voor Https wanneer cipherSuiteSetType is aangepast.

Name	Type	Description
cipherSuiteSetForTls12	AfdCustomizedCipherSuiteForTls12[]	Coderingssuites voor TLS 1.2. Vereist ten minste één in minimumTlsVersion TLS 1.2.
cipherSuiteSetForTls13	AfdCustomizedCipherSuiteForTls13[]	Coderingssuites voor TLS 1.3. Vereist ten minste één in minimumTlsVersion TLS 1.2, TLS 1.3.

AFDDomainHttpsParameters

Object

Het JSON-object dat de eigenschappen bevat om een domein te beveiligen.

Name	Type	Description
certificateType	AfdCertificateType	Definieert de bron van het SSL-certificaat.
cipherSuiteSetType	AfdCipherSuiteSetType	settype coderingssuite dat wordt gebruikt voor Https
customizedCipherSuiteSet	AFDDomainHttpsCustomizedCipherSuiteSet	Aangepast coderingssuiteobject dat wordt gebruikt voor Https wanneer cipherSuiteSetType is aangepast.
minimumTlsVersion	AfdMinimumTlsVersion	TLS-protocolversie die wordt gebruikt voor Https wanneer cipherSuiteSetType is aangepast.
secret	ResourceReference	Resourcereferentie naar het geheim. Ie. subs/rg/profile/secret

AfdErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

AfdMinimumTlsVersion

Inventarisatie

TLS-protocolversie die wordt gebruikt voor Https wanneer cipherSuiteSetType is aangepast.

Waarde	Description
TLS10
TLS12
TLS13

AfdProvisioningState

Inventarisatie

Inrichtingsstatus

Waarde	Description
Succeeded
Failed
Updating
Deleting
Creating

DeploymentStatus

Inventarisatie

Waarde	Description
NotStarted
InProgress
Succeeded
Failed

DomainValidationProperties

Object

Het JSON-object dat de eigenschappen bevat om een domein te valideren.

Name	Type	Description
expirationDate	string	De datum waarop het token verloopt
validationToken	string	Uitdaging die wordt gebruikt voor validatie van DNS TXT-records of -bestanden

DomainValidationState

Inventarisatie

De inrichtingssubstate toont de voortgang van aangepaste HTTPS die proces stap voor stap inschakelt/uitschakelt. DCV staat voor DomainControlValidation.

Waarde	Description
Unknown
Submitting
Pending
Rejected
TimedOut
PendingRevalidation
Approved
RefreshingValidationToken
InternalError

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

IdentityType

Inventarisatie

Het type identiteit waarmee resources worden gemaakt/gewijzigd

Waarde	Description
user
application
managedIdentity
key

ResourceReference

Object

Verwijzing naar een andere resource.

Name	Type	Description
id	string	Resource-id.

SystemData

Object

Alleen-lezen systeemgegevens

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC)
createdBy	string	Een id voor de identiteit die de resource heeft gemaakt
createdByType	IdentityType	Het type identiteit dat de resource heeft gemaakt
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	Een id voor de identiteit die de resource voor het laatst heeft gewijzigd
lastModifiedByType	IdentityType	Het type identiteit dat de resource voor het laatst heeft gewijzigd

Delen via

AFD Custom Domains - Get

URI-parameters

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

AFDCustomDomains_Get

Voorbeeldaanvraag

Voorbeeldrespons

Definities

AfdCertificateType

AfdCipherSuiteSetType

AfdCustomizedCipherSuiteForTls12

AfdCustomizedCipherSuiteForTls13

AFDDomain

AFDDomainHttpsCustomizedCipherSuiteSet

AFDDomainHttpsParameters

AfdErrorResponse

AfdMinimumTlsVersion

AfdProvisioningState

DeploymentStatus

DomainValidationProperties

DomainValidationState

ErrorAdditionalInfo

ErrorDetail

IdentityType

ResourceReference

SystemData