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 |
---|---|---|---|---|
custom
|
path | True |
string |
Naam van het aangepaste domein in een eindpunt. |
endpoint
|
path | True |
string |
Naam van het eindpunt onder het profiel dat wereldwijd uniek is. |
profile
|
path | True |
string |
Naam van het CDN-profiel dat uniek is binnen de resourcegroep. |
resource
|
path | True |
string |
Naam van de resourcegroep binnen het Azure-abonnement. Regex-patroon: |
subscription
|
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 |
---|---|
Cdn |
Definieert de certificaatbronparameters met behulp van cdn beheerd certificaat voor het inschakelen van SSL. |
User |
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 |
Definieert de certificaatbronparameters met behulp van cdn beheerd certificaat voor het inschakelen van SSL. |
|
protocolType | True |
Definieert het TLS-extensieprotocol dat wordt gebruikt voor veilige levering. |
|
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:
Azure |
Definieert de bron van het SSL-certificaat. |
certificateSourceParameters | True |
Definieert de certificaatbronparameters met behulp van het sleutelkluiscertificaat van de gebruiker voor het inschakelen van SSL. |
|
protocolType | True |
Definieert het TLS-extensieprotocol dat wordt gebruikt voor veilige levering. |
|
minimumTlsVersion |
TLS-protocolversie die wordt gebruikt voor Https |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK. De aanvraag is geslaagd. |
|
202 Accepted |
Geaccepteerd en de bewerking wordt asynchroon voltooid. Kopteksten location: string |
|
Other Status Codes |
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
Custom |
Custom |
CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
Voorbeeldaanvraag
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
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 |
---|---|
Cdn |
Definieert de parameters voor het gebruik van cdn beheerd certificaat voor het beveiligen van aangepaste domein. |
Cdn |
Definieert de certificaatbronparameters met behulp van cdn beheerd certificaat voor het inschakelen van SSL. |
Certificate |
Type certificaat dat wordt gebruikt |
Custom |
Beschrijvende domeinnaamtoewijzing aan de hostnaam van het eindpunt die de klant aanbiedt voor huisstijldoeleinden, bijvoorbeeld www.contoso.com. |
Custom |
Resourcestatus van het aangepaste domein. |
Custom |
Inrichtingsstatus van het aangepaste domein. |
Custom |
De substatus inrichten toont stap voor stap de voortgang van het proces voor het inschakelen/uitschakelen van aangepaste HTTPS. |
Delete |
Beschrijft de actie die moet worden uitgevoerd wanneer het certificaat uit Key Vault wordt verwijderd. |
Error |
Aanvullende informatie over de resourcebeheerfout. |
Error |
De foutdetails. |
Error |
Foutreactie |
Identity |
Het type identiteit dat resources maakt/wijzigt |
Key |
Beschrijft de parameters voor het gebruik van het KeyVault-certificaat van een gebruiker voor het beveiligen van een aangepast domein. |
Minimum |
TLS-protocolversie die wordt gebruikt voor Https |
Protocol |
Definieert het TLS-extensieprotocol dat wordt gebruikt voor veilige levering. |
System |
Alleen-lezensysteemgegevens |
Update |
Beschrijft de actie die moet worden uitgevoerd wanneer het certificaat wordt bijgewerkt in Key Vault. |
User |
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 |
Type certificaat dat wordt gebruikt |
|
typeName | string: |
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 |
Definieert de certificaatbronparameters met behulp van cdn beheerd certificaat voor het inschakelen van SSL. |
|
minimumTlsVersion |
TLS-protocolversie die wordt gebruikt voor Https |
|
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 |
Inrichtingsstatus van het aangepaste domein. |
|
properties.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 |
Inrichtingsstatus van Aangepaste HTTPS van het aangepaste domein. |
|
properties.resourceState |
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 |
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 |
De fout aanvullende informatie. |
|
code |
string |
De foutcode. |
details |
De foutdetails. |
|
message |
string |
Het foutbericht. |
target |
string |
Het foutdoel. |
ErrorResponse
Foutreactie
Name | Type | Description |
---|---|---|
error |
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 |
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: | |
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 |
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 |
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:
Azure |
Definieert de bron van het SSL-certificaat. |
certificateSourceParameters |
Definieert de certificaatbronparameters met behulp van het sleutelkluiscertificaat van de gebruiker voor het inschakelen van SSL. |
|
minimumTlsVersion |
TLS-protocolversie die wordt gebruikt voor Https |
|
protocolType |
Definieert het TLS-extensieprotocol dat wordt gebruikt voor veilige levering. |