Microsoft.Network/frontDoors 2019-05-01 - Bicep, ARM template & Terraform AzAPI reference

Definição de recurso do Bicep

O tipo de recurso frontDoors pode ser implementado em:

Grupos de recursos – veja comandos de implementação de grupos de recursos

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

Formato do recurso

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

resource symbolicname 'Microsoft.Network/frontDoors@2019-05-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    backendPools: [
      {
        id: 'string'
        name: 'string'
        properties: {
          backends: [
            {
              address: 'string'
              backendHostHeader: 'string'
              enabledState: 'string'
              httpPort: int
              httpsPort: int
              priority: int
              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
          }
        }
      }
    ]
  }
}

Objetos RouteConfiguration

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

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

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

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

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

Valores de propriedade

frontDoors

Nome	Descrição	Valor
name	O nome do recurso	cadeia (obrigatório) Limite de carateres: 5-64 Carateres válidos: Alfanuméricos e hífenes. Comece e termine com alfanumérico. O nome do recurso tem de ser exclusivo em todo o Azure.
localização	Localização do recurso.	string
etiquetas	Etiquetas de recursos.	Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
propriedades	Propriedades do front door Balanceador de Carga	FrontDoorProperties

FrontDoorProperties

Nome	Descrição	Valor
backendPools	Conjuntos de back-end disponíveis para regras de encaminhamento.	BackendPool[]
backendPoolsSettings	Definições para todos os back-endPools	BackendPoolsSettings
enabledState	Estado operacional do balanceador de carga do Front Door. Os valores permitidos são "Ativado" ou "Desativado"	"Desativado" "Ativado"
friendlyName	Um nome amigável para o frontDoor	string
frontendEndpoints	Pontos finais de front-end disponíveis para regras de encaminhamento.	FrontendEndpoint[]
healthProbeSettings	Definições da sonda de estado de funcionamento associadas a esta instância do Front Door.	HealthProbeSettingsModel[]
loadBalancingSettings	Definições de balanceamento de carga associadas a esta instância do Front Door.	LoadBalancingSettingsModel[]
routingRules	Regras de encaminhamento associadas a este Front Door.	RoutingRule[]

BackendPool

Nome	Descrição	Valor
ID	ID do Recurso.	string
name	Nome do recurso.	string
propriedades	Propriedades do Conjunto de Back-end do Front Door	BackendPoolProperties

BackendPoolProperties

Nome	Descrição	Valor
back-ends	O conjunto de back-ends deste conjunto	Back-end[]
healthProbeSettings	Definições da sonda de estado de funcionamento L7 para um conjunto de back-end	Sub-origem
loadBalancingSettings	Definições de balanceamento de carga para um conjunto de back-end	Sub-origem

Back-end

Nome	Descrição	Valor
address	Localização do back-end (endereço IP ou FQDN)	string
backendHostHeader	O valor a utilizar como cabeçalho do anfitrião enviado para o back-end. Se estiver em branco ou não for especificado, esta opção é predefinida para o anfitrião de entrada.	string
enabledState	Se pretende ativar a utilização deste back-end. Os valores permitidos são "Ativado" ou "Desativado"	"Desativado" "Ativado"
httpPort	O número da porta TCP HTTP. Tem de estar entre 1 e 65535.	int
httpsPort	O número da porta TCP HTTPS. Tem de estar entre 1 e 65535.	int
prioridade	Prioridade a utilizar para balanceamento de carga. As prioridades mais elevadas não serão utilizadas para o balanceamento de carga se qualquer back-end de prioridade inferior estiver em bom estado de funcionamento.	int
peso	Peso deste ponto final para fins de balanceamento de carga.	int

Sub-origem

Nome	Descrição	Valor
ID	ID do Recurso.	string

BackendPoolsSettings

Nome	Descrição	Valor
enforceCertificateNameCheck	Se pretende impor a verificação do nome do certificado em pedidos HTTPS para todos os conjuntos de back-end. Sem efeito em pedidos não HTTPS.	"Desativado" "Ativado"
sendRecvTimeoutSeconds	Enviar e receber tempo limite no pedido de reencaminhamento para o back-end. Quando o tempo limite for atingido, o pedido falha e devolve.	int

FrontendEndpoint

Nome	Descrição	Valor
ID	ID do Recurso.	string
name	Nome do recurso.	string
propriedades	Propriedades do ponto final de Front-end	FrontendEndpointProperties

FrontendEndpointProperties

Nome	Descrição	Valor
hostName	O nome do anfitrião do frontendEndpoint. Tem de ser um nome de domínio.	string
sessionAffinityEnabledState	Se pretende permitir a afinidade de sessão neste anfitrião. As opções válidas são "Ativado" ou "Desativado"	"Desativado" "Ativado"
sessionAffinityTtlSeconds	NÃO UTILIZADO. Este campo será ignorado. O TTL a utilizar em segundos para a afinidade de sessão, se aplicável.	int
webApplicationFirewallPolicyLink	Define a política de Firewall de Aplicações Web para cada anfitrião (se aplicável)	FrontendEndpointUpdateParametersWebApplicationFirewa...

FrontendEndpointUpdateParametersWebApplicationFirewa...

Nome	Descrição	Valor
ID	ID do Recurso.	string

HealthProbeSettingsModel

Nome	Descrição	Valor
ID	ID do Recurso.	string
name	Nome do recurso.	string
propriedades	Propriedades das definições da sonda de estado de funcionamento	HealthProbeSettingsProperties

HealthProbeSettingsProperties

Nome	Descrição	Valor
enabledState	Se pretende permitir que as sondas de estado de funcionamento sejam efetuadas em back-ends definidos em backendPools. As sondas de estado de funcionamento só podem ser desativadas se existir um único back-end ativado no conjunto de back-end ativado único.	"Desativado" "Ativado"
healthProbeMethod	Configura o método HTTP a utilizar para sondar os back-ends definidos em backendPools.	'GET' 'CABEÇA'
intervalInSeconds	O número de segundos entre as sondas de estado de funcionamento.	int
caminho	O caminho a utilizar para a sonda de estado de funcionamento. A predefinição é /	string
protocolo	Esquema de protocolo a utilizar para esta sonda	'Http' "Https"

LoadBalancingSettingsModel

Nome	Descrição	Valor
ID	ID do Recurso.	string
name	Nome do recurso.	string
propriedades	Propriedades das definições de balanceamento de carga	LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Nome	Descrição	Valor
additionalLatencyMilliseconds	A latência adicional em milissegundos para que as sondas caiam no registo de latência mais baixo	int
sampleSize	O número de amostras a considerar para decisões de balanceamento de carga	int
successfulSamplesRequired	O número de amostras no período de exemplo que tem de ser bem-sucedido	int

RoutingRule

Nome	Descrição	Valor
ID	ID do Recurso.	string
name	Nome do recurso.	string
propriedades	Propriedades da Regra de Encaminhamento do Front Door	RoutingRuleProperties

RoutingRuleProperties

Nome	Descrição	Valor
acceptedProtocols	Esquemas de protocolo a corresponder a esta regra	Matriz de cadeias que contém qualquer um dos seguintes: 'Http' "Https"
enabledState	Se pretende ativar a utilização desta regra. Os valores permitidos são "Ativado" ou "Desativado"	"Desativado" "Ativado"
frontendEndpoints	Pontos finais de front-end associados a esta regra	SubResource[]
patternsToMatch	Os padrões de rota da regra.	cadeia[]
routeConfiguration	Uma referência à configuração de encaminhamento.	RouteConfiguration

RouteConfiguration

Nome	Descrição	Valor
@odata.type	Definir o tipo de objeto	#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (obrigatório)

ForwardingConfiguration

Nome	Descrição	Valor
@odata.type		"#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (obrigatório)
backendPool	Uma referência ao BackendPool para o qual esta regra se encaminha.	Sub-origem
cacheConfiguration	A configuração de colocação em cache associada a esta regra.	CacheConfiguration
customForwardingPath	Um caminho personalizado utilizado para reescrever caminhos de recursos correspondentes a esta regra. Deixe vazio para utilizar o caminho de entrada.	string
forwardingProtocol	Protocolo que esta regra utilizará ao reencaminhar o tráfego para back-ends.	"HttpOnly" "HttpsOnly" 'MatchRequest'

CacheConfiguration

Nome	Descrição	Valor
dynamicCompression	Se pretende utilizar a compressão dinâmica para conteúdo em cache	"Desativado" "Ativado"
queryParameterStripDirective	Tratamento dos termos de consulta de URL ao formar a chave de cache.	'StripAll' 'StripNone'

RedirectConfiguration

Nome	Descrição	Valor
@odata.type		"#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (obrigatório)
customFragment	Fragmento para adicionar ao URL de redirecionamento. Fragmento é a parte do URL que vem depois de #. Não inclua o #.	string
customHost	Anfitrião a redirecionar. Deixe vazio para utilizar o anfitrião de entrada como anfitrião de destino.	string
customPath	O caminho completo para redirecionar. O caminho não pode estar vazio e tem de começar com /. Deixe vazio para utilizar o caminho de entrada como caminho de destino.	string
customQueryString	O conjunto de cadeias de consulta a colocar no URL de redirecionamento. Definir este valor substituiria qualquer cadeia de consulta existente; deixe em branco para preservar a cadeia de consulta de entrada. A cadeia de consulta tem de estar no formato {key}={value}. O primeiro ? e & serão adicionadas automaticamente, pelo que não as inclua na frente, mas separe várias cadeias de consulta com &.	string
redirectProtocol	O protocolo do destino para onde o tráfego é redirecionado	"HttpOnly" "HttpsOnly" 'MatchRequest'
redirectType	O tipo de redirecionamento que a regra irá utilizar ao redirecionar o tráfego.	"Encontrado" 'Movido' "PermanentRedirect" "TemporaryRedirect"

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo	Description
Criar o Azure Front Door em frente ao Azure Gestão de API	Este exemplo demonstra como utilizar o Azure Front Door como um balanceador de carga global em frente ao Azure Gestão de API.
Create a basic Front Door (Criar um Front Door básico)	Este modelo cria uma configuração básica do Front Door com um único back-end.
Create Front Door with caching enabled for certain routes (Criar o Front Door com a colocação em cache ativada para determinadas rotas)	Este modelo cria um Front Door com a colocação em cache ativada para a configuração de encaminhamento definida, colocando assim em cache quaisquer recursos estáticos para a carga de trabalho.
Criar um Front Door com vários back-ends e conjuntos de back-end	Este modelo cria um Front Door com balanceamento de carga configurado para vários back-ends num conjunto de back-end e também em conjuntos de back-end com base no caminho do URL.
Criar um Front Door com redirecionamento HTTP para HTTPS	Este modelo cria uma configuração do Front Door para redirecionamento HTTP para HTTPS.
Adicionar domínio personalizado e certificado gerido com o Front Door	Este modelo integra e protege um domínio personalizado com o Front Door
Adicionar domínio personalizado e certificado personalizado com o Front Door	Este modelo integra e protege um domínio personalizado com o Front Door com um certificado gerido pelo cliente
Control Health Probes for your backends on Front Door (Controlar as Sondas de Estado de Funcionamento dos back-ends no Front Door)	Este modelo atualiza o Front Door para alterar as definições da sonda de estado de funcionamento ao definir o caminho da sonda e também os intervalos nos quais as sondas serão enviadas.
Criar o Front Door com Active-Standby configuração	Este modelo cria um Front Door que demonstra o encaminhamento baseado em prioridades para a topologia da aplicação Active-Standby.
Configure Session Affinity for your Front Door host names (Configurar a Afinidade de Sessão para os nomes de anfitrião do Front Door)	Este modelo atualiza um Front Door para ativar a afinidade de sessão para o anfitrião de front-end, enviando assim tráfego subsequente da mesma sessão de utilizador para o mesmo back-end.

Definição de recurso de modelo do ARM

O tipo de recurso frontDoors pode ser implementado em:

Grupos de recursos – veja comandos de implementação de grupos de recursos

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

Formato do recurso

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

{
  "type": "Microsoft.Network/frontDoors",
  "apiVersion": "2019-05-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "backendPools": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "backends": [
            {
              "address": "string",
              "backendHostHeader": "string",
              "enabledState": "string",
              "httpPort": "int",
              "httpsPort": "int",
              "priority": "int",
              "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
          }
        }
      }
    ]
  }
}

Objetos RouteConfiguration

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

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

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

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

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

Valores de propriedade

frontDoors

Nome	Descrição	Valor
tipo	O tipo de recurso	"Microsoft.Network/frontDoors"
apiVersion	A versão da API de recursos	'2019-05-01'
name	O nome do recurso	cadeia (obrigatório) Limite de carateres: 5-64 Carateres válidos: Alfanuméricos e hífenes. Comece e termine com alfanumérico. O nome do recurso tem de ser exclusivo em todo o Azure.
localização	Localização do recurso.	string
etiquetas	Etiquetas de recursos.	Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
propriedades	Propriedades do front door Balanceador de Carga	FrontDoorProperties

FrontDoorProperties

Nome	Descrição	Valor
backendPools	Conjuntos de back-end disponíveis para regras de encaminhamento.	BackendPool[]
backendPoolsSettings	Definições para todos os back-endPools	BackendPoolsSettings
enabledState	Estado operacional do balanceador de carga do Front Door. Os valores permitidos são "Ativado" ou "Desativado"	"Desativado" "Ativado"
friendlyName	Um nome amigável para o frontDoor	string
frontendEndpoints	Pontos finais de front-end disponíveis para regras de encaminhamento.	FrontendEndpoint[]
healthProbeSettings	Definições da sonda de estado de funcionamento associadas a esta instância do Front Door.	HealthProbeSettingsModel[]
loadBalancingSettings	Definições de balanceamento de carga associadas a esta instância do Front Door.	LoadBalancingSettingsModel[]
routingRules	Regras de encaminhamento associadas a este Front Door.	RoutingRule[]

BackendPool

Nome	Descrição	Valor
ID	ID do Recurso.	string
name	Nome do recurso.	string
propriedades	Propriedades do Conjunto de Back-end do Front Door	BackendPoolProperties

BackendPoolProperties

Nome	Descrição	Valor
back-ends	O conjunto de back-ends deste conjunto	Back-end[]
healthProbeSettings	Definições da sonda de estado de funcionamento L7 para um conjunto de back-end	Sub-origem
loadBalancingSettings	Definições de balanceamento de carga para um conjunto de back-end	Sub-origem

Back-end

Nome	Descrição	Valor
address	Localização do back-end (endereço IP ou FQDN)	string
backendHostHeader	O valor a utilizar como cabeçalho de anfitrião enviado para o back-end. Se estiver em branco ou não for especificado, esta predefinição é o anfitrião de entrada.	string
enabledState	Se pretende ativar a utilização deste back-end. Os valores permitidos são "Ativado" ou "Desativado"	"Desativado" "Ativado"
httpPort	O número da porta TCP HTTP. Tem de estar entre 1 e 65535.	int
httpsPort	O número da porta TCP HTTPS. Tem de estar entre 1 e 65535.	int
prioridade	Prioridade a utilizar para balanceamento de carga. As prioridades mais elevadas não serão utilizadas para o balanceamento de carga se algum back-end de prioridade inferior estiver em bom estado de funcionamento.	int
peso	Peso deste ponto final para fins de balanceamento de carga.	int

Sub-origem

Nome	Descrição	Valor
ID	ID do Recurso.	string

BackendPoolsSettings

Nome	Descrição	Valor
enforceCertificateNameCheck	Se pretende impor a verificação do nome do certificado em pedidos HTTPS para todos os conjuntos de back-end. Nenhum efeito nos pedidos não HTTPS.	"Desativado" "Ativado"
sendRecvTimeoutSeconds	Enviar e receber tempo limite no pedido de reencaminhamento para o back-end. Quando o tempo limite é atingido, o pedido falha e devolve.	int

FrontendEndpoint

Nome	Descrição	Valor
ID	ID do Recurso.	string
name	Nome do recurso.	string
propriedades	Propriedades do ponto final de Front-end	FrontendEndpointProperties

FrontendEndpointProperties

Nome	Descrição	Valor
hostName	O nome do anfitrião do frontendEndpoint. Tem de ser um nome de domínio.	string
sessionAffinityEnabledState	Se pretende permitir a afinidade de sessão neste anfitrião. As opções válidas são "Ativado" ou "Desativado"	"Desativado" "Ativado"
sessionAffinityTtlSeconds	NÃO UTILIZADO. Este campo será ignorado. O TTL a utilizar em segundos para a afinidade de sessão, se aplicável.	int
webApplicationFirewallPolicyLink	Define a política de Firewall de Aplicações Web para cada anfitrião (se aplicável)	FrontendEndpointUpdateParametersWebApplicationFirewa...

FrontendEndpointUpdateParametersWebApplicationFirewa...

Nome	Descrição	Valor
ID	ID do Recurso.	string

HealthProbeSettingsModel

Nome	Descrição	Valor
ID	ID do Recurso.	string
name	Nome do recurso.	string
propriedades	Propriedades das definições da sonda de estado de funcionamento	HealthProbeSettingsProperties

HealthProbeSettingsProperties

Nome	Descrição	Valor
enabledState	Se pretende permitir que as sondas de estado de funcionamento sejam efetuadas em back-ends definidos em backendPools. As sondas de estado de funcionamento só podem ser desativadas se existir um único back-end ativado no conjunto de back-end ativado único.	"Desativado" "Ativado"
healthProbeMethod	Configura o método HTTP a utilizar para sondar os back-ends definidos em backendPools.	'GET' 'CABEÇALHO'
intervalInSeconds	O número de segundos entre as sondas de estado de funcionamento.	int
caminho	O caminho a utilizar para a sonda de estado de funcionamento. A predefinição é /	string
protocolo	Esquema de protocolo a utilizar para esta sonda	'Http' 'Https'

LoadBalancingSettingsModel

Nome	Descrição	Valor
ID	ID do Recurso.	string
name	Nome do recurso.	string
propriedades	Propriedades das definições de balanceamento de carga	LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Nome	Descrição	Valor
additionalLatencyMilliseconds	A latência adicional em milissegundos para que as sondas caiam no registo de latência mais baixa	int
sampleSize	O número de amostras a considerar para decisões de balanceamento de carga	int
successfulSamplesRequired	O número de amostras no período de exemplo que tem de ser bem-sucedido	int

RoutingRule

Nome	Descrição	Valor
ID	ID do Recurso.	string
name	Nome do recurso.	string
propriedades	Propriedades da Regra de Encaminhamento do Front Door	RoutingRuleProperties

RoutingRuleProperties

Nome	Descrição	Valor
acceptedProtocols	Esquemas de protocolo para corresponder a esta regra	Matriz de cadeia que contém qualquer um dos seguintes: 'Http' 'Https'
enabledState	Se pretende ativar a utilização desta regra. Os valores permitidos são "Ativado" ou "Desativado"	"Desativado" "Ativado"
frontendEndpoints	Pontos finais de front-end associados a esta regra	Subresource[]
patternsToMatch	Os padrões de rota da regra.	string[]
routeConfiguration	Uma referência à configuração de encaminhamento.	RouteConfiguration

RouteConfiguration

Nome	Descrição	Valor
@odata.type	Definir o tipo de objeto	#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (obrigatório)

ForwardingConfiguration

Nome	Descrição	Valor
@odata.type		"#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (obrigatório)
backendPool	Uma referência ao BackendPool para o qual esta regra encaminha.	Sub-origem
cacheConfiguration	A configuração de colocação em cache associada a esta regra.	CacheConfiguration
customForwardingPath	Um caminho personalizado utilizado para reescrever caminhos de recursos correspondentes a esta regra. Deixe vazio para utilizar o caminho de entrada.	string
forwardingProtocol	Protocolo que esta regra utilizará ao reencaminhar tráfego para back-ends.	"HttpOnly" "HttpsOnly" 'MatchRequest'

CacheConfiguration

Nome	Descrição	Valor
dynamicCompression	Se pretende utilizar a compressão dinâmica para conteúdo em cache	"Desativado" "Ativado"
queryParameterStripDirective	Tratamento dos termos de consulta de URL ao formar a chave de cache.	'StripAll' 'StripNone'

RedirectConfiguration

Nome	Descrição	Valor
@odata.type		"#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (obrigatório)
customFragment	Fragmento para adicionar ao URL de redirecionamento. Fragmento é a parte do URL que vem depois de #. Não inclua o #.	string
customHost	Anfitrião a redirecionar. Deixe vazio para utilizar o anfitrião de entrada como anfitrião de destino.	string
customPath	O caminho completo para redirecionar. O caminho não pode estar vazio e tem de começar por /. Deixe vazio para utilizar o caminho de entrada como caminho de destino.	string
customQueryString	O conjunto de cadeias de consulta a colocar no URL de redirecionamento. Definir este valor substituiria qualquer cadeia de consulta existente; deixe em branco para preservar a cadeia de consulta de entrada. A cadeia de consulta tem de estar no formato {key}={value}. O primeiro ? e & serão adicionadas automaticamente, pelo que não as inclua na parte frontal, mas separe várias cadeias de consulta com &.	string
redirectProtocol	O protocolo do destino para onde o tráfego é redirecionado	"HttpOnly" "HttpsOnly" 'MatchRequest'
redirectType	O tipo de redirecionamento que a regra utilizará ao redirecionar o tráfego.	"Encontrado" 'Movido' "PermanentRedirect" "TemporaryRedirect"

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo	Description
Criar o Azure Front Door em frente ao Azure Gestão de API	Este exemplo demonstra como utilizar o Azure Front Door como um balanceador de carga global em frente ao Azure Gestão de API.
Create a basic Front Door (Criar um Front Door básico)	Este modelo cria uma configuração básica do Front Door com um único back-end.
Create Front Door with caching enabled for certain routes (Criar o Front Door com a colocação em cache ativada para determinadas rotas)	Este modelo cria um Front Door com a colocação em cache ativada para a configuração de encaminhamento definida, colocando assim em cache quaisquer recursos estáticos para a carga de trabalho.
Criar um Front Door com vários back-ends e conjuntos de back-end	Este modelo cria um Front Door com balanceamento de carga configurado para vários back-ends num conjunto de back-end e também em conjuntos de back-end com base no caminho do URL.
Criar um Front Door com redirecionamento HTTP para HTTPS	Este modelo cria uma configuração do Front Door para redirecionamento HTTP para HTTPS.
Adicionar um domínio personalizado e um certificado gerido com o Front Door	Este modelo integra e protege um domínio personalizado com o Front Door
Adicionar um domínio personalizado e um certificado personalizado com o Front Door	Este modelo integra e protege um domínio personalizado com o Front Door com um certificado gerido pelo cliente
Control Health Probes for your backends on Front Door (Controlar as Sondas de Estado de Funcionamento dos back-ends no Front Door)	Este modelo atualiza o Front Door para alterar as definições da pesquisa de estado de funcionamento ao definir o caminho da sonda e também os intervalos em que as pesquisas serão enviadas.
Criar o Front Door com Active-Standby configuração	Este modelo cria um Front Door que demonstra o encaminhamento baseado na prioridade para Active-Standby topologia de aplicação.
Configure Session Affinity for your Front Door host names (Configurar a Afinidade de Sessão para os nomes de anfitrião do Front Door)	Este modelo atualiza um Front Door para ativar a afinidade de sessão para o anfitrião de front-end, enviando assim tráfego subsequente da mesma sessão de utilizador para o mesmo back-end.

Definição de recurso terraform (fornecedor AzAPI)

O tipo de recurso frontDoors pode ser implementado em:

Grupos de recursos

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

Formato do recurso

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/frontDoors@2019-05-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      backendPools = [
        {
          id = "string"
          name = "string"
          properties = {
            backends = [
              {
                address = "string"
                backendHostHeader = "string"
                enabledState = "string"
                httpPort = int
                httpsPort = int
                priority = int
                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
            }
          }
        }
      ]
    }
  })
}

Objetos RouteConfiguration

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

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

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

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

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

Valores de propriedade

frontDoors

Nome	Descrição	Valor
tipo	O tipo de recurso	"Microsoft.Network/frontDoors@2019-05-01"
name	O nome do recurso	cadeia (obrigatório) Limite de carateres: 5-64 Carateres válidos: Alfanuméricos e hífenes. Comece e termine com alfanumérico. O nome do recurso tem de ser exclusivo em todo o Azure.
localização	Localização do recurso.	string
parent_id	Para implementar num grupo de recursos, utilize o ID desse grupo de recursos.	cadeia (obrigatório)
etiquetas	Etiquetas de recursos.	Dicionário de nomes e valores de etiquetas.
propriedades	Propriedades do front door Balanceador de Carga	FrontDoorProperties

FrontDoorProperties

Nome	Descrição	Valor
backendPools	Conjuntos de back-end disponíveis para regras de encaminhamento.	BackendPool[]
backendPoolsSettings	Definições para todos os back-endPools	BackendPoolsSettings
enabledState	Estado operacional do balanceador de carga do Front Door. Os valores permitidos são "Ativado" ou "Desativado"	"Desativado" "Ativado"
friendlyName	Um nome amigável para o frontDoor	string
frontendEndpoints	Pontos finais de front-end disponíveis para regras de encaminhamento.	FrontendEndpoint[]
healthProbeSettings	Definições da sonda de estado de funcionamento associadas a esta instância do Front Door.	HealthProbeSettingsModel[]
loadBalancingSettings	Definições de balanceamento de carga associadas a esta instância do Front Door.	LoadBalancingSettingsModel[]
routingRules	Regras de encaminhamento associadas a este Front Door.	RoutingRule[]

BackendPool

Nome	Descrição	Valor
ID	ID do Recurso.	string
name	Nome do recurso.	string
propriedades	Propriedades do Conjunto de Back-end do Front Door	BackendPoolProperties

BackendPoolProperties

Nome	Descrição	Valor
back-ends	O conjunto de back-ends deste conjunto	Back-end[]
healthProbeSettings	Definições da sonda de estado de funcionamento L7 para um conjunto de back-end	Sub-origem
loadBalancingSettings	Definições de balanceamento de carga para um conjunto de back-end	Sub-origem

Back-end

Nome	Descrição	Valor
address	Localização do back-end (endereço IP ou FQDN)	string
backendHostHeader	O valor a utilizar como cabeçalho do anfitrião enviado para o back-end. Se estiver em branco ou não for especificado, esta opção é predefinida para o anfitrião de entrada.	string
enabledState	Se pretende ativar a utilização deste back-end. Os valores permitidos são "Ativado" ou "Desativado"	"Desativado" "Ativado"
httpPort	O número da porta TCP HTTP. Tem de estar entre 1 e 65535.	int
httpsPort	O número da porta TCP HTTPS. Tem de estar entre 1 e 65535.	int
prioridade	Prioridade a utilizar para balanceamento de carga. As prioridades mais elevadas não serão utilizadas para o balanceamento de carga se qualquer back-end de prioridade inferior estiver em bom estado de funcionamento.	int
peso	Peso deste ponto final para fins de balanceamento de carga.	int

Sub-origem

Nome	Descrição	Valor
ID	ID do Recurso.	string

BackendPoolsSettings

Nome	Descrição	Valor
enforceCertificateNameCheck	Se pretende impor a verificação do nome do certificado em pedidos HTTPS para todos os conjuntos de back-end. Sem efeito em pedidos não HTTPS.	"Desativado" "Ativado"
sendRecvTimeoutSeconds	Enviar e receber tempo limite no pedido de reencaminhamento para o back-end. Quando o tempo limite for atingido, o pedido falha e devolve.	int

FrontendEndpoint

Nome	Descrição	Valor
ID	ID do Recurso.	string
name	Nome do recurso.	string
propriedades	Propriedades do ponto final de Front-end	FrontendEndpointProperties

FrontendEndpointProperties

Nome	Descrição	Valor
hostName	O nome do anfitrião do frontendEndpoint. Tem de ser um nome de domínio.	string
sessionAffinityEnabledState	Se pretende permitir a afinidade de sessão neste anfitrião. As opções válidas são "Ativado" ou "Desativado"	"Desativado" "Ativado"
sessionAffinityTtlSeconds	NÃO UTILIZADO. Este campo será ignorado. O TTL a utilizar em segundos para a afinidade de sessão, se aplicável.	int
webApplicationFirewallPolicyLink	Define a política de Firewall de Aplicações Web para cada anfitrião (se aplicável)	FrontendEndpointUpdateParametersWebApplicationFirewa...

FrontendEndpointUpdateParametersWebApplicationFirewa...

Nome	Descrição	Valor
ID	ID do Recurso.	string

HealthProbeSettingsModel

Nome	Descrição	Valor
ID	ID do Recurso.	string
name	Nome do recurso.	string
propriedades	Propriedades das definições da sonda de estado de funcionamento	HealthProbeSettingsProperties

HealthProbeSettingsProperties

Nome	Descrição	Valor
enabledState	Se pretende permitir que as sondas de estado de funcionamento sejam efetuadas em back-ends definidos em backendPools. As sondas de estado de funcionamento só podem ser desativadas se existir um único back-end ativado no conjunto de back-end ativado único.	"Desativado" "Ativado"
healthProbeMethod	Configura o método HTTP a utilizar para sondar os back-ends definidos em backendPools.	"GET" "CABEÇALHO"
intervalInSeconds	O número de segundos entre as sondas de estado de funcionamento.	int
caminho	O caminho a utilizar para a sonda de estado de funcionamento. A predefinição é /	string
protocolo	Esquema de protocolo a utilizar para esta sonda	"Http" "Https"

LoadBalancingSettingsModel

Nome	Descrição	Valor
ID	ID do Recurso.	string
name	Nome do recurso.	string
propriedades	Propriedades das definições de balanceamento de carga	LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Nome	Descrição	Valor
additionalLatencyMilliseconds	A latência adicional em milissegundos para que as sondas caiam no registo de latência mais baixa	int
sampleSize	O número de amostras a considerar para decisões de balanceamento de carga	int
successfulSamplesRequired	O número de amostras no período de exemplo que tem de ser bem-sucedido	int

RoutingRule

Nome	Descrição	Valor
ID	ID do Recurso.	string
name	Nome do recurso.	string
propriedades	Propriedades da Regra de Encaminhamento do Front Door	RoutingRuleProperties

RoutingRuleProperties

Nome	Descrição	Valor
acceptedProtocols	Esquemas de protocolo para corresponder a esta regra	Matriz de cadeia que contém qualquer um dos seguintes: "Http" "Https"
enabledState	Se pretende ativar a utilização desta regra. Os valores permitidos são "Ativado" ou "Desativado"	"Desativado" "Ativado"
frontendEndpoints	Pontos finais de front-end associados a esta regra	Subresource[]
patternsToMatch	Os padrões de rota da regra.	string[]
routeConfiguration	Uma referência à configuração de encaminhamento.	RouteConfiguration

RouteConfiguration

Nome	Descrição	Valor
@odata.type	Definir o tipo de objeto	#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (obrigatório)

ForwardingConfiguration

Nome	Descrição	Valor
@odata.type		"#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (obrigatório)
backendPool	Uma referência ao BackendPool para o qual esta regra encaminha.	Sub-origem
cacheConfiguration	A configuração de colocação em cache associada a esta regra.	CacheConfiguration
customForwardingPath	Um caminho personalizado utilizado para reescrever caminhos de recursos correspondentes a esta regra. Deixe vazio para utilizar o caminho de entrada.	string
forwardingProtocol	Protocolo que esta regra utilizará ao reencaminhar o tráfego para back-ends.	"HttpOnly" "HttpsOnly" "MatchRequest"

CacheConfiguration

Nome	Descrição	Valor
dynamicCompression	Se pretende utilizar a compressão dinâmica para conteúdo em cache	"Desativado" "Ativado"
queryParameterStripDirective	Tratamento dos termos de consulta de URL ao formar a chave de cache.	"StripAll" "StripNone"

RedirectConfiguration

Nome	Descrição	Valor
@odata.type		"#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (obrigatório)
customFragment	Fragmento para adicionar ao URL de redirecionamento. Fragmento é a parte do URL que vem depois de #. Não inclua o #.	string
customHost	Anfitrião a redirecionar. Deixe vazio para utilizar o anfitrião de entrada como anfitrião de destino.	string
customPath	O caminho completo para redirecionar. O caminho não pode estar vazio e tem de começar com /. Deixe vazio para utilizar o caminho de entrada como caminho de destino.	string
customQueryString	O conjunto de cadeias de consulta a colocar no URL de redirecionamento. Definir este valor substituiria qualquer cadeia de consulta existente; deixe em branco para preservar a cadeia de consulta de entrada. A cadeia de consulta tem de estar no formato {key}={value}. O primeiro ? e & serão adicionadas automaticamente, pelo que não as inclua na frente, mas separe várias cadeias de consulta com &.	string
redirectProtocol	O protocolo do destino para onde o tráfego é redirecionado	"HttpOnly" "HttpsOnly" "MatchRequest"
redirectType	O tipo de redirecionamento que a regra irá utilizar ao redirecionar o tráfego.	"Encontrado" "Movido" "PermanentRedirect" "TemporaryRedirect"

Partilhar via

Microsoft.Network frontDoors 2019-05-01

Definição de recurso do Bicep

Formato do recurso

Objetos RouteConfiguration

Valores de propriedade

frontDoors

FrontDoorProperties

BackendPool

BackendPoolProperties

Back-end

Sub-origem

BackendPoolsSettings

FrontendEndpoint

FrontendEndpointProperties

FrontendEndpointUpdateParametersWebApplicationFirewa...

HealthProbeSettingsModel

HealthProbeSettingsProperties

LoadBalancingSettingsModel

LoadBalancingSettingsProperties

RoutingRule

RoutingRuleProperties

RouteConfiguration

ForwardingConfiguration

CacheConfiguration

RedirectConfiguration

Modelos de início rápido

Definição de recurso de modelo do ARM

Formato do recurso

Objetos RouteConfiguration

Valores de propriedade

frontDoors

FrontDoorProperties

BackendPool

BackendPoolProperties

Back-end

Sub-origem

BackendPoolsSettings

FrontendEndpoint

FrontendEndpointProperties

FrontendEndpointUpdateParametersWebApplicationFirewa...

HealthProbeSettingsModel

HealthProbeSettingsProperties

LoadBalancingSettingsModel

LoadBalancingSettingsProperties

RoutingRule

RoutingRuleProperties

RouteConfiguration

ForwardingConfiguration

CacheConfiguration

RedirectConfiguration

Modelos de início rápido

Definição de recurso terraform (fornecedor AzAPI)

Formato do recurso

Objetos RouteConfiguration

Valores de propriedade

frontDoors

FrontDoorProperties

BackendPool

BackendPoolProperties

Back-end

Sub-origem

BackendPoolsSettings

FrontendEndpoint

FrontendEndpointProperties

FrontendEndpointUpdateParametersWebApplicationFirewa...

HealthProbeSettingsModel

HealthProbeSettingsProperties

LoadBalancingSettingsModel

LoadBalancingSettingsProperties

RoutingRule

RoutingRuleProperties

RouteConfiguration

ForwardingConfiguration

CacheConfiguration

RedirectConfiguration

Comentários

Recursos adicionais