Sdílet prostřednictvím


Custom Domains - Enable Custom Https

Povolte doručování vlastní domény pomocí protokolu HTTPS.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
customDomainName
path True

string

Název vlastní domény v rámci koncového bodu

endpointName
path True

string

Název koncového bodu v profilu, který je globálně jedinečný.

profileName
path True

string

Název profilu CDN, který je v rámci skupiny prostředků jedinečný.

resourceGroupName
path True

string

Název skupiny prostředků v rámci předplatného Azure

Vzor regulárního výrazu: ^[-\w\._\(\)]+$

subscriptionId
path True

string

ID předplatného Azure.

api-version
query True

string

Verze rozhraní API, která se má použít s požadavkem klienta. Aktuální verze je 2024-02-01.

Text požadavku

Text žádosti může tvořit:

Name Description
CdnManagedHttpsParameters

Definuje parametry zdroje certifikátu pomocí spravovaného certifikátu CDN pro povolení SSL.

UserManagedHttpsParameters

Definuje parametry zdroje certifikátu pomocí certifikátu keyvault uživatele pro povolení SSL.

CdnManagedHttpsParameters

Definuje parametry zdroje certifikátu pomocí spravovaného certifikátu CDN pro povolení SSL.

Name Vyžadováno Typ Description
certificateSource True string:

Cdn

Definuje zdroj certifikátu SSL.

certificateSourceParameters True

CdnCertificateSourceParameters

Definuje parametry zdroje certifikátu pomocí spravovaného certifikátu CDN pro povolení SSL.

protocolType True

ProtocolType

Definuje protokol rozšíření TLS, který se používá pro zabezpečené doručování.

minimumTlsVersion

MinimumTlsVersion

Verze protokolu TLS, která se použije pro https

UserManagedHttpsParameters

Definuje parametry zdroje certifikátu pomocí certifikátu keyvault uživatele pro povolení SSL.

Name Vyžadováno Typ Description
certificateSource True string:

AzureKeyVault

Definuje zdroj certifikátu SSL.

certificateSourceParameters True

KeyVaultCertificateSourceParameters

Definuje parametry zdroje certifikátu pomocí certifikátu keyvault uživatele pro povolení SSL.

protocolType True

ProtocolType

Definuje protokol rozšíření TLS, který se používá pro zabezpečené doručování.

minimumTlsVersion

MinimumTlsVersion

Verze protokolu TLS, která se použije pro https

Odpovědi

Name Typ Description
200 OK

CustomDomain

OK. Žádost byla úspěšná.

202 Accepted

CustomDomain

Akce byla přijata a operace se dokončí asynchronně.

Hlavičky

location: string

Other Status Codes

ErrorResponse

Odpověď na chybu CDN popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
CustomDomains_EnableCustomHttpsUsingYourOwnCertificate

CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate

Ukázkový požadavek

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

Ukázková odpověď

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

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
CdnCertificateSourceParameters

Definuje parametry pro použití spravovaného certifikátu CDN k zabezpečení vlastní domény.

CdnManagedHttpsParameters

Definuje parametry zdroje certifikátu pomocí spravovaného certifikátu CDN pro povolení SSL.

CertificateType

Typ použitého certifikátu

CustomDomain

Popisné mapování názvu domény na název hostitele koncového bodu, který zákazník poskytuje pro účely brandingu, například www.contoso.com.

CustomDomainResourceState

Stav prostředku vlastní domény.

CustomHttpsProvisioningState

Stav zřizování vlastní domény.

CustomHttpsProvisioningSubstate

Dílčí stav zřizování ukazuje průběh procesu povolení nebo zakázání vlastního protokolu HTTPS krok za krokem.

DeleteRule

Popisuje akci, která se má provést při odebrání certifikátu z Key Vault.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě.

ErrorResponse

Odpověď na chybu

IdentityType

Typ identity, která vytváří nebo upravuje prostředky

KeyVaultCertificateSourceParameters

Popisuje parametry pro použití certifikátu KeyVault uživatele k zabezpečení vlastní domény.

MinimumTlsVersion

Verze protokolu TLS, která se použije pro https

ProtocolType

Definuje protokol rozšíření TLS, který se používá pro zabezpečené doručování.

SystemData

Systémová data jen pro čtení

UpdateRule

Popisuje akci, která se má provést při aktualizaci certifikátu v Key Vault.

UserManagedHttpsParameters

Definuje parametry zdroje certifikátu pomocí certifikátu keyvault uživatele pro povolení SSL.

CdnCertificateSourceParameters

Definuje parametry pro použití spravovaného certifikátu CDN k zabezpečení vlastní domény.

Name Typ Description
certificateType

CertificateType

Typ použitého certifikátu

typeName string:

CdnCertificateSourceParameters

CdnManagedHttpsParameters

Definuje parametry zdroje certifikátu pomocí spravovaného certifikátu CDN pro povolení SSL.

Name Typ Description
certificateSource string:

Cdn

Definuje zdroj certifikátu SSL.

certificateSourceParameters

CdnCertificateSourceParameters

Definuje parametry zdroje certifikátu pomocí spravovaného certifikátu CDN pro povolení SSL.

minimumTlsVersion

MinimumTlsVersion

Verze protokolu TLS, která se použije pro https

protocolType

ProtocolType

Definuje protokol rozšíření TLS, který se používá pro zabezpečené doručování.

CertificateType

Typ použitého certifikátu

Name Typ Description
Dedicated

string

Shared

string

CustomDomain

Popisné mapování názvu domény na název hostitele koncového bodu, který zákazník poskytuje pro účely brandingu, například www.contoso.com.

Name Typ Description
id

string

ID prostředku.

name

string

Název prostředku.

properties.customHttpsParameters CustomDomainHttpsParameters:

Parametry certifikátu pro zabezpečení vlastního HTTPS

properties.customHttpsProvisioningState

CustomHttpsProvisioningState

Stav zřizování vlastní domény.

properties.customHttpsProvisioningSubstate

CustomHttpsProvisioningSubstate

Dílčí stav zřizování ukazuje průběh procesu povolení nebo zakázání vlastního protokolu HTTPS krok za krokem.

properties.hostName

string

Název hostitele vlastní domény. Musí to být název domény.

properties.provisioningState

CustomHttpsProvisioningState

Stav zřizování vlastního https vlastní domény.

properties.resourceState

CustomDomainResourceState

Stav prostředku vlastní domény.

properties.validationData

string

Kvůli místnímu dodržování předpisů může být při doručování CDN do některých oblastí vyžadováno speciální ověření nebo data. Například číslo licence ICP vlastní domény se vyžaduje k doručování obsahu v Číně.

systemData

SystemData

Systémová data jen pro čtení

type

string

Typ prostředku.

CustomDomainResourceState

Stav prostředku vlastní domény.

Name Typ Description
Active

string

Creating

string

Deleting

string

CustomHttpsProvisioningState

Stav zřizování vlastní domény.

Name Typ Description
Disabled

string

Disabling

string

Enabled

string

Enabling

string

Failed

string

CustomHttpsProvisioningSubstate

Dílčí stav zřizování ukazuje průběh procesu povolení nebo zakázání vlastního protokolu HTTPS krok za krokem.

Name Typ Description
CertificateDeleted

string

CertificateDeployed

string

DeletingCertificate

string

DeployingCertificate

string

DomainControlValidationRequestApproved

string

DomainControlValidationRequestRejected

string

DomainControlValidationRequestTimedOut

string

IssuingCertificate

string

PendingDomainControlValidationREquestApproval

string

SubmittingDomainControlValidationRequest

string

DeleteRule

Popisuje akci, která se má provést při odebrání certifikátu z Key Vault.

Name Typ Description
NoAction

string

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě

code

string

Kód chyby

details

ErrorDetail[]

Podrobnosti o chybě

message

string

Chybová zpráva

target

string

Cíl chyby.

ErrorResponse

Odpověď na chybu

Name Typ Description
error

ErrorDetail

Objekt chyby.

IdentityType

Typ identity, která vytváří nebo upravuje prostředky

Name Typ Description
application

string

key

string

managedIdentity

string

user

string

KeyVaultCertificateSourceParameters

Popisuje parametry pro použití certifikátu KeyVault uživatele k zabezpečení vlastní domény.

Name Typ Description
deleteRule

DeleteRule

Popisuje akci, která se má provést při odebrání certifikátu z Key Vault.

resourceGroupName

string

Skupina prostředků Key Vault uživatele obsahující certifikát SSL

secretName

string

Název tajného kódu Key Vault (představující úplný certifikát PFX) v Key Vault.

secretVersion

string

Verze (GUID) tajného kódu Key Vault v Key Vault.

subscriptionId

string

ID předplatného Key Vault uživatele obsahující certifikát SSL

typeName string:

KeyVaultCertificateSourceParameters

updateRule

UpdateRule

Popisuje akci, která se má provést při aktualizaci certifikátu v Key Vault.

vaultName

string

Název Key Vault uživatele obsahující certifikát SSL

MinimumTlsVersion

Verze protokolu TLS, která se použije pro https

Name Typ Description
None

string

TLS10

string

TLS12

string

ProtocolType

Definuje protokol rozšíření TLS, který se používá pro zabezpečené doručování.

Name Typ Description
IPBased

string

ServerNameIndication

string

SystemData

Systémová data jen pro čtení

Name Typ Description
createdAt

string

Časové razítko vytvoření prostředku (UTC)

createdBy

string

Identifikátor identity, která vytvořila prostředek

createdByType

IdentityType

Typ identity, která vytvořila prostředek

lastModifiedAt

string

Časové razítko poslední změny prostředku (UTC)

lastModifiedBy

string

Identifikátor identity, která naposledy změnila prostředek

lastModifiedByType

IdentityType

Typ identity, která naposledy změnila prostředek

UpdateRule

Popisuje akci, která se má provést při aktualizaci certifikátu v Key Vault.

Name Typ Description
NoAction

string

UserManagedHttpsParameters

Definuje parametry zdroje certifikátu pomocí certifikátu keyvault uživatele pro povolení SSL.

Name Typ Description
certificateSource string:

AzureKeyVault

Definuje zdroj certifikátu SSL.

certificateSourceParameters

KeyVaultCertificateSourceParameters

Definuje parametry zdroje certifikátu pomocí certifikátu keyvault uživatele pro povolení SSL.

minimumTlsVersion

MinimumTlsVersion

Verze protokolu TLS, která se použije pro https

protocolType

ProtocolType

Definuje protokol rozšíření TLS, který se používá pro zabezpečené doručování.