Compartilhar via

Microsoft.Network frontDoors 2020-05-01

  • Artigo

Definição de recurso do Bicep

O tipo de recurso frontDoors pode ser implantado com operações de destino:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Network/frontDoors, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.Network/frontDoors@2020-05-01' = {
  location: 'string'
  name: 'string'
  properties: {
    backendPools: [
      {
        id: 'string'
        name: 'string'
        properties: {
          backends: [
            {
              address: 'string'
              backendHostHeader: 'string'
              enabledState: 'string'
              httpPort: int
              httpsPort: int
              priority: int
              privateLinkAlias: 'string'
              privateLinkApprovalMessage: 'string'
              privateLinkLocation: 'string'
              privateLinkResourceId: 'string'
              weight: int
            }
          ]
          healthProbeSettings: {
            id: 'string'
          }
          loadBalancingSettings: {
            id: 'string'
          }
        }
      }
    ]
    backendPoolsSettings: {
      enforceCertificateNameCheck: 'string'
      sendRecvTimeoutSeconds: int
    }
    enabledState: 'string'
    friendlyName: 'string'
    frontendEndpoints: [
      {
        id: 'string'
        name: 'string'
        properties: {
          hostName: 'string'
          sessionAffinityEnabledState: 'string'
          sessionAffinityTtlSeconds: int
          webApplicationFirewallPolicyLink: {
            id: 'string'
          }
        }
      }
    ]
    healthProbeSettings: [
      {
        id: 'string'
        name: 'string'
        properties: {
          enabledState: 'string'
          healthProbeMethod: 'string'
          intervalInSeconds: int
          path: 'string'
          protocol: 'string'
        }
      }
    ]
    loadBalancingSettings: [
      {
        id: 'string'
        name: 'string'
        properties: {
          additionalLatencyMilliseconds: int
          sampleSize: int
          successfulSamplesRequired: int
        }
      }
    ]
    routingRules: [
      {
        id: 'string'
        name: 'string'
        properties: {
          acceptedProtocols: [
            'string'
          ]
          enabledState: 'string'
          frontendEndpoints: [
            {
              id: 'string'
            }
          ]
          patternsToMatch: [
            'string'
          ]
          routeConfiguration: {
            @odata.type: 'string'
            // For remaining properties, see RouteConfiguration objects
          }
          rulesEngine: {
            id: 'string'
          }
          webApplicationFirewallPolicyLink: {
            id: 'string'
          }
        }
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

Objetos RouteConfiguration

Defina a propriedade @odata.type para especificar o tipo de objeto.

Para #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration, use:

{
  @odata.type: '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
  backendPool: {
    id: 'string'
  }
  cacheConfiguration: {
    cacheDuration: 'string'
    dynamicCompression: 'string'
    queryParameters: 'string'
    queryParameterStripDirective: 'string'
  }
  customForwardingPath: 'string'
  forwardingProtocol: 'string'
}

Para #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration, use:

{
  @odata.type: '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration'
  customFragment: 'string'
  customHost: 'string'
  customPath: 'string'
  customQueryString: 'string'
  redirectProtocol: 'string'
  redirectType: 'string'
}

Valores de propriedade

Back-end

Nome Descrição Valor
endereço Local do back-end (endereço IP ou FQDN) corda
backendHostHeader O valor a ser usado como o cabeçalho do host enviado para o back-end. Se estiver em branco ou não for especificado, esse padrão será o host de entrada. corda
enabledState Se deseja habilitar o uso desse back-end. Os valores permitidos são 'Habilitados' ou 'Desabilitados' 'Desabilitado'
'Habilitado'
httpPort O número da porta TCP HTTP. Deve estar entre 1 e 65535. int

Restrições:
Valor mínimo = 1
Valor máximo = 65535
httpsPort O número da porta TCP HTTPS. Deve estar entre 1 e 65535. int

Restrições:
Valor mínimo = 1
Valor máximo = 65535
prioridade Prioridade a ser usada para balanceamento de carga. Prioridades mais altas não serão usadas para balanceamento de carga se qualquer back-end de prioridade mais baixa estiver íntegro. int

Restrições:
Valor mínimo = 1
Valor máximo = 5
privateLinkAlias O Alias do recurso de Link Privado. Preencher esse campo opcional indica que esse back-end é 'Privado' corda
privateLinkApprovalMessage Uma mensagem personalizada a ser incluída na solicitação de aprovação para se conectar ao Link Privado corda
privateLinkLocation O local do recurso de Link Privado. Necessário somente se 'privateLinkResourceId' for preenchido corda
privateLinkResourceId A ID do Recurso do Recurso de Link Privado. Preencher esse campo opcional indica que esse back-end é 'Privado' corda
peso Peso desse ponto de extremidade para fins de balanceamento de carga. int

Restrições:
Valor mínimo = 1
Valor máximo = 1000

BackendPool

Nome Descrição Valor
id ID do recurso. corda
nome Nome do recurso. corda
Propriedades Propriedades do pool de back-end do Front Door BackendPoolProperties

BackendPoolProperties

Nome Descrição Valor
back-ends O conjunto de back-ends para esse pool de back-end []
healthProbeSettings Configurações de investigação de integridade L7 para um pool de back-end sub-recurso
loadBalancingSettings Configurações de balanceamento de carga para um pool de back-end sub-recurso

BackendPoolsSettings

Nome Descrição Valor
enforceCertificateNameCheck Se deseja impor a verificação de nome de certificado em solicitações HTTPS a todos os pools de back-end. Nenhum efeito em solicitações não HTTPS. 'Desabilitado'
'Habilitado'
sendRecvTimeoutSeconds Enviar e receber tempo limite na solicitação de encaminhamento para o back-end. Quando o tempo limite é atingido, a solicitação falha e retorna. int

Restrições:
Valor mínimo = 16

CacheConfiguration

Nome Descrição Valor
cacheDuration A duração para a qual o conteúdo precisa ser armazenado em cache. O formato permitido está no formato ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP requer que o valor seja não mais do que um ano corda
dynamicCompression Se deve usar a compactação dinâmica para conteúdo armazenado em cache 'Desabilitado'
'Habilitado'
queryParameters parâmetros de consulta a serem incluídos ou excluídos (separados por vírgula). corda
queryParameterStripDirective Tratamento de termos de consulta de URL ao formar a chave de cache. 'StripAll'
'StripAllExcept'
'StripNone'
'StripOnly'

ForwardingConfiguration

Nome Descrição Valor
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (obrigatório)
backendPool Uma referência ao BackendPool para o qual essa regra é roteada. sub-recurso
cacheConfiguration A configuração de cache associada a essa regra. cacheConfiguration
customForwardingPath Um caminho personalizado usado para reescrever caminhos de recurso correspondentes a essa regra. Deixe vazio para usar o caminho de entrada. corda
forwardingProtocol Protocolo que essa regra usará ao encaminhar o tráfego para back-ends. 'HttpOnly'
'HttpsOnly'
'MatchRequest'

FrontDoorProperties

Nome Descrição Valor
backendPools Pools de back-end disponíveis para regras de roteamento. back-endPool[]
backendPoolsSettings Configurações para todos os back-endPools BackendPoolsSettings
enabledState Status operacional do balanceador de carga do Front Door. Os valores permitidos são 'Habilitados' ou 'Desabilitados' 'Desabilitado'
'Habilitado'
friendlyName Um nome amigável para o frontDoor corda
frontendEndpoints Pontos de extremidade de front-end disponíveis para regras de roteamento. do FrontendEndpoint []
healthProbeSettings Configurações de investigação de integridade associadas a essa instância do Front Door. HealthProbeSettingsModel[]
loadBalancingSettings Configurações de balanceamento de carga associadas a essa instância do Front Door. LoadBalancingSettingsModel[]
routingRules Regras de roteamento associadas a este Front Door. RoutingRule []

FrontendEndpoint

Nome Descrição Valor
id ID do recurso. corda
nome Nome do recurso. corda
Propriedades Propriedades do ponto de extremidade front-end frontendEndpointProperties

FrontendEndpointProperties

Nome Descrição Valor
hostName O nome do host do frontendEndpoint. Deve ser um nome de domínio. corda
sessionAffinityEnabledState Se deseja permitir afinidade de sessão neste host. As opções válidas são "Habilitado" ou "Desabilitado" 'Desabilitado'
'Habilitado'
sessionAffinityTtlSeconds UTILIZADAS. Esse campo será ignorado. O TTL a ser usado em segundos para afinidade de sessão, se aplicável. int
webApplicationFirewallPolicyLink Define a política de Firewall do Aplicativo Web para cada host (se aplicável) FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Nome Descrição Valor
id ID do recurso. corda

HealthProbeSettingsModel

Nome Descrição Valor
id ID do recurso. corda
nome Nome do recurso. corda
Propriedades Propriedades das configurações de investigação de integridade HealthProbeSettingsProperties

HealthProbeSettingsProperties

Nome Descrição Valor
enabledState Se as investigações de integridade devem ser feitas em relação aos back-ends definidos em back-endPools. Investigações de integridade só poderão ser desabilitadas se houver um único back-end habilitado no pool de back-end habilitado único. 'Desabilitado'
'Habilitado'
healthProbeMethod Configura qual método HTTP usar para investigar os back-ends definidos em back-endPools. 'GET'
'HEAD'
intervalInSeconds O número de segundos entre investigações de integridade. int
caminho O caminho a ser usado para a investigação de integridade. O padrão é / corda
protocolo Esquema de protocolo a ser usado para esta investigação 'Http'
'Https'

LoadBalancingSettingsModel

Nome Descrição Valor
id ID do recurso. corda
nome Nome do recurso. corda
Propriedades Propriedades das configurações de balanceamento de carga LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Nome Descrição Valor
additionalLatencyMilliseconds A latência adicional em milissegundos para que as investigações caiam no bucket de latência mais baixo int
sampleSize O número de exemplos a serem considerados para decisões de balanceamento de carga int
successfulSamplesRequired O número de exemplos dentro do período de exemplo que deve ter êxito int

Microsoft.Network/frontDoors

Nome Descrição Valor
localização Local do recurso. corda
nome O nome do recurso corda

Restrições:
Comprimento mínimo = 5
Comprimento máximo = 5
Padrão = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (obrigatório)
Propriedades Propriedades do Balanceador de Carga do Front Door FrontDoorProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos

RedirectConfiguration

Nome Descrição Valor
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obrigatório)
customFragment Fragmento a ser adicionado à URL de redirecionamento. Fragmento é a parte da URL que vem depois de #. Não inclua o #. corda
customHost Hospedar para redirecionar. Deixe vazio para usar o host de entrada como o host de destino. corda
customPath O caminho completo para redirecionamento. O caminho não pode estar vazio e deve começar com /. Deixe vazio para usar o caminho de entrada como caminho de destino. corda
customQueryString O conjunto de cadeias de caracteres de consulta a serem colocadas na URL de redirecionamento. Definir esse valor substituiria qualquer cadeia de caracteres de consulta existente; deixe vazio para preservar a cadeia de caracteres de consulta de entrada. A cadeia de caracteres de consulta deve estar em <chave>= formato> de valor<. O primeiro? e & serão adicionados automaticamente, portanto, não os inclua na frente, mas separe várias cadeias de caracteres de consulta com &. corda
redirectProtocol O protocolo do destino para onde o tráfego é redirecionado 'HttpOnly'
'HttpsOnly'
'MatchRequest'
redirectType O tipo de redirecionamento que a regra usará ao redirecionar o tráfego. 'Encontrado'
'Movido'
'PermanentRedirect'
'TemporaryRedirect'

ResourceTags

Nome Descrição Valor

RouteConfiguration

Nome Descrição Valor
@odata.type Defina como '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' para o tipo ForwardingConfiguration. Defina como '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' para o tipo RedirectConfiguration. '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
'#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obrigatório)

RoutingRule

Nome Descrição Valor
id ID do recurso. corda
nome Nome do recurso. corda
Propriedades Propriedades da regra de roteamento do Front Door RoutingRuleProperties

RoutingRuleProperties

Nome Descrição Valor
acceptedProtocols Esquemas de protocolo para corresponder a essa regra Matriz de cadeia de caracteres que contém qualquer um dos:
'Http'
'Https'
enabledState Se deseja habilitar o uso dessa regra. Os valores permitidos são 'Habilitados' ou 'Desabilitados' 'Desabilitado'
'Habilitado'
frontendEndpoints Pontos de extremidade de front-end associados a essa regra sub-recursos[]
patternsToMatch Os padrões de rota da regra. string[]
routeConfiguration Uma referência à configuração de roteamento. RouteConfiguration
rulesEngine Uma referência a uma configuração específica do mecanismo de regras a ser aplicada a essa rota. sub-recurso
webApplicationFirewallPolicyLink Define a política de Firewall do Aplicativo Web para cada regra de roteamento (se aplicável) RoutingRuleUpdateParametersWebApplicationFirewallPolicyLink
Nome Descrição Valor
id ID do recurso. corda

SubResource

Nome Descrição Valor
id ID do recurso. corda

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
Adicionar domínio personalizado e certificado personalizado com o Front Door Esse modelo integra e protege um domínio personalizado com o Front Door com um certificado gerenciado pelo cliente
Adicionar domínio personalizado e certificado gerenciado com o Front Door Esse modelo integra e protege um domínio personalizado com o Front Door
controlar investigações de integridade para seus back-ends no Front Door Este modelo atualiza o Front Door para alterar as configurações de investigação de integridade definindo o caminho da investigação e também os intervalos nos quais as investigações serão enviadas.
criar um básico do Front Door Esse modelo cria uma configuração básica do Front Door com um único back-end.
criar um Front Door com de redirecionamento HTTP para HTTPS Esse modelo cria uma configuração do Front Door para redirecionamento HTTP para HTTPS.

Definição de recurso de modelo do ARM

O tipo de recurso frontDoors pode ser implantado com operações de destino:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Network/frontDoors, adicione o JSON a seguir ao seu modelo.

{
  "type": "Microsoft.Network/frontDoors",
  "apiVersion": "2020-05-01",
  "name": "string",
  "location": "string",
  "properties": {
    "backendPools": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "backends": [
            {
              "address": "string",
              "backendHostHeader": "string",
              "enabledState": "string",
              "httpPort": "int",
              "httpsPort": "int",
              "priority": "int",
              "privateLinkAlias": "string",
              "privateLinkApprovalMessage": "string",
              "privateLinkLocation": "string",
              "privateLinkResourceId": "string",
              "weight": "int"
            }
          ],
          "healthProbeSettings": {
            "id": "string"
          },
          "loadBalancingSettings": {
            "id": "string"
          }
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "string",
      "sendRecvTimeoutSeconds": "int"
    },
    "enabledState": "string",
    "friendlyName": "string",
    "frontendEndpoints": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "hostName": "string",
          "sessionAffinityEnabledState": "string",
          "sessionAffinityTtlSeconds": "int",
          "webApplicationFirewallPolicyLink": {
            "id": "string"
          }
        }
      }
    ],
    "healthProbeSettings": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "enabledState": "string",
          "healthProbeMethod": "string",
          "intervalInSeconds": "int",
          "path": "string",
          "protocol": "string"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "additionalLatencyMilliseconds": "int",
          "sampleSize": "int",
          "successfulSamplesRequired": "int"
        }
      }
    ],
    "routingRules": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "acceptedProtocols": [ "string" ],
          "enabledState": "string",
          "frontendEndpoints": [
            {
              "id": "string"
            }
          ],
          "patternsToMatch": [ "string" ],
          "routeConfiguration": {
            "@odata.type": "string"
            // For remaining properties, see RouteConfiguration objects
          },
          "rulesEngine": {
            "id": "string"
          },
          "webApplicationFirewallPolicyLink": {
            "id": "string"
          }
        }
      }
    ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objetos RouteConfiguration

Defina a propriedade @odata.type para especificar o tipo de objeto.

Para #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration, use:

{
  "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
  "backendPool": {
    "id": "string"
  },
  "cacheConfiguration": {
    "cacheDuration": "string",
    "dynamicCompression": "string",
    "queryParameters": "string",
    "queryParameterStripDirective": "string"
  },
  "customForwardingPath": "string",
  "forwardingProtocol": "string"
}

Para #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration, use:

{
  "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration",
  "customFragment": "string",
  "customHost": "string",
  "customPath": "string",
  "customQueryString": "string",
  "redirectProtocol": "string",
  "redirectType": "string"
}

Valores de propriedade

Back-end

Nome Descrição Valor
endereço Local do back-end (endereço IP ou FQDN) corda
backendHostHeader O valor a ser usado como o cabeçalho do host enviado para o back-end. Se estiver em branco ou não for especificado, esse padrão será o host de entrada. corda
enabledState Se deseja habilitar o uso desse back-end. Os valores permitidos são 'Habilitados' ou 'Desabilitados' 'Desabilitado'
'Habilitado'
httpPort O número da porta TCP HTTP. Deve estar entre 1 e 65535. int

Restrições:
Valor mínimo = 1
Valor máximo = 65535
httpsPort O número da porta TCP HTTPS. Deve estar entre 1 e 65535. int

Restrições:
Valor mínimo = 1
Valor máximo = 65535
prioridade Prioridade a ser usada para balanceamento de carga. Prioridades mais altas não serão usadas para balanceamento de carga se qualquer back-end de prioridade mais baixa estiver íntegro. int

Restrições:
Valor mínimo = 1
Valor máximo = 5
privateLinkAlias O Alias do recurso de Link Privado. Preencher esse campo opcional indica que esse back-end é 'Privado' corda
privateLinkApprovalMessage Uma mensagem personalizada a ser incluída na solicitação de aprovação para se conectar ao Link Privado corda
privateLinkLocation O local do recurso de Link Privado. Necessário somente se 'privateLinkResourceId' for preenchido corda
privateLinkResourceId A ID do Recurso do Recurso de Link Privado. Preencher esse campo opcional indica que esse back-end é 'Privado' corda
peso Peso desse ponto de extremidade para fins de balanceamento de carga. int

Restrições:
Valor mínimo = 1
Valor máximo = 1000

BackendPool

Nome Descrição Valor
id ID do recurso. corda
nome Nome do recurso. corda
Propriedades Propriedades do pool de back-end do Front Door BackendPoolProperties

BackendPoolProperties

Nome Descrição Valor
back-ends O conjunto de back-ends para esse pool de back-end []
healthProbeSettings Configurações de investigação de integridade L7 para um pool de back-end sub-recurso
loadBalancingSettings Configurações de balanceamento de carga para um pool de back-end sub-recurso

BackendPoolsSettings

Nome Descrição Valor
enforceCertificateNameCheck Se deseja impor a verificação de nome de certificado em solicitações HTTPS a todos os pools de back-end. Nenhum efeito em solicitações não HTTPS. 'Desabilitado'
'Habilitado'
sendRecvTimeoutSeconds Enviar e receber tempo limite na solicitação de encaminhamento para o back-end. Quando o tempo limite é atingido, a solicitação falha e retorna. int

Restrições:
Valor mínimo = 16

CacheConfiguration

Nome Descrição Valor
cacheDuration A duração para a qual o conteúdo precisa ser armazenado em cache. O formato permitido está no formato ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP requer que o valor seja não mais do que um ano corda
dynamicCompression Se deve usar a compactação dinâmica para conteúdo armazenado em cache 'Desabilitado'
'Habilitado'
queryParameters parâmetros de consulta a serem incluídos ou excluídos (separados por vírgula). corda
queryParameterStripDirective Tratamento de termos de consulta de URL ao formar a chave de cache. 'StripAll'
'StripAllExcept'
'StripNone'
'StripOnly'

ForwardingConfiguration

Nome Descrição Valor
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (obrigatório)
backendPool Uma referência ao BackendPool para o qual essa regra é roteada. sub-recurso
cacheConfiguration A configuração de cache associada a essa regra. cacheConfiguration
customForwardingPath Um caminho personalizado usado para reescrever caminhos de recurso correspondentes a essa regra. Deixe vazio para usar o caminho de entrada. corda
forwardingProtocol Protocolo que essa regra usará ao encaminhar o tráfego para back-ends. 'HttpOnly'
'HttpsOnly'
'MatchRequest'

FrontDoorProperties

Nome Descrição Valor
backendPools Pools de back-end disponíveis para regras de roteamento. back-endPool[]
backendPoolsSettings Configurações para todos os back-endPools BackendPoolsSettings
enabledState Status operacional do balanceador de carga do Front Door. Os valores permitidos são 'Habilitados' ou 'Desabilitados' 'Desabilitado'
'Habilitado'
friendlyName Um nome amigável para o frontDoor corda
frontendEndpoints Pontos de extremidade de front-end disponíveis para regras de roteamento. do FrontendEndpoint []
healthProbeSettings Configurações de investigação de integridade associadas a essa instância do Front Door. HealthProbeSettingsModel[]
loadBalancingSettings Configurações de balanceamento de carga associadas a essa instância do Front Door. LoadBalancingSettingsModel[]
routingRules Regras de roteamento associadas a este Front Door. RoutingRule []

FrontendEndpoint

Nome Descrição Valor
id ID do recurso. corda
nome Nome do recurso. corda
Propriedades Propriedades do ponto de extremidade front-end frontendEndpointProperties

FrontendEndpointProperties

Nome Descrição Valor
hostName O nome do host do frontendEndpoint. Deve ser um nome de domínio. corda
sessionAffinityEnabledState Se deseja permitir afinidade de sessão neste host. As opções válidas são "Habilitado" ou "Desabilitado" 'Desabilitado'
'Habilitado'
sessionAffinityTtlSeconds UTILIZADAS. Esse campo será ignorado. O TTL a ser usado em segundos para afinidade de sessão, se aplicável. int
webApplicationFirewallPolicyLink Define a política de Firewall do Aplicativo Web para cada host (se aplicável) FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Nome Descrição Valor
id ID do recurso. corda

HealthProbeSettingsModel

Nome Descrição Valor
id ID do recurso. corda
nome Nome do recurso. corda
Propriedades Propriedades das configurações de investigação de integridade HealthProbeSettingsProperties

HealthProbeSettingsProperties

Nome Descrição Valor
enabledState Se as investigações de integridade devem ser feitas em relação aos back-ends definidos em back-endPools. Investigações de integridade só poderão ser desabilitadas se houver um único back-end habilitado no pool de back-end habilitado único. 'Desabilitado'
'Habilitado'
healthProbeMethod Configura qual método HTTP usar para investigar os back-ends definidos em back-endPools. 'GET'
'HEAD'
intervalInSeconds O número de segundos entre investigações de integridade. int
caminho O caminho a ser usado para a investigação de integridade. O padrão é / corda
protocolo Esquema de protocolo a ser usado para esta investigação 'Http'
'Https'

LoadBalancingSettingsModel

Nome Descrição Valor
id ID do recurso. corda
nome Nome do recurso. corda
Propriedades Propriedades das configurações de balanceamento de carga LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Nome Descrição Valor
additionalLatencyMilliseconds A latência adicional em milissegundos para que as investigações caiam no bucket de latência mais baixo int
sampleSize O número de exemplos a serem considerados para decisões de balanceamento de carga int
successfulSamplesRequired O número de exemplos dentro do período de exemplo que deve ter êxito int

Microsoft.Network/frontDoors

Nome Descrição Valor
apiVersion A versão da API '2020-05-01'
localização Local do recurso. corda
nome O nome do recurso corda

Restrições:
Comprimento mínimo = 5
Comprimento máximo = 5
Padrão = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (obrigatório)
Propriedades Propriedades do Balanceador de Carga do Front Door FrontDoorProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.Network/frontDoors'

RedirectConfiguration

Nome Descrição Valor
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obrigatório)
customFragment Fragmento a ser adicionado à URL de redirecionamento. Fragmento é a parte da URL que vem depois de #. Não inclua o #. corda
customHost Hospedar para redirecionar. Deixe vazio para usar o host de entrada como o host de destino. corda
customPath O caminho completo para redirecionamento. O caminho não pode estar vazio e deve começar com /. Deixe vazio para usar o caminho de entrada como caminho de destino. corda
customQueryString O conjunto de cadeias de caracteres de consulta a serem colocadas na URL de redirecionamento. Definir esse valor substituiria qualquer cadeia de caracteres de consulta existente; deixe vazio para preservar a cadeia de caracteres de consulta de entrada. A cadeia de caracteres de consulta deve estar em <chave>= formato> de valor<. O primeiro? e & serão adicionados automaticamente, portanto, não os inclua na frente, mas separe várias cadeias de caracteres de consulta com &. corda
redirectProtocol O protocolo do destino para onde o tráfego é redirecionado 'HttpOnly'
'HttpsOnly'
'MatchRequest'
redirectType O tipo de redirecionamento que a regra usará ao redirecionar o tráfego. 'Encontrado'
'Movido'
'PermanentRedirect'
'TemporaryRedirect'

ResourceTags

Nome Descrição Valor

RouteConfiguration

Nome Descrição Valor
@odata.type Defina como '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' para o tipo ForwardingConfiguration. Defina como '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' para o tipo RedirectConfiguration. '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
'#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obrigatório)

RoutingRule

Nome Descrição Valor
id ID do recurso. corda
nome Nome do recurso. corda
Propriedades Propriedades da regra de roteamento do Front Door RoutingRuleProperties

RoutingRuleProperties

Nome Descrição Valor
acceptedProtocols Esquemas de protocolo para corresponder a essa regra Matriz de cadeia de caracteres que contém qualquer um dos:
'Http'
'Https'
enabledState Se deseja habilitar o uso dessa regra. Os valores permitidos são 'Habilitados' ou 'Desabilitados' 'Desabilitado'
'Habilitado'
frontendEndpoints Pontos de extremidade de front-end associados a essa regra sub-recursos[]
patternsToMatch Os padrões de rota da regra. string[]
routeConfiguration Uma referência à configuração de roteamento. RouteConfiguration
rulesEngine Uma referência a uma configuração específica do mecanismo de regras a ser aplicada a essa rota. sub-recurso
webApplicationFirewallPolicyLink Define a política de Firewall do Aplicativo Web para cada regra de roteamento (se aplicável) RoutingRuleUpdateParametersWebApplicationFirewallPolicyLink
Nome Descrição Valor
id ID do recurso. corda

SubResource

Nome Descrição Valor
id ID do recurso. corda

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Adicionar domínio personalizado e certificado personalizado com o Front Door

Implantar no Azure 		Esse modelo integra e protege um domínio personalizado com o Front Door com um certificado gerenciado pelo cliente
Adicionar domínio personalizado e certificado gerenciado com o Front Door

Implantar no Azure 		Esse modelo integra e protege um domínio personalizado com o Front Door
configurar afinidade de sessão para seus nomes de host do Front Door

Implantar no Azure 		Esse modelo atualiza um Front Door para habilitar a afinidade de sessão para o host de front-end, enviando assim o tráfego subsequente da mesma sessão de usuário para o mesmo back-end.
controlar investigações de integridade para seus back-ends no Front Door

Implantar no Azure 		Este modelo atualiza o Front Door para alterar as configurações de investigação de integridade definindo o caminho da investigação e também os intervalos nos quais as investigações serão enviadas.
criar um básico do Front Door

Implantar no Azure 		Esse modelo cria uma configuração básica do Front Door com um único back-end.
criar um Front Door com de redirecionamento HTTP para HTTPS

Implantar no Azure 		Esse modelo cria uma configuração do Front Door para redirecionamento HTTP para HTTPS.
Criar um Front Door com vários back-ends e pools de back-end

Implantar no Azure 		Esse modelo cria um Front Door com balanceamento de carga configurado para vários back-ends em um pool de back-end e também em pools de back-end com base no caminho da URL.
criar o Azure Front Door em frente ao Gerenciamento de API do Azure

Implantar no Azure 		Este exemplo demonstra como usar o Azure Front Door como um balanceador de carga global na frente do Gerenciamento de API do Azure.
criar o Front Door com Active-Standby de configuração

Implantar no Azure 		Esse modelo cria um Front Door que demonstra o roteamento baseado em prioridade para Active-Standby topologia do aplicativo.
Criar o Front Door com o cache habilitado para determinadas rotas

Implantar no Azure 		Esse modelo cria um Front Door com cache habilitado para a configuração de roteamento definida, armazenando em cache quaisquer ativos estáticos para sua carga de trabalho.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso frontDoors pode ser implantado com operações de destino:

  • grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Network/frontDoors, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/frontDoors@2020-05-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      backendPools = [
        {
          id = "string"
          name = "string"
          properties = {
            backends = [
              {
                address = "string"
                backendHostHeader = "string"
                enabledState = "string"
                httpPort = int
                httpsPort = int
                priority = int
                privateLinkAlias = "string"
                privateLinkApprovalMessage = "string"
                privateLinkLocation = "string"
                privateLinkResourceId = "string"
                weight = int
              }
            ]
            healthProbeSettings = {
              id = "string"
            }
            loadBalancingSettings = {
              id = "string"
            }
          }
        }
      ]
      backendPoolsSettings = {
        enforceCertificateNameCheck = "string"
        sendRecvTimeoutSeconds = int
      }
      enabledState = "string"
      friendlyName = "string"
      frontendEndpoints = [
        {
          id = "string"
          name = "string"
          properties = {
            hostName = "string"
            sessionAffinityEnabledState = "string"
            sessionAffinityTtlSeconds = int
            webApplicationFirewallPolicyLink = {
              id = "string"
            }
          }
        }
      ]
      healthProbeSettings = [
        {
          id = "string"
          name = "string"
          properties = {
            enabledState = "string"
            healthProbeMethod = "string"
            intervalInSeconds = int
            path = "string"
            protocol = "string"
          }
        }
      ]
      loadBalancingSettings = [
        {
          id = "string"
          name = "string"
          properties = {
            additionalLatencyMilliseconds = int
            sampleSize = int
            successfulSamplesRequired = int
          }
        }
      ]
      routingRules = [
        {
          id = "string"
          name = "string"
          properties = {
            acceptedProtocols = [
              "string"
            ]
            enabledState = "string"
            frontendEndpoints = [
              {
                id = "string"
              }
            ]
            patternsToMatch = [
              "string"
            ]
            routeConfiguration = {
              @odata.type = "string"
              // For remaining properties, see RouteConfiguration objects
            }
            rulesEngine = {
              id = "string"
            }
            webApplicationFirewallPolicyLink = {
              id = "string"
            }
          }
        }
      ]
    }
  })
}

Objetos RouteConfiguration

Defina a propriedade @odata.type para especificar o tipo de objeto.

Para #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration, use:

{
  @odata.type = "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration"
  backendPool = {
    id = "string"
  }
  cacheConfiguration = {
    cacheDuration = "string"
    dynamicCompression = "string"
    queryParameters = "string"
    queryParameterStripDirective = "string"
  }
  customForwardingPath = "string"
  forwardingProtocol = "string"
}

Para #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration, use:

{
  @odata.type = "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration"
  customFragment = "string"
  customHost = "string"
  customPath = "string"
  customQueryString = "string"
  redirectProtocol = "string"
  redirectType = "string"
}

Valores de propriedade

Back-end

Nome Descrição Valor
endereço Local do back-end (endereço IP ou FQDN) corda
backendHostHeader O valor a ser usado como o cabeçalho do host enviado para o back-end. Se estiver em branco ou não for especificado, esse padrão será o host de entrada. corda
enabledState Se deseja habilitar o uso desse back-end. Os valores permitidos são 'Habilitados' ou 'Desabilitados' 'Desabilitado'
'Habilitado'
httpPort O número da porta TCP HTTP. Deve estar entre 1 e 65535. int

Restrições:
Valor mínimo = 1
Valor máximo = 65535
httpsPort O número da porta TCP HTTPS. Deve estar entre 1 e 65535. int

Restrições:
Valor mínimo = 1
Valor máximo = 65535
prioridade Prioridade a ser usada para balanceamento de carga. Prioridades mais altas não serão usadas para balanceamento de carga se qualquer back-end de prioridade mais baixa estiver íntegro. int

Restrições:
Valor mínimo = 1
Valor máximo = 5
privateLinkAlias O Alias do recurso de Link Privado. Preencher esse campo opcional indica que esse back-end é 'Privado' corda
privateLinkApprovalMessage Uma mensagem personalizada a ser incluída na solicitação de aprovação para se conectar ao Link Privado corda
privateLinkLocation O local do recurso de Link Privado. Necessário somente se 'privateLinkResourceId' for preenchido corda
privateLinkResourceId A ID do Recurso do Recurso de Link Privado. Preencher esse campo opcional indica que esse back-end é 'Privado' corda
peso Peso desse ponto de extremidade para fins de balanceamento de carga. int

Restrições:
Valor mínimo = 1
Valor máximo = 1000

BackendPool

Nome Descrição Valor
id ID do recurso. corda
nome Nome do recurso. corda
Propriedades Propriedades do pool de back-end do Front Door BackendPoolProperties

BackendPoolProperties

Nome Descrição Valor
back-ends O conjunto de back-ends para esse pool de back-end []
healthProbeSettings Configurações de investigação de integridade L7 para um pool de back-end sub-recurso
loadBalancingSettings Configurações de balanceamento de carga para um pool de back-end sub-recurso

BackendPoolsSettings

Nome Descrição Valor
enforceCertificateNameCheck Se deseja impor a verificação de nome de certificado em solicitações HTTPS a todos os pools de back-end. Nenhum efeito em solicitações não HTTPS. 'Desabilitado'
'Habilitado'
sendRecvTimeoutSeconds Enviar e receber tempo limite na solicitação de encaminhamento para o back-end. Quando o tempo limite é atingido, a solicitação falha e retorna. int

Restrições:
Valor mínimo = 16

CacheConfiguration

Nome Descrição Valor
cacheDuration A duração para a qual o conteúdo precisa ser armazenado em cache. O formato permitido está no formato ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP requer que o valor seja não mais do que um ano corda
dynamicCompression Se deve usar a compactação dinâmica para conteúdo armazenado em cache 'Desabilitado'
'Habilitado'
queryParameters parâmetros de consulta a serem incluídos ou excluídos (separados por vírgula). corda
queryParameterStripDirective Tratamento de termos de consulta de URL ao formar a chave de cache. 'StripAll'
'StripAllExcept'
'StripNone'
'StripOnly'

ForwardingConfiguration

Nome Descrição Valor
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (obrigatório)
backendPool Uma referência ao BackendPool para o qual essa regra é roteada. sub-recurso
cacheConfiguration A configuração de cache associada a essa regra. cacheConfiguration
customForwardingPath Um caminho personalizado usado para reescrever caminhos de recurso correspondentes a essa regra. Deixe vazio para usar o caminho de entrada. corda
forwardingProtocol Protocolo que essa regra usará ao encaminhar o tráfego para back-ends. 'HttpOnly'
'HttpsOnly'
'MatchRequest'

FrontDoorProperties

Nome Descrição Valor
backendPools Pools de back-end disponíveis para regras de roteamento. back-endPool[]
backendPoolsSettings Configurações para todos os back-endPools BackendPoolsSettings
enabledState Status operacional do balanceador de carga do Front Door. Os valores permitidos são 'Habilitados' ou 'Desabilitados' 'Desabilitado'
'Habilitado'
friendlyName Um nome amigável para o frontDoor corda
frontendEndpoints Pontos de extremidade de front-end disponíveis para regras de roteamento. do FrontendEndpoint []
healthProbeSettings Configurações de investigação de integridade associadas a essa instância do Front Door. HealthProbeSettingsModel[]
loadBalancingSettings Configurações de balanceamento de carga associadas a essa instância do Front Door. LoadBalancingSettingsModel[]
routingRules Regras de roteamento associadas a este Front Door. RoutingRule []

FrontendEndpoint

Nome Descrição Valor
id ID do recurso. corda
nome Nome do recurso. corda
Propriedades Propriedades do ponto de extremidade front-end frontendEndpointProperties

FrontendEndpointProperties

Nome Descrição Valor
hostName O nome do host do frontendEndpoint. Deve ser um nome de domínio. corda
sessionAffinityEnabledState Se deseja permitir afinidade de sessão neste host. As opções válidas são "Habilitado" ou "Desabilitado" 'Desabilitado'
'Habilitado'
sessionAffinityTtlSeconds UTILIZADAS. Esse campo será ignorado. O TTL a ser usado em segundos para afinidade de sessão, se aplicável. int
webApplicationFirewallPolicyLink Define a política de Firewall do Aplicativo Web para cada host (se aplicável) FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Nome Descrição Valor
id ID do recurso. corda

HealthProbeSettingsModel

Nome Descrição Valor
id ID do recurso. corda
nome Nome do recurso. corda
Propriedades Propriedades das configurações de investigação de integridade HealthProbeSettingsProperties

HealthProbeSettingsProperties

Nome Descrição Valor
enabledState Se as investigações de integridade devem ser feitas em relação aos back-ends definidos em back-endPools. Investigações de integridade só poderão ser desabilitadas se houver um único back-end habilitado no pool de back-end habilitado único. 'Desabilitado'
'Habilitado'
healthProbeMethod Configura qual método HTTP usar para investigar os back-ends definidos em back-endPools. 'GET'
'HEAD'
intervalInSeconds O número de segundos entre investigações de integridade. int
caminho O caminho a ser usado para a investigação de integridade. O padrão é / corda
protocolo Esquema de protocolo a ser usado para esta investigação 'Http'
'Https'

LoadBalancingSettingsModel

Nome Descrição Valor
id ID do recurso. corda
nome Nome do recurso. corda
Propriedades Propriedades das configurações de balanceamento de carga LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Nome Descrição Valor
additionalLatencyMilliseconds A latência adicional em milissegundos para que as investigações caiam no bucket de latência mais baixo int
sampleSize O número de exemplos a serem considerados para decisões de balanceamento de carga int
successfulSamplesRequired O número de exemplos dentro do período de exemplo que deve ter êxito int

Microsoft.Network/frontDoors

Nome Descrição Valor
localização Local do recurso. corda
nome O nome do recurso corda

Restrições:
Comprimento mínimo = 5
Comprimento máximo = 5
Padrão = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (obrigatório)
Propriedades Propriedades do Balanceador de Carga do Front Door FrontDoorProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.Network/frontDoors@2020-05-01"

RedirectConfiguration

Nome Descrição Valor
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obrigatório)
customFragment Fragmento a ser adicionado à URL de redirecionamento. Fragmento é a parte da URL que vem depois de #. Não inclua o #. corda
customHost Hospedar para redirecionar. Deixe vazio para usar o host de entrada como o host de destino. corda
customPath O caminho completo para redirecionamento. O caminho não pode estar vazio e deve começar com /. Deixe vazio para usar o caminho de entrada como caminho de destino. corda
customQueryString O conjunto de cadeias de caracteres de consulta a serem colocadas na URL de redirecionamento. Definir esse valor substituiria qualquer cadeia de caracteres de consulta existente; deixe vazio para preservar a cadeia de caracteres de consulta de entrada. A cadeia de caracteres de consulta deve estar em <chave>= formato> de valor<. O primeiro? e & serão adicionados automaticamente, portanto, não os inclua na frente, mas separe várias cadeias de caracteres de consulta com &. corda
redirectProtocol O protocolo do destino para onde o tráfego é redirecionado 'HttpOnly'
'HttpsOnly'
'MatchRequest'
redirectType O tipo de redirecionamento que a regra usará ao redirecionar o tráfego. 'Encontrado'
'Movido'
'PermanentRedirect'
'TemporaryRedirect'

ResourceTags

Nome Descrição Valor

RouteConfiguration

Nome Descrição Valor
@odata.type Defina como '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' para o tipo ForwardingConfiguration. Defina como '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' para o tipo RedirectConfiguration. '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
'#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obrigatório)

RoutingRule

Nome Descrição Valor
id ID do recurso. corda
nome Nome do recurso. corda
Propriedades Propriedades da regra de roteamento do Front Door RoutingRuleProperties

RoutingRuleProperties

Nome Descrição Valor
acceptedProtocols Esquemas de protocolo para corresponder a essa regra Matriz de cadeia de caracteres que contém qualquer um dos:
'Http'
'Https'
enabledState Se deseja habilitar o uso dessa regra. Os valores permitidos são 'Habilitados' ou 'Desabilitados' 'Desabilitado'
'Habilitado'
frontendEndpoints Pontos de extremidade de front-end associados a essa regra sub-recursos[]
patternsToMatch Os padrões de rota da regra. string[]
routeConfiguration Uma referência à configuração de roteamento. RouteConfiguration
rulesEngine Uma referência a uma configuração específica do mecanismo de regras a ser aplicada a essa rota. sub-recurso
webApplicationFirewallPolicyLink Define a política de Firewall do Aplicativo Web para cada regra de roteamento (se aplicável) RoutingRuleUpdateParametersWebApplicationFirewallPolicyLink
Nome Descrição Valor
id ID do recurso. corda

SubResource

Nome Descrição Valor
id ID do recurso. corda