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 |
---|---|---|---|---|
custom
|
path | True |
string |
Nome do domínio personalizado em um ponto de extremidade. |
endpoint
|
path | True |
string |
Nome do ponto de extremidade no perfil que é exclusivo globalmente. |
profile
|
path | True |
string |
Nome do perfil cdn que é exclusivo dentro do grupo de recursos. |
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+$ |
Nome do grupo de recursos na assinatura do Azure. |
subscription
|
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 |
---|---|
Cdn |
Define os parâmetros de origem do certificado usando o certificado gerenciado da CDN para habilitar o SSL. |
User |
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 |
Define os parâmetros de origem do certificado usando o certificado gerenciado da CDN para habilitar o SSL. |
|
protocolType | True |
Define o protocolo de extensão TLS usado para entrega segura. |
|
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:
Azure |
Define a origem do certificado SSL. |
certificateSourceParameters | True |
Define os parâmetros de origem do certificado usando o certificado keyvault do usuário para habilitar o SSL. |
|
protocolType | True |
Define o protocolo de extensão TLS usado para entrega segura. |
|
minimumTlsVersion |
Versão do protocolo TLS que será usada para Https |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OKEY. A solicitação foi bem-sucedida. |
|
202 Accepted |
Aceito e a operação será concluída de forma assíncrona. Cabeçalhos location: string |
|
Other Status Codes |
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
Custom |
Custom |
CustomDomains_EnableCustomHttpsUsingCDNManagedCertificate
Solicitação de exemplo
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
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 |
---|---|
Cdn |
Define os parâmetros para usar o certificado gerenciado da CDN para proteger o domínio personalizado. |
Cdn |
Define os parâmetros de origem do certificado usando o certificado gerenciado da CDN para habilitar o SSL. |
Certificate |
Tipo de certificado usado |
Custom |
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. |
Custom |
Status do recurso do domínio personalizado. |
Custom |
Status de provisionamento do domínio personalizado. |
Custom |
O subestado de provisionamento mostra o progresso da habilitação/desabilitação do processo HTTPS personalizado passo a passo. |
Delete |
Descreve a ação que deve ser tomada quando o certificado é removido do Key Vault. |
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta de erro |
Identity |
O tipo de identidade que cria/modifica recursos |
Key |
Descreve os parâmetros para usar o certificado KeyVault de um usuário para proteger o domínio personalizado. |
Minimum |
Versão do protocolo TLS que será usada para Https |
Protocol |
Define o protocolo de extensão TLS usado para entrega segura. |
System |
Ler somente dados do sistema |
Update |
Descreve a ação que deve ser tomada quando o certificado é atualizado no Key Vault. |
User |
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 |
Tipo de certificado usado |
|
typeName | string: |
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 |
Define os parâmetros de origem do certificado usando o certificado gerenciado da CDN para habilitar o SSL. |
|
minimumTlsVersion |
Versão do protocolo TLS que será usada para Https |
|
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 |
Status de provisionamento do domínio personalizado. |
|
properties.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 |
Status de provisionamento de Https Personalizados do domínio personalizado. |
|
properties.resourceState |
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 |
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 |
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 de erro
Nome | Tipo | Description |
---|---|---|
error |
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 |
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: | |
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 |
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 |
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:
Azure |
Define a origem do certificado SSL. |
certificateSourceParameters |
Define os parâmetros de origem do certificado usando o certificado keyvault do usuário para habilitar o SSL. |
|
minimumTlsVersion |
Versão do protocolo TLS que será usada para Https |
|
protocolType |
Define o protocolo de extensão TLS usado para entrega segura. |