Partager via


Custom Domains - Enable Custom Https

Activez la remise https du domaine personnalisé.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains/{customDomainName}/enableCustomHttps?api-version=2024-02-01

Paramètres URI

Nom Dans Obligatoire Type Description
customDomainName
path True

string

Nom du domaine personnalisé dans un point de terminaison.

endpointName
path True

string

Nom du point de terminaison sous le profil qui est unique globalement.

profileName
path True

string

Nom du profil CDN unique au sein du groupe de ressources.

resourceGroupName
path True

string

Nom du groupe de ressources dans l’abonnement Azure.

Modèle d’expression régulière: ^[-\w\._\(\)]+$

subscriptionId
path True

string

ID d’abonnement Azure.

api-version
query True

string

Version de l’API à utiliser avec la demande du client. La version actuelle est 2024-02-01.

Corps de la demande

Le corps de la requête peut être l’un des suivants :

Nom Description
CdnManagedHttpsParameters

Définit les paramètres de source de certificat à l’aide d’un certificat managé CDN pour l’activation de SSL.

UserManagedHttpsParameters

Définit les paramètres de source de certificat à l’aide du certificat de coffre de clés de l’utilisateur pour activer SSL.

CdnManagedHttpsParameters

Définit les paramètres de source de certificat à l’aide d’un certificat managé CDN pour l’activation de SSL.

Nom Obligatoire Type Description
certificateSource True string:

Cdn

Définit la source du certificat SSL.

certificateSourceParameters True

CdnCertificateSourceParameters

Définit les paramètres de source de certificat à l’aide d’un certificat managé CDN pour l’activation de SSL.

protocolType True

ProtocolType

Définit le protocole d’extension TLS utilisé pour la remise sécurisée.

minimumTlsVersion

MinimumTlsVersion

Version du protocole TLS qui sera utilisée pour Https

UserManagedHttpsParameters

Définit les paramètres de source de certificat à l’aide du certificat de coffre de clés de l’utilisateur pour activer SSL.

Nom Obligatoire Type Description
certificateSource True string:

AzureKeyVault

Définit la source du certificat SSL.

certificateSourceParameters True

KeyVaultCertificateSourceParameters

Définit les paramètres de source de certificat à l’aide du certificat de coffre de clés de l’utilisateur pour activer SSL.

protocolType True

ProtocolType

Définit le protocole d’extension TLS utilisé pour la remise sécurisée.

minimumTlsVersion

MinimumTlsVersion

Version du protocole TLS qui sera utilisée pour Https

Réponses

Nom Type Description
200 OK

CustomDomain

OK. La demande a réussi.

202 Accepted

CustomDomain

Accepté et l’opération se termine de manière asynchrone.

En-têtes

location: string

Other Status Codes

ErrorResponse

Réponse d’erreur CDN décrivant la raison de l’échec de l’opération.

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

CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
CustomDomains_EnableCustomHttpsUsingYourOwnCertificate

CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate

Exemple de requête

POST https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customDomains/www-someDomain-net/enableCustomHttps?api-version=2024-02-01

Exemple de réponse

{
  "name": "www-someDomain-net",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
  "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
  "properties": {
    "provisioningState": "Succeeded",
    "resourceState": "Active",
    "hostName": "www.someDomain.net",
    "customHttpsProvisioningState": "Enabled",
    "customHttpsProvisioningSubstate": "CertificateDeployed",
    "validationData": "validationdata"
  }
}
azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2024-02-01
{
  "name": "www-someDomain-net",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
  "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
  "properties": {
    "provisioningState": "Succeeded",
    "resourceState": "Active",
    "hostName": "www.someDomain.net",
    "customHttpsProvisioningState": "Enabling",
    "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
    "validationData": "validationdata"
  }
}

CustomDomains_EnableCustomHttpsUsingYourOwnCertificate

Exemple de requête

POST https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customDomains/www-someDomain-net/enableCustomHttps?api-version=2024-02-01

Exemple de réponse

{
  "name": "www-someDomain-net",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
  "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
  "properties": {
    "provisioningState": "Succeeded",
    "resourceState": "Active",
    "hostName": "www.someDomain.net",
    "customHttpsProvisioningState": "Enabled",
    "customHttpsProvisioningSubstate": "CertificateDeployed",
    "validationData": "validationdata"
  }
}
azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2024-02-01
{
  "name": "www-someDomain-net",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/customdomains/www-someDomain-net",
  "type": "Microsoft.Cdn/profiles/endpoints/customdomains",
  "properties": {
    "provisioningState": "Succeeded",
    "resourceState": "Active",
    "hostName": "www.someDomain.net",
    "customHttpsProvisioningState": "Enabling",
    "customHttpsProvisioningSubstate": "PendingDomainControlValidationREquestApproval",
    "validationData": "validationdata"
  }
}

Définitions

Nom Description
CdnCertificateSourceParameters

Définit les paramètres d’utilisation d’un certificat managé CDN pour sécuriser un domaine personnalisé.

CdnManagedHttpsParameters

Définit les paramètres de source de certificat à l’aide d’un certificat managé CDN pour l’activation de SSL.

CertificateType

Type de certificat utilisé

CustomDomain

Mappage de nom de domaine convivial au nom d’hôte de point de terminaison fourni par le client à des fins de personnalisation, par exemple www.contoso.com.

CustomDomainResourceState

Ressource status du domaine personnalisé.

CustomHttpsProvisioningState

Approvisionnement status du domaine personnalisé.

CustomHttpsProvisioningSubstate

Le sous-état d’approvisionnement montre la progression du processus d’activation/désactivation HTTPS personnalisé étape par étape.

DeleteRule

Décrit l’action qui doit être effectuée lorsque le certificat est supprimé de Key Vault.

ErrorAdditionalInfo

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

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

IdentityType

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

KeyVaultCertificateSourceParameters

Décrit les paramètres d’utilisation du certificat KeyVault d’un utilisateur pour sécuriser un domaine personnalisé.

MinimumTlsVersion

Version du protocole TLS qui sera utilisée pour Https

ProtocolType

Définit le protocole d’extension TLS utilisé pour la remise sécurisée.

SystemData

Lecture seule des données système

UpdateRule

Décrit l’action qui doit être effectuée lorsque le certificat est mis à jour dans Key Vault.

UserManagedHttpsParameters

Définit les paramètres de source de certificat à l’aide du certificat de coffre de clés de l’utilisateur pour activer SSL.

CdnCertificateSourceParameters

Définit les paramètres d’utilisation d’un certificat managé CDN pour sécuriser un domaine personnalisé.

Nom Type Description
certificateType

CertificateType

Type de certificat utilisé

typeName string:

CdnCertificateSourceParameters

CdnManagedHttpsParameters

Définit les paramètres de source de certificat à l’aide d’un certificat managé CDN pour l’activation de SSL.

Nom Type Description
certificateSource string:

Cdn

Définit la source du certificat SSL.

certificateSourceParameters

CdnCertificateSourceParameters

Définit les paramètres de source de certificat à l’aide d’un certificat managé CDN pour l’activation de SSL.

minimumTlsVersion

MinimumTlsVersion

Version du protocole TLS qui sera utilisée pour Https

protocolType

ProtocolType

Définit le protocole d’extension TLS utilisé pour la remise sécurisée.

CertificateType

Type de certificat utilisé

Nom Type Description
Dedicated

string

Shared

string

CustomDomain

Mappage de nom de domaine convivial au nom d’hôte de point de terminaison fourni par le client à des fins de personnalisation, par exemple www.contoso.com.

Nom Type Description
id

string

ID de la ressource

name

string

Nom de la ressource.

properties.customHttpsParameters CustomDomainHttpsParameters:

Paramètres de certificat pour la sécurisation du protocole HTTPS personnalisé

properties.customHttpsProvisioningState

CustomHttpsProvisioningState

Approvisionnement status du domaine personnalisé.

properties.customHttpsProvisioningSubstate

CustomHttpsProvisioningSubstate

Le sous-état d’approvisionnement montre la progression du processus d’activation/désactivation HTTPS personnalisé étape par étape.

properties.hostName

string

Nom d’hôte du domaine personnalisé. Doit être un nom de domaine.

properties.provisioningState

CustomHttpsProvisioningState

Approvisionnement status de Https personnalisé du domaine personnalisé.

properties.resourceState

CustomDomainResourceState

Ressource status du domaine personnalisé.

properties.validationData

string

Une validation ou des données spéciales peuvent être requises lors de la remise du CDN à certaines régions pour des raisons de conformité locale. Par exemple, le numéro de licence ICP d’un domaine personnalisé est requis pour fournir du contenu en Chine.

systemData

SystemData

Lecture seule des données système

type

string

Type de ressource.

CustomDomainResourceState

Ressource status du domaine personnalisé.

Nom Type Description
Active

string

Creating

string

Deleting

string

CustomHttpsProvisioningState

Approvisionnement status du domaine personnalisé.

Nom Type Description
Disabled

string

Disabling

string

Enabled

string

Enabling

string

Failed

string

CustomHttpsProvisioningSubstate

Le sous-état d’approvisionnement montre la progression du processus d’activation/désactivation HTTPS personnalisé étape par étape.

Nom Type Description
CertificateDeleted

string

CertificateDeployed

string

DeletingCertificate

string

DeployingCertificate

string

DomainControlValidationRequestApproved

string

DomainControlValidationRequestRejected

string

DomainControlValidationRequestTimedOut

string

IssuingCertificate

string

PendingDomainControlValidationREquestApproval

string

SubmittingDomainControlValidationRequest

string

DeleteRule

Décrit l’action qui doit être effectuée lorsque le certificat est supprimé de Key Vault.

Nom Type Description
NoAction

string

ErrorAdditionalInfo

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

Nom Type Description
info

object

Informations supplémentaires

type

string

Type d’informations supplémentaires.

ErrorDetail

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.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet error.

IdentityType

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

Nom Type Description
application

string

key

string

managedIdentity

string

user

string

KeyVaultCertificateSourceParameters

Décrit les paramètres d’utilisation du certificat KeyVault d’un utilisateur pour sécuriser un domaine personnalisé.

Nom Type Description
deleteRule

DeleteRule

Décrit l’action qui doit être effectuée lorsque le certificat est supprimé de Key Vault.

resourceGroupName

string

Groupe de ressources du Key Vault de l’utilisateur contenant le certificat SSL

secretName

string

Nom de Key Vault Secret (représentant le certificat complet PFX) dans Key Vault.

secretVersion

string

Version (GUID) de Key Vault Secret dans Key Vault.

subscriptionId

string

ID d’abonnement du Key Vault de l’utilisateur contenant le certificat SSL

typeName string:

KeyVaultCertificateSourceParameters

updateRule

UpdateRule

Décrit l’action qui doit être effectuée lorsque le certificat est mis à jour dans Key Vault.

vaultName

string

Nom du Key Vault de l’utilisateur contenant le certificat SSL

MinimumTlsVersion

Version du protocole TLS qui sera utilisée pour Https

Nom Type Description
None

string

TLS10

string

TLS12

string

ProtocolType

Définit le protocole d’extension TLS utilisé pour la remise sécurisée.

Nom Type Description
IPBased

string

ServerNameIndication

string

SystemData

Lecture seule des données système

Nom Type Description
createdAt

string

Horodatage de la création de ressource (UTC)

createdBy

string

Identificateur de l’identité qui a créé la ressource

createdByType

IdentityType

Type d’identité qui a créé la ressource

lastModifiedAt

string

Horodatage de la dernière modification de la ressource (UTC)

lastModifiedBy

string

Identificateur de l’identité qui a modifié la ressource pour la dernière fois

lastModifiedByType

IdentityType

Type d’identité qui a modifié la ressource pour la dernière fois

UpdateRule

Décrit l’action qui doit être effectuée lorsque le certificat est mis à jour dans Key Vault.

Nom Type Description
NoAction

string

UserManagedHttpsParameters

Définit les paramètres de source de certificat à l’aide du certificat de coffre de clés de l’utilisateur pour activer SSL.

Nom Type Description
certificateSource string:

AzureKeyVault

Définit la source du certificat SSL.

certificateSourceParameters

KeyVaultCertificateSourceParameters

Définit les paramètres de source de certificat à l’aide du certificat de coffre de clés de l’utilisateur pour activer SSL.

minimumTlsVersion

MinimumTlsVersion

Version du protocole TLS qui sera utilisée pour Https

protocolType

ProtocolType

Définit le protocole d’extension TLS utilisé pour la remise sécurisée.