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 |
Nombre del grupo de recursos dentro de la suscripción de Azure. Patrón de Regex: |
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 de almacén de claves 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 de almacén de claves 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 de almacén de claves 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 |
Aceptar. 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 la red 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 | suplantación de su 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 de 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 nombres de dominio descriptivos al nombre de host del punto de conexión que el cliente proporciona con 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 substate de aprovisionamiento muestra el progreso de la habilitación o deshabilitación del proceso personalizado https 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 |
Datos del sistema de solo lectura |
Update |
Describe la acción que se realizará cuando se actualice el certificado en Key Vault. |
User |
Define los parámetros de origen del certificado mediante el certificado de almacén de claves del usuario para habilitar SSL. |
CdnCertificateSourceParameters
Define los parámetros para usar el certificado administrado de 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
Nombre | Tipo | Description |
---|---|---|
Dedicated |
string |
|
Shared |
string |
CustomDomain
Asignación de nombres de dominio descriptivos al nombre de host del punto de conexión que el cliente proporciona con fines de personalización de marca, por ejemplo , www.contoso.com.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador del 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 substate de aprovisionamiento muestra el progreso de la habilitación o deshabilitación del proceso personalizado https 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 necesiten datos o validación especiales al entregar la red CDN a algunas regiones debido a motivos de cumplimiento local. Por ejemplo, el número de licencia de ICP de un dominio personalizado es necesario para entregar contenido en China. |
systemData |
Datos del sistema de solo lectura |
|
type |
string |
Tipo de recurso. |
CustomDomainResourceState
Estado del recurso del dominio personalizado.
Nombre | Tipo | Description |
---|---|---|
Active |
string |
|
Creating |
string |
|
Deleting |
string |
CustomHttpsProvisioningState
Estado de aprovisionamiento del dominio personalizado.
Nombre | Tipo | Description |
---|---|---|
Disabled |
string |
|
Disabling |
string |
|
Enabled |
string |
|
Enabling |
string |
|
Failed |
string |
CustomHttpsProvisioningSubstate
El substate de aprovisionamiento muestra el progreso de la habilitación o deshabilitación del proceso personalizado https paso a paso.
Nombre | Tipo | Description |
---|---|---|
CertificateDeleted |
string |
|
CertificateDeployed |
string |
|
DeletingCertificate |
string |
|
DeployingCertificate |
string |
|
DomainControlValidationRequestApproved |
string |
|
DomainControlValidationRequestRejected |
string |
|
DomainControlValidationRequestTimedOut |
string |
|
IssuingCertificate |
string |
|
PendingDomainControlValidationREquestApproval |
string |
|
SubmittingDomainControlValidationRequest |
string |
DeleteRule
Describe la acción que se realizará cuando se quite el certificado de Key Vault.
Nombre | Tipo | Description |
---|---|---|
NoAction |
string |
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 |
Los detalles del error. |
|
message |
string |
El 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.
Nombre | Tipo | Description |
---|---|---|
application |
string |
|
key |
string |
|
managedIdentity |
string |
|
user |
string |
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 Key Vault del usuario que contiene el certificado SSL |
secretName |
string |
Nombre de Key Vault Secreto (que representa el certificado completo PFX) en Key Vault. |
secretVersion |
string |
La versión (GUID) de Key Vault Secreto en Key Vault. |
subscriptionId |
string |
Identificador de suscripción del Key Vault del usuario que contiene el certificado SSL |
typeName | string: | |
updateRule |
Describe la acción que se realizará cuando se actualice el certificado en Key Vault. |
|
vaultName |
string |
Nombre del Key Vault del usuario que contiene el certificado SSL. |
MinimumTlsVersion
Versión del protocolo TLS que se usará para Https
Nombre | Tipo | Description |
---|---|---|
None |
string |
|
TLS10 |
string |
|
TLS12 |
string |
ProtocolType
Define el protocolo de extensión TLS que se usa para la entrega segura.
Nombre | Tipo | Description |
---|---|---|
IPBased |
string |
|
ServerNameIndication |
string |
SystemData
Datos del sistema de solo lectura
Nombre | Tipo | Description |
---|---|---|
createdAt |
string |
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 |
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 se actualice el certificado en Key Vault.
Nombre | Tipo | Description |
---|---|---|
NoAction |
string |
UserManagedHttpsParameters
Define los parámetros de origen del certificado mediante el certificado de almacén de claves 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 de almacén de claves 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. |