AFD Custom Domains - Get

Service:: Front Door Service

Version d'API:: 2025-04-15

Obtient un domaine AzureFrontDoor existant avec le nom de domaine spécifié sous l’abonnement, le groupe de ressources et le profil spécifiés.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
customDomainName	path	True	string	Nom du domaine sous le profil qui est unique globalement.
profileName	path	True	string minLength: 1 maxLength: 260 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9])$	Nom d’Azure Front Door Standard ou d’Azure Front Door Premium qui est unique dans le groupe de ressources.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Nom du groupe de ressources dans l’abonnement Azure.
subscriptionId	path	True	string	ID d’abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser avec la demande cliente. La version actuelle est 2025-04-15.

Réponses

Nom	Type	Description
200 OK	AFDDomain	D’ACCORD
Other Status Codes	AfdErrorResponse	Réponse d’erreur Azure Front Door décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

AFDCustomDomains_Get

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:: 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"
  }
}

Définitions

Nom	Description
AfdCertificateType	Définit la source du certificat SSL.
AfdCipherSuiteSetType	type de jeu de suite de chiffrement qui sera utilisé pour Https
AfdCustomizedCipherSuiteForTls12	Suites de chiffrement pour TLS 1.2. Obligatoire au moins un dans minimumTlsVersion TLS 1.2.
AfdCustomizedCipherSuiteForTls13	Suites de chiffrement pour TLS 1.3. Requis au moins un dans minimumTlsVersion TLS 1.2, TLS 1.3.
AFDDomain	Mappage convivial du nom de domaine vers le nom d’hôte du point de terminaison que le client fournit à des fins de marque, par exemple `www.contoso.com`.
AFDDomainHttpsCustomizedCipherSuiteSet	Objet de jeu de suite de chiffrement personnalisé qui sera utilisé pour Https lorsque cipherSuiteSetType est personnalisé.
AFDDomainHttpsParameters	Objet JSON qui contient les propriétés pour sécuriser un domaine.
AfdErrorResponse	Réponse d’erreur
AfdMinimumTlsVersion	Version du protocole TLS qui sera utilisée pour Https lorsque cipherSuiteSetType est personnalisé.
AfdProvisioningState	État d’approvisionnement
DeploymentStatus
DomainValidationProperties	Objet JSON qui contient les propriétés pour valider un domaine.
DomainValidationState	L’état de sous-état d’approvisionnement indique la progression du processus d’activation/désactivation HTTPS personnalisé étape par étape. DCV signifie DomainControlValidation.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
IdentityType	Type d’identité qui crée/modifie des ressources
ResourceReference	Référence à une autre ressource.
SystemData	Lire uniquement les données système

AfdCertificateType

Énumération

Définit la source du certificat SSL.

Valeur	Description
CustomerCertificate
ManagedCertificate
AzureFirstPartyManagedCertificate

AfdCipherSuiteSetType

Énumération

type de jeu de suite de chiffrement qui sera utilisé pour Https

Valeur	Description
Customized
TLS10_2019
TLS12_2022
TLS12_2023

AfdCustomizedCipherSuiteForTls12

Énumération

Suites de chiffrement pour TLS 1.2. Obligatoire au moins un dans minimumTlsVersion TLS 1.2.

Valeur	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

Énumération

Suites de chiffrement pour TLS 1.3. Requis au moins un dans minimumTlsVersion TLS 1.2, TLS 1.3.

Valeur	Description
TLS_AES_128_GCM_SHA256
TLS_AES_256_GCM_SHA384

AFDDomain

Object

Mappage convivial du nom de domaine vers le nom d’hôte du point de terminaison que le client fournit à des fins de marque, par exemple www.contoso.com.

Nom	Type	Description
id	string	ID de ressource.
name	string	Nom de la ressource.
properties.azureDnsZone	ResourceReference	Référence de ressource à la zone Azure DNS
properties.deploymentStatus	DeploymentStatus
properties.domainValidationState	DomainValidationState	L’état de sous-état d’approvisionnement indique la progression du processus d’activation/désactivation HTTPS personnalisé étape par étape. DCV signifie DomainControlValidation.
properties.extendedProperties	object	Key-Value paire représentant les propriétés de migration pour les domaines.
properties.hostName	string	Nom d’hôte du domaine. Doit être un nom de domaine.
properties.preValidatedCustomDomainResourceId	ResourceReference	Référence de ressource à la ressource Azure où la propriété du domaine personnalisé a été prévalidée
properties.profileName	string	Nom du profil qui contient le domaine.
properties.provisioningState	AfdProvisioningState	État d’approvisionnement
properties.tlsSettings	AFDDomainHttpsParameters	Configuration spécifiant comment activer HTTPS pour le domaine , à l’aide du certificat managé AzureFrontDoor ou du propre certificat de l’utilisateur. Si ce n’est pas spécifié, l’activation de ssl utilise le certificat managé AzureFrontDoor par défaut.
properties.validationProperties	DomainValidationProperties	Valeurs que le client doit valider la propriété du domaine
systemData	SystemData	Lire uniquement les données système
type	string	Type de ressource.

AFDDomainHttpsCustomizedCipherSuiteSet

Object

Objet de jeu de suite de chiffrement personnalisé qui sera utilisé pour Https lorsque cipherSuiteSetType est personnalisé.

Nom	Type	Description
cipherSuiteSetForTls12	AfdCustomizedCipherSuiteForTls12[]	Suites de chiffrement pour TLS 1.2. Obligatoire au moins un dans minimumTlsVersion TLS 1.2.
cipherSuiteSetForTls13	AfdCustomizedCipherSuiteForTls13[]	Suites de chiffrement pour TLS 1.3. Requis au moins un dans minimumTlsVersion TLS 1.2, TLS 1.3.

AFDDomainHttpsParameters

Object

Objet JSON qui contient les propriétés pour sécuriser un domaine.

Nom	Type	Description
certificateType	AfdCertificateType	Définit la source du certificat SSL.
cipherSuiteSetType	AfdCipherSuiteSetType	type de jeu de suite de chiffrement qui sera utilisé pour Https
customizedCipherSuiteSet	AFDDomainHttpsCustomizedCipherSuiteSet	Objet de suites de chiffrement personnalisé qui sera utilisé pour Https lorsque cipherSuiteSetType est personnalisé.
minimumTlsVersion	AfdMinimumTlsVersion	Version du protocole TLS qui sera utilisée pour Https lorsque cipherSuiteSetType est personnalisé.
secret	ResourceReference	Référence de ressource au secret. Ie. subs/rg/profile/secret

AfdErrorResponse

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

AfdMinimumTlsVersion

Énumération

Version du protocole TLS qui sera utilisée pour Https lorsque cipherSuiteSetType est personnalisé.

Valeur	Description
TLS10
TLS12
TLS13

AfdProvisioningState

Énumération

État d’approvisionnement

Valeur	Description
Succeeded
Failed
Updating
Deleting
Creating

DeploymentStatus

Énumération

Valeur	Description
NotStarted
InProgress
Succeeded
Failed

DomainValidationProperties

Object

Objet JSON qui contient les propriétés pour valider un domaine.

Nom	Type	Description
expirationDate	string	Heure d’expiration du jeton
validationToken	string	Défi utilisé pour la validation basée sur les fichiers ou l’enregistrement TXT DNS

DomainValidationState

Énumération

L’état de sous-état d’approvisionnement indique la progression du processus d’activation/désactivation HTTPS personnalisé étape par étape. DCV signifie DomainControlValidation.

Valeur	Description
Unknown
Submitting
Pending
Rejected
TimedOut
PendingRevalidation
Approved
RefreshingValidationToken
InternalError

ErrorAdditionalInfo

Object

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

IdentityType

Énumération

Type d’identité qui crée/modifie des ressources

Valeur	Description
user
application
managedIdentity
key

ResourceReference

Object

Référence à une autre ressource.

Nom	Type	Description
id	string	ID de ressource.

SystemData

Object

Lire uniquement les données système

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC)
createdBy	string	Identificateur de l’identité qui a créé la ressource
createdByType	IdentityType	Type d’identité qui a créé la ressource
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identificateur de l’identité qui a modifié la dernière ressource
lastModifiedByType	IdentityType	Type d’identité qui a modifié la dernière ressource

Partager via

AFD Custom Domains - Get

Paramètres URI

Réponses

Sécurité

azure_auth

Étendues

Exemples

AFDCustomDomains_Get

Exemple de requête

Exemple de réponse

Définitions

AfdCertificateType

AfdCipherSuiteSetType

AfdCustomizedCipherSuiteForTls12

AfdCustomizedCipherSuiteForTls13

AFDDomain

AFDDomainHttpsCustomizedCipherSuiteSet

AFDDomainHttpsParameters

AfdErrorResponse

AfdMinimumTlsVersion

AfdProvisioningState

DeploymentStatus

DomainValidationProperties

DomainValidationState

ErrorAdditionalInfo

ErrorDetail

IdentityType

ResourceReference

SystemData