Custom Domains - Enable Custom Https
Habilite la entrega https del dominio personalizado.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains/{customDomainName}/enableCustomHttps?api-version=2024-02-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
custom
|
path | True |
string |
Nombre del dominio personalizado dentro de un punto de conexión. |
endpoint
|
path | True |
string |
Nombre del punto de conexión en el perfil que es único globalmente. |
profile
|
path | True |
string |
Nombre del perfil de cdn que es único dentro del grupo de recursos. |
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+$ |
Nombre del grupo de recursos dentro de la suscripción de Azure. |
subscription
|
path | True |
string |
Identificador de suscripción de Azure. |
api-version
|
query | True |
string |
Versión de la API que se va a usar con la solicitud de cliente. La versión actual es 2024-02-01. |
Cuerpo de la solicitud
El cuerpo de la solicitud puede ser uno de los siguientes:
Nombre | Description |
---|---|
Cdn |
Define los parámetros de origen del certificado mediante el certificado administrado por CDN para habilitar SSL. |
User |
Define los parámetros de origen del certificado mediante el certificado keyvault del usuario para habilitar SSL. |
CdnManagedHttpsParameters
Define los parámetros de origen del certificado mediante el certificado administrado por CDN para habilitar SSL.
Nombre | Requerido | Tipo | Description |
---|---|---|---|
certificateSource | True |
string:
Cdn |
Define el origen del certificado SSL. |
certificateSourceParameters | True |
Define los parámetros de origen del certificado mediante el certificado administrado por CDN para habilitar SSL. |
|
protocolType | True |
Define el protocolo de extensión TLS que se usa para la entrega segura. |
|
minimumTlsVersion |
Versión del protocolo TLS que se usará para Https |
UserManagedHttpsParameters
Define los parámetros de origen del certificado mediante el certificado keyvault del usuario para habilitar SSL.
Nombre | Requerido | Tipo | Description |
---|---|---|---|
certificateSource | True |
string:
Azure |
Define el origen del certificado SSL. |
certificateSourceParameters | True |
Define los parámetros de origen del certificado mediante el certificado keyvault del usuario para habilitar SSL. |
|
protocolType | True |
Define el protocolo de extensión TLS que se usa para la entrega segura. |
|
minimumTlsVersion |
Versión del protocolo TLS que se usará para Https |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
De acuerdo. La solicitud se ha realizado correctamente. |
|
202 Accepted |
Aceptado y la operación se completará de forma asincrónica. Encabezados location: string |
|
Other Status Codes |
Respuesta de error de CDN que describe por qué se produjo un error en la operación. |
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory.
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
Nombre | Description |
---|---|
user_impersonation | suplantar la cuenta de usuario |
Ejemplos
Custom |
Custom |
CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
Solicitud de ejemplo
Respuesta de muestra
{
"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
Solicitud de ejemplo
Respuesta de muestra
{
"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"
}
}
Definiciones
Nombre | Description |
---|---|
Cdn |
Define los parámetros para usar el certificado administrado por CDN para proteger el dominio personalizado. |
Cdn |
Define los parámetros de origen del certificado mediante el certificado administrado por CDN para habilitar SSL. |
Certificate |
Tipo de certificado usado |
Custom |
Asignación de nombre de dominio descriptivo al nombre de host del punto de conexión que el cliente proporciona para fines de personalización de marca, por ejemplo, www.contoso.com. |
Custom |
Estado del recurso del dominio personalizado. |
Custom |
Estado de aprovisionamiento del dominio personalizado. |
Custom |
El subestado de aprovisionamiento muestra el progreso de la habilitación o deshabilitación del proceso https personalizado paso a paso. |
Delete |
Describe la acción que se realizará cuando se quite el certificado de Key Vault. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Identity |
Tipo de identidad que crea o modifica recursos |
Key |
Describe los parámetros para usar el certificado KeyVault de un usuario para proteger el dominio personalizado. |
Minimum |
Versión del protocolo TLS que se usará para Https |
Protocol |
Define el protocolo de extensión TLS que se usa para la entrega segura. |
System |
Solo lectura de datos del sistema |
Update |
Describe la acción que se realizará cuando el certificado se actualice en Key Vault. |
User |
Define los parámetros de origen del certificado mediante el certificado keyvault del usuario para habilitar SSL. |
CdnCertificateSourceParameters
Define los parámetros para usar el certificado administrado por CDN para proteger el dominio personalizado.
Nombre | Tipo | Description |
---|---|---|
certificateType |
Tipo de certificado usado |
|
typeName | string: |
CdnManagedHttpsParameters
Define los parámetros de origen del certificado mediante el certificado administrado por CDN para habilitar SSL.
Nombre | Tipo | Description |
---|---|---|
certificateSource |
string:
Cdn |
Define el origen del certificado SSL. |
certificateSourceParameters |
Define los parámetros de origen del certificado mediante el certificado administrado por CDN para habilitar SSL. |
|
minimumTlsVersion |
Versión del protocolo TLS que se usará para Https |
|
protocolType |
Define el protocolo de extensión TLS que se usa para la entrega segura. |
CertificateType
Tipo de certificado usado
Valor | Description |
---|---|
Dedicated | |
Shared |
CustomDomain
Asignación de nombre de dominio descriptivo al nombre de host del punto de conexión que el cliente proporciona para fines de personalización de marca, por ejemplo, www.contoso.com.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso. |
name |
string |
Nombre del recurso. |
properties.customHttpsParameters | CustomDomainHttpsParameters: |
Parámetros de certificado para proteger HTTPS personalizado |
properties.customHttpsProvisioningState |
Estado de aprovisionamiento del dominio personalizado. |
|
properties.customHttpsProvisioningSubstate |
El subestado de aprovisionamiento muestra el progreso de la habilitación o deshabilitación del proceso https personalizado paso a paso. |
|
properties.hostName |
string |
Nombre de host del dominio personalizado. Debe ser un nombre de dominio. |
properties.provisioningState |
Estado de aprovisionamiento de Https personalizado del dominio personalizado. |
|
properties.resourceState |
Estado del recurso del dominio personalizado. |
|
properties.validationData |
string |
Es posible que se requieran datos o validación especiales al entregar cdn a algunas regiones debido a motivos de cumplimiento locales. Por ejemplo, el número de licencia de ICP de un dominio personalizado es necesario para entregar contenido en China. |
systemData |
Solo lectura de datos del sistema |
|
type |
string |
Tipo de recurso. |
CustomDomainResourceState
Estado del recurso del dominio personalizado.
Valor | Description |
---|---|
Active | |
Creating | |
Deleting |
CustomHttpsProvisioningState
Estado de aprovisionamiento del dominio personalizado.
Valor | Description |
---|---|
Disabled | |
Disabling | |
Enabled | |
Enabling | |
Failed |
CustomHttpsProvisioningSubstate
El subestado de aprovisionamiento muestra el progreso de la habilitación o deshabilitación del proceso https personalizado paso a paso.
Valor | Description |
---|---|
CertificateDeleted | |
CertificateDeployed | |
DeletingCertificate | |
DeployingCertificate | |
DomainControlValidationRequestApproved | |
DomainControlValidationRequestRejected | |
DomainControlValidationRequestTimedOut | |
IssuingCertificate | |
PendingDomainControlValidationREquestApproval | |
SubmittingDomainControlValidationRequest |
DeleteRule
Describe la acción que se realizará cuando se quite el certificado de Key Vault.
Valor | Description |
---|---|
NoAction |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Detalles del error. |
|
message |
string |
Mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
IdentityType
Tipo de identidad que crea o modifica recursos
Valor | Description |
---|---|
application | |
key | |
managedIdentity | |
user |
KeyVaultCertificateSourceParameters
Describe los parámetros para usar el certificado KeyVault de un usuario para proteger el dominio personalizado.
Nombre | Tipo | Description |
---|---|---|
deleteRule |
Describe la acción que se realizará cuando se quite el certificado de Key Vault. |
|
resourceGroupName |
string |
Grupo de recursos del almacén de claves del usuario que contiene el certificado SSL |
secretName |
string |
Nombre del secreto de Key Vault (que representa el certificado COMPLETO PFX) en Key Vault. |
secretVersion |
string |
La versión (GUID) del secreto de Key Vault en Key Vault. |
subscriptionId |
string |
Identificador de suscripción del almacén de claves del usuario que contiene el certificado SSL |
typeName | string: | |
updateRule |
Describe la acción que se realizará cuando el certificado se actualice en Key Vault. |
|
vaultName |
string |
Nombre del almacén de claves del usuario que contiene el certificado SSL. |
MinimumTlsVersion
Versión del protocolo TLS que se usará para Https
Valor | Description |
---|---|
None | |
TLS10 | |
TLS12 |
ProtocolType
Define el protocolo de extensión TLS que se usa para la entrega segura.
Valor | Description |
---|---|
IPBased | |
ServerNameIndication |
SystemData
Solo lectura de datos del sistema
Nombre | Tipo | Description |
---|---|---|
createdAt |
string (date-time) |
Marca de tiempo de creación de recursos (UTC) |
createdBy |
string |
Identificador de la identidad que creó el recurso |
createdByType |
Tipo de identidad que creó el recurso |
|
lastModifiedAt |
string (date-time) |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identificador de la identidad que modificó el recurso por última vez. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |
UpdateRule
Describe la acción que se realizará cuando el certificado se actualice en Key Vault.
Valor | Description |
---|---|
NoAction |
UserManagedHttpsParameters
Define los parámetros de origen del certificado mediante el certificado keyvault del usuario para habilitar SSL.
Nombre | Tipo | Description |
---|---|---|
certificateSource |
string:
Azure |
Define el origen del certificado SSL. |
certificateSourceParameters |
Define los parámetros de origen del certificado mediante el certificado keyvault del usuario para habilitar SSL. |
|
minimumTlsVersion |
Versión del protocolo TLS que se usará para Https |
|
protocolType |
Define el protocolo de extensión TLS que se usa para la entrega segura. |