Udostępnij za pośrednictwem

Microsoft.App containerApps/resiliencyPolicies 2024-10-02-preview

  • Artykuł

Definicja zasobu Bicep

Typ zasobu containerApps/resiliencyPolicies można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.App/containerApps/resiliencyPolicies, dodaj następujący kod Bicep do szablonu.

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
    }
  }
}

Wartości właściwości

Właściwości appResiliencyProperties

Nazwa Opis Wartość
circuitBreakerPolicy Zasady definiujące warunki wyłącznika CircuitBreakerPolicy
httpConnectionPool Definiuje parametry buforowania połączeń HTTP HttpConnectionPool
httpRetryPolicy Zasady definiujące warunki ponawiania żądania HTTP HttpRetryPolicy
tcpConnectionPool Definiuje parametry buforowania połączeń tcp TcpConnectionPool
tcpRetryPolicy Zasady definiujące warunki ponawiania żądań tcp TcpRetryPolicy
timeoutPolicy Zasady ustawiania limitów czasu żądania timeoutPolicy

CircuitBreakerPolicy

Nazwa Opis Wartość
consecutiveErrors Liczba kolejnych błędów przed otwarciem wyłącznika Int
intervalInSeconds Interwał czasu (w sekundach) między sprawdzaniem punktu końcowego. Może to spowodować otwarcie wyłącznika, jeśli sprawdzanie zakończy się niepowodzeniem, a także zamknięcie wyłącznika, jeśli sprawdzanie powiedzie się. Wartość domyślna to 10s. Int
maxEjectionPercent Maksymalny procent hostów, które zostaną wyrzucone po osiągnięciu progu awarii Int

NagłówekMatch

Nazwa Opis Wartość
nagłówek Nazwa nagłówka struna
zapałka Typ dopasowania do wykonania HeaderMatch

HeaderMatchMatchMatch

Nazwa Opis Wartość
exactMatch Dokładna wartość nagłówka struna
prefiksMatch Wartość prefiksu nagłówka struna
regexMatch Wartość wyrażenia regularnego nagłówka struna
sufiksMatch Wartość sufiksu nagłówka struna

HttpConnectionPool

Nazwa Opis Wartość
http1MaxPendingRequests Maksymalna dozwolona liczba oczekujących żądań http1 Int
http2MaxRequests Dozwolona maksymalna liczba żądań http2 Int

HttpRetryPolicy

Nazwa Opis Wartość
Pasuje Warunki, które muszą zostać spełnione, aby żądanie było ponawiane HttpRetryPolicyMatches
maxRetries Maksymalna liczba ponownych prób żądania Int
retryBackOff Ustawienia właściwości wycofywania ponawiania prób HttpRetryPolicyRetryBackOff

HttpRetryPolicyMatches

Nazwa Opis Wartość
Błędy Błędy, które mogą wyzwalać ponowienie próby string[]
Nagłówki Nagłówki, które muszą być obecne, aby żądanie było ponawiane HeaderMatch[]
httpStatusCodes Dodatkowe kody stanu http, które mogą wyzwalać ponowienie próby int[]

HttpRetryPolicyRetryBackOff

Nazwa Opis Wartość
initialDelayInMilliseconds Początkowe opóźnienie(w milisekundach) przed ponowieniu próby żądania Int
maxIntervalInMilliseconds Maksymalny interwał (w milisekundach) między ponownymi próbami Int

Microsoft.App/containerApps/resiliencyPolicies

Nazwa Opis Wartość
nazwa Nazwa zasobu struna

Ograniczenia:
Wzorzec = ^[-\w\._\(\)]+$ (wymagane)
rodzic W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.		 Nazwa symboliczna zasobu typu: containerApps
Właściwości Właściwości specyficzne dla zasobu odporności aplikacji AppResiliencyProperties

TcpConnectionPool

Nazwa Opis Wartość
maxConnections Maksymalna dozwolona liczba połączeń tcp Int

TcpRetryPolicy

Nazwa Opis Wartość
maxConnectAttempts Maksymalna liczba prób nawiązania połączenia z usługą tcp Int

Limit czasuPolicy

Nazwa Opis Wartość
connectionTimeoutInSeconds Limit czasu w sekundach dla żądania zainicjowania połączenia Int
responseTimeoutInSeconds Limit czasu w sekundach dla żądania odpowiedzi Int

Definicja zasobu szablonu usługi ARM

Typ zasobu containerApps/resiliencyPolicies można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.App/containerApps/resiliencyPolicies, dodaj następujący kod JSON do szablonu.

{
  "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"
    }
  }
}

Wartości właściwości

Właściwości appResiliencyProperties

Nazwa Opis Wartość
circuitBreakerPolicy Zasady definiujące warunki wyłącznika CircuitBreakerPolicy
httpConnectionPool Definiuje parametry buforowania połączeń HTTP HttpConnectionPool
httpRetryPolicy Zasady definiujące warunki ponawiania żądania HTTP HttpRetryPolicy
tcpConnectionPool Definiuje parametry buforowania połączeń tcp TcpConnectionPool
tcpRetryPolicy Zasady definiujące warunki ponawiania żądań tcp TcpRetryPolicy
timeoutPolicy Zasady ustawiania limitów czasu żądania timeoutPolicy

CircuitBreakerPolicy

Nazwa Opis Wartość
consecutiveErrors Liczba kolejnych błędów przed otwarciem wyłącznika Int
intervalInSeconds Interwał czasu (w sekundach) między sprawdzaniem punktu końcowego. Może to spowodować otwarcie wyłącznika, jeśli sprawdzanie zakończy się niepowodzeniem, a także zamknięcie wyłącznika, jeśli sprawdzanie powiedzie się. Wartość domyślna to 10s. Int
maxEjectionPercent Maksymalny procent hostów, które zostaną wyrzucone po osiągnięciu progu awarii Int

NagłówekMatch

Nazwa Opis Wartość
nagłówek Nazwa nagłówka struna
zapałka Typ dopasowania do wykonania HeaderMatch

HeaderMatchMatchMatch

Nazwa Opis Wartość
exactMatch Dokładna wartość nagłówka struna
prefiksMatch Wartość prefiksu nagłówka struna
regexMatch Wartość wyrażenia regularnego nagłówka struna
sufiksMatch Wartość sufiksu nagłówka struna

HttpConnectionPool

Nazwa Opis Wartość
http1MaxPendingRequests Maksymalna dozwolona liczba oczekujących żądań http1 Int
http2MaxRequests Dozwolona maksymalna liczba żądań http2 Int

HttpRetryPolicy

Nazwa Opis Wartość
Pasuje Warunki, które muszą zostać spełnione, aby żądanie było ponawiane HttpRetryPolicyMatches
maxRetries Maksymalna liczba ponownych prób żądania Int
retryBackOff Ustawienia właściwości wycofywania ponawiania prób HttpRetryPolicyRetryBackOff

HttpRetryPolicyMatches

Nazwa Opis Wartość
Błędy Błędy, które mogą wyzwalać ponowienie próby string[]
Nagłówki Nagłówki, które muszą być obecne, aby żądanie było ponawiane HeaderMatch[]
httpStatusCodes Dodatkowe kody stanu http, które mogą wyzwalać ponowienie próby int[]

HttpRetryPolicyRetryBackOff

Nazwa Opis Wartość
initialDelayInMilliseconds Początkowe opóźnienie(w milisekundach) przed ponowieniu próby żądania Int
maxIntervalInMilliseconds Maksymalny interwał (w milisekundach) między ponownymi próbami Int

Microsoft.App/containerApps/resiliencyPolicies

Nazwa Opis Wartość
apiVersion Wersja interfejsu API "2024-10-02-preview"
nazwa Nazwa zasobu struna

Ograniczenia:
Wzorzec = ^[-\w\._\(\)]+$ (wymagane)
Właściwości Właściwości specyficzne dla zasobu odporności aplikacji AppResiliencyProperties
typ Typ zasobu "Microsoft.App/containerApps/resiliencyPolicies"

TcpConnectionPool

Nazwa Opis Wartość
maxConnections Maksymalna dozwolona liczba połączeń tcp Int

TcpRetryPolicy

Nazwa Opis Wartość
maxConnectAttempts Maksymalna liczba prób nawiązania połączenia z usługą tcp Int

Limit czasuPolicy

Nazwa Opis Wartość
connectionTimeoutInSeconds Limit czasu w sekundach dla żądania zainicjowania połączenia Int
responseTimeoutInSeconds Limit czasu w sekundach dla żądania odpowiedzi Int

Przykłady użycia

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu containerApps/resiliencyPolicies można wdrożyć przy użyciu operacji docelowych:

  • grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.App/containerApps/resiliencyPolicies, dodaj następujący program Terraform do szablonu.

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
      }
    }
  })
}

Wartości właściwości

Właściwości appResiliencyProperties

Nazwa Opis Wartość
circuitBreakerPolicy Zasady definiujące warunki wyłącznika CircuitBreakerPolicy
httpConnectionPool Definiuje parametry buforowania połączeń HTTP HttpConnectionPool
httpRetryPolicy Zasady definiujące warunki ponawiania żądania HTTP HttpRetryPolicy
tcpConnectionPool Definiuje parametry buforowania połączeń tcp TcpConnectionPool
tcpRetryPolicy Zasady definiujące warunki ponawiania żądań tcp TcpRetryPolicy
timeoutPolicy Zasady ustawiania limitów czasu żądania timeoutPolicy

CircuitBreakerPolicy

Nazwa Opis Wartość
consecutiveErrors Liczba kolejnych błędów przed otwarciem wyłącznika Int
intervalInSeconds Interwał czasu (w sekundach) między sprawdzaniem punktu końcowego. Może to spowodować otwarcie wyłącznika, jeśli sprawdzanie zakończy się niepowodzeniem, a także zamknięcie wyłącznika, jeśli sprawdzanie powiedzie się. Wartość domyślna to 10s. Int
maxEjectionPercent Maksymalny procent hostów, które zostaną wyrzucone po osiągnięciu progu awarii Int

NagłówekMatch

Nazwa Opis Wartość
nagłówek Nazwa nagłówka struna
zapałka Typ dopasowania do wykonania HeaderMatch

HeaderMatchMatchMatch

Nazwa Opis Wartość
exactMatch Dokładna wartość nagłówka struna
prefiksMatch Wartość prefiksu nagłówka struna
regexMatch Wartość wyrażenia regularnego nagłówka struna
sufiksMatch Wartość sufiksu nagłówka struna

HttpConnectionPool

Nazwa Opis Wartość
http1MaxPendingRequests Maksymalna dozwolona liczba oczekujących żądań http1 Int
http2MaxRequests Dozwolona maksymalna liczba żądań http2 Int

HttpRetryPolicy

Nazwa Opis Wartość
Pasuje Warunki, które muszą zostać spełnione, aby żądanie było ponawiane HttpRetryPolicyMatches
maxRetries Maksymalna liczba ponownych prób żądania Int
retryBackOff Ustawienia właściwości wycofywania ponawiania prób HttpRetryPolicyRetryBackOff

HttpRetryPolicyMatches

Nazwa Opis Wartość
Błędy Błędy, które mogą wyzwalać ponowienie próby string[]
Nagłówki Nagłówki, które muszą być obecne, aby żądanie było ponawiane HeaderMatch[]
httpStatusCodes Dodatkowe kody stanu http, które mogą wyzwalać ponowienie próby int[]

HttpRetryPolicyRetryBackOff

Nazwa Opis Wartość
initialDelayInMilliseconds Początkowe opóźnienie(w milisekundach) przed ponowieniu próby żądania Int
maxIntervalInMilliseconds Maksymalny interwał (w milisekundach) między ponownymi próbami Int

Microsoft.App/containerApps/resiliencyPolicies

Nazwa Opis Wartość
nazwa Nazwa zasobu struna

Ograniczenia:
Wzorzec = ^[-\w\._\(\)]+$ (wymagane)
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: containerApps
Właściwości Właściwości specyficzne dla zasobu odporności aplikacji AppResiliencyProperties
typ Typ zasobu "Microsoft.App/containerApps/resiliencyPolicies@2024-10-02-preview"

TcpConnectionPool

Nazwa Opis Wartość
maxConnections Maksymalna dozwolona liczba połączeń tcp Int

TcpRetryPolicy

Nazwa Opis Wartość
maxConnectAttempts Maksymalna liczba prób nawiązania połączenia z usługą tcp Int

Limit czasuPolicy

Nazwa Opis Wartość
connectionTimeoutInSeconds Limit czasu w sekundach dla żądania zainicjowania połączenia Int
responseTimeoutInSeconds Limit czasu w sekundach dla żądania odpowiedzi Int