Condividi tramite

Microsoft.App contenitoreApps/resiliencyPolicies

  • Articolo

Definizione di risorsa Bicep

Il tipo di risorsa containerApps/resiliencyPolicies può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.App/containerApps/resiliencyPolicies, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.App/containerApps/resiliencyPolicies@2024-10-02-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    circuitBreakerPolicy: {
      consecutiveErrors: int
      intervalInSeconds: int
      maxEjectionPercent: int
    }
    httpConnectionPool: {
      http1MaxPendingRequests: int
      http2MaxRequests: int
    }
    httpRetryPolicy: {
      matches: {
        errors: [
          'string'
        ]
        headers: [
          {
            header: 'string'
            match: {
              exactMatch: 'string'
              prefixMatch: 'string'
              regexMatch: 'string'
              suffixMatch: 'string'
            }
          }
        ]
        httpStatusCodes: [
          int
        ]
      }
      maxRetries: int
      retryBackOff: {
        initialDelayInMilliseconds: int
        maxIntervalInMilliseconds: int
      }
    }
    tcpConnectionPool: {
      maxConnections: int
    }
    tcpRetryPolicy: {
      maxConnectAttempts: int
    }
    timeoutPolicy: {
      connectionTimeoutInSeconds: int
      responseTimeoutInSeconds: int
    }
  }
}

Valori delle proprietà

AppResiliencyProperties

Nome Descrizione Valore
circuitBreakerPolicy Criteri che definiscono le condizioni dell'interruttore CircuitBreakerPolicy
httpConnectionPool Definisce i parametri per il pool di connessioni HTTP HttpConnectionPool
httpRetryPolicy Criteri che definiscono le condizioni di ripetizione dei tentativi di richiesta HTTP HttpRetryPolicy
tcpConnectionPool Definisce i parametri per il pool di connessioni TCP TcpConnectionPool
tcpRetryPolicy Criteri che definiscono le condizioni di ripetizione delle richieste TCP TcpRetryPolicy
timeoutPolicy Criteri per impostare i timeout delle richieste TimeoutPolicy

CircuitBreakerPolicy

Nome Descrizione Valore
consecutiveErrors Numero di errori consecutivi prima dell'apertura dell'interruttore Int
intervalInSeconds Intervallo di tempo, espresso in secondi, tra i controlli dell'endpoint. Ciò può comportare l'apertura dell'interruttore se il controllo ha esito negativo e la chiusura dell'interruttore se il controllo ha esito positivo. Il valore predefinito è 10s. Int
maxEjectionPercent Percentuale massima di host che verranno espulsi dopo che è stata raggiunta la soglia di errore Int

HeaderMatch

Nome Descrizione Valore
intestazione Nome dell'intestazione corda
fiammifero Tipo di corrispondenza da eseguire HeaderMatchMatch

HeaderMatchMatch

Nome Descrizione Valore
exactMatch Valore esatto dell'intestazione corda
prefixMatch Valore prefisso dell'intestazione corda
regexMatch Valore regex dell'intestazione corda
suffissoMatch Valore del suffisso dell'intestazione corda

HttpConnectionPool

Nome Descrizione Valore
http1MaxPendingRequests Numero massimo di richieste HTTP1 in sospeso consentite Int
http2MaxRequests Numero massimo di richieste http2 consentite Int

HttpRetryPolicy

Nome Descrizione Valore
Corrisponde Condizioni che devono essere soddisfatte affinché una richiesta venga ritentata HttpRetryPolicyMatches
maxRetries Numero massimo di tentativi di ripetizione di una richiesta Int
retryBackOff Impostazioni per le caratteristiche di backoff di ripetizione dei tentativi HttpRetryPolicyRetryBackOff

HttpRetryPolicyMatches

Nome Descrizione Valore
errori Errori che possono attivare un nuovo tentativo string[]
Intestazioni Intestazioni che devono essere presenti per una richiesta da ritentare HeaderMatch[]
httpStatusCodes Codici di stato HTTP aggiuntivi che possono attivare un nuovo tentativo int[]

HttpRetryPolicyRetryBackOff

Nome Descrizione Valore
initialDelayInMilliseconds Ritardo iniziale, in millisecondi, prima di ripetere una richiesta Int
maxIntervalInMilliseconds Intervallo massimo, espresso in millisecondi, tra tentativi Int

Microsoft.App/containerApps/resiliencyPolicies

Nome Descrizione Valore
nome Nome della risorsa corda

Vincoli:
Pattern = ^[-\w\._\(\)]+$ (obbligatorio)
genitore In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.		 Nome simbolico per la risorsa di tipo: containerApps
proprietà Proprietà specifiche delle risorse con resilienza delle app AppResiliencyProperties

TcpConnectionPool

Nome Descrizione Valore
maxConnections Numero massimo di connessioni TCP consentite Int

TcpRetryPolicy

Nome Descrizione Valore
maxConnectAttempts Numero massimo di tentativi di connessione al servizio TCP Int

TimeoutPolicy

Nome Descrizione Valore
connectionTimeoutInSeconds Timeout, in secondi, affinché una richiesta avvii una connessione Int
responseTimeoutInSeconds Timeout, in secondi, per una richiesta di risposta Int

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa containerApps/resiliencyPolicies può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.App/containerApps/resiliencyPolicies, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.App/containerApps/resiliencyPolicies",
  "apiVersion": "2024-10-02-preview",
  "name": "string",
  "properties": {
    "circuitBreakerPolicy": {
      "consecutiveErrors": "int",
      "intervalInSeconds": "int",
      "maxEjectionPercent": "int"
    },
    "httpConnectionPool": {
      "http1MaxPendingRequests": "int",
      "http2MaxRequests": "int"
    },
    "httpRetryPolicy": {
      "matches": {
        "errors": [ "string" ],
        "headers": [
          {
            "header": "string",
            "match": {
              "exactMatch": "string",
              "prefixMatch": "string",
              "regexMatch": "string",
              "suffixMatch": "string"
            }
          }
        ],
        "httpStatusCodes": [ "int" ]
      },
      "maxRetries": "int",
      "retryBackOff": {
        "initialDelayInMilliseconds": "int",
        "maxIntervalInMilliseconds": "int"
      }
    },
    "tcpConnectionPool": {
      "maxConnections": "int"
    },
    "tcpRetryPolicy": {
      "maxConnectAttempts": "int"
    },
    "timeoutPolicy": {
      "connectionTimeoutInSeconds": "int",
      "responseTimeoutInSeconds": "int"
    }
  }
}

Valori delle proprietà

AppResiliencyProperties

Nome Descrizione Valore
circuitBreakerPolicy Criteri che definiscono le condizioni dell'interruttore CircuitBreakerPolicy
httpConnectionPool Definisce i parametri per il pool di connessioni HTTP HttpConnectionPool
httpRetryPolicy Criteri che definiscono le condizioni di ripetizione dei tentativi di richiesta HTTP HttpRetryPolicy
tcpConnectionPool Definisce i parametri per il pool di connessioni TCP TcpConnectionPool
tcpRetryPolicy Criteri che definiscono le condizioni di ripetizione delle richieste TCP TcpRetryPolicy
timeoutPolicy Criteri per impostare i timeout delle richieste TimeoutPolicy

CircuitBreakerPolicy

Nome Descrizione Valore
consecutiveErrors Numero di errori consecutivi prima dell'apertura dell'interruttore Int
intervalInSeconds Intervallo di tempo, espresso in secondi, tra i controlli dell'endpoint. Ciò può comportare l'apertura dell'interruttore se il controllo ha esito negativo e la chiusura dell'interruttore se il controllo ha esito positivo. Il valore predefinito è 10s. Int
maxEjectionPercent Percentuale massima di host che verranno espulsi dopo che è stata raggiunta la soglia di errore Int

HeaderMatch

Nome Descrizione Valore
intestazione Nome dell'intestazione corda
fiammifero Tipo di corrispondenza da eseguire HeaderMatchMatch

HeaderMatchMatch

Nome Descrizione Valore
exactMatch Valore esatto dell'intestazione corda
prefixMatch Valore prefisso dell'intestazione corda
regexMatch Valore regex dell'intestazione corda
suffissoMatch Valore del suffisso dell'intestazione corda

HttpConnectionPool

Nome Descrizione Valore
http1MaxPendingRequests Numero massimo di richieste HTTP1 in sospeso consentite Int
http2MaxRequests Numero massimo di richieste http2 consentite Int

HttpRetryPolicy

Nome Descrizione Valore
Corrisponde Condizioni che devono essere soddisfatte affinché una richiesta venga ritentata HttpRetryPolicyMatches
maxRetries Numero massimo di tentativi di ripetizione di una richiesta Int
retryBackOff Impostazioni per le caratteristiche di backoff di ripetizione dei tentativi HttpRetryPolicyRetryBackOff

HttpRetryPolicyMatches

Nome Descrizione Valore
errori Errori che possono attivare un nuovo tentativo string[]
Intestazioni Intestazioni che devono essere presenti per una richiesta da ritentare HeaderMatch[]
httpStatusCodes Codici di stato HTTP aggiuntivi che possono attivare un nuovo tentativo int[]

HttpRetryPolicyRetryBackOff

Nome Descrizione Valore
initialDelayInMilliseconds Ritardo iniziale, in millisecondi, prima di ripetere una richiesta Int
maxIntervalInMilliseconds Intervallo massimo, espresso in millisecondi, tra tentativi Int

Microsoft.App/containerApps/resiliencyPolicies

Nome Descrizione Valore
apiVersion Versione dell'API '2024-10-02-preview'
nome Nome della risorsa corda

Vincoli:
Pattern = ^[-\w\._\(\)]+$ (obbligatorio)
proprietà Proprietà specifiche delle risorse con resilienza delle app AppResiliencyProperties
digitare Tipo di risorsa 'Microsoft.App/containerApps/resiliencyPolicies'

TcpConnectionPool

Nome Descrizione Valore
maxConnections Numero massimo di connessioni TCP consentite Int

TcpRetryPolicy

Nome Descrizione Valore
maxConnectAttempts Numero massimo di tentativi di connessione al servizio TCP Int

TimeoutPolicy

Nome Descrizione Valore
connectionTimeoutInSeconds Timeout, in secondi, affinché una richiesta avvii una connessione Int
responseTimeoutInSeconds Timeout, in secondi, per una richiesta di risposta Int

Esempi di utilizzo

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa containerApps/resiliencyPolicies 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.App/containerApps/resiliencyPolicies, aggiungere il modello terraform seguente.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.App/containerApps/resiliencyPolicies@2024-10-02-preview"
  name = "string"
  body = jsonencode({
    properties = {
      circuitBreakerPolicy = {
        consecutiveErrors = int
        intervalInSeconds = int
        maxEjectionPercent = int
      }
      httpConnectionPool = {
        http1MaxPendingRequests = int
        http2MaxRequests = int
      }
      httpRetryPolicy = {
        matches = {
          errors = [
            "string"
          ]
          headers = [
            {
              header = "string"
              match = {
                exactMatch = "string"
                prefixMatch = "string"
                regexMatch = "string"
                suffixMatch = "string"
              }
            }
          ]
          httpStatusCodes = [
            int
          ]
        }
        maxRetries = int
        retryBackOff = {
          initialDelayInMilliseconds = int
          maxIntervalInMilliseconds = int
        }
      }
      tcpConnectionPool = {
        maxConnections = int
      }
      tcpRetryPolicy = {
        maxConnectAttempts = int
      }
      timeoutPolicy = {
        connectionTimeoutInSeconds = int
        responseTimeoutInSeconds = int
      }
    }
  })
}

Valori delle proprietà

AppResiliencyProperties

Nome Descrizione Valore
circuitBreakerPolicy Criteri che definiscono le condizioni dell'interruttore CircuitBreakerPolicy
httpConnectionPool Definisce i parametri per il pool di connessioni HTTP HttpConnectionPool
httpRetryPolicy Criteri che definiscono le condizioni di ripetizione dei tentativi di richiesta HTTP HttpRetryPolicy
tcpConnectionPool Definisce i parametri per il pool di connessioni TCP TcpConnectionPool
tcpRetryPolicy Criteri che definiscono le condizioni di ripetizione delle richieste TCP TcpRetryPolicy
timeoutPolicy Criteri per impostare i timeout delle richieste TimeoutPolicy

CircuitBreakerPolicy

Nome Descrizione Valore
consecutiveErrors Numero di errori consecutivi prima dell'apertura dell'interruttore Int
intervalInSeconds Intervallo di tempo, espresso in secondi, tra i controlli dell'endpoint. Ciò può comportare l'apertura dell'interruttore se il controllo ha esito negativo e la chiusura dell'interruttore se il controllo ha esito positivo. Il valore predefinito è 10s. Int
maxEjectionPercent Percentuale massima di host che verranno espulsi dopo che è stata raggiunta la soglia di errore Int

HeaderMatch

Nome Descrizione Valore
intestazione Nome dell'intestazione corda
fiammifero Tipo di corrispondenza da eseguire HeaderMatchMatch

HeaderMatchMatch

Nome Descrizione Valore
exactMatch Valore esatto dell'intestazione corda
prefixMatch Valore prefisso dell'intestazione corda
regexMatch Valore regex dell'intestazione corda
suffissoMatch Valore del suffisso dell'intestazione corda

HttpConnectionPool

Nome Descrizione Valore
http1MaxPendingRequests Numero massimo di richieste HTTP1 in sospeso consentite Int
http2MaxRequests Numero massimo di richieste http2 consentite Int

HttpRetryPolicy

Nome Descrizione Valore
Corrisponde Condizioni che devono essere soddisfatte affinché una richiesta venga ritentata HttpRetryPolicyMatches
maxRetries Numero massimo di tentativi di ripetizione di una richiesta Int
retryBackOff Impostazioni per le caratteristiche di backoff di ripetizione dei tentativi HttpRetryPolicyRetryBackOff

HttpRetryPolicyMatches

Nome Descrizione Valore
errori Errori che possono attivare un nuovo tentativo string[]
Intestazioni Intestazioni che devono essere presenti per una richiesta da ritentare HeaderMatch[]
httpStatusCodes Codici di stato HTTP aggiuntivi che possono attivare un nuovo tentativo int[]

HttpRetryPolicyRetryBackOff

Nome Descrizione Valore
initialDelayInMilliseconds Ritardo iniziale, in millisecondi, prima di ripetere una richiesta Int
maxIntervalInMilliseconds Intervallo massimo, espresso in millisecondi, tra tentativi Int

Microsoft.App/containerApps/resiliencyPolicies

Nome Descrizione Valore
nome Nome della risorsa corda

Vincoli:
Pattern = ^[-\w\._\(\)]+$ (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: containerApp
proprietà Proprietà specifiche delle risorse con resilienza delle app AppResiliencyProperties
digitare Tipo di risorsa "Microsoft.App/containerApps/resiliencyPolicies@2024-10-02-preview"

TcpConnectionPool

Nome Descrizione Valore
maxConnections Numero massimo di connessioni TCP consentite Int

TcpRetryPolicy

Nome Descrizione Valore
maxConnectAttempts Numero massimo di tentativi di connessione al servizio TCP Int

TimeoutPolicy

Nome Descrizione Valore
connectionTimeoutInSeconds Timeout, in secondi, affinché una richiesta avvii una connessione Int
responseTimeoutInSeconds Timeout, in secondi, per una richiesta di risposta Int