Compartilhar via


Custom Domains - Enable Custom Https

Habilite a entrega https do domínio 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 URI

Nome Em Obrigatório Tipo Description
customDomainName
path True

string

Nome do domínio personalizado em um ponto de extremidade.

endpointName
path True

string

Nome do ponto de extremidade no perfil que é exclusivo globalmente.

profileName
path True

string

Nome do perfil cdn que é exclusivo dentro do grupo de recursos.

resourceGroupName
path True

string

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

Nome do grupo de recursos na assinatura do Azure.

subscriptionId
path True

string

ID da Assinatura do Azure.

api-version
query True

string

Versão da API a ser usada com a solicitação do cliente. A versão atual é 2024-02-01.

Corpo da solicitação

O corpo da solicitação pode ser um dos seguintes:

Nome Description
CdnManagedHttpsParameters

Define os parâmetros de origem do certificado usando o certificado gerenciado da CDN para habilitar o SSL.

UserManagedHttpsParameters

Define os parâmetros de origem do certificado usando o certificado keyvault do usuário para habilitar o SSL.

CdnManagedHttpsParameters

Define os parâmetros de origem do certificado usando o certificado gerenciado da CDN para habilitar o SSL.

Nome Obrigatório Tipo Description
certificateSource True string:

Cdn

Define a origem do certificado SSL.

certificateSourceParameters True

CdnCertificateSourceParameters

Define os parâmetros de origem do certificado usando o certificado gerenciado da CDN para habilitar o SSL.

protocolType True

ProtocolType

Define o protocolo de extensão TLS usado para entrega segura.

minimumTlsVersion

MinimumTlsVersion

Versão do protocolo TLS que será usada para Https

UserManagedHttpsParameters

Define os parâmetros de origem do certificado usando o certificado keyvault do usuário para habilitar o SSL.

Nome Obrigatório Tipo Description
certificateSource True string:

AzureKeyVault

Define a origem do certificado SSL.

certificateSourceParameters True

KeyVaultCertificateSourceParameters

Define os parâmetros de origem do certificado usando o certificado keyvault do usuário para habilitar o SSL.

protocolType True

ProtocolType

Define o protocolo de extensão TLS usado para entrega segura.

minimumTlsVersion

MinimumTlsVersion

Versão do protocolo TLS que será usada para Https

Respostas

Nome Tipo Description
200 OK

CustomDomain

OKEY. A solicitação foi bem-sucedida.

202 Accepted

CustomDomain

Aceito e a operação será concluída de forma assíncrona.

Cabeçalhos

location: string

Other Status Codes

ErrorResponse

Resposta de erro cdn descrevendo por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
CustomDomains_EnableCustomHttpsUsingYourOwnCertificate

CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate

Solicitação de exemplo

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

Resposta de exemplo

{
  "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

Solicitação de exemplo

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

Resposta de exemplo

{
  "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"
  }
}

Definições

Nome Description
CdnCertificateSourceParameters

Define os parâmetros para usar o certificado gerenciado da CDN para proteger o domínio personalizado.

CdnManagedHttpsParameters

Define os parâmetros de origem do certificado usando o certificado gerenciado da CDN para habilitar o SSL.

CertificateType

Tipo de certificado usado

CustomDomain

Mapeamento de nome de domínio amigável para o nome do host do ponto de extremidade que o cliente fornece para fins de identidade visual, por exemplo, www.contoso.com.

CustomDomainResourceState

Status do recurso do domínio personalizado.

CustomHttpsProvisioningState

Status de provisionamento do domínio personalizado.

CustomHttpsProvisioningSubstate

O subestado de provisionamento mostra o progresso da habilitação/desabilitação do processo HTTPS personalizado passo a passo.

DeleteRule

Descreve a ação que deve ser tomada quando o certificado é removido do Key Vault.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

IdentityType

O tipo de identidade que cria/modifica recursos

KeyVaultCertificateSourceParameters

Descreve os parâmetros para usar o certificado KeyVault de um usuário para proteger o domínio personalizado.

MinimumTlsVersion

Versão do protocolo TLS que será usada para Https

ProtocolType

Define o protocolo de extensão TLS usado para entrega segura.

SystemData

Ler somente dados do sistema

UpdateRule

Descreve a ação que deve ser tomada quando o certificado é atualizado no Key Vault.

UserManagedHttpsParameters

Define os parâmetros de origem do certificado usando o certificado keyvault do usuário para habilitar o SSL.

CdnCertificateSourceParameters

Define os parâmetros para usar o certificado gerenciado da CDN para proteger o domínio personalizado.

Nome Tipo Description
certificateType

CertificateType

Tipo de certificado usado

typeName string:

CdnCertificateSourceParameters

CdnManagedHttpsParameters

Define os parâmetros de origem do certificado usando o certificado gerenciado da CDN para habilitar o SSL.

Nome Tipo Description
certificateSource string:

Cdn

Define a origem do certificado SSL.

certificateSourceParameters

CdnCertificateSourceParameters

Define os parâmetros de origem do certificado usando o certificado gerenciado da CDN para habilitar o SSL.

minimumTlsVersion

MinimumTlsVersion

Versão do protocolo TLS que será usada para Https

protocolType

ProtocolType

Define o protocolo de extensão TLS usado para entrega segura.

CertificateType

Tipo de certificado usado

Valor Description
Dedicated
Shared

CustomDomain

Mapeamento de nome de domínio amigável para o nome do host do ponto de extremidade que o cliente fornece para fins de identidade visual, por exemplo, www.contoso.com.

Nome Tipo Description
id

string

ID do recurso.

name

string

Nome do recurso.

properties.customHttpsParameters CustomDomainHttpsParameters:

Parâmetros de certificado para proteger HTTPS personalizado

properties.customHttpsProvisioningState

CustomHttpsProvisioningState

Status de provisionamento do domínio personalizado.

properties.customHttpsProvisioningSubstate

CustomHttpsProvisioningSubstate

O subestado de provisionamento mostra o progresso da habilitação/desabilitação do processo HTTPS personalizado passo a passo.

properties.hostName

string

O nome do host do domínio personalizado. Deve ser um nome de domínio.

properties.provisioningState

CustomHttpsProvisioningState

Status de provisionamento de Https Personalizados do domínio personalizado.

properties.resourceState

CustomDomainResourceState

Status do recurso do domínio personalizado.

properties.validationData

string

A validação ou os dados especiais podem ser necessários ao fornecer CDN para algumas regiões devido a motivos de conformidade local. Por exemplo, o número de licença ICP de um domínio personalizado é necessário para fornecer conteúdo na China.

systemData

SystemData

Ler somente dados do sistema

type

string

Tipo de recurso.

CustomDomainResourceState

Status do recurso do domínio personalizado.

Valor Description
Active
Creating
Deleting

CustomHttpsProvisioningState

Status de provisionamento do domínio personalizado.

Valor Description
Disabled
Disabling
Enabled
Enabling
Failed

CustomHttpsProvisioningSubstate

O subestado de provisionamento mostra o progresso da habilitação/desabilitação do processo HTTPS personalizado passo a passo.

Valor Description
CertificateDeleted
CertificateDeployed
DeletingCertificate
DeployingCertificate
DomainControlValidationRequestApproved
DomainControlValidationRequestRejected
DomainControlValidationRequestTimedOut
IssuingCertificate
PendingDomainControlValidationREquestApproval
SubmittingDomainControlValidationRequest

DeleteRule

Descreve a ação que deve ser tomada quando o certificado é removido do Key Vault.

Valor Description
NoAction

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

IdentityType

O tipo de identidade que cria/modifica recursos

Valor Description
application
key
managedIdentity
user

KeyVaultCertificateSourceParameters

Descreve os parâmetros para usar o certificado KeyVault de um usuário para proteger o domínio personalizado.

Nome Tipo Description
deleteRule

DeleteRule

Descreve a ação que deve ser tomada quando o certificado é removido do Key Vault.

resourceGroupName

string

Grupo de recursos do Key Vault do usuário que contém o certificado SSL

secretName

string

O nome do Segredo do Key Vault (que representa o certificado completo PFX) no Key Vault.

secretVersion

string

A versão (GUID) do Segredo do Key Vault no Key Vault.

subscriptionId

string

ID de assinatura do Key Vault do usuário que contém o certificado SSL

typeName string:

KeyVaultCertificateSourceParameters

updateRule

UpdateRule

Descreve a ação que deve ser tomada quando o certificado é atualizado no Key Vault.

vaultName

string

O nome do Key Vault do usuário que contém o certificado SSL

MinimumTlsVersion

Versão do protocolo TLS que será usada para Https

Valor Description
None
TLS10
TLS12

ProtocolType

Define o protocolo de extensão TLS usado para entrega segura.

Valor Description
IPBased
ServerNameIndication

SystemData

Ler somente dados do sistema

Nome Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC)

createdBy

string

Um identificador para a identidade que criou o recurso

createdByType

IdentityType

O tipo de identidade que criou o recurso

lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

Um identificador para a identidade que modificou o recurso pela última vez

lastModifiedByType

IdentityType

O tipo de identidade que modificou o recurso pela última vez

UpdateRule

Descreve a ação que deve ser tomada quando o certificado é atualizado no Key Vault.

Valor Description
NoAction

UserManagedHttpsParameters

Define os parâmetros de origem do certificado usando o certificado keyvault do usuário para habilitar o SSL.

Nome Tipo Description
certificateSource string:

AzureKeyVault

Define a origem do certificado SSL.

certificateSourceParameters

KeyVaultCertificateSourceParameters

Define os parâmetros de origem do certificado usando o certificado keyvault do usuário para habilitar o SSL.

minimumTlsVersion

MinimumTlsVersion

Versão do protocolo TLS que será usada para Https

protocolType

ProtocolType

Define o protocolo de extensão TLS usado para entrega segura.