Delen via


Custom Domains - Enable Custom Https

Https-levering van het aangepaste domein inschakelen.

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

URI-parameters

Name In Vereist Type Description
customDomainName
path True

string

Naam van het aangepaste domein in een eindpunt.

endpointName
path True

string

Naam van het eindpunt onder het profiel dat wereldwijd uniek is.

profileName
path True

string

Naam van het CDN-profiel dat uniek is binnen de resourcegroep.

resourceGroupName
path True

string

Naam van de resourcegroep binnen het Azure-abonnement.

Regex-patroon: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Azure-abonnements-id.

api-version
query True

string

Versie van de API die moet worden gebruikt met de clientaanvraag. Huidige versie is 2024-02-01.

Aanvraagbody

De aanvraagtekst kan een van de volgende zijn:

Name Description
CdnManagedHttpsParameters

Definieert de certificaatbronparameters met behulp van cdn beheerd certificaat voor het inschakelen van SSL.

UserManagedHttpsParameters

Definieert de certificaatbronparameters met behulp van het sleutelkluiscertificaat van de gebruiker voor het inschakelen van SSL.

CdnManagedHttpsParameters

Definieert de certificaatbronparameters met behulp van cdn beheerd certificaat voor het inschakelen van SSL.

Name Vereist Type Description
certificateSource True string:

Cdn

Definieert de bron van het SSL-certificaat.

certificateSourceParameters True

CdnCertificateSourceParameters

Definieert de certificaatbronparameters met behulp van cdn beheerd certificaat voor het inschakelen van SSL.

protocolType True

ProtocolType

Definieert het TLS-extensieprotocol dat wordt gebruikt voor veilige levering.

minimumTlsVersion

MinimumTlsVersion

TLS-protocolversie die wordt gebruikt voor Https

UserManagedHttpsParameters

Definieert de certificaatbronparameters met behulp van het sleutelkluiscertificaat van de gebruiker voor het inschakelen van SSL.

Name Vereist Type Description
certificateSource True string:

AzureKeyVault

Definieert de bron van het SSL-certificaat.

certificateSourceParameters True

KeyVaultCertificateSourceParameters

Definieert de certificaatbronparameters met behulp van het sleutelkluiscertificaat van de gebruiker voor het inschakelen van SSL.

protocolType True

ProtocolType

Definieert het TLS-extensieprotocol dat wordt gebruikt voor veilige levering.

minimumTlsVersion

MinimumTlsVersion

TLS-protocolversie die wordt gebruikt voor Https

Antwoorden

Name Type Description
200 OK

CustomDomain

OK. De aanvraag is geslaagd.

202 Accepted

CustomDomain

Geaccepteerd en de bewerking wordt asynchroon voltooid.

Kopteksten

location: string

Other Status Codes

ErrorResponse

CDN-foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom.

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

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
CustomDomains_EnableCustomHttpsUsingYourOwnCertificate

CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate

Voorbeeldaanvraag

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

Voorbeeldrespons

{
  "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

Voorbeeldaanvraag

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

Voorbeeldrespons

{
  "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"
  }
}

Definities

Name Description
CdnCertificateSourceParameters

Definieert de parameters voor het gebruik van cdn beheerd certificaat voor het beveiligen van aangepaste domein.

CdnManagedHttpsParameters

Definieert de certificaatbronparameters met behulp van cdn beheerd certificaat voor het inschakelen van SSL.

CertificateType

Type certificaat dat wordt gebruikt

CustomDomain

Beschrijvende domeinnaamtoewijzing aan de hostnaam van het eindpunt die de klant aanbiedt voor huisstijldoeleinden, bijvoorbeeld www.contoso.com.

CustomDomainResourceState

Resourcestatus van het aangepaste domein.

CustomHttpsProvisioningState

Inrichtingsstatus van het aangepaste domein.

CustomHttpsProvisioningSubstate

De substatus inrichten toont stap voor stap de voortgang van het proces voor het inschakelen/uitschakelen van aangepaste HTTPS.

DeleteRule

Beschrijft de actie die moet worden uitgevoerd wanneer het certificaat uit Key Vault wordt verwijderd.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

IdentityType

Het type identiteit dat resources maakt/wijzigt

KeyVaultCertificateSourceParameters

Beschrijft de parameters voor het gebruik van het KeyVault-certificaat van een gebruiker voor het beveiligen van een aangepast domein.

MinimumTlsVersion

TLS-protocolversie die wordt gebruikt voor Https

ProtocolType

Definieert het TLS-extensieprotocol dat wordt gebruikt voor veilige levering.

SystemData

Alleen-lezensysteemgegevens

UpdateRule

Beschrijft de actie die moet worden uitgevoerd wanneer het certificaat wordt bijgewerkt in Key Vault.

UserManagedHttpsParameters

Definieert de certificaatbronparameters met behulp van het sleutelkluiscertificaat van de gebruiker voor het inschakelen van SSL.

CdnCertificateSourceParameters

Definieert de parameters voor het gebruik van cdn beheerd certificaat voor het beveiligen van aangepaste domein.

Name Type Description
certificateType

CertificateType

Type certificaat dat wordt gebruikt

typeName string:

CdnCertificateSourceParameters

CdnManagedHttpsParameters

Definieert de certificaatbronparameters met behulp van cdn beheerd certificaat voor het inschakelen van SSL.

Name Type Description
certificateSource string:

Cdn

Definieert de bron van het SSL-certificaat.

certificateSourceParameters

CdnCertificateSourceParameters

Definieert de certificaatbronparameters met behulp van cdn beheerd certificaat voor het inschakelen van SSL.

minimumTlsVersion

MinimumTlsVersion

TLS-protocolversie die wordt gebruikt voor Https

protocolType

ProtocolType

Definieert het TLS-extensieprotocol dat wordt gebruikt voor veilige levering.

CertificateType

Type certificaat dat wordt gebruikt

Name Type Description
Dedicated

string

Shared

string

CustomDomain

Beschrijvende domeinnaamtoewijzing aan de hostnaam van het eindpunt die de klant aanbiedt voor huisstijldoeleinden, bijvoorbeeld www.contoso.com.

Name Type Description
id

string

Resource-id.

name

string

Resourcenaam.

properties.customHttpsParameters CustomDomainHttpsParameters:

Certificaatparameters voor het beveiligen van aangepaste HTTPS

properties.customHttpsProvisioningState

CustomHttpsProvisioningState

Inrichtingsstatus van het aangepaste domein.

properties.customHttpsProvisioningSubstate

CustomHttpsProvisioningSubstate

De substatus inrichten toont stap voor stap de voortgang van het proces voor het inschakelen/uitschakelen van aangepaste HTTPS.

properties.hostName

string

De hostnaam van het aangepaste domein. Moet een domeinnaam zijn.

properties.provisioningState

CustomHttpsProvisioningState

Inrichtingsstatus van Aangepaste HTTPS van het aangepaste domein.

properties.resourceState

CustomDomainResourceState

Resourcestatus van het aangepaste domein.

properties.validationData

string

Speciale validatie of gegevens kunnen vereist zijn bij het leveren van CDN aan sommige regio's vanwege lokale nalevingsredenen. Bijvoorbeeld: het ICP-licentienummer van een aangepast domein is vereist voor het leveren van inhoud in China.

systemData

SystemData

Alleen-lezensysteemgegevens

type

string

Resourcetype.

CustomDomainResourceState

Resourcestatus van het aangepaste domein.

Name Type Description
Active

string

Creating

string

Deleting

string

CustomHttpsProvisioningState

Inrichtingsstatus van het aangepaste domein.

Name Type Description
Disabled

string

Disabling

string

Enabled

string

Enabling

string

Failed

string

CustomHttpsProvisioningSubstate

De substatus inrichten toont stap voor stap de voortgang van het proces voor het inschakelen/uitschakelen van aangepaste HTTPS.

Name Type Description
CertificateDeleted

string

CertificateDeployed

string

DeletingCertificate

string

DeployingCertificate

string

DomainControlValidationRequestApproved

string

DomainControlValidationRequestRejected

string

DomainControlValidationRequestTimedOut

string

IssuingCertificate

string

PendingDomainControlValidationREquestApproval

string

SubmittingDomainControlValidationRequest

string

DeleteRule

Beschrijft de actie die moet worden uitgevoerd wanneer het certificaat uit Key Vault wordt verwijderd.

Name Type Description
NoAction

string

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

IdentityType

Het type identiteit dat resources maakt/wijzigt

Name Type Description
application

string

key

string

managedIdentity

string

user

string

KeyVaultCertificateSourceParameters

Beschrijft de parameters voor het gebruik van het KeyVault-certificaat van een gebruiker voor het beveiligen van een aangepast domein.

Name Type Description
deleteRule

DeleteRule

Beschrijft de actie die moet worden uitgevoerd wanneer het certificaat uit Key Vault wordt verwijderd.

resourceGroupName

string

Resourcegroep van de Key Vault van de gebruiker die het SSL-certificaat bevat

secretName

string

De naam van Key Vault Secret (die het volledige PFX-certificaat vertegenwoordigt) in Key Vault.

secretVersion

string

De versie (GUID) van Key Vault Geheim in Key Vault.

subscriptionId

string

Abonnements-id van de Key Vault van de gebruiker die het SSL-certificaat bevat

typeName string:

KeyVaultCertificateSourceParameters

updateRule

UpdateRule

Beschrijft de actie die moet worden uitgevoerd wanneer het certificaat wordt bijgewerkt in Key Vault.

vaultName

string

De naam van de Key Vault van de gebruiker die het SSL-certificaat bevat

MinimumTlsVersion

TLS-protocolversie die wordt gebruikt voor Https

Name Type Description
None

string

TLS10

string

TLS12

string

ProtocolType

Definieert het TLS-extensieprotocol dat wordt gebruikt voor veilige levering.

Name Type Description
IPBased

string

ServerNameIndication

string

SystemData

Alleen-lezensysteemgegevens

Name Type Description
createdAt

string

Het tijdstempel van het maken van resources (UTC)

createdBy

string

Een id voor de identiteit die de resource heeft gemaakt

createdByType

IdentityType

Het type identiteit waarmee de resource is gemaakt

lastModifiedAt

string

Het tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

Een id voor de identiteit die de resource het laatst heeft gewijzigd

lastModifiedByType

IdentityType

Het type identiteit dat de resource het laatst heeft gewijzigd

UpdateRule

Beschrijft de actie die moet worden uitgevoerd wanneer het certificaat wordt bijgewerkt in Key Vault.

Name Type Description
NoAction

string

UserManagedHttpsParameters

Definieert de certificaatbronparameters met behulp van het sleutelkluiscertificaat van de gebruiker voor het inschakelen van SSL.

Name Type Description
certificateSource string:

AzureKeyVault

Definieert de bron van het SSL-certificaat.

certificateSourceParameters

KeyVaultCertificateSourceParameters

Definieert de certificaatbronparameters met behulp van het sleutelkluiscertificaat van de gebruiker voor het inschakelen van SSL.

minimumTlsVersion

MinimumTlsVersion

TLS-protocolversie die wordt gebruikt voor Https

protocolType

ProtocolType

Definieert het TLS-extensieprotocol dat wordt gebruikt voor veilige levering.