Custom Domains - Enable Custom Https
Aktivera https-leverans av den anpassade domänen.
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-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
custom
|
path | True |
string |
Namnet på den anpassade domänen i en slutpunkt. |
endpoint
|
path | True |
string |
Namnet på slutpunkten under profilen som är unik globalt. |
profile
|
path | True |
string |
Namnet på DEN CDN-profil som är unik i resursgruppen. |
resource
|
path | True |
string |
Namnet på resursgruppen i Azure-prenumerationen. Reguljärt uttrycksmönster: |
subscription
|
path | True |
string |
Azure-prenumerations-ID. |
api-version
|
query | True |
string |
Version av API:et som ska användas med klientbegäran. Den aktuella versionen är 2024-02-01. |
Begärandetext
Brödtexten i begäran kan vara något av följande:
Name | Description |
---|---|
Cdn |
Definierar certifikatkällans parametrar med hjälp av CDN-hanterat certifikat för aktivering av SSL. |
User |
Definierar certifikatkällans parametrar med hjälp av användarens nyckelvalvscertifikat för att aktivera SSL. |
CdnManagedHttpsParameters
Definierar certifikatkällans parametrar med hjälp av CDN-hanterat certifikat för aktivering av SSL.
Name | Obligatorisk | Typ | Description |
---|---|---|---|
certificateSource | True |
string:
Cdn |
Definierar källan för SSL-certifikatet. |
certificateSourceParameters | True |
Definierar certifikatkällans parametrar med hjälp av CDN-hanterat certifikat för aktivering av SSL. |
|
protocolType | True |
Definierar TLS-tilläggsprotokollet som används för säker leverans. |
|
minimumTlsVersion |
TLS-protokollversion som ska användas för Https |
UserManagedHttpsParameters
Definierar certifikatkällans parametrar med hjälp av användarens nyckelvalvscertifikat för att aktivera SSL.
Name | Obligatorisk | Typ | Description |
---|---|---|---|
certificateSource | True |
string:
Azure |
Definierar källan för SSL-certifikatet. |
certificateSourceParameters | True |
Definierar certifikatkällans parametrar med hjälp av användarens nyckelvalvscertifikat för att aktivera SSL. |
|
protocolType | True |
Definierar TLS-tilläggsprotokollet som används för säker leverans. |
|
minimumTlsVersion |
TLS-protokollversion som ska användas för Https |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK. Begäran har slutförts. |
|
202 Accepted |
Åtgärden godkänns och slutförs asynkront. Sidhuvuden location: string |
|
Other Status Codes |
CDN-felsvar som beskriver varför åtgärden misslyckades. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
Name | Description |
---|---|
user_impersonation | personifiera ditt användarkonto |
Exempel
Custom |
Custom |
CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
Exempelbegäran
Exempelsvar
{
"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
Exempelbegäran
Exempelsvar
{
"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"
}
}
Definitioner
Name | Description |
---|---|
Cdn |
Definierar parametrarna för att använda CDN-hanterat certifikat för att skydda en anpassad domän. |
Cdn |
Definierar certifikatkällans parametrar med hjälp av CDN-hanterat certifikat för aktivering av SSL. |
Certificate |
Typ av certifikat som används |
Custom |
Användarvänlig domännamnsmappning till slutpunktens värdnamn som kunden tillhandahåller för varumärkesändamål, t.ex. www.contoso.com. |
Custom |
Resursstatus för den anpassade domänen. |
Custom |
Etableringsstatus för den anpassade domänen. |
Custom |
Etableringsundertillstånd visar förloppet för den anpassade HTTPS-aktiverings-/inaktiveringsprocessen steg för steg. |
Delete |
Beskriver de åtgärder som ska vidtas när certifikatet tas bort från Key Vault. |
Error |
Ytterligare information om resurshanteringsfelet. |
Error |
Felinformationen. |
Error |
Felsvar |
Identity |
Den typ av identitet som skapar/ändrar resurser |
Key |
Beskriver parametrarna för att använda en användares KeyVault-certifikat för att skydda en anpassad domän. |
Minimum |
TLS-protokollversion som ska användas för Https |
Protocol |
Definierar TLS-tilläggsprotokollet som används för säker leverans. |
System |
Skrivskyddade systemdata |
Update |
Beskriver de åtgärder som ska vidtas när certifikatet uppdateras i Key Vault. |
User |
Definierar certifikatkällans parametrar med hjälp av användarens nyckelvalvscertifikat för att aktivera SSL. |
CdnCertificateSourceParameters
Definierar parametrarna för att använda CDN-hanterat certifikat för att skydda en anpassad domän.
Name | Typ | Description |
---|---|---|
certificateType |
Typ av certifikat som används |
|
typeName | string: |
CdnManagedHttpsParameters
Definierar certifikatkällans parametrar med hjälp av CDN-hanterat certifikat för aktivering av SSL.
Name | Typ | Description |
---|---|---|
certificateSource |
string:
Cdn |
Definierar källan för SSL-certifikatet. |
certificateSourceParameters |
Definierar certifikatkällans parametrar med hjälp av CDN-hanterat certifikat för aktivering av SSL. |
|
minimumTlsVersion |
TLS-protokollversion som ska användas för Https |
|
protocolType |
Definierar TLS-tilläggsprotokollet som används för säker leverans. |
CertificateType
Typ av certifikat som används
Name | Typ | Description |
---|---|---|
Dedicated |
string |
|
Shared |
string |
CustomDomain
Användarvänlig domännamnsmappning till slutpunktens värdnamn som kunden tillhandahåller för varumärkesändamål, t.ex. www.contoso.com.
Name | Typ | Description |
---|---|---|
id |
string |
Resurs-ID. |
name |
string |
Resursnamn. |
properties.customHttpsParameters | CustomDomainHttpsParameters: |
Certifikatparametrar för att skydda anpassad HTTPS |
properties.customHttpsProvisioningState |
Etableringsstatus för den anpassade domänen. |
|
properties.customHttpsProvisioningSubstate |
Etableringsundertillstånd visar förloppet för den anpassade HTTPS-aktiverings-/inaktiveringsprocessen steg för steg. |
|
properties.hostName |
string |
Värdnamnet för den anpassade domänen. Måste vara ett domännamn. |
properties.provisioningState |
Etableringsstatus för anpassade https för den anpassade domänen. |
|
properties.resourceState |
Resursstatus för den anpassade domänen. |
|
properties.validationData |
string |
Särskild validering eller data kan krävas när du levererar CDN till vissa regioner på grund av lokala efterlevnadsskäl. Till exempel krävs ICP-licensnumret för en anpassad domän för att leverera innehåll i Kina. |
systemData |
Skrivskyddade systemdata |
|
type |
string |
Resurstyp. |
CustomDomainResourceState
Resursstatus för den anpassade domänen.
Name | Typ | Description |
---|---|---|
Active |
string |
|
Creating |
string |
|
Deleting |
string |
CustomHttpsProvisioningState
Etableringsstatus för den anpassade domänen.
Name | Typ | Description |
---|---|---|
Disabled |
string |
|
Disabling |
string |
|
Enabled |
string |
|
Enabling |
string |
|
Failed |
string |
CustomHttpsProvisioningSubstate
Etableringsundertillstånd visar förloppet för den anpassade HTTPS-aktiverings-/inaktiveringsprocessen steg för steg.
Name | Typ | Description |
---|---|---|
CertificateDeleted |
string |
|
CertificateDeployed |
string |
|
DeletingCertificate |
string |
|
DeployingCertificate |
string |
|
DomainControlValidationRequestApproved |
string |
|
DomainControlValidationRequestRejected |
string |
|
DomainControlValidationRequestTimedOut |
string |
|
IssuingCertificate |
string |
|
PendingDomainControlValidationREquestApproval |
string |
|
SubmittingDomainControlValidationRequest |
string |
DeleteRule
Beskriver de åtgärder som ska vidtas när certifikatet tas bort från Key Vault.
Name | Typ | Description |
---|---|---|
NoAction |
string |
ErrorAdditionalInfo
Ytterligare information om resurshanteringsfelet.
Name | Typ | Description |
---|---|---|
info |
object |
Den ytterligare informationen. |
type |
string |
Ytterligare informationstyp. |
ErrorDetail
Felinformationen.
Name | Typ | Description |
---|---|---|
additionalInfo |
Ytterligare information om felet. |
|
code |
string |
Felkoden. |
details |
Felinformationen. |
|
message |
string |
Felmeddelandet. |
target |
string |
Felmålet. |
ErrorResponse
Felsvar
Name | Typ | Description |
---|---|---|
error |
Felobjektet. |
IdentityType
Den typ av identitet som skapar/ändrar resurser
Name | Typ | Description |
---|---|---|
application |
string |
|
key |
string |
|
managedIdentity |
string |
|
user |
string |
KeyVaultCertificateSourceParameters
Beskriver parametrarna för att använda en användares KeyVault-certifikat för att skydda en anpassad domän.
Name | Typ | Description |
---|---|---|
deleteRule |
Beskriver de åtgärder som ska vidtas när certifikatet tas bort från Key Vault. |
|
resourceGroupName |
string |
Resursgrupp för användarens Key Vault som innehåller SSL-certifikatet |
secretName |
string |
Namnet på Key Vault Secret (som representerar det fullständiga certifikatets PFX) i Key Vault. |
secretVersion |
string |
Version (GUID) av Key Vault Hemlighet i Key Vault. |
subscriptionId |
string |
Prenumerations-ID för användarens Key Vault som innehåller SSL-certifikatet |
typeName | string: | |
updateRule |
Beskriver de åtgärder som ska vidtas när certifikatet uppdateras i Key Vault. |
|
vaultName |
string |
Namnet på användarens Key Vault som innehåller SSL-certifikatet |
MinimumTlsVersion
TLS-protokollversion som ska användas för Https
Name | Typ | Description |
---|---|---|
None |
string |
|
TLS10 |
string |
|
TLS12 |
string |
ProtocolType
Definierar TLS-tilläggsprotokollet som används för säker leverans.
Name | Typ | Description |
---|---|---|
IPBased |
string |
|
ServerNameIndication |
string |
SystemData
Skrivskyddade systemdata
Name | Typ | Description |
---|---|---|
createdAt |
string |
Tidsstämpeln för resursskapande (UTC) |
createdBy |
string |
En identifierare för identiteten som skapade resursen |
createdByType |
Den typ av identitet som skapade resursen |
|
lastModifiedAt |
string |
Tidsstämpeln för resursens senaste ändring (UTC) |
lastModifiedBy |
string |
En identifierare för den identitet som senast ändrade resursen |
lastModifiedByType |
Den typ av identitet som senast ändrade resursen |
UpdateRule
Beskriver de åtgärder som ska vidtas när certifikatet uppdateras i Key Vault.
Name | Typ | Description |
---|---|---|
NoAction |
string |
UserManagedHttpsParameters
Definierar certifikatkällans parametrar med hjälp av användarens nyckelvalvscertifikat för att aktivera SSL.
Name | Typ | Description |
---|---|---|
certificateSource |
string:
Azure |
Definierar källan för SSL-certifikatet. |
certificateSourceParameters |
Definierar certifikatkällans parametrar med hjälp av användarens nyckelvalvscertifikat för att aktivera SSL. |
|
minimumTlsVersion |
TLS-protokollversion som ska användas för Https |
|
protocolType |
Definierar TLS-tilläggsprotokollet som används för säker leverans. |