Partilhar via


Custom Domains - Enable Custom Https

Ative 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 do URI

Name Em Necessário Tipo Description
customDomainName
path True

string

Nome do domínio personalizado dentro de um ponto final.

endpointName
path True

string

Nome do ponto final no perfil que é exclusivo globalmente.

profileName
path True

string

Nome do perfil da CDN que é exclusivo no grupo de recursos.

resourceGroupName
path True

string

Nome do Grupo de recursos na subscrição do Azure.

Padrão Regex: ^[-\w\._\(\)]+$

subscriptionId
path True

string

ID da Subscrição do Azure.

api-version
query True

string

Versão da API a utilizar com o pedido de cliente. A versão atual é 2024-02-01.

Corpo do Pedido

O corpo de pedido pode ser um dos seguintes:

Name Description
CdnManagedHttpsParameters

Define os parâmetros de origem do certificado com o certificado gerido da CDN para ativar o SSL.

UserManagedHttpsParameters

Define os parâmetros de origem do certificado com o certificado keyvault do utilizador para ativar o SSL.

CdnManagedHttpsParameters

Define os parâmetros de origem do certificado com o certificado gerido da CDN para ativar o SSL.

Name Necessário Tipo Description
certificateSource True string:

Cdn

Define a origem do certificado SSL.

certificateSourceParameters True

CdnCertificateSourceParameters

Define os parâmetros de origem do certificado com o certificado gerido da CDN para ativar o SSL.

protocolType True

ProtocolType

Define o protocolo de extensão TLS que é utilizado para entrega segura.

minimumTlsVersion

MinimumTlsVersion

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

UserManagedHttpsParameters

Define os parâmetros de origem do certificado com o certificado keyvault do utilizador para ativar o SSL.

Name Necessário Tipo Description
certificateSource True string:

AzureKeyVault

Define a origem do certificado SSL.

certificateSourceParameters True

KeyVaultCertificateSourceParameters

Define os parâmetros de origem do certificado com o certificado keyvault do utilizador para ativar o SSL.

protocolType True

ProtocolType

Define o protocolo de extensão TLS que é utilizado para entrega segura.

minimumTlsVersion

MinimumTlsVersion

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

Respostas

Name Tipo Description
200 OK

CustomDomain

OK. O pedido foi efetuada com êxito.

202 Accepted

CustomDomain

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

Cabeçalhos

location: string

Other Status Codes

ErrorResponse

Resposta de erro da CDN que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
CustomDomains_EnableCustomHttpsUsingYourOwnCertificate

CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate

Pedido de amostra

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 da amostra

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

Pedido de amostra

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 da amostra

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

Name Description
CdnCertificateSourceParameters

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

CdnManagedHttpsParameters

Define os parâmetros de origem do certificado com o certificado gerido da CDN para ativar o SSL.

CertificateType

Tipo de certificado utilizado

CustomDomain

Mapeamento amigável de nomes de domínio para o nome de anfitrião do ponto final que o cliente fornece para fins de imagem corporativa, por exemplo, www.contoso.com.

CustomDomainResourceState

Estado do recurso do domínio personalizado.

CustomHttpsProvisioningState

Estado de aprovisionamento do domínio personalizado.

CustomHttpsProvisioningSubstate

O subestado de aprovisionamento mostra o progresso da ativação/desativação de HTTPS personalizada passo a passo.

DeleteRule

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

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta a erros

IdentityType

O tipo de identidade que cria/modifica recursos

KeyVaultCertificateSourceParameters

Descreve os parâmetros para utilizar o certificado KeyVault de um utilizador para proteger o domínio personalizado.

MinimumTlsVersion

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

ProtocolType

Define o protocolo de extensão TLS que é utilizado para entrega segura.

SystemData

Dados do sistema só de leitura

UpdateRule

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

UserManagedHttpsParameters

Define os parâmetros de origem do certificado com o certificado keyvault do utilizador para ativar o SSL.

CdnCertificateSourceParameters

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

Name Tipo Description
certificateType

CertificateType

Tipo de certificado utilizado

typeName string:

CdnCertificateSourceParameters

CdnManagedHttpsParameters

Define os parâmetros de origem do certificado com o certificado gerido da CDN para ativar o SSL.

Name Tipo Description
certificateSource string:

Cdn

Define a origem do certificado SSL.

certificateSourceParameters

CdnCertificateSourceParameters

Define os parâmetros de origem do certificado com o certificado gerido da CDN para ativar o SSL.

minimumTlsVersion

MinimumTlsVersion

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

protocolType

ProtocolType

Define o protocolo de extensão TLS que é utilizado para entrega segura.

CertificateType

Tipo de certificado utilizado

Name Tipo Description
Dedicated

string

Shared

string

CustomDomain

Mapeamento amigável de nomes de domínio para o nome de anfitrião do ponto final que o cliente fornece para fins de imagem corporativa, por exemplo, www.contoso.com.

Name 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

Estado de aprovisionamento do domínio personalizado.

properties.customHttpsProvisioningSubstate

CustomHttpsProvisioningSubstate

O subestado de aprovisionamento mostra o progresso da ativação/desativação de HTTPS personalizada passo a passo.

properties.hostName

string

O nome do anfitrião do domínio personalizado. Tem de ser um nome de domínio.

properties.provisioningState

CustomHttpsProvisioningState

Estado de aprovisionamento de Https Personalizados do domínio personalizado.

properties.resourceState

CustomDomainResourceState

Estado do recurso do domínio personalizado.

properties.validationData

string

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

systemData

SystemData

Dados do sistema só de leitura

type

string

Tipo de recurso.

CustomDomainResourceState

Estado do recurso do domínio personalizado.

Name Tipo Description
Active

string

Creating

string

Deleting

string

CustomHttpsProvisioningState

Estado de aprovisionamento do domínio personalizado.

Name Tipo Description
Disabled

string

Disabling

string

Enabled

string

Enabling

string

Failed

string

CustomHttpsProvisioningSubstate

O subestado de aprovisionamento mostra o progresso da ativação/desativação de HTTPS personalizada passo a passo.

Name Tipo Description
CertificateDeleted

string

CertificateDeployed

string

DeletingCertificate

string

DeployingCertificate

string

DomainControlValidationRequestApproved

string

DomainControlValidationRequestRejected

string

DomainControlValidationRequestTimedOut

string

IssuingCertificate

string

PendingDomainControlValidationREquestApproval

string

SubmittingDomainControlValidationRequest

string

DeleteRule

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

Name Tipo Description
NoAction

string

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informações adicionais.

ErrorDetail

O detalhe do erro.

Name 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 a erros

Name Tipo Description
error

ErrorDetail

O objeto de erro.

IdentityType

O tipo de identidade que cria/modifica recursos

Name Tipo Description
application

string

key

string

managedIdentity

string

user

string

KeyVaultCertificateSourceParameters

Descreve os parâmetros para utilizar o certificado KeyVault de um utilizador para proteger o domínio personalizado.

Name Tipo Description
deleteRule

DeleteRule

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

resourceGroupName

string

Grupo de recursos do Key Vault do utilizador que contém o certificado SSL

secretName

string

O nome de Key Vault Secret (que representa o certificado completo PFX) no Key Vault.

secretVersion

string

A versão (GUID) de Key Vault Secret no Key Vault.

subscriptionId

string

ID da subscrição do Key Vault do utilizador que contém o certificado SSL

typeName string:

KeyVaultCertificateSourceParameters

updateRule

UpdateRule

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

vaultName

string

O nome da Key Vault do utilizador que contém o certificado SSL

MinimumTlsVersion

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

Name Tipo Description
None

string

TLS10

string

TLS12

string

ProtocolType

Define o protocolo de extensão TLS que é utilizado para entrega segura.

Name Tipo Description
IPBased

string

ServerNameIndication

string

SystemData

Dados do sistema só de leitura

Name Tipo Description
createdAt

string

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

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 acção que deve ser tomada quando o certificado for atualizado no Key Vault.

Name Tipo Description
NoAction

string

UserManagedHttpsParameters

Define os parâmetros de origem do certificado com o certificado keyvault do utilizador para ativar o SSL.

Name Tipo Description
certificateSource string:

AzureKeyVault

Define a origem do certificado SSL.

certificateSourceParameters

KeyVaultCertificateSourceParameters

Define os parâmetros de origem do certificado com o certificado keyvault do utilizador para ativar o SSL.

minimumTlsVersion

MinimumTlsVersion

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

protocolType

ProtocolType

Define o protocolo de extensão TLS que é utilizado para entrega segura.