Compartir a través de


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
customDomainName
path True

string

Nombre del dominio personalizado dentro de un punto de conexión.

endpointName
path True

string

Nombre del punto de conexión en el perfil que es único globalmente.

profileName
path True

string

Nombre del perfil de cdn que es único dentro del grupo de recursos.

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

Nombre del grupo de recursos dentro de la suscripción de Azure.

subscriptionId
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
CdnManagedHttpsParameters

Define los parámetros de origen del certificado mediante el certificado administrado por CDN para habilitar SSL.

UserManagedHttpsParameters

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

CdnCertificateSourceParameters

Define los parámetros de origen del certificado mediante el certificado administrado por CDN para habilitar SSL.

protocolType True

ProtocolType

Define el protocolo de extensión TLS que se usa para la entrega segura.

minimumTlsVersion

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:

AzureKeyVault

Define el origen del certificado SSL.

certificateSourceParameters True

KeyVaultCertificateSourceParameters

Define los parámetros de origen del certificado mediante el certificado keyvault del usuario para habilitar SSL.

protocolType True

ProtocolType

Define el protocolo de extensión TLS que se usa para la entrega segura.

minimumTlsVersion

MinimumTlsVersion

Versión del protocolo TLS que se usará para Https

Respuestas

Nombre Tipo Description
200 OK

CustomDomain

De acuerdo. La solicitud se ha realizado correctamente.

202 Accepted

CustomDomain

Aceptado y la operación se completará de forma asincrónica.

Encabezados

location: string

Other Status Codes

ErrorResponse

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

CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
CustomDomains_EnableCustomHttpsUsingYourOwnCertificate

CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate

Solicitud de ejemplo

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

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

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

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
CdnCertificateSourceParameters

Define los parámetros para usar el certificado administrado por CDN para proteger el dominio personalizado.

CdnManagedHttpsParameters

Define los parámetros de origen del certificado mediante el certificado administrado por CDN para habilitar SSL.

CertificateType

Tipo de certificado usado

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.

CustomDomainResourceState

Estado del recurso del dominio personalizado.

CustomHttpsProvisioningState

Estado de aprovisionamiento del dominio personalizado.

CustomHttpsProvisioningSubstate

El subestado de aprovisionamiento muestra el progreso de la habilitación o deshabilitación del proceso https personalizado paso a paso.

DeleteRule

Describe la acción que se realizará cuando se quite el certificado de Key Vault.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

IdentityType

Tipo de identidad que crea o modifica recursos

KeyVaultCertificateSourceParameters

Describe los parámetros para usar el certificado KeyVault de un usuario para proteger el dominio personalizado.

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.

SystemData

Solo lectura de datos del sistema

UpdateRule

Describe la acción que se realizará cuando el certificado se actualice en Key Vault.

UserManagedHttpsParameters

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

CertificateType

Tipo de certificado usado

typeName string:

CdnCertificateSourceParameters

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

CdnCertificateSourceParameters

Define los parámetros de origen del certificado mediante el certificado administrado por CDN para habilitar SSL.

minimumTlsVersion

MinimumTlsVersion

Versión del protocolo TLS que se usará para Https

protocolType

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

CustomHttpsProvisioningState

Estado de aprovisionamiento del dominio personalizado.

properties.customHttpsProvisioningSubstate

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

CustomHttpsProvisioningState

Estado de aprovisionamiento de Https personalizado del dominio personalizado.

properties.resourceState

CustomDomainResourceState

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

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

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

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

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:

KeyVaultCertificateSourceParameters

updateRule

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

IdentityType

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

IdentityType

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:

AzureKeyVault

Define el origen del certificado SSL.

certificateSourceParameters

KeyVaultCertificateSourceParameters

Define los parámetros de origen del certificado mediante el certificado keyvault del usuario para habilitar SSL.

minimumTlsVersion

MinimumTlsVersion

Versión del protocolo TLS que se usará para Https

protocolType

ProtocolType

Define el protocolo de extensión TLS que se usa para la entrega segura.