Custom Domains - Enable Custom Https
Включите доставку личного домена по протоколу 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
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
custom
|
path | True |
string |
Имя личного домена в конечной точке. |
endpoint
|
path | True |
string |
Имя конечной точки в профиле, которая является глобально уникальной. |
profile
|
path | True |
string |
Имя профиля CDN, который является уникальным в пределах группы ресурсов. |
resource
|
path | True |
string |
Имя группы ресурсов в подписке Azure. Шаблон регулярного выражения: |
subscription
|
path | True |
string |
Идентификатор подписки Azure. |
api-version
|
query | True |
string |
Версия API для использования с клиентским запросом. Текущая версия — 01.02.2024. |
Текст запроса
Текст запроса может быть таким:
Имя | Описание |
---|---|
Cdn |
Определяет параметры источника сертификата с помощью управляемого сертификата CDN для включения SSL. |
User |
Определяет параметры источника сертификата, используя сертификат хранилища ключей пользователя для включения SSL. |
CdnManagedHttpsParameters
Определяет параметры источника сертификата с помощью управляемого сертификата CDN для включения SSL.
Имя | Обязательно | Тип | Описание |
---|---|---|---|
certificateSource | True |
string:
Cdn |
Определяет источник SSL-сертификата. |
certificateSourceParameters | True |
Определяет параметры источника сертификата с помощью управляемого сертификата CDN для включения SSL. |
|
protocolType | True |
Определяет протокол расширения TLS, используемый для безопасной доставки. |
|
minimumTlsVersion |
Версия протокола TLS, которая будет использоваться для https |
UserManagedHttpsParameters
Определяет параметры источника сертификата, используя сертификат хранилища ключей пользователя для включения SSL.
Имя | Обязательно | Тип | Описание |
---|---|---|---|
certificateSource | True |
string:
Azure |
Определяет источник SSL-сертификата. |
certificateSourceParameters | True |
Определяет параметры источника сертификата, используя сертификат хранилища ключей пользователя для включения SSL. |
|
protocolType | True |
Определяет протокол расширения TLS, используемый для безопасной доставки. |
|
minimumTlsVersion |
Версия протокола TLS, которая будет использоваться для https |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Все в порядке. Запрос выполнен успешно. |
|
202 Accepted |
Принято, и операция завершится асинхронно. Заголовки location: string |
|
Other Status Codes |
Ответ об ошибке CDN, описывающий причину сбоя операции. |
Безопасность
azure_auth
Поток OAuth2 в Azure Active Directory.
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
Имя | Описание |
---|---|
user_impersonation | олицетворения учетной записи пользователя |
Примеры
Custom |
Custom |
CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
Образец запроса
Пример ответа
{
"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
Образец запроса
Пример ответа
{
"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"
}
}
Определения
Имя | Описание |
---|---|
Cdn |
Определяет параметры использования управляемого сертификата CDN для защиты личного домена. |
Cdn |
Определяет параметры источника сертификата с помощью управляемого сертификата CDN для включения SSL. |
Certificate |
Тип используемого сертификата |
Custom |
Понятное сопоставление доменного имени с именем узла конечной точки, которое клиент предоставляет для целей фирменной символики, например www.contoso.com. |
Custom |
Состояние ресурса личного домена. |
Custom |
Состояние подготовки личного домена. |
Custom |
В подсостояние подготовки показано пошаговое выполнение пользовательского процесса включения и отключения HTTPS. |
Delete |
Описывает действия, которые необходимо выполнить при удалении сертификата из Key Vault. |
Error |
Дополнительные сведения об ошибке управления ресурсами. |
Error |
Сведения об ошибке. |
Error |
Сообщение об ошибке |
Identity |
Тип удостоверения, создающего или изменяющего ресурсы |
Key |
Описываются параметры использования сертификата KeyVault пользователя для защиты личного домена. |
Minimum |
Версия протокола TLS, которая будет использоваться для https |
Protocol |
Определяет протокол расширения TLS, используемый для безопасной доставки. |
System |
Чтение только системных данных |
Update |
Описывает действия, которые необходимо предпринять при обновлении сертификата в Key Vault. |
User |
Определяет параметры источника сертификата, используя сертификат хранилища ключей пользователя для включения SSL. |
CdnCertificateSourceParameters
Определяет параметры использования управляемого сертификата CDN для защиты личного домена.
Имя | Тип | Описание |
---|---|---|
certificateType |
Тип используемого сертификата |
|
typeName | string: |
CdnManagedHttpsParameters
Определяет параметры источника сертификата с помощью управляемого сертификата CDN для включения SSL.
Имя | Тип | Описание |
---|---|---|
certificateSource |
string:
Cdn |
Определяет источник SSL-сертификата. |
certificateSourceParameters |
Определяет параметры источника сертификата с помощью управляемого сертификата CDN для включения SSL. |
|
minimumTlsVersion |
Версия протокола TLS, которая будет использоваться для https |
|
protocolType |
Определяет протокол расширения TLS, используемый для безопасной доставки. |
CertificateType
Тип используемого сертификата
Имя | Тип | Описание |
---|---|---|
Dedicated |
string |
|
Shared |
string |
CustomDomain
Понятное сопоставление доменного имени с именем узла конечной точки, которое клиент предоставляет для целей фирменной символики, например www.contoso.com.
Имя | Тип | Описание |
---|---|---|
id |
string |
Идентификатор ресурса. |
name |
string |
Имя ресурса. |
properties.customHttpsParameters | CustomDomainHttpsParameters: |
Параметры сертификата для защиты настраиваемого протокола HTTPS |
properties.customHttpsProvisioningState |
Состояние подготовки личного домена. |
|
properties.customHttpsProvisioningSubstate |
В подсостояние подготовки показано пошаговое выполнение пользовательского процесса включения и отключения HTTPS. |
|
properties.hostName |
string |
Имя узла личного домена. Это должно быть доменное имя. |
properties.provisioningState |
Состояние подготовки пользовательских https личного домена. |
|
properties.resourceState |
Состояние ресурса личного домена. |
|
properties.validationData |
string |
При доставке CDN в некоторые регионы может потребоваться специальная проверка или данные из-за локальных причин соответствия требованиям. Например, для доставки содержимого в Китай требуется номер лицензии ICP личного домена. |
systemData |
Чтение только системных данных |
|
type |
string |
Тип ресурса. |
CustomDomainResourceState
Состояние ресурса личного домена.
Имя | Тип | Описание |
---|---|---|
Active |
string |
|
Creating |
string |
|
Deleting |
string |
CustomHttpsProvisioningState
Состояние подготовки личного домена.
Имя | Тип | Описание |
---|---|---|
Disabled |
string |
|
Disabling |
string |
|
Enabled |
string |
|
Enabling |
string |
|
Failed |
string |
CustomHttpsProvisioningSubstate
В подсостояние подготовки показано пошаговое выполнение пользовательского процесса включения и отключения HTTPS.
Имя | Тип | Описание |
---|---|---|
CertificateDeleted |
string |
|
CertificateDeployed |
string |
|
DeletingCertificate |
string |
|
DeployingCertificate |
string |
|
DomainControlValidationRequestApproved |
string |
|
DomainControlValidationRequestRejected |
string |
|
DomainControlValidationRequestTimedOut |
string |
|
IssuingCertificate |
string |
|
PendingDomainControlValidationREquestApproval |
string |
|
SubmittingDomainControlValidationRequest |
string |
DeleteRule
Описывает действия, которые необходимо выполнить при удалении сертификата из Key Vault.
Имя | Тип | Описание |
---|---|---|
NoAction |
string |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
info |
object |
Дополнительные сведения. |
type |
string |
Тип дополнительных сведений. |
ErrorDetail
Сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
additionalInfo |
Дополнительные сведения об ошибке. |
|
code |
string |
Код ошибки. |
details |
Сведения об ошибке. |
|
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
ErrorResponse
Сообщение об ошибке
Имя | Тип | Описание |
---|---|---|
error |
Объект error. |
IdentityType
Тип удостоверения, создающего или изменяющего ресурсы
Имя | Тип | Описание |
---|---|---|
application |
string |
|
key |
string |
|
managedIdentity |
string |
|
user |
string |
KeyVaultCertificateSourceParameters
Описываются параметры использования сертификата KeyVault пользователя для защиты личного домена.
Имя | Тип | Описание |
---|---|---|
deleteRule |
Описывает действия, которые необходимо выполнить при удалении сертификата из Key Vault. |
|
resourceGroupName |
string |
Группа ресурсов Key Vault пользователя, содержащая SSL-сертификат |
secretName |
string |
Имя секрета Key Vault (представляющего полный PFX-файл сертификата) в Key Vault. |
secretVersion |
string |
Версия (GUID) секрета Key Vault в Key Vault. |
subscriptionId |
string |
Идентификатор подписки Key Vault пользователя, содержащего SSL-сертификат |
typeName | string: | |
updateRule |
Описывает действия, которые необходимо предпринять при обновлении сертификата в Key Vault. |
|
vaultName |
string |
Имя Key Vault пользователя, содержащего SSL-сертификат. |
MinimumTlsVersion
Версия протокола TLS, которая будет использоваться для https
Имя | Тип | Описание |
---|---|---|
None |
string |
|
TLS10 |
string |
|
TLS12 |
string |
ProtocolType
Определяет протокол расширения TLS, используемый для безопасной доставки.
Имя | Тип | Описание |
---|---|---|
IPBased |
string |
|
ServerNameIndication |
string |
SystemData
Чтение только системных данных
Имя | Тип | Описание |
---|---|---|
createdAt |
string |
Метка времени создания ресурса (UTC) |
createdBy |
string |
Идентификатор удостоверения, создавшего ресурс. |
createdByType |
Тип удостоверения, создавшего ресурс. |
|
lastModifiedAt |
string |
Метка времени последнего изменения ресурса (UTC) |
lastModifiedBy |
string |
Идентификатор удостоверения, изменившего ресурс в последний раз. |
lastModifiedByType |
Тип удостоверения, которое в последний раз изменял ресурс. |
UpdateRule
Описывает действия, которые необходимо предпринять при обновлении сертификата в Key Vault.
Имя | Тип | Описание |
---|---|---|
NoAction |
string |
UserManagedHttpsParameters
Определяет параметры источника сертификата, используя сертификат хранилища ключей пользователя для включения SSL.
Имя | Тип | Описание |
---|---|---|
certificateSource |
string:
Azure |
Определяет источник SSL-сертификата. |
certificateSourceParameters |
Определяет параметры источника сертификата, используя сертификат хранилища ключей пользователя для включения SSL. |
|
minimumTlsVersion |
Версия протокола TLS, которая будет использоваться для https |
|
protocolType |
Определяет протокол расширения TLS, используемый для безопасной доставки. |