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 |
---|---|---|---|---|
custom
|
path | True |
string |
Název vlastní domény v rámci koncového bodu |
endpoint
|
path | True |
string |
Název koncového bodu v profilu, který je globálně jedinečný. |
profile
|
path | True |
string |
Název profilu CDN, který je v rámci skupiny prostředků jedinečný. |
resource
|
path | True |
string |
Název skupiny prostředků v rámci předplatného Azure Vzor regulárního výrazu: |
subscription
|
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 |
---|---|
Cdn |
Definuje parametry zdroje certifikátu pomocí spravovaného certifikátu CDN pro povolení SSL. |
User |
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 |
Definuje parametry zdroje certifikátu pomocí spravovaného certifikátu CDN pro povolení SSL. |
|
protocolType | True |
Definuje protokol rozšíření TLS, který se používá pro zabezpečené doručování. |
|
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:
Azure |
Definuje zdroj certifikátu SSL. |
certificateSourceParameters | True |
Definuje parametry zdroje certifikátu pomocí certifikátu keyvault uživatele pro povolení SSL. |
|
protocolType | True |
Definuje protokol rozšíření TLS, který se používá pro zabezpečené doručování. |
|
minimumTlsVersion |
Verze protokolu TLS, která se použije pro https |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK. Žádost byla úspěšná. |
|
202 Accepted |
Akce byla přijata a operace se dokončí asynchronně. Hlavičky location: string |
|
Other Status Codes |
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
Custom |
Custom |
CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
Ukázkový požadavek
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
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 |
---|---|
Cdn |
Definuje parametry pro použití spravovaného certifikátu CDN k zabezpečení vlastní domény. |
Cdn |
Definuje parametry zdroje certifikátu pomocí spravovaného certifikátu CDN pro povolení SSL. |
Certificate |
Typ použitého certifikátu |
Custom |
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. |
Custom |
Stav prostředku vlastní domény. |
Custom |
Stav zřizování vlastní domény. |
Custom |
Dílčí stav zřizování ukazuje průběh procesu povolení nebo zakázání vlastního protokolu HTTPS krok za krokem. |
Delete |
Popisuje akci, která se má provést při odebrání certifikátu z Key Vault. |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě. |
Error |
Odpověď na chybu |
Identity |
Typ identity, která vytváří nebo upravuje prostředky |
Key |
Popisuje parametry pro použití certifikátu KeyVault uživatele k zabezpečení vlastní domény. |
Minimum |
Verze protokolu TLS, která se použije pro https |
Protocol |
Definuje protokol rozšíření TLS, který se používá pro zabezpečené doručování. |
System |
Systémová data jen pro čtení |
Update |
Popisuje akci, která se má provést při aktualizaci certifikátu v Key Vault. |
User |
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 |
Typ použitého certifikátu |
|
typeName | string: |
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 |
Definuje parametry zdroje certifikátu pomocí spravovaného certifikátu CDN pro povolení SSL. |
|
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í. |
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 |
Stav zřizování vlastní domény. |
|
properties.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 |
Stav zřizování vlastního https vlastní domény. |
|
properties.resourceState |
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 |
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 |
Další informace o chybě |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Odpověď na chybu
Name | Typ | Description |
---|---|---|
error |
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 |
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: | |
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 |
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 |
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:
Azure |
Definuje zdroj certifikátu SSL. |
certificateSourceParameters |
Definuje parametry zdroje certifikátu pomocí certifikátu keyvault uživatele pro povolení SSL. |
|
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í. |