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 assinatura e no grupo de recursos especificados.

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

Parâmetros de URI

Nome	Em	Obrigató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 assinatura do Azure. Padrão Regex: `^[a-zA-Z0-9_\-\.]*[^\.]$`
subscriptionId	path	True	string	As credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.
api-version	query	True	string	Versão de API do cliente.

Corpo da solicitação

Nome	Tipo	Description
location	string	Local do recurso.
properties.backendPools	BackendPool[]	Pools de back-end disponíveis para regras de roteamento.
properties.backendPoolsSettings	BackendPoolsSettings	Configurações para todos os backendPools
properties.enabledState	FrontDoorEnabledState	Status operacional do balanceador de carga do Front Door. Os valores permitidos são 'Enabled' ou 'Disabled'
properties.friendlyName	string	Um nome amigável para o frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Pontos de extremidade de front-end disponíveis para regras de roteamento.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Configurações de investigação de integridade associadas a esta instância do Front Door.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Configurações de balanceamento de carga associadas a esta instância do Front Door.
properties.routingRules	RoutingRule[]	Regras de roteamento associadas a este Front Door.
tags	object	Marcas de recurso.

Respostas

Nome	Tipo	Description
200 OK	FrontDoor	OK. A solicitação foi bem-sucedida.
201 Created	FrontDoor	Criado. A solicitação foi atendida e um novo Front Door foi criado.
202 Accepted	FrontDoor	Aceita. A solicitação foi aceita 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 por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Create or update specific Front Door

Solicitação de exemplo

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 de exemplo

Código de status:: 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 status:: 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 status:: 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

Nome	Description
Backend	Endereço de back-end de um balanceador de carga frontDoor.
backendEnabledState	Se deseja habilitar o uso desse back-end. Os valores permitidos são 'Enabled' ou 'Disabled'
BackendPool	Um pool de back-end é uma coleção de back-ends para os quais pode ser roteado.
BackendPoolsSettings	Configurações que se aplicam a todos os pools de back-end.
CacheConfiguration	Configurações de cache para uma rota do tipo cache. Para desabilitar o cache, não forneça um objeto cacheConfiguration.
CustomHttpsConfiguration	Configurações de Https para um domínio
CustomHttpsProvisioningState	Provisionamento status de Https Personalizados do frontendEndpoint.
CustomHttpsProvisioningSubstate	O subestado de provisionamento mostra o progresso da habilitação/desabilitação de HTTPS personalizada passo a passo.
DynamicCompressionEnabled	Se deve usar a compactação dinâmica para conteúdo armazenado em cache
enforceCertificateNameCheckEnabledState	Se o nome do certificado deve ser marcar em solicitações HTTPS a todos os pools de back-end. Nenhum efeito em solicitações não HTTPS.
ErrorResponse	A resposta de erro indica que o serviço front door não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.
ForwardingConfiguration	Descreve a Rota de Encaminhamento.
FrontDoor	O Front Door representa uma coleção de pontos de extremidade de back-end para os quais o tráfego é roteado junto com regras que especificam como o tráfego é enviado para lá.
FrontDoorCertificateSource	Define a origem do certificado SSL
FrontDoorCertificateType	Define o tipo do certificado usado para conexões seguras com um frontendEndpoint
FrontDoorEnabledState	Status operacional do balanceador de carga do Front Door. Os valores permitidos são 'Enabled' ou 'Disabled'
FrontDoorForwardingProtocol	O protocolo que essa regra usará ao encaminhar o tráfego aos back-ends.
FrontDoorHealthProbeMethod	Configura qual método HTTP usar para investigar os back-ends definidos em back-endPools.
FrontDoorProtocol	Esquemas de protocolo para corresponder a essa regra
FrontDoorQuery	Tratamento de 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 usará ao redirecionar o tráfego.
FrontDoorResourceState	Status de recursos do Front Door ou do SubResource do Front Door.
FrontDoorTlsProtocolType	Define o protocolo de extensão TLS usado para entrega segura
FrontendEndpoint	Um ponto de extremidade de front-end usado para roteamento.
HealthProbeEnabled	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 em um único pool de back-end habilitado.
HealthProbeSettingsModel	Configurações de balanceamento de carga para um pool de back-end
LoadBalancingSettingsModel	Configurações de balanceamento de carga para um pool 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 roteamento representa uma especificação para o tráfego tratar e para onde enviá-la, juntamente com informações de investigação de integridade.
routingRuleEnabledState	Se deseja habilitar o uso dessa regra. Os valores permitidos são 'Enabled' ou 'Disabled'
SessionAffinityEnabledState	Se deseja permitir a afinidade de sessão neste host. As opções válidas são 'Enabled' ou 'Disabled'
SubResource	Referência a outro sub-recurso.
Vault	O Key Vault que contém o certificado SSL
WebApplicationFirewallPolicyLink	Define a política de Firewall de Aplicativo Web para cada host (se aplicável)

Backend

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

Nome	Tipo	Description
address	string	Localização do back-end (endereço IP ou FQDN)
backendHostHeader	string	O valor a ser usado como o cabeçalho de host enviado para o back-end. Se estiver em branco ou não for especificado, o padrão será o host de entrada.
enabledState	backendEnabledState	Se deseja habilitar o uso desse back-end. Os valores permitidos são 'Enabled' ou 'Disabled'
httpPort	integer	O número da porta TCP do HTTP. Precisa estar entre 1 e 65535.
httpsPort	integer	O número da porta TCP do HTTPS. Precisa estar entre 1 e 65535.
priority	integer	A prioridade a ser usada para o 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.
weight	integer	O peso desse ponto de extremidade para fins de balanceamento de carga.

backendEnabledState

Se deseja habilitar o uso desse back-end. Os valores permitidos são 'Enabled' ou 'Disabled'

Nome	Tipo	Description
Disabled	string
Enabled	string

BackendPool

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

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.backends	Backend[]	O conjunto de back-ends para esse pool
properties.healthProbeSettings	SubResource	Configurações de investigação de integridade L7 para um pool de back-end
properties.loadBalancingSettings	SubResource	Configurações de balanceamento de carga para um pool de back-end
properties.resourceState	FrontDoorResourceState	Status de recursos do Front Door ou do SubResource do Front Door. Status de recursos.
type	string	Tipo de recurso.

BackendPoolsSettings

Configurações que se aplicam a todos os pools de back-end.

Nome	Tipo	Valor padrão	Description
enforceCertificateNameCheck	enforceCertificateNameCheckEnabledState	Enabled	Se deve impor o nome do certificado marcar em solicitações HTTPS a todos os pools de back-end. Nenhum efeito em solicitações não HTTPS.
sendRecvTimeoutSeconds	integer		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.

CacheConfiguration

Configurações de cache para uma rota do tipo cache. Para desabilitar o cache, não forneça um objeto cacheConfiguration.

Nome	Tipo	Description
dynamicCompression	DynamicCompressionEnabled	Se deve usar a compactação dinâmica para conteúdo armazenado em cache
queryParameterStripDirective	FrontDoorQuery	Tratamento de termos de consulta de URL ao formar a chave de cache.

CustomHttpsConfiguration

Configurações de Https para um domínio

Nome	Tipo	Description
certificateSource	FrontDoorCertificateSource	Define a origem do certificado SSL
frontDoorCertificateSourceParameters.certificateType	FrontDoorCertificateType	Define o tipo do certificado usado para conexões seguras com um frontendEndpoint
keyVaultCertificateSourceParameters.secretName	string	O nome do segredo do Key Vault que representa o PFX do certificado completo
keyVaultCertificateSourceParameters.secretVersion	string	A versão do segredo do Key Vault que representa o PFX do certificado completo
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 usado para entrega segura

CustomHttpsProvisioningState

Provisionamento status de Https Personalizados do frontendEndpoint.

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

CustomHttpsProvisioningSubstate

O subestado de provisionamento mostra o progresso da habilitação/desabilitação de HTTPS personalizada passo a passo.

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

DynamicCompressionEnabled

Se deve usar a compactação dinâmica para conteúdo armazenado em cache

Nome	Tipo	Description
Disabled	string
Enabled	string

enforceCertificateNameCheckEnabledState

Se o nome do certificado deve ser marcar em solicitações HTTPS a todos os pools de back-end. Nenhum efeito em solicitações não HTTPS.

Nome	Tipo	Description
Disabled	string
Enabled	string

ErrorResponse

A resposta de erro indica que o serviço front door não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Nome	Tipo	Description
code	string	Código do erro.
message	string	Mensagem de erro indicando por que a operação falhou.

ForwardingConfiguration

Descreve a Rota de Encaminhamento.

Nome	Tipo	Description
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
backendPool	SubResource	Uma referência ao BackendPool para o qual essa regra roteia.
cacheConfiguration	CacheConfiguration	A configuração de cache associada a essa regra.
customForwardingPath	string	Um caminho personalizado usado para reescrever caminhos de recursos correspondentes a essa regra. Deixe em branco para usar o caminho de entrada.
forwardingProtocol	FrontDoorForwardingProtocol	O protocolo que essa regra usará ao encaminhar o tráfego aos back-ends.

FrontDoor

O Front Door representa uma coleção de pontos de extremidade de back-end para os quais o tráfego é roteado junto com regras que especificam como o tráfego é enviado para lá.

Nome	Tipo	Description
id	string	ID do recurso.
location	string	Local do recurso.
name	string	Nome do recurso.
properties.backendPools	BackendPool[]	Pools de back-end disponíveis para regras de roteamento.
properties.backendPoolsSettings	BackendPoolsSettings	Configurações para todos os back-endPools
properties.cname	string	O host para o qual cada frontendEndpoint deve ser CNAME.
properties.enabledState	FrontDoorEnabledState	Status operacional do balanceador de carga do Front Door. Os valores permitidos são 'Enabled' ou 'Disabled'
properties.friendlyName	string	Um nome amigável para o frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Pontos de extremidade de front-end disponíveis para regras de roteamento.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Configurações de investigação de integridade associadas a esta instância do Front Door.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Configurações de balanceamento de carga associadas a esta instância do Front Door.
properties.provisioningState	string	Estado de provisionamento do Front Door.
properties.resourceState	FrontDoorResourceState	Status de recursos do Front Door ou do SubResource do Front Door. Status de recursos do Front Door.
properties.routingRules	RoutingRule[]	Regras de roteamento associadas a este Front Door.
tags	object	Marcas de recurso.
type	string	Tipo de recurso.

FrontDoorCertificateSource

Define a origem do certificado SSL

Nome	Tipo	Description
AzureKeyVault	string
FrontDoor	string

FrontDoorCertificateType

Define o tipo do certificado usado para conexões seguras com um frontendEndpoint

Nome	Tipo	Description
Dedicated	string

FrontDoorEnabledState

Status operacional do balanceador de carga do Front Door. Os valores permitidos são 'Enabled' ou 'Disabled'

Nome	Tipo	Description
Disabled	string
Enabled	string

FrontDoorForwardingProtocol

O protocolo que essa regra usará ao encaminhar o tráfego aos back-ends.

Nome	Tipo	Description
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorHealthProbeMethod

Configura qual método HTTP usar para investigar os back-ends definidos em back-endPools.

Nome	Tipo	Description
GET	string
HEAD	string

FrontDoorProtocol

Esquemas de protocolo para corresponder a essa regra

Nome	Tipo	Description
Http	string
Https	string

FrontDoorQuery

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

Nome	Tipo	Description
StripAll	string
StripNone	string

FrontDoorRedirectProtocol

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

Nome	Tipo	Description
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorRedirectType

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

Nome	Tipo	Description
Found	string
Moved	string
PermanentRedirect	string
TemporaryRedirect	string

FrontDoorResourceState

Status de recursos do Front Door ou do SubResource do Front Door.

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

FrontDoorTlsProtocolType

Define o protocolo de extensão TLS usado para entrega segura

Nome	Tipo	Description
ServerNameIndication	string

FrontendEndpoint

Um ponto de extremidade de front-end usado para roteamento.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.customHttpsConfiguration	CustomHttpsConfiguration	A configuração que especifica como habilitar HTTPS
properties.customHttpsProvisioningState	CustomHttpsProvisioningState	Provisionando status de Https Personalizados do front-endEndpoint.
properties.customHttpsProvisioningSubstate	CustomHttpsProvisioningSubstate	O subestado de provisionamento mostra o progresso do processo personalizado de habilitação/desabilitação de HTTPS passo a passo.
properties.hostName	string	O nome de host do frontendEndpoint. Precisa ser um nome de domínio.
properties.resourceState	FrontDoorResourceState	Status de recursos do Front Door ou do SubResource do Front Door. Status de recursos.
properties.sessionAffinityEnabledState	SessionAffinityEnabledState	Se deseja permitir a afinidade de sessão neste host. As opções válidas são 'Habilitado' ou 'Desabilitado'
properties.sessionAffinityTtlSeconds	integer	UTILIZADAS. Esse campo será ignorado. O TTL a ser usado em segundos para afinidade de sessão, se aplicável.
properties.webApplicationFirewallPolicyLink	WebApplicationFirewallPolicyLink	Define a política de Firewall de Aplicativo Web para cada host (se aplicável)
type	string	Tipo de recurso.

HealthProbeEnabled

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 em um único pool de back-end habilitado.

Nome	Tipo	Description
Disabled	string
Enabled	string

HealthProbeSettingsModel

Configurações de balanceamento de carga para um pool de back-end

Nome	Tipo	Valor padrão	Description
id	string		ID do recurso.
name	string		Nome do recurso.
properties.enabledState	HealthProbeEnabled		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 em um único pool de back-end habilitado.
properties.healthProbeMethod	FrontDoorHealthProbeMethod	HEAD	Configura qual método HTTP usar para investigar os back-ends definidos em back-endPools.
properties.intervalInSeconds	integer		O número de segundos entre as investigações de integridade.
properties.path	string		O caminho a ser usado para a investigação de integridade. O padrão é /
properties.protocol	FrontDoorProtocol		Esquema de protocolo a ser usado para esta investigação
properties.resourceState	FrontDoorResourceState		Status de recursos do Front Door ou do SubResource do Front Door. Status de recursos.
type	string		Tipo de recurso.

LoadBalancingSettingsModel

Configurações de balanceamento de carga para um pool de back-end

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.additionalLatencyMilliseconds	integer	A latência adicional em milissegundos para que as investigações caiam no bucket de latência mais baixo
properties.resourceState	FrontDoorResourceState	Status de recursos do Front Door ou do SubResource do Front Door. Status de recursos.
properties.sampleSize	integer	O número de exemplos a serem considerados para decisões de balanceamento de carga
properties.successfulSamplesRequired	integer	O número de exemplos dentro do período de exemplo que deve ter êxito
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.

Nome	Tipo	Description
1.0	string
1.2	string

RedirectConfiguration

Descreve a Rota de Redirecionamento.

Nome	Tipo	Description
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration
customFragment	string	Fragmento a ser adicionado à URL de redirecionamento. Fragment é a parte da URL que vem depois de #. Não inclua o #.
customHost	string	Host a ser redirecionada. Deixe vazio para usar o host de entrada como o host de destino.
customPath	string	O caminho completo para redirecionar. O caminho não pode estar vazio e deve começar com /. Deixe vazio para usar o caminho de entrada como caminho de destino.
customQueryString	string	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 no formato = . O primeiro? e & serão adicionados automaticamente, portanto, não os inclua na frente, mas separe várias cadeias de caracteres de consulta com &.
redirectProtocol	FrontDoorRedirectProtocol	O protocolo do destino para onde o tráfego é redirecionado
redirectType	FrontDoorRedirectType	O tipo de redirecionamento que a regra usará ao redirecionar o tráfego.

RoutingRule

Uma regra de roteamento representa uma especificação para o tráfego tratar e para onde enviá-la, juntamente com informações de investigação de integridade.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.acceptedProtocols	FrontDoorProtocol[]	Esquemas de protocolo para corresponder a essa regra
properties.enabledState	routingRuleEnabledState	Se deseja habilitar o uso dessa regra. Os valores permitidos são 'Enabled' ou 'Disabled'
properties.frontendEndpoints	SubResource[]	Pontos de extremidade de front-end associados a essa regra
properties.patternsToMatch	string[]	Os padrões de rota da regra.
properties.resourceState	FrontDoorResourceState	Status de recursos do Front Door ou do SubResource do Front Door. Status de recursos.
properties.routeConfiguration	RouteConfiguration: ForwardingConfiguration RedirectConfiguration	Uma referência à configuração de roteamento.
type	string	Tipo de recurso.

routingRuleEnabledState

Se deseja habilitar o uso dessa regra. Os valores permitidos são 'Enabled' ou 'Disabled'

Nome	Tipo	Description
Disabled	string
Enabled	string

SessionAffinityEnabledState

Se deseja permitir a afinidade de sessão neste host. As opções válidas são 'Enabled' ou 'Disabled'

Nome	Tipo	Description
Disabled	string
Enabled	string

SubResource

Referência a outro sub-recurso.

Nome	Tipo	Description
id	string	ID do recurso.

Vault

O Key Vault que contém o certificado SSL

Nome	Tipo	Description
id	string	ID do recurso.

WebApplicationFirewallPolicyLink

Define a política de Firewall de Aplicativo Web para cada host (se aplicável)

Nome	Tipo	Description
id	string	ID do recurso.

Compartilhar via

Front Doors - Create Or Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

Create or update specific Front Door

Solicitação de exemplo

Resposta de exemplo

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