Dela via


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
customDomainName
path True

string

Namnet på den anpassade domänen i en slutpunkt.

endpointName
path True

string

Namnet på slutpunkten under profilen som är unik globalt.

profileName
path True

string

Namnet på DEN CDN-profil som är unik i resursgruppen.

resourceGroupName
path True

string

Namnet på resursgruppen i Azure-prenumerationen.

Reguljärt uttrycksmönster: ^[-\w\._\(\)]+$

subscriptionId
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
CdnManagedHttpsParameters

Definierar certifikatkällans parametrar med hjälp av CDN-hanterat certifikat för aktivering av SSL.

UserManagedHttpsParameters

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

CdnCertificateSourceParameters

Definierar certifikatkällans parametrar med hjälp av CDN-hanterat certifikat för aktivering av SSL.

protocolType True

ProtocolType

Definierar TLS-tilläggsprotokollet som används för säker leverans.

minimumTlsVersion

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:

AzureKeyVault

Definierar källan för SSL-certifikatet.

certificateSourceParameters True

KeyVaultCertificateSourceParameters

Definierar certifikatkällans parametrar med hjälp av användarens nyckelvalvscertifikat för att aktivera SSL.

protocolType True

ProtocolType

Definierar TLS-tilläggsprotokollet som används för säker leverans.

minimumTlsVersion

MinimumTlsVersion

TLS-protokollversion som ska användas för Https

Svar

Name Typ Description
200 OK

CustomDomain

OK. Begäran har slutförts.

202 Accepted

CustomDomain

Åtgärden godkänns och slutförs asynkront.

Sidhuvuden

location: string

Other Status Codes

ErrorResponse

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

CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
CustomDomains_EnableCustomHttpsUsingYourOwnCertificate

CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate

Exempelbegäran

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

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

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

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
CdnCertificateSourceParameters

Definierar parametrarna för att använda CDN-hanterat certifikat för att skydda en anpassad domän.

CdnManagedHttpsParameters

Definierar certifikatkällans parametrar med hjälp av CDN-hanterat certifikat för aktivering av SSL.

CertificateType

Typ av certifikat som används

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.

CustomDomainResourceState

Resursstatus för den anpassade domänen.

CustomHttpsProvisioningState

Etableringsstatus för den anpassade domänen.

CustomHttpsProvisioningSubstate

Etableringsundertillstånd visar förloppet för den anpassade HTTPS-aktiverings-/inaktiveringsprocessen steg för steg.

DeleteRule

Beskriver de åtgärder som ska vidtas när certifikatet tas bort från Key Vault.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

IdentityType

Den typ av identitet som skapar/ändrar resurser

KeyVaultCertificateSourceParameters

Beskriver parametrarna för att använda en användares KeyVault-certifikat för att skydda en anpassad domän.

MinimumTlsVersion

TLS-protokollversion som ska användas för Https

ProtocolType

Definierar TLS-tilläggsprotokollet som används för säker leverans.

SystemData

Skrivskyddade systemdata

UpdateRule

Beskriver de åtgärder som ska vidtas när certifikatet uppdateras i Key Vault.

UserManagedHttpsParameters

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

CertificateType

Typ av certifikat som används

typeName enum:

CdnCertificateSourceParameters

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

CdnCertificateSourceParameters

Definierar certifikatkällans parametrar med hjälp av CDN-hanterat certifikat för aktivering av SSL.

minimumTlsVersion

MinimumTlsVersion

TLS-protokollversion som ska användas för Https

protocolType

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

CustomHttpsProvisioningState

Etableringsstatus för den anpassade domänen.

properties.customHttpsProvisioningSubstate

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

CustomHttpsProvisioningState

Etableringsstatus för anpassade https för den anpassade domänen.

properties.resourceState

CustomDomainResourceState

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

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

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

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

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 enum:

KeyVaultCertificateSourceParameters

updateRule

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

IdentityType

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

IdentityType

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:

AzureKeyVault

Definierar källan för SSL-certifikatet.

certificateSourceParameters

KeyVaultCertificateSourceParameters

Definierar certifikatkällans parametrar med hjälp av användarens nyckelvalvscertifikat för att aktivera SSL.

minimumTlsVersion

MinimumTlsVersion

TLS-protokollversion som ska användas för Https

protocolType

ProtocolType

Definierar TLS-tilläggsprotokollet som används för säker leverans.