Front Doors - Create Or Update

Referência

Serviço:: Front Door Service

Versão da API:: 2019-05-01

Cria um novo Front Door com um nome do Front Door na subscrição especificada e no grupo de recursos.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/frontDoors/{frontDoorName}?api-version=2019-05-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
frontDoorName	path	True	string	Nome do Front Door que é globalmente exclusivo. Padrão Regex: `^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$`
resourceGroupName	path	True	string	Nome do Grupo de recursos na subscrição do Azure. Padrão Regex: `^[a-zA-Z0-9_\-\.]*[^\.]$`
subscriptionId	path	True	string	As credenciais de subscrição que identificam exclusivamente a subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço.
api-version	query	True	string	Versão da API de Cliente.

Corpo do Pedido

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

Respostas

Name	Tipo	Description
200 OK	FrontDoor	OK. O pedido foi bem-sucedido.
201 Created	FrontDoor	Criado. O pedido foi cumprido e foi criado um novo Front Door.
202 Accepted	FrontDoor	Aceite. O pedido foi aceite para processamento e a operação será concluída de forma assíncrona.
Other Status Codes	ErrorResponse	Resposta de erro do Front Door que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

Create or update specific Front Door

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1?api-version=2019-05-01

{
  "location": "westus",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "routingRules": [
      {
        "name": "routingRule1",
        "properties": {
          "frontendEndpoints": [
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default"
            }
          ],
          "acceptedProtocols": [
            "Http"
          ],
          "patternsToMatch": [
            "/*"
          ],
          "routeConfiguration": {
            "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
            "backendPool": {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1"
            }
          },
          "enabledState": "Enabled"
        }
      }
    ],
    "healthProbeSettings": [
      {
        "name": "healthProbeSettings1",
        "properties": {
          "path": "/",
          "protocol": "Http",
          "intervalInSeconds": 120,
          "enabledState": "Enabled",
          "healthProbeMethod": "HEAD"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "name": "loadBalancingSettings1",
        "properties": {
          "sampleSize": 4,
          "successfulSamplesRequired": 2
        }
      }
    ],
    "backendPools": [
      {
        "name": "backendPool1",
        "properties": {
          "backends": [
            {
              "address": "w3.contoso.com",
              "httpPort": 80,
              "httpsPort": 443,
              "weight": 1,
              "priority": 2
            },
            {
              "address": "contoso.com.website-us-west-2.othercloud.net",
              "httpPort": 80,
              "httpsPort": 443,
              "weight": 2,
              "priority": 1
            },
            {
              "address": "contoso1.azurewebsites.net",
              "httpPort": 80,
              "httpsPort": 443,
              "weight": 1,
              "priority": 1
            }
          ],
          "loadBalancingSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/loadBalancingSettings/loadBalancingSettings1"
          },
          "healthProbeSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/healthProbeSettings/healthProbeSettings1"
          }
        }
      }
    ],
    "frontendEndpoints": [
      {
        "name": "frontendEndpoint1",
        "properties": {
          "hostName": "www.contoso.com",
          "sessionAffinityEnabledState": "Enabled",
          "sessionAffinityTtlSeconds": 60,
          "webApplicationFirewallPolicyLink": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoorWebApplicationFirewallPolicies/policy1"
          }
        }
      },
      {
        "name": "default",
        "properties": {
          "hostName": "frontDoor1.azurefd.net"
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "Enabled",
      "sendRecvTimeoutSeconds": 60
    },
    "enabledState": "Enabled"
  }
}

Resposta da amostra

Código de estado:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1",
  "name": "frontDoor1",
  "type": "Microsoft.Network/frontDoor",
  "location": "westus",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "routingRules": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/routingRules/routingRule1",
        "name": "routingRule1",
        "properties": {
          "frontendEndpoints": [
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default"
            }
          ],
          "acceptedProtocols": [
            "Http"
          ],
          "patternsToMatch": [
            "/*"
          ],
          "routeConfiguration": {
            "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
            "customForwardingPath": "",
            "forwardingProtocol": "MatchRequest",
            "backendPool": {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1"
            }
          },
          "enabledState": "Enabled"
        }
      }
    ],
    "healthProbeSettings": [
      {
        "name": "healthProbeSettings1",
        "properties": {
          "path": "/",
          "protocol": "Http",
          "intervalInSeconds": 120,
          "enabledState": "Enabled",
          "healthProbeMethod": "HEAD"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "name": "loadBalancingSettings1",
        "properties": {
          "sampleSize": 4,
          "successfulSamplesRequired": 2
        }
      }
    ],
    "backendPools": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1",
        "name": "backendPool1",
        "properties": {
          "backends": [
            {
              "address": "w3.contoso.com",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 2
            },
            {
              "address": "contoso.com.website-us-west-2.othercloud.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 2,
              "priority": 1
            },
            {
              "address": "contoso1.azurewebsites.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 1
            }
          ],
          "loadBalancingSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/loadBalancingSettings/loadBalancingSettings1"
          },
          "healthProbeSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/healthProbeSettings/healthProbeSettings1"
          }
        }
      }
    ],
    "frontendEndpoints": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1",
        "name": "frontendEndpoint1",
        "properties": {
          "hostName": "www.contoso.com",
          "sessionAffinityEnabledState": "Enabled",
          "sessionAffinityTtlSeconds": 60,
          "webApplicationFirewallPolicyLink": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoorWebApplicationFirewallPolicies/policy1"
          }
        }
      },
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default",
        "name": "default",
        "properties": {
          "hostName": "frontDoor1.azurefd.net"
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "Enabled",
      "sendRecvTimeoutSeconds": 60
    },
    "enabledState": "Enabled",
    "resourceState": "Creating",
    "provisioningState": "Succeeded",
    "cname": "frontDoor1.azurefd.net"
  }
}

Código de estado:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1",
  "name": "frontDoor1",
  "type": "Microsoft.Network/frontDoor",
  "location": "westus",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "routingRules": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/routingRules/routingRule1",
        "name": "routingRule1",
        "properties": {
          "frontendEndpoints": [
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default"
            }
          ],
          "acceptedProtocols": [
            "Http"
          ],
          "patternsToMatch": [
            "/*"
          ],
          "routeConfiguration": {
            "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
            "customForwardingPath": "",
            "forwardingProtocol": "MatchRequest",
            "backendPool": {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1"
            }
          },
          "enabledState": "Enabled"
        }
      }
    ],
    "healthProbeSettings": [
      {
        "name": "healthProbeSettings1",
        "properties": {
          "path": "/",
          "protocol": "Http",
          "intervalInSeconds": 120,
          "enabledState": "Enabled",
          "healthProbeMethod": "HEAD"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "name": "loadBalancingSettings1",
        "properties": {
          "sampleSize": 4,
          "successfulSamplesRequired": 2
        }
      }
    ],
    "backendPools": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1",
        "name": "backendPool1",
        "properties": {
          "backends": [
            {
              "address": "w3.contoso.com",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 2
            },
            {
              "address": "contoso.com.website-us-west-2.othercloud.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 2,
              "priority": 1
            },
            {
              "address": "contoso1.azurewebsites.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 1
            }
          ],
          "loadBalancingSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/loadBalancingSettings/loadBalancingSettings1"
          },
          "healthProbeSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/healthProbeSettings/healthProbeSettings1"
          }
        }
      }
    ],
    "frontendEndpoints": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1",
        "name": "frontendEndpoint1",
        "properties": {
          "hostName": "www.contoso.com",
          "sessionAffinityEnabledState": "Enabled",
          "sessionAffinityTtlSeconds": 60,
          "webApplicationFirewallPolicyLink": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoorWebApplicationFirewallPolicies/policy1"
          }
        }
      },
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default",
        "name": "default",
        "properties": {
          "hostName": "frontDoor1.azurefd.net"
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "Enabled",
      "sendRecvTimeoutSeconds": 60
    },
    "enabledState": "Enabled",
    "resourceState": "Creating",
    "provisioningState": "Provisioning",
    "cname": "frontDoor1.azurefd.net"
  }
}

Código de estado:: 202

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1",
  "name": "frontDoor1",
  "type": "Microsoft.Network/frontDoor",
  "location": "westus",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "routingRules": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/routingRules/routingRule1",
        "name": "routingRule1",
        "properties": {
          "frontendEndpoints": [
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default"
            }
          ],
          "acceptedProtocols": [
            "Http"
          ],
          "patternsToMatch": [
            "/*"
          ],
          "routeConfiguration": {
            "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
            "customForwardingPath": "",
            "forwardingProtocol": "MatchRequest",
            "backendPool": {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1"
            }
          },
          "enabledState": "Enabled"
        }
      }
    ],
    "healthProbeSettings": [
      {
        "name": "healthProbeSettings1",
        "properties": {
          "path": "/",
          "protocol": "Http",
          "intervalInSeconds": 120,
          "enabledState": "Enabled",
          "healthProbeMethod": "HEAD"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "name": "loadBalancingSettings1",
        "properties": {
          "sampleSize": 4,
          "successfulSamplesRequired": 2
        }
      }
    ],
    "backendPools": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1",
        "name": "backendPool1",
        "properties": {
          "backends": [
            {
              "address": "w3.contoso.com",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 2
            },
            {
              "address": "contoso.com.website-us-west-2.othercloud.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 2,
              "priority": 1
            },
            {
              "address": "contoso1.azurewebsites.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 1
            }
          ],
          "loadBalancingSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/loadBalancingSettings/loadBalancingSettings1"
          },
          "healthProbeSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/healthProbeSettings/healthProbeSettings1"
          }
        }
      }
    ],
    "frontendEndpoints": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1",
        "name": "frontendEndpoint1",
        "properties": {
          "hostName": "www.contoso.com",
          "sessionAffinityEnabledState": "Enabled",
          "sessionAffinityTtlSeconds": 60,
          "webApplicationFirewallPolicyLink": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoorWebApplicationFirewallPolicies/policy1"
          }
        }
      },
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default",
        "name": "default",
        "properties": {
          "hostName": "frontDoor1.azurefd.net"
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "Enabled",
      "sendRecvTimeoutSeconds": 60
    },
    "enabledState": "Enabled",
    "resourceState": "Creating",
    "provisioningState": "Provisioning",
    "cname": "frontDoor1.azurefd.net"
  }
}

Definições

Name	Description
Backend	Endereço de back-end de um balanceador de carga frontDoor.
backendEnabledState	Se pretende ativar a utilização deste back-end. Os valores permitidos são "Ativado" ou "Desativado"
BackendPool	Um conjunto de back-end é uma coleção de back-ends para os quais pode ser encaminhado.
BackendPoolsSettings	Definições que se aplicam a todos os conjuntos de back-end.
CacheConfiguration	Definições de colocação em cache de uma rota do tipo de colocação em cache. Para desativar a colocação em cache, não forneça um objeto cacheConfiguration.
CustomHttpsConfiguration	Definições de Https para um domínio
CustomHttpsProvisioningState	Estado de aprovisionamento de Https Personalizados do frontendEndpoint.
CustomHttpsProvisioningSubstate	O subestado de aprovisionamento mostra o progresso da ativação/desativação de HTTPS personalizada passo a passo.
DynamicCompressionEnabled	Se pretende utilizar a compressão dinâmica para conteúdo em cache
enforceCertificateNameCheckEnabledState	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.
ErrorResponse	A resposta de erro indica que o serviço Front Door não consegue processar o pedido recebido. O motivo é fornecido na mensagem de erro.
ForwardingConfiguration	Descreve a Rota de Reencaminhamento.
FrontDoor	O Front Door representa uma coleção de pontos finais de back-end para encaminhar o tráfego para juntamente com regras que especificam como o tráfego é enviado para lá.
FrontDoorCertificateSource	Define a origem do certificado SSL
FrontDoorCertificateType	Define o tipo de certificado utilizado para ligações seguras a um frontendEndpoint
FrontDoorEnabledState	Estado operacional do balanceador de carga do Front Door. Os valores permitidos são "Ativado" ou "Desativado"
FrontDoorForwardingProtocol	Protocolo que esta regra utilizará ao reencaminhar o tráfego para back-ends.
FrontDoorHealthProbeMethod	Configura o método HTTP a utilizar para sondar os back-ends definidos em backendPools.
FrontDoorProtocol	Esquemas de protocolo a corresponder a esta regra
FrontDoorQuery	Tratamento dos termos de consulta de URL ao formar a chave de cache.
FrontDoorRedirectProtocol	O protocolo do destino para onde o tráfego é redirecionado
FrontDoorRedirectType	O tipo de redirecionamento que a regra irá utilizar ao redirecionar o tráfego.
FrontDoorResourceState	Estado do recurso da Sub-origem do Front Door ou do Front Door.
FrontDoorTlsProtocolType	Define o protocolo de extensão TLS que é utilizado para a entrega segura
FrontendEndpoint	Um ponto final de front-end utilizado para encaminhamento.
HealthProbeEnabled	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.
HealthProbeSettingsModel	Definições de balanceamento de carga para um conjunto de back-end
LoadBalancingSettingsModel	Definições de balanceamento de carga para um conjunto de back-end
MinimumTLSVersion	A versão mínima do TLS necessária dos clientes para estabelecer um handshake SSL com o Front Door.
RedirectConfiguration	Descreve a Rota de Redirecionamento.
RoutingRule	Uma regra de encaminhamento representa uma especificação para o tráfego tratar e para onde enviá-la, juntamente com as informações da sonda de estado de funcionamento.
routingRuleEnabledState	Se pretende ativar a utilização desta regra. Os valores permitidos são "Ativado" ou "Desativado"
SessionAffinityEnabledState	Se pretende permitir a afinidade de sessão neste anfitrião. As opções válidas são "Ativado" ou "Desativado"
SubResource	Referência a outra sub-origem.
Vault	O Key Vault que contém o certificado SSL
WebApplicationFirewallPolicyLink	Define a política de Firewall de Aplicações Web para cada anfitrião (se aplicável)

Backend

Endereço de back-end de um balanceador de carga frontDoor.

Name	Tipo	Description
address	string	Localização do back-end (endereço IP ou FQDN)
backendHostHeader	string	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.
enabledState	backendEnabledState	Se pretende ativar a utilização deste back-end. Os valores permitidos são "Ativado" ou "Desativado"
httpPort	integer	O número da porta TCP HTTP. Tem de estar entre 1 e 65535.
httpsPort	integer	O número da porta TCP HTTPS. Tem de estar entre 1 e 65535.
priority	integer	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.
weight	integer	Peso deste ponto final para fins de balanceamento de carga.

backendEnabledState

Se pretende ativar a utilização deste back-end. Os valores permitidos são "Ativado" ou "Desativado"

Name	Tipo	Description
Disabled	string
Enabled	string

BackendPool

Um conjunto de back-end é uma coleção de back-ends para os quais pode ser encaminhado.

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.backends	Backend[]	O conjunto de back-ends deste conjunto
properties.healthProbeSettings	SubResource	Definições da sonda de estado de funcionamento L7 para um conjunto de back-end
properties.loadBalancingSettings	SubResource	Definições de balanceamento de carga para um conjunto de back-end
properties.resourceState	FrontDoorResourceState	Estado do recurso da Sub-origem do Front Door ou do Front Door. Estado do recurso.
type	string	Tipo de recurso.

BackendPoolsSettings

Definições que se aplicam a todos os conjuntos de back-end.

Name	Tipo	Default value	Description
enforceCertificateNameCheck	enforceCertificateNameCheckEnabledState	Enabled	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.
sendRecvTimeoutSeconds	integer		Enviar e receber tempo limite no pedido de reencaminhamento para o back-end. Quando o tempo limite for atingido, o pedido falha e devolve.

CacheConfiguration

Definições de colocação em cache de uma rota do tipo de colocação em cache. Para desativar a colocação em cache, não forneça um objeto cacheConfiguration.

Name	Tipo	Description
dynamicCompression	DynamicCompressionEnabled	Se pretende utilizar a compressão dinâmica para conteúdo em cache
queryParameterStripDirective	FrontDoorQuery	Tratamento dos termos de consulta de URL ao formar a chave de cache.

CustomHttpsConfiguration

Definições de Https para um domínio

Name	Tipo	Description
certificateSource	FrontDoorCertificateSource	Define a origem do certificado SSL
frontDoorCertificateSourceParameters.certificateType	FrontDoorCertificateType	Define o tipo de certificado utilizado para ligações seguras a um frontendEndpoint
keyVaultCertificateSourceParameters.secretName	string	O nome do segredo Key Vault que representa o certificado completo PFX
keyVaultCertificateSourceParameters.secretVersion	string	A versão do segredo Key Vault que representa o certificado completo PFX
keyVaultCertificateSourceParameters.vault	Vault	O Key Vault que contém o certificado SSL
minimumTlsVersion	MinimumTLSVersion	A versão mínima do TLS necessária dos clientes para estabelecer um handshake SSL com o Front Door.
protocolType	FrontDoorTlsProtocolType	Define o protocolo de extensão TLS que é utilizado para a entrega segura

CustomHttpsProvisioningState

Estado de aprovisionamento de Https Personalizados do frontendEndpoint.

Name	Tipo	Description
Disabled	string
Disabling	string
Enabled	string
Enabling	string
Failed	string

CustomHttpsProvisioningSubstate

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

Name	Tipo	Description
CertificateDeleted	string
CertificateDeployed	string
DeletingCertificate	string
DeployingCertificate	string
DomainControlValidationRequestApproved	string
DomainControlValidationRequestRejected	string
DomainControlValidationRequestTimedOut	string
IssuingCertificate	string
PendingDomainControlValidationREquestApproval	string
SubmittingDomainControlValidationRequest	string

DynamicCompressionEnabled

Se pretende utilizar a compressão dinâmica para conteúdo em cache

Name	Tipo	Description
Disabled	string
Enabled	string

enforceCertificateNameCheckEnabledState

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.

Name	Tipo	Description
Disabled	string
Enabled	string

ErrorResponse

A resposta de erro indica que o serviço Front Door não consegue processar o pedido recebido. O motivo é fornecido na mensagem de erro.

Name	Tipo	Description
code	string	Código de erro.
message	string	Mensagem de erro a indicar por que motivo a operação falhou.

ForwardingConfiguration

Descreve a Rota de Reencaminhamento.

Name	Tipo	Description
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
backendPool	SubResource	Uma referência ao BackendPool para o qual esta regra se encaminha.
cacheConfiguration	CacheConfiguration	A configuração de colocação em cache associada a esta regra.
customForwardingPath	string	Um caminho personalizado utilizado para reescrever caminhos de recursos correspondentes a esta regra. Deixe vazio para utilizar o caminho de entrada.
forwardingProtocol	FrontDoorForwardingProtocol	Protocolo que esta regra utilizará ao reencaminhar o tráfego para back-ends.

FrontDoor

O Front Door representa uma coleção de pontos finais de back-end para encaminhar o tráfego para juntamente com regras que especificam como o tráfego é enviado para lá.

Name	Tipo	Description
id	string	ID do Recurso.
location	string	Localização do recurso.
name	string	Nome do recurso.
properties.backendPools	BackendPool[]	Conjuntos de back-end disponíveis para regras de encaminhamento.
properties.backendPoolsSettings	BackendPoolsSettings	Definições para todos os back-endPools
properties.cname	string	O anfitrião para o qual cada frontendEndpoint tem de CNAME.
properties.enabledState	FrontDoorEnabledState	Estado operacional do balanceador de carga do Front Door. Os valores permitidos são "Ativado" ou "Desativado"
properties.friendlyName	string	Um nome amigável para o frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Pontos finais de front-end disponíveis para regras de encaminhamento.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Definições da sonda de estado de funcionamento associadas a esta instância do Front Door.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Definições de balanceamento de carga associadas a esta instância do Front Door.
properties.provisioningState	string	Estado de aprovisionamento do Front Door.
properties.resourceState	FrontDoorResourceState	Estado do recurso da Sub-origem do Front Door ou do Front Door. Estado do recurso do Front Door.
properties.routingRules	RoutingRule[]	Regras de encaminhamento associadas a este Front Door.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso.

FrontDoorCertificateSource

Define a origem do certificado SSL

Name	Tipo	Description
AzureKeyVault	string
FrontDoor	string

FrontDoorCertificateType

Define o tipo de certificado utilizado para ligações seguras a um frontendEndpoint

Name	Tipo	Description
Dedicated	string

FrontDoorEnabledState

Estado operacional do balanceador de carga do Front Door. Os valores permitidos são "Ativado" ou "Desativado"

Name	Tipo	Description
Disabled	string
Enabled	string

FrontDoorForwardingProtocol

Protocolo que esta regra utilizará ao reencaminhar o tráfego para back-ends.

Name	Tipo	Description
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorHealthProbeMethod

Configura o método HTTP a utilizar para sondar os back-ends definidos em backendPools.

Name	Tipo	Description
GET	string
HEAD	string

FrontDoorProtocol

Esquemas de protocolo a corresponder a esta regra

Name	Tipo	Description
Http	string
Https	string

FrontDoorQuery

Tratamento dos termos de consulta de URL ao formar a chave de cache.

Name	Tipo	Description
StripAll	string
StripNone	string

FrontDoorRedirectProtocol

O protocolo do destino para onde o tráfego é redirecionado

Name	Tipo	Description
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorRedirectType

O tipo de redirecionamento que a regra irá utilizar ao redirecionar o tráfego.

Name	Tipo	Description
Found	string
Moved	string
PermanentRedirect	string
TemporaryRedirect	string

FrontDoorResourceState

Estado do recurso da Sub-origem do Front Door ou do Front Door.

Name	Tipo	Description
Creating	string
Deleting	string
Disabled	string
Disabling	string
Enabled	string
Enabling	string

FrontDoorTlsProtocolType

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

Name	Tipo	Description
ServerNameIndication	string

FrontendEndpoint

Um ponto final de front-end utilizado para encaminhamento.

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.customHttpsConfiguration	CustomHttpsConfiguration	A configuração que especifica como ativar HTTPS
properties.customHttpsProvisioningState	CustomHttpsProvisioningState	Estado de aprovisionamento de Https Personalizados do frontendEndpoint.
properties.customHttpsProvisioningSubstate	CustomHttpsProvisioningSubstate	O subestado de aprovisionamento mostra o progresso da ativação/desativação de HTTPS personalizada passo a passo.
properties.hostName	string	O nome do anfitrião do frontendEndpoint. Tem de ser um nome de domínio.
properties.resourceState	FrontDoorResourceState	Estado do recurso da Sub-origem do Front Door ou do Front Door. Estado do recurso.
properties.sessionAffinityEnabledState	SessionAffinityEnabledState	Se pretende permitir a afinidade de sessão neste anfitrião. As opções válidas são "Ativado" ou "Desativado"
properties.sessionAffinityTtlSeconds	integer	NÃO UTILIZADO. Este campo será ignorado. O TTL a utilizar em segundos para a afinidade de sessão, se aplicável.
properties.webApplicationFirewallPolicyLink	WebApplicationFirewallPolicyLink	Define a política de Firewall de Aplicações Web para cada anfitrião (se aplicável)
type	string	Tipo de recurso.

HealthProbeEnabled

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.

Name	Tipo	Description
Disabled	string
Enabled	string

HealthProbeSettingsModel

Definições de balanceamento de carga para um conjunto de back-end

Name	Tipo	Default value	Description
id	string		ID do Recurso.
name	string		Nome do recurso.
properties.enabledState	HealthProbeEnabled		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.
properties.healthProbeMethod	FrontDoorHealthProbeMethod	HEAD	Configura o método HTTP a utilizar para sondar os back-ends definidos em backendPools.
properties.intervalInSeconds	integer		O número de segundos entre as sondas de estado de funcionamento.
properties.path	string		O caminho a utilizar para a sonda de estado de funcionamento. A predefinição é /
properties.protocol	FrontDoorProtocol		Esquema de protocolo a utilizar para esta sonda
properties.resourceState	FrontDoorResourceState		Estado do recurso da Sub-origem do Front Door ou do Front Door. Estado do recurso.
type	string		Tipo de recurso.

LoadBalancingSettingsModel

Definições de balanceamento de carga para um conjunto de back-end

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.additionalLatencyMilliseconds	integer	A latência adicional em milissegundos para que as sondas caiam no registo de latência mais baixo
properties.resourceState	FrontDoorResourceState	Estado do recurso da Sub-origem do Front Door ou do Front Door. Estado do recurso.
properties.sampleSize	integer	O número de amostras a considerar para decisões de balanceamento de carga
properties.successfulSamplesRequired	integer	O número de amostras no período de exemplo que tem de ser bem-sucedido
type	string	Tipo de recurso.

MinimumTLSVersion

A versão mínima do TLS necessária dos clientes para estabelecer um handshake SSL com o Front Door.

Name	Tipo	Description
1.0	string
1.2	string

RedirectConfiguration

Descreve a Rota de Redirecionamento.

Name	Tipo	Description
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration
customFragment	string	Fragmento para adicionar ao URL de redirecionamento. Fragmento é a parte do URL que vem depois de #. Não inclua o #.
customHost	string	Anfitrião a redirecionar. Deixe vazio para utilizar o anfitrião de entrada como anfitrião de destino.
customPath	string	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.
customQueryString	string	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 = . O primeiro ? e & serão adicionadas automaticamente, pelo que não as inclua na frente, mas separe várias cadeias de consulta com &.
redirectProtocol	FrontDoorRedirectProtocol	O protocolo do destino para onde o tráfego é redirecionado
redirectType	FrontDoorRedirectType	O tipo de redirecionamento que a regra irá utilizar ao redirecionar o tráfego.

RoutingRule

Uma regra de encaminhamento representa uma especificação para o tráfego tratar e para onde enviá-la, juntamente com as informações da sonda de estado de funcionamento.

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.acceptedProtocols	FrontDoorProtocol[]	Esquemas de protocolo a corresponder a esta regra
properties.enabledState	routingRuleEnabledState	Se pretende ativar a utilização desta regra. Os valores permitidos são "Ativado" ou "Desativado"
properties.frontendEndpoints	SubResource[]	Pontos finais de front-end associados a esta regra
properties.patternsToMatch	string[]	Os padrões de rota da regra.
properties.resourceState	FrontDoorResourceState	Estado do recurso da Sub-origem do Front Door ou do Front Door. Estado do recurso.
properties.routeConfiguration	RouteConfiguration: ForwardingConfiguration RedirectConfiguration	Uma referência à configuração de encaminhamento.
type	string	Tipo de recurso.

routingRuleEnabledState

Se pretende ativar a utilização desta regra. Os valores permitidos são "Ativado" ou "Desativado"

Name	Tipo	Description
Disabled	string
Enabled	string

SessionAffinityEnabledState

Se pretende permitir a afinidade de sessão neste anfitrião. As opções válidas são "Ativado" ou "Desativado"

Name	Tipo	Description
Disabled	string
Enabled	string

SubResource

Referência a outra sub-origem.

Name	Tipo	Description
id	string	ID do Recurso.

Vault

O Key Vault que contém o certificado SSL

Name	Tipo	Description
id	string	ID do Recurso.

WebApplicationFirewallPolicyLink

Define a política de Firewall de Aplicações Web para cada anfitrião (se aplicável)

Name	Tipo	Description
id	string	ID do Recurso.

Partilhar via

Front Doors - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Create or update specific Front Door

Pedido de amostra

Resposta da amostra

Definições

Backend

backendEnabledState

BackendPool

BackendPoolsSettings

CacheConfiguration

CustomHttpsConfiguration

CustomHttpsProvisioningState

CustomHttpsProvisioningSubstate

DynamicCompressionEnabled

enforceCertificateNameCheckEnabledState

ErrorResponse

ForwardingConfiguration

FrontDoor

FrontDoorCertificateSource

FrontDoorCertificateType

FrontDoorEnabledState

FrontDoorForwardingProtocol

FrontDoorHealthProbeMethod

FrontDoorProtocol

FrontDoorQuery

FrontDoorRedirectProtocol

FrontDoorRedirectType

FrontDoorResourceState

FrontDoorTlsProtocolType

FrontendEndpoint

HealthProbeEnabled

HealthProbeSettingsModel

LoadBalancingSettingsModel

MinimumTLSVersion

RedirectConfiguration

RoutingRule

routingRuleEnabledState

SessionAffinityEnabledState

SubResource

Vault

WebApplicationFirewallPolicyLink

Recursos adicionais