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 |
---|---|---|---|---|
custom
|
path | True |
string |
Nome do domínio personalizado dentro de um ponto final. |
endpoint
|
path | True |
string |
Nome do ponto final no perfil que é exclusivo globalmente. |
profile
|
path | True |
string |
Nome do perfil da CDN que é exclusivo no grupo de recursos. |
resource
|
path | True |
string |
Nome do Grupo de recursos na subscrição do Azure. Padrão Regex: |
subscription
|
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 |
---|---|
Cdn |
Define os parâmetros de origem do certificado com o certificado gerido da CDN para ativar o SSL. |
User |
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 |
Define os parâmetros de origem do certificado com o certificado gerido da CDN para ativar o SSL. |
|
protocolType | True |
Define o protocolo de extensão TLS que é utilizado para entrega segura. |
|
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:
Azure |
Define a origem do certificado SSL. |
certificateSourceParameters | True |
Define os parâmetros de origem do certificado com o certificado keyvault do utilizador para ativar o SSL. |
|
protocolType | True |
Define o protocolo de extensão TLS que é utilizado para entrega segura. |
|
minimumTlsVersion |
Versão do protocolo TLS que será utilizada para Https |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
OK. O pedido foi efetuada com êxito. |
|
202 Accepted |
Aceite e a operação será concluída de forma assíncrona. Cabeçalhos location: string |
|
Other Status Codes |
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
Custom |
Custom |
CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
Pedido de amostra
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
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 |
---|---|
Cdn |
Define os parâmetros para utilizar o certificado gerido da CDN para proteger o domínio personalizado. |
Cdn |
Define os parâmetros de origem do certificado com o certificado gerido da CDN para ativar o SSL. |
Certificate |
Tipo de certificado utilizado |
Custom |
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. |
Custom |
Estado do recurso do domínio personalizado. |
Custom |
Estado de aprovisionamento do domínio personalizado. |
Custom |
O subestado de aprovisionamento mostra o progresso da ativação/desativação de HTTPS personalizada passo a passo. |
Delete |
Descreve a acção que deve ser tomada quando o certificado for removido do Key Vault. |
Error |
Informações adicionais sobre o erro de gestão de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta a erros |
Identity |
O tipo de identidade que cria/modifica recursos |
Key |
Descreve os parâmetros para utilizar o certificado KeyVault de um utilizador para proteger o domínio personalizado. |
Minimum |
Versão do protocolo TLS que será utilizada para Https |
Protocol |
Define o protocolo de extensão TLS que é utilizado para entrega segura. |
System |
Dados do sistema só de leitura |
Update |
Descreve a acção que deve ser tomada quando o certificado for atualizado no Key Vault. |
User |
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 |
Tipo de certificado utilizado |
|
typeName | string: |
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 |
Define os parâmetros de origem do certificado com o certificado gerido da CDN para ativar o SSL. |
|
minimumTlsVersion |
Versão do protocolo TLS que será utilizada para Https |
|
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 |
Estado de aprovisionamento do domínio personalizado. |
|
properties.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 |
Estado de aprovisionamento de Https Personalizados do domínio personalizado. |
|
properties.resourceState |
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 |
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 |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta a erros
Name | Tipo | Description |
---|---|---|
error |
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 |
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: | |
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 |
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 |
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:
Azure |
Define a origem do certificado SSL. |
certificateSourceParameters |
Define os parâmetros de origem do certificado com o certificado keyvault do utilizador para ativar o SSL. |
|
minimumTlsVersion |
Versão do protocolo TLS que será utilizada para Https |
|
protocolType |
Define o protocolo de extensão TLS que é utilizado para entrega segura. |