Frontdoor Microsoft.Network 2020-01-01
- più recenti
- 2021-06-01
- 2020-05-01
- 2020-04-01
- 2020-01-01
- 2019-05-01
- 2019-04-01
- 2018-08-01
Definizione di risorsa Bicep
Il tipo di risorsa frontdoor può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.Network/frontDoors, aggiungere il bicep seguente al modello.
resource symbolicname 'Microsoft.Network/frontDoors@2020-01-01' = {
location: 'string'
name: 'string'
properties: {
backendPools: [
{
id: 'string'
name: 'string'
properties: {
backends: [
{
address: 'string'
backendHostHeader: 'string'
enabledState: 'string'
httpPort: int
httpsPort: int
priority: int
privateLinkAlias: 'string'
privateLinkApprovalMessage: 'string'
weight: int
}
]
healthProbeSettings: {
id: 'string'
}
loadBalancingSettings: {
id: 'string'
}
}
}
]
backendPoolsSettings: {
enforceCertificateNameCheck: 'string'
sendRecvTimeoutSeconds: int
}
enabledState: 'string'
friendlyName: 'string'
frontendEndpoints: [
{
id: 'string'
name: 'string'
properties: {
hostName: 'string'
sessionAffinityEnabledState: 'string'
sessionAffinityTtlSeconds: int
webApplicationFirewallPolicyLink: {
id: 'string'
}
}
}
]
healthProbeSettings: [
{
id: 'string'
name: 'string'
properties: {
enabledState: 'string'
healthProbeMethod: 'string'
intervalInSeconds: int
path: 'string'
protocol: 'string'
}
}
]
loadBalancingSettings: [
{
id: 'string'
name: 'string'
properties: {
additionalLatencyMilliseconds: int
sampleSize: int
successfulSamplesRequired: int
}
}
]
routingRules: [
{
id: 'string'
name: 'string'
properties: {
acceptedProtocols: [
'string'
]
enabledState: 'string'
frontendEndpoints: [
{
id: 'string'
}
]
patternsToMatch: [
'string'
]
routeConfiguration: {
@odata.type: 'string'
// For remaining properties, see RouteConfiguration objects
}
rulesEngine: {
id: 'string'
}
}
}
]
}
tags: {
{customized property}: 'string'
}
}
Oggetti RouteConfiguration
Impostare la proprietà
Per #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration, usare:
{
@odata.type: '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
backendPool: {
id: 'string'
}
cacheConfiguration: {
cacheDuration: 'string'
dynamicCompression: 'string'
queryParameters: 'string'
queryParameterStripDirective: 'string'
}
customForwardingPath: 'string'
forwardingProtocol: 'string'
}
Per #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration, usare:
{
@odata.type: '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration'
customFragment: 'string'
customHost: 'string'
customPath: 'string'
customQueryString: 'string'
redirectProtocol: 'string'
redirectType: 'string'
}
Valori delle proprietà
Back-end
Nome | Descrizione | Valore |
---|---|---|
indirizzo | Posizione del back-end (indirizzo IP o FQDN) | corda |
backendHostHeader | Valore da usare come intestazione host inviata al back-end. Se vuoto o non specificato, il valore predefinito è l'host in ingresso. | corda |
enabledState | Indica se abilitare l'uso di questo back-end. I valori consentiti sono 'Enabled' o 'Disabled' | 'Disabilitato' 'Enabled' |
httpPort | Numero di porta TCP HTTP. Deve essere compreso tra 1 e 65535. | Int Vincoli: Valore minimo = 1 Valore massimo = 65535 |
httpsPort | Numero di porta TCP HTTPS. Deve essere compreso tra 1 e 65535. | Int Vincoli: Valore minimo = 1 Valore massimo = 65535 |
priorità | Priorità da usare per il bilanciamento del carico. Le priorità più elevate non verranno usate per il bilanciamento del carico se un back-end con priorità inferiore è integro. | Int Vincoli: Valore minimo = 1 Valore massimo = 5 |
privateLinkAlias | Alias della risorsa collegamento privato. Il popolamento di questo campo facoltativo indica che il back-end è "Privato" | corda |
privateLinkApprovalMessage | Messaggio personalizzato da includere nella richiesta di approvazione per la connessione al collegamento privato | corda |
peso | Peso di questo endpoint a scopo di bilanciamento del carico. | Int Vincoli: Valore minimo = 1 Valore massimo = 1000 |
BackendPool
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
nome | Nome risorsa. | corda |
proprietà | Proprietà del pool back-end frontdoor | |
BackendPoolProperties
Nome | Descrizione | Valore |
---|---|---|
back-end | Set di back-end per questo pool | back-end[] |
healthProbeSettings | Impostazioni del probe di integrità L7 per un pool back-end | SubResource |
loadBalancingSettings | Impostazioni di bilanciamento del carico per un pool back-end | SubResource |
BackendPoolsSettings
Nome | Descrizione | Valore |
---|---|---|
enforceCertificateNameCheck | Indica se applicare il controllo del nome del certificato alle richieste HTTPS a tutti i pool back-end. Nessun effetto sulle richieste non HTTPS. | 'Disabilitato' 'Enabled' |
sendRecvTimeoutSeconds | Inviare e ricevere il timeout sulla richiesta di inoltro al back-end. Quando viene raggiunto il timeout, la richiesta ha esito negativo e restituisce. | Int Vincoli: Valore minimo = 16 |
CacheConfiguration
Nome | Descrizione | Valore |
---|---|---|
cacheDuration | Durata per cui il contenuto deve essere memorizzato nella cache. Il formato consentito è in formato ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP richiede che il valore non sia più di un anno | corda |
dynamicCompression | Indica se usare la compressione dinamica per il contenuto memorizzato nella cache | 'Disabilitato' 'Enabled' |
queryParameters | parametri di query da includere o escludere (delimitati da virgole). | corda |
queryParameterStripDirective | Trattamento dei termini di query URL quando si forma la chiave della cache. | 'StripAll' 'StripAllExcept' 'StripNone' 'StripOnly' |
ForwardingConfiguration
Nome | Descrizione | Valore |
---|---|---|
@odata.type | '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (obbligatorio) | |
backendPool | Riferimento a BackendPool a cui viene instradata questa regola. | SubResource |
cacheConfiguration | Configurazione di memorizzazione nella cache associata a questa regola. | CacheConfiguration |
customForwardingPath | Percorso personalizzato usato per riscrivere i percorsi delle risorse corrispondenti a questa regola. Lasciare vuoto per usare il percorso in ingresso. | corda |
forwardingProtocol | Protocollo che questa regola verrà usata durante l'inoltro del traffico ai back-end. | 'HttpOnly' 'HttpsOnly' 'MatchRequest' |
FrontdoorProprietà
Nome | Descrizione | Valore |
---|---|---|
back-endPools | Pool back-end disponibili per le regole di routing. | back-endpool[] |
backendPoolsSettings | Impostazioni per tutti i pool back-end | BackendPoolsSettings |
enabledState | Stato operativo del servizio di bilanciamento del carico di Frontdoor. I valori consentiti sono 'Enabled' o 'Disabled' | 'Disabilitato' 'Enabled' |
friendlyName | Nome descrittivo per frontdoor | corda |
frontendEndpoints | Endpoint front-end disponibili per le regole di routing. | frontendEndpoint[] |
healthProbeSettings | Impostazioni del probe di integrità associate a questa istanza di Frontdoor. | HealthProbeSettingsModel[] |
loadBalancingSettings | Impostazioni di bilanciamento del carico associate a questa istanza di Frontdoor. | LoadBalancingSettingsModel[] |
routingRules | Regole di routing associate a questa frontdoor. | RoutingRule[] |
Front-endEndpoint
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
nome | Nome risorsa. | corda |
proprietà | Proprietà dell'endpoint front-end | FrontndEndpointProperties |
FrontndEndpointProperties
Nome | Descrizione | Valore |
---|---|---|
hostName | Nome host del front-endEndpoint. Deve essere un nome di dominio. | corda |
sessionAffinityEnabledState | Indica se consentire l'affinità di sessione in questo host. Le opzioni valide sono 'Enabled' o 'Disabled' | 'Disabilitato' 'Enabled' |
sessionAffinityTtlSeconds | INUTILIZZATO. Questo campo verrà ignorato. Durata (TTL) da usare in secondi per l'affinità di sessione, se applicabile. | Int |
webApplicationFirewallPolicyLink | Definisce i criteri web application firewall per ogni host (se applicabile) | FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink |
FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
HealthProbeSettingsModel
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
nome | Nome risorsa. | corda |
proprietà | Proprietà delle impostazioni del probe di integrità | HealthProbeSettingsProperties |
HealthProbeSettingsProperties
Nome | Descrizione | Valore |
---|---|---|
enabledState | Indica se abilitare i probe di integrità da eseguire su back-end definiti in back-endPools. I probe di integrità possono essere disabilitati solo se è presente un singolo back-end abilitato in un singolo pool back-end abilitato. | 'Disabilitato' 'Enabled' |
healthProbeMethod | Configura il metodo HTTP da usare per eseguire il probe dei back-end definiti in backendPools. | 'GET' 'HEAD' |
intervalInSeconds | Numero di secondi tra i probe di integrità. | Int |
sentiero | Percorso da usare per il probe di integrità. Il valore predefinito è / | corda |
protocollo | Schema di protocollo da usare per questo probe | 'Http' 'Https' |
LoadBalancingSettingsModel
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
nome | Nome risorsa. | corda |
proprietà | Proprietà delle impostazioni di bilanciamento del carico | LoadBalancingSettingsProperties |
LoadBalancingSettingsProperties
Nome | Descrizione | Valore |
---|---|---|
additionalLatencyMilliseconds | Latenza aggiuntiva in millisecondi per i probe che rientrano nel bucket di latenza più bassa | Int |
sampleSize | Numero di campioni da considerare per le decisioni di bilanciamento del carico | Int |
successfulSamplesRequired | Numero di campioni entro il periodo di campionamento che deve avere esito positivo | Int |
Microsoft.Network/frontdoors
Nome | Descrizione | Valore |
---|---|---|
ubicazione | Percorso della risorsa. | corda |
nome | Nome della risorsa | corda Vincoli: Lunghezza minima = 5 Lunghezza massima = 5 Pattern = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (obbligatorio) |
proprietà | Proprietà del servizio di bilanciamento del carico frontdoor | FrontDoorProprietà |
Tag | Tag delle risorse | Dizionario di nomi e valori di tag. Vedere tag nei modelli |
RedirectConfiguration
Nome | Descrizione | Valore |
---|---|---|
@odata.type | '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obbligatorio) | |
customFragment | Frammento da aggiungere all'URL di reindirizzamento. Fragment è la parte dell'URL che segue #. Non includere il file #. | corda |
customHost | Host da reindirizzare. Lasciare vuoto per usare l'host in ingresso come host di destinazione. | corda |
customPath | Percorso completo da reindirizzare. Il percorso non può essere vuoto e deve iniziare con /. Lasciare vuoto per usare il percorso in ingresso come percorso di destinazione. | corda |
customQueryString | Set di stringhe di query da inserire nell'URL di reindirizzamento. L'impostazione di questo valore sostituirà qualsiasi stringa di query esistente; lasciare vuoto per mantenere la stringa di query in ingresso. La stringa di query deve essere in <>chiave =<formato> valore. Prima? e & verranno aggiunti automaticamente in modo da non includerli in primo piano, ma separare più stringhe di query con &. | corda |
redirectProtocol | Protocollo della destinazione in cui viene reindirizzato il traffico | 'HttpOnly' 'HttpsOnly' 'MatchRequest' |
redirectType | Tipo di reindirizzamento che verrà usata dalla regola durante il reindirizzamento del traffico. | 'Trovato' 'Spostato' 'PermanentRedirect' 'TemporaryRedirect' |
ResourceTags
Nome | Descrizione | Valore |
---|
RouteConfiguration
Nome | Descrizione | Valore |
---|---|---|
@odata.type | Impostare su "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" per il tipo ForwardingConfiguration. Impostare su "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" per il tipo RedirectConfiguration. | '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obbligatorio) |
RoutingRule
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
nome | Nome risorsa. | corda |
proprietà | Proprietà della regola di routing di Frontdoor | RoutingRuleProperties |
RoutingRuleProperties
Nome | Descrizione | Valore |
---|---|---|
acceptedProtocols | Schemi di protocollo che corrispondono a questa regola | Matrice di stringhe contenente uno dei seguenti elementi: 'Http' 'Https' |
enabledState | Indica se abilitare l'uso di questa regola. I valori consentiti sono 'Enabled' o 'Disabled' | 'Disabilitato' 'Enabled' |
frontendEndpoints | Endpoint front-end associati a questa regola | SubResource [] |
patternsToMatch | Modelli di route della regola. | string[] |
routeConfiguration | Riferimento alla configurazione di routing. | RouteConfiguration |
rulesEngine | Riferimento a una configurazione specifica del motore regole da applicare a questa route. | SubResource |
Sottorisorsa
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
Esempi di avvio rapido
Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.
Bicep File | Descrizione |
---|---|
Aggiungere un dominio personalizzato e un certificato personalizzato con Frontdoor | Questo modello esegue l'onboarding e protegge un dominio personalizzato con Frontdoor con un certificato gestito dal cliente |
Aggiungere un dominio personalizzato e un certificato gestito con Frontdoor | Questo modello esegue l'onboarding e protegge un dominio personalizzato con Frontdoor |
controllare i probe di integrità per i back-end in Frontdoor | Questo modello aggiorna frontdoor per modificare le impostazioni del probe di integrità impostando il percorso del probe e anche gli intervalli in cui verranno inviati i probe. |
Creare una frontdoor di base | Questo modello crea una configurazione frontdoor di base con un singolo back-end. |
Creare una frontdoor con reindirizzamento DA HTTP a HTTPS | Questo modello crea una configurazione di Frontdoor per il reindirizzamento DA HTTP a HTTPS. |
Definizione di risorsa del modello di Resource Manager
Il tipo di risorsa frontdoor può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.Network/frontDoors, aggiungere il codice JSON seguente al modello.
{
"type": "Microsoft.Network/frontDoors",
"apiVersion": "2020-01-01",
"name": "string",
"location": "string",
"properties": {
"backendPools": [
{
"id": "string",
"name": "string",
"properties": {
"backends": [
{
"address": "string",
"backendHostHeader": "string",
"enabledState": "string",
"httpPort": "int",
"httpsPort": "int",
"priority": "int",
"privateLinkAlias": "string",
"privateLinkApprovalMessage": "string",
"weight": "int"
}
],
"healthProbeSettings": {
"id": "string"
},
"loadBalancingSettings": {
"id": "string"
}
}
}
],
"backendPoolsSettings": {
"enforceCertificateNameCheck": "string",
"sendRecvTimeoutSeconds": "int"
},
"enabledState": "string",
"friendlyName": "string",
"frontendEndpoints": [
{
"id": "string",
"name": "string",
"properties": {
"hostName": "string",
"sessionAffinityEnabledState": "string",
"sessionAffinityTtlSeconds": "int",
"webApplicationFirewallPolicyLink": {
"id": "string"
}
}
}
],
"healthProbeSettings": [
{
"id": "string",
"name": "string",
"properties": {
"enabledState": "string",
"healthProbeMethod": "string",
"intervalInSeconds": "int",
"path": "string",
"protocol": "string"
}
}
],
"loadBalancingSettings": [
{
"id": "string",
"name": "string",
"properties": {
"additionalLatencyMilliseconds": "int",
"sampleSize": "int",
"successfulSamplesRequired": "int"
}
}
],
"routingRules": [
{
"id": "string",
"name": "string",
"properties": {
"acceptedProtocols": [ "string" ],
"enabledState": "string",
"frontendEndpoints": [
{
"id": "string"
}
],
"patternsToMatch": [ "string" ],
"routeConfiguration": {
"@odata.type": "string"
// For remaining properties, see RouteConfiguration objects
},
"rulesEngine": {
"id": "string"
}
}
}
]
},
"tags": {
"{customized property}": "string"
}
}
Oggetti RouteConfiguration
Impostare la proprietà
Per #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration, usare:
{
"@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
"backendPool": {
"id": "string"
},
"cacheConfiguration": {
"cacheDuration": "string",
"dynamicCompression": "string",
"queryParameters": "string",
"queryParameterStripDirective": "string"
},
"customForwardingPath": "string",
"forwardingProtocol": "string"
}
Per #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration, usare:
{
"@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration",
"customFragment": "string",
"customHost": "string",
"customPath": "string",
"customQueryString": "string",
"redirectProtocol": "string",
"redirectType": "string"
}
Valori delle proprietà
Back-end
Nome | Descrizione | Valore |
---|---|---|
indirizzo | Posizione del back-end (indirizzo IP o FQDN) | corda |
backendHostHeader | Valore da usare come intestazione host inviata al back-end. Se vuoto o non specificato, il valore predefinito è l'host in ingresso. | corda |
enabledState | Indica se abilitare l'uso di questo back-end. I valori consentiti sono 'Enabled' o 'Disabled' | 'Disabilitato' 'Enabled' |
httpPort | Numero di porta TCP HTTP. Deve essere compreso tra 1 e 65535. | Int Vincoli: Valore minimo = 1 Valore massimo = 65535 |
httpsPort | Numero di porta TCP HTTPS. Deve essere compreso tra 1 e 65535. | Int Vincoli: Valore minimo = 1 Valore massimo = 65535 |
priorità | Priorità da usare per il bilanciamento del carico. Le priorità più elevate non verranno usate per il bilanciamento del carico se un back-end con priorità inferiore è integro. | Int Vincoli: Valore minimo = 1 Valore massimo = 5 |
privateLinkAlias | Alias della risorsa collegamento privato. Il popolamento di questo campo facoltativo indica che il back-end è "Privato" | corda |
privateLinkApprovalMessage | Messaggio personalizzato da includere nella richiesta di approvazione per la connessione al collegamento privato | corda |
peso | Peso di questo endpoint a scopo di bilanciamento del carico. | Int Vincoli: Valore minimo = 1 Valore massimo = 1000 |
BackendPool
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
nome | Nome risorsa. | corda |
proprietà | Proprietà del pool back-end frontdoor | |
BackendPoolProperties
Nome | Descrizione | Valore |
---|---|---|
back-end | Set di back-end per questo pool | back-end[] |
healthProbeSettings | Impostazioni del probe di integrità L7 per un pool back-end | SubResource |
loadBalancingSettings | Impostazioni di bilanciamento del carico per un pool back-end | SubResource |
BackendPoolsSettings
Nome | Descrizione | Valore |
---|---|---|
enforceCertificateNameCheck | Indica se applicare il controllo del nome del certificato alle richieste HTTPS a tutti i pool back-end. Nessun effetto sulle richieste non HTTPS. | 'Disabilitato' 'Enabled' |
sendRecvTimeoutSeconds | Inviare e ricevere il timeout sulla richiesta di inoltro al back-end. Quando viene raggiunto il timeout, la richiesta ha esito negativo e restituisce. | Int Vincoli: Valore minimo = 16 |
CacheConfiguration
Nome | Descrizione | Valore |
---|---|---|
cacheDuration | Durata per cui il contenuto deve essere memorizzato nella cache. Il formato consentito è in formato ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP richiede che il valore non sia più di un anno | corda |
dynamicCompression | Indica se usare la compressione dinamica per il contenuto memorizzato nella cache | 'Disabilitato' 'Enabled' |
queryParameters | parametri di query da includere o escludere (delimitati da virgole). | corda |
queryParameterStripDirective | Trattamento dei termini di query URL quando si forma la chiave della cache. | 'StripAll' 'StripAllExcept' 'StripNone' 'StripOnly' |
ForwardingConfiguration
Nome | Descrizione | Valore |
---|---|---|
@odata.type | '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (obbligatorio) | |
backendPool | Riferimento a BackendPool a cui viene instradata questa regola. | SubResource |
cacheConfiguration | Configurazione di memorizzazione nella cache associata a questa regola. | CacheConfiguration |
customForwardingPath | Percorso personalizzato usato per riscrivere i percorsi delle risorse corrispondenti a questa regola. Lasciare vuoto per usare il percorso in ingresso. | corda |
forwardingProtocol | Protocollo che questa regola verrà usata durante l'inoltro del traffico ai back-end. | 'HttpOnly' 'HttpsOnly' 'MatchRequest' |
FrontdoorProprietà
Nome | Descrizione | Valore |
---|---|---|
back-endPools | Pool back-end disponibili per le regole di routing. | back-endpool[] |
backendPoolsSettings | Impostazioni per tutti i pool back-end | BackendPoolsSettings |
enabledState | Stato operativo del servizio di bilanciamento del carico di Frontdoor. I valori consentiti sono 'Enabled' o 'Disabled' | 'Disabilitato' 'Enabled' |
friendlyName | Nome descrittivo per frontdoor | corda |
frontendEndpoints | Endpoint front-end disponibili per le regole di routing. | frontendEndpoint[] |
healthProbeSettings | Impostazioni del probe di integrità associate a questa istanza di Frontdoor. | HealthProbeSettingsModel[] |
loadBalancingSettings | Impostazioni di bilanciamento del carico associate a questa istanza di Frontdoor. | LoadBalancingSettingsModel[] |
routingRules | Regole di routing associate a questa frontdoor. | RoutingRule[] |
Front-endEndpoint
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
nome | Nome risorsa. | corda |
proprietà | Proprietà dell'endpoint front-end | FrontndEndpointProperties |
FrontndEndpointProperties
Nome | Descrizione | Valore |
---|---|---|
hostName | Nome host del front-endEndpoint. Deve essere un nome di dominio. | corda |
sessionAffinityEnabledState | Indica se consentire l'affinità di sessione in questo host. Le opzioni valide sono 'Enabled' o 'Disabled' | 'Disabilitato' 'Enabled' |
sessionAffinityTtlSeconds | INUTILIZZATO. Questo campo verrà ignorato. Durata (TTL) da usare in secondi per l'affinità di sessione, se applicabile. | Int |
webApplicationFirewallPolicyLink | Definisce i criteri web application firewall per ogni host (se applicabile) | FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink |
FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
HealthProbeSettingsModel
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
nome | Nome risorsa. | corda |
proprietà | Proprietà delle impostazioni del probe di integrità | HealthProbeSettingsProperties |
HealthProbeSettingsProperties
Nome | Descrizione | Valore |
---|---|---|
enabledState | Indica se abilitare i probe di integrità da eseguire su back-end definiti in back-endPools. I probe di integrità possono essere disabilitati solo se è presente un singolo back-end abilitato in un singolo pool back-end abilitato. | 'Disabilitato' 'Enabled' |
healthProbeMethod | Configura il metodo HTTP da usare per eseguire il probe dei back-end definiti in backendPools. | 'GET' 'HEAD' |
intervalInSeconds | Numero di secondi tra i probe di integrità. | Int |
sentiero | Percorso da usare per il probe di integrità. Il valore predefinito è / | corda |
protocollo | Schema di protocollo da usare per questo probe | 'Http' 'Https' |
LoadBalancingSettingsModel
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
nome | Nome risorsa. | corda |
proprietà | Proprietà delle impostazioni di bilanciamento del carico | LoadBalancingSettingsProperties |
LoadBalancingSettingsProperties
Nome | Descrizione | Valore |
---|---|---|
additionalLatencyMilliseconds | Latenza aggiuntiva in millisecondi per i probe che rientrano nel bucket di latenza più bassa | Int |
sampleSize | Numero di campioni da considerare per le decisioni di bilanciamento del carico | Int |
successfulSamplesRequired | Numero di campioni entro il periodo di campionamento che deve avere esito positivo | Int |
Microsoft.Network/frontdoors
Nome | Descrizione | Valore |
---|---|---|
apiVersion | Versione dell'API | '2020-01-01' |
ubicazione | Percorso della risorsa. | corda |
nome | Nome della risorsa | corda Vincoli: Lunghezza minima = 5 Lunghezza massima = 5 Pattern = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (obbligatorio) |
proprietà | Proprietà del servizio di bilanciamento del carico frontdoor | FrontDoorProprietà |
Tag | Tag delle risorse | Dizionario di nomi e valori di tag. Vedere tag nei modelli |
digitare | Tipo di risorsa | 'Microsoft.Network/frontdoors' |
RedirectConfiguration
Nome | Descrizione | Valore |
---|---|---|
@odata.type | '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obbligatorio) | |
customFragment | Frammento da aggiungere all'URL di reindirizzamento. Fragment è la parte dell'URL che segue #. Non includere il file #. | corda |
customHost | Host da reindirizzare. Lasciare vuoto per usare l'host in ingresso come host di destinazione. | corda |
customPath | Percorso completo da reindirizzare. Il percorso non può essere vuoto e deve iniziare con /. Lasciare vuoto per usare il percorso in ingresso come percorso di destinazione. | corda |
customQueryString | Set di stringhe di query da inserire nell'URL di reindirizzamento. L'impostazione di questo valore sostituirà qualsiasi stringa di query esistente; lasciare vuoto per mantenere la stringa di query in ingresso. La stringa di query deve essere in <>chiave =<formato> valore. Prima? e & verranno aggiunti automaticamente in modo da non includerli in primo piano, ma separare più stringhe di query con &. | corda |
redirectProtocol | Protocollo della destinazione in cui viene reindirizzato il traffico | 'HttpOnly' 'HttpsOnly' 'MatchRequest' |
redirectType | Tipo di reindirizzamento che verrà usata dalla regola durante il reindirizzamento del traffico. | 'Trovato' 'Spostato' 'PermanentRedirect' 'TemporaryRedirect' |
ResourceTags
Nome | Descrizione | Valore |
---|
RouteConfiguration
Nome | Descrizione | Valore |
---|---|---|
@odata.type | Impostare su "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" per il tipo ForwardingConfiguration. Impostare su "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" per il tipo RedirectConfiguration. | '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obbligatorio) |
RoutingRule
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
nome | Nome risorsa. | corda |
proprietà | Proprietà della regola di routing di Frontdoor | RoutingRuleProperties |
RoutingRuleProperties
Nome | Descrizione | Valore |
---|---|---|
acceptedProtocols | Schemi di protocollo che corrispondono a questa regola | Matrice di stringhe contenente uno dei seguenti elementi: 'Http' 'Https' |
enabledState | Indica se abilitare l'uso di questa regola. I valori consentiti sono 'Enabled' o 'Disabled' | 'Disabilitato' 'Enabled' |
frontendEndpoints | Endpoint front-end associati a questa regola | SubResource [] |
patternsToMatch | Modelli di route della regola. | string[] |
routeConfiguration | Riferimento alla configurazione di routing. | RouteConfiguration |
rulesEngine | Riferimento a una configurazione specifica del motore regole da applicare a questa route. | SubResource |
Sottorisorsa
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
Modelli di avvio rapido
I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.
Sagoma | Descrizione |
---|---|
Aggiungere un dominio personalizzato e un certificato personalizzato con Frontdoor |
Questo modello esegue l'onboarding e protegge un dominio personalizzato con Frontdoor con un certificato gestito dal cliente |
Aggiungere un dominio personalizzato e un certificato gestito con Frontdoor |
Questo modello esegue l'onboarding e protegge un dominio personalizzato con Frontdoor |
Configurare l'affinità di sessione per i nomi host di Frontdoor |
Questo modello aggiorna una frontdoor per abilitare l'affinità di sessione per l'host front-end, inviando così il traffico successivo dalla stessa sessione utente allo stesso back-end. |
controllare i probe di integrità per i back-end in Frontdoor |
Questo modello aggiorna frontdoor per modificare le impostazioni del probe di integrità impostando il percorso del probe e anche gli intervalli in cui verranno inviati i probe. |
Creare una frontdoor di base |
Questo modello crea una configurazione frontdoor di base con un singolo back-end. |
Creare una frontdoor con reindirizzamento DA HTTP a HTTPS |
Questo modello crea una configurazione di Frontdoor per il reindirizzamento DA HTTP a HTTPS. |
Creare una frontdoor con più back-end e pool back-end |
Questo modello crea una frontdoor con bilanciamento del carico configurato per più back-end in un pool back-end e anche tra pool back-end in base al percorso URL. |
Creare frontdoor di Azure davanti a Gestione API di Azure |
Questo esempio illustra come usare Frontdoor di Azure come servizio di bilanciamento del carico globale davanti a Gestione API di Azure. |
Creare Frontdoor con Active-Standby config |
Questo modello crea una frontdoor che illustra il routing basato sulla priorità per Active-Standby topologia dell'applicazione. |
Creare Frontdoor con memorizzazione nella cache abilitata per determinate route |
Questo modello crea una frontdoor con memorizzazione nella cache abilitata per la configurazione di routing definita, memorizzando nella cache tutti gli asset statici per il carico di lavoro. |
Definizione di risorsa Terraform (provider AzAPI)
Il tipo di risorsa frontdoor può essere distribuito con operazioni destinate a:
- gruppi di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.Network/frontDoors, aggiungere il comando Terraform seguente al modello.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Network/frontDoors@2020-01-01"
name = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
backendPools = [
{
id = "string"
name = "string"
properties = {
backends = [
{
address = "string"
backendHostHeader = "string"
enabledState = "string"
httpPort = int
httpsPort = int
priority = int
privateLinkAlias = "string"
privateLinkApprovalMessage = "string"
weight = int
}
]
healthProbeSettings = {
id = "string"
}
loadBalancingSettings = {
id = "string"
}
}
}
]
backendPoolsSettings = {
enforceCertificateNameCheck = "string"
sendRecvTimeoutSeconds = int
}
enabledState = "string"
friendlyName = "string"
frontendEndpoints = [
{
id = "string"
name = "string"
properties = {
hostName = "string"
sessionAffinityEnabledState = "string"
sessionAffinityTtlSeconds = int
webApplicationFirewallPolicyLink = {
id = "string"
}
}
}
]
healthProbeSettings = [
{
id = "string"
name = "string"
properties = {
enabledState = "string"
healthProbeMethod = "string"
intervalInSeconds = int
path = "string"
protocol = "string"
}
}
]
loadBalancingSettings = [
{
id = "string"
name = "string"
properties = {
additionalLatencyMilliseconds = int
sampleSize = int
successfulSamplesRequired = int
}
}
]
routingRules = [
{
id = "string"
name = "string"
properties = {
acceptedProtocols = [
"string"
]
enabledState = "string"
frontendEndpoints = [
{
id = "string"
}
]
patternsToMatch = [
"string"
]
routeConfiguration = {
@odata.type = "string"
// For remaining properties, see RouteConfiguration objects
}
rulesEngine = {
id = "string"
}
}
}
]
}
})
}
Oggetti RouteConfiguration
Impostare la proprietà
Per #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration, usare:
{
@odata.type = "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration"
backendPool = {
id = "string"
}
cacheConfiguration = {
cacheDuration = "string"
dynamicCompression = "string"
queryParameters = "string"
queryParameterStripDirective = "string"
}
customForwardingPath = "string"
forwardingProtocol = "string"
}
Per #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration, usare:
{
@odata.type = "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration"
customFragment = "string"
customHost = "string"
customPath = "string"
customQueryString = "string"
redirectProtocol = "string"
redirectType = "string"
}
Valori delle proprietà
Back-end
Nome | Descrizione | Valore |
---|---|---|
indirizzo | Posizione del back-end (indirizzo IP o FQDN) | corda |
backendHostHeader | Valore da usare come intestazione host inviata al back-end. Se vuoto o non specificato, il valore predefinito è l'host in ingresso. | corda |
enabledState | Indica se abilitare l'uso di questo back-end. I valori consentiti sono 'Enabled' o 'Disabled' | 'Disabilitato' 'Enabled' |
httpPort | Numero di porta TCP HTTP. Deve essere compreso tra 1 e 65535. | Int Vincoli: Valore minimo = 1 Valore massimo = 65535 |
httpsPort | Numero di porta TCP HTTPS. Deve essere compreso tra 1 e 65535. | Int Vincoli: Valore minimo = 1 Valore massimo = 65535 |
priorità | Priorità da usare per il bilanciamento del carico. Le priorità più elevate non verranno usate per il bilanciamento del carico se un back-end con priorità inferiore è integro. | Int Vincoli: Valore minimo = 1 Valore massimo = 5 |
privateLinkAlias | Alias della risorsa collegamento privato. Il popolamento di questo campo facoltativo indica che il back-end è "Privato" | corda |
privateLinkApprovalMessage | Messaggio personalizzato da includere nella richiesta di approvazione per la connessione al collegamento privato | corda |
peso | Peso di questo endpoint a scopo di bilanciamento del carico. | Int Vincoli: Valore minimo = 1 Valore massimo = 1000 |
BackendPool
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
nome | Nome risorsa. | corda |
proprietà | Proprietà del pool back-end frontdoor | |
BackendPoolProperties
Nome | Descrizione | Valore |
---|---|---|
back-end | Set di back-end per questo pool | back-end[] |
healthProbeSettings | Impostazioni del probe di integrità L7 per un pool back-end | SubResource |
loadBalancingSettings | Impostazioni di bilanciamento del carico per un pool back-end | SubResource |
BackendPoolsSettings
Nome | Descrizione | Valore |
---|---|---|
enforceCertificateNameCheck | Indica se applicare il controllo del nome del certificato alle richieste HTTPS a tutti i pool back-end. Nessun effetto sulle richieste non HTTPS. | 'Disabilitato' 'Enabled' |
sendRecvTimeoutSeconds | Inviare e ricevere il timeout sulla richiesta di inoltro al back-end. Quando viene raggiunto il timeout, la richiesta ha esito negativo e restituisce. | Int Vincoli: Valore minimo = 16 |
CacheConfiguration
Nome | Descrizione | Valore |
---|---|---|
cacheDuration | Durata per cui il contenuto deve essere memorizzato nella cache. Il formato consentito è in formato ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP richiede che il valore non sia più di un anno | corda |
dynamicCompression | Indica se usare la compressione dinamica per il contenuto memorizzato nella cache | 'Disabilitato' 'Enabled' |
queryParameters | parametri di query da includere o escludere (delimitati da virgole). | corda |
queryParameterStripDirective | Trattamento dei termini di query URL quando si forma la chiave della cache. | 'StripAll' 'StripAllExcept' 'StripNone' 'StripOnly' |
ForwardingConfiguration
Nome | Descrizione | Valore |
---|---|---|
@odata.type | '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (obbligatorio) | |
backendPool | Riferimento a BackendPool a cui viene instradata questa regola. | SubResource |
cacheConfiguration | Configurazione di memorizzazione nella cache associata a questa regola. | CacheConfiguration |
customForwardingPath | Percorso personalizzato usato per riscrivere i percorsi delle risorse corrispondenti a questa regola. Lasciare vuoto per usare il percorso in ingresso. | corda |
forwardingProtocol | Protocollo che questa regola verrà usata durante l'inoltro del traffico ai back-end. | 'HttpOnly' 'HttpsOnly' 'MatchRequest' |
FrontdoorProprietà
Nome | Descrizione | Valore |
---|---|---|
back-endPools | Pool back-end disponibili per le regole di routing. | back-endpool[] |
backendPoolsSettings | Impostazioni per tutti i pool back-end | BackendPoolsSettings |
enabledState | Stato operativo del servizio di bilanciamento del carico di Frontdoor. I valori consentiti sono 'Enabled' o 'Disabled' | 'Disabilitato' 'Enabled' |
friendlyName | Nome descrittivo per frontdoor | corda |
frontendEndpoints | Endpoint front-end disponibili per le regole di routing. | frontendEndpoint[] |
healthProbeSettings | Impostazioni del probe di integrità associate a questa istanza di Frontdoor. | HealthProbeSettingsModel[] |
loadBalancingSettings | Impostazioni di bilanciamento del carico associate a questa istanza di Frontdoor. | LoadBalancingSettingsModel[] |
routingRules | Regole di routing associate a questa frontdoor. | RoutingRule[] |
Front-endEndpoint
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
nome | Nome risorsa. | corda |
proprietà | Proprietà dell'endpoint front-end | FrontndEndpointProperties |
FrontndEndpointProperties
Nome | Descrizione | Valore |
---|---|---|
hostName | Nome host del front-endEndpoint. Deve essere un nome di dominio. | corda |
sessionAffinityEnabledState | Indica se consentire l'affinità di sessione in questo host. Le opzioni valide sono 'Enabled' o 'Disabled' | 'Disabilitato' 'Enabled' |
sessionAffinityTtlSeconds | INUTILIZZATO. Questo campo verrà ignorato. Durata (TTL) da usare in secondi per l'affinità di sessione, se applicabile. | Int |
webApplicationFirewallPolicyLink | Definisce i criteri web application firewall per ogni host (se applicabile) | FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink |
FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
HealthProbeSettingsModel
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
nome | Nome risorsa. | corda |
proprietà | Proprietà delle impostazioni del probe di integrità | HealthProbeSettingsProperties |
HealthProbeSettingsProperties
Nome | Descrizione | Valore |
---|---|---|
enabledState | Indica se abilitare i probe di integrità da eseguire su back-end definiti in back-endPools. I probe di integrità possono essere disabilitati solo se è presente un singolo back-end abilitato in un singolo pool back-end abilitato. | 'Disabilitato' 'Enabled' |
healthProbeMethod | Configura il metodo HTTP da usare per eseguire il probe dei back-end definiti in backendPools. | 'GET' 'HEAD' |
intervalInSeconds | Numero di secondi tra i probe di integrità. | Int |
sentiero | Percorso da usare per il probe di integrità. Il valore predefinito è / | corda |
protocollo | Schema di protocollo da usare per questo probe | 'Http' 'Https' |
LoadBalancingSettingsModel
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
nome | Nome risorsa. | corda |
proprietà | Proprietà delle impostazioni di bilanciamento del carico | LoadBalancingSettingsProperties |
LoadBalancingSettingsProperties
Nome | Descrizione | Valore |
---|---|---|
additionalLatencyMilliseconds | Latenza aggiuntiva in millisecondi per i probe che rientrano nel bucket di latenza più bassa | Int |
sampleSize | Numero di campioni da considerare per le decisioni di bilanciamento del carico | Int |
successfulSamplesRequired | Numero di campioni entro il periodo di campionamento che deve avere esito positivo | Int |
Microsoft.Network/frontdoors
Nome | Descrizione | Valore |
---|---|---|
ubicazione | Percorso della risorsa. | corda |
nome | Nome della risorsa | corda Vincoli: Lunghezza minima = 5 Lunghezza massima = 5 Pattern = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (obbligatorio) |
proprietà | Proprietà del servizio di bilanciamento del carico frontdoor | FrontDoorProprietà |
Tag | Tag delle risorse | Dizionario di nomi e valori di tag. |
digitare | Tipo di risorsa | "Microsoft.Network/frontDoors@2020-01-01" |
RedirectConfiguration
Nome | Descrizione | Valore |
---|---|---|
@odata.type | '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obbligatorio) | |
customFragment | Frammento da aggiungere all'URL di reindirizzamento. Fragment è la parte dell'URL che segue #. Non includere il file #. | corda |
customHost | Host da reindirizzare. Lasciare vuoto per usare l'host in ingresso come host di destinazione. | corda |
customPath | Percorso completo da reindirizzare. Il percorso non può essere vuoto e deve iniziare con /. Lasciare vuoto per usare il percorso in ingresso come percorso di destinazione. | corda |
customQueryString | Set di stringhe di query da inserire nell'URL di reindirizzamento. L'impostazione di questo valore sostituirà qualsiasi stringa di query esistente; lasciare vuoto per mantenere la stringa di query in ingresso. La stringa di query deve essere in <>chiave =<formato> valore. Prima? e & verranno aggiunti automaticamente in modo da non includerli in primo piano, ma separare più stringhe di query con &. | corda |
redirectProtocol | Protocollo della destinazione in cui viene reindirizzato il traffico | 'HttpOnly' 'HttpsOnly' 'MatchRequest' |
redirectType | Tipo di reindirizzamento che verrà usata dalla regola durante il reindirizzamento del traffico. | 'Trovato' 'Spostato' 'PermanentRedirect' 'TemporaryRedirect' |
ResourceTags
Nome | Descrizione | Valore |
---|
RouteConfiguration
Nome | Descrizione | Valore |
---|---|---|
@odata.type | Impostare su "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" per il tipo ForwardingConfiguration. Impostare su "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" per il tipo RedirectConfiguration. | '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obbligatorio) |
RoutingRule
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |
nome | Nome risorsa. | corda |
proprietà | Proprietà della regola di routing di Frontdoor | RoutingRuleProperties |
RoutingRuleProperties
Nome | Descrizione | Valore |
---|---|---|
acceptedProtocols | Schemi di protocollo che corrispondono a questa regola | Matrice di stringhe contenente uno dei seguenti elementi: 'Http' 'Https' |
enabledState | Indica se abilitare l'uso di questa regola. I valori consentiti sono 'Enabled' o 'Disabled' | 'Disabilitato' 'Enabled' |
frontendEndpoints | Endpoint front-end associati a questa regola | SubResource [] |
patternsToMatch | Modelli di route della regola. | string[] |
routeConfiguration | Riferimento alla configurazione di routing. | RouteConfiguration |
rulesEngine | Riferimento a una configurazione specifica del motore regole da applicare a questa route. | SubResource |
Sottorisorsa
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa. | corda |