Udostępnij za pośrednictwem


Microsoft.Insights webtests 2020-10-05-preview

Definicja zasobu Bicep

Typ zasobu webtests można wdrożyć z operacjami docelowymi:

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

Format zasobu

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

resource symbolicname 'Microsoft.Insights/webtests@2020-10-05-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  kind: 'string'
  properties: {
    Configuration: {
      WebTest: 'string'
    }
    Description: 'string'
    Enabled: bool
    Frequency: int
    Kind: 'string'
    Locations: [
      {
        Id: 'string'
      }
    ]
    Name: 'string'
    Request: {
      FollowRedirects: bool
      Headers: [
        {
          key: 'string'
          value: 'string'
        }
      ]
      HttpVerb: 'string'
      ParseDependentRequests: bool
      RequestBody: 'string'
      RequestUrl: 'string'
    }
    RetryEnabled: bool
    SyntheticMonitorId: 'string'
    Timeout: int
    ValidationRules: {
      ContentValidation: {
        ContentMatch: 'string'
        IgnoreCase: bool
        PassIfTextFound: bool
      }
      ExpectedHttpStatusCode: int
      IgnoreHttpsStatusCode: bool
      SSLCertRemainingLifetimeCheck: int
      SSLCheck: bool
    }
  }
}

Wartości właściwości

webtests

Nazwa Opis Wartość
name Nazwa zasobu ciąg (wymagany)
location Lokalizacja zasobu ciąg (wymagany)
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
Rodzaju Rodzaj testu internetowego, który sprawdza ten test internetowy. Opcje są ping i wieloetapowe. "wieloetapowy"
"ping"
properties Metadane opisujące test internetowy dla zasobu platformy Azure. Właściwości WebTestProperties

Właściwości WebTestProperties

Nazwa Opis Wartość
Konfigurowanie Specyfikacja konfiguracji XML dla webtestu. WebTestPropertiesConfiguration
Opis Opis zdefiniowany przez użytkownika dla tego testu sieci Web. ciąg
Enabled (Włączony) Czy test jest aktywnie monitorowany. bool
Częstotliwość Interwał w sekundach między przebiegami testów dla tego testu sieci Web. Wartość domyślna to 300. int
Rodzaj Rodzaj testu internetowego to prawidłowe opcje to ping, wieloetapowe, podstawowe i standardowe. "basic"
"wieloetapowy"
"ping"
"Standardowa" (wymagana)
Lokalizacje Lista miejsc, z których należy fizycznie uruchamiać testy w celu zapewnienia globalnego pokrycia ułatwień dostępu aplikacji. WebTestGeolocation[] (wymagane)
Nazwa Nazwa zdefiniowana przez użytkownika, jeśli ten test sieci Web. ciąg (wymagany)
Żądanie Kolekcja właściwości żądania WebTestPropertiesRequest
Ponów próbęWłąd Zezwalaj na ponawianie prób, jeśli ten test sieci Web nie powiedzie się. bool
SyntheticMonitorId Unikatowy identyfikator tego testu internetowego. Zazwyczaj jest to ta sama wartość co pole Nazwa. ciąg (wymagany)
Limit czasu Sekundy do czasu przekroczenia limitu czasu i niepowodzenia tego testu internetowego. Wartość domyślna to 30. int
Validationrules Kolekcja właściwości reguły walidacji WebTestPropertiesValidationRules

WebTestPropertiesConfiguration

Nazwa Opis Wartość
Webtest Specyfikacja XML testu internetowego do uruchamiania względem aplikacji. ciąg

WebTestGeolocation

Nazwa Opis Wartość
Id Identyfikator lokalizacji dla testu internetowego do uruchomienia. ciąg

WebTestPropertiesRequest

Nazwa Opis Wartość
ŚledźRedirects Postępuj zgodnie z przekierowaniami dla tego testu internetowego. bool
Nagłówki Lista nagłówków i ich wartości do dodania do wywołania WebTest. HeaderField[]
HttpVerb Czasownik HTTP do użycia na potrzeby tego testu internetowego. ciąg
ParseDependentRequests Przeanalizuj zależne żądanie dla tego testu sieci Web. bool
RequestBody Treść ciągów zakodowanych w formacie Base64 do wysłania za pomocą tego testu internetowego. ciąg
RequestUrl Lokalizacja adresu URL do przetestowania. ciąg

Pole nagłówka

Nazwa Opis Wartość
key Nazwa nagłówka. ciąg
wartość Wartość nagłówka. ciąg

WebTestPropertiesValidationRules

Nazwa Opis Wartość
ContentValidation Kolekcja właściwości weryfikacji zawartości WebTestPropertiesValidationRulesContentValidation
ExpectedHttpStatusCode Sprawdź, czy test internetowy zwraca podany kod stanu HTTP. int
IgnoreHttpsStatusCode Po ustawieniu walidacja zignoruje kod stanu. bool
SSLCertRemainingLifetimeCheck Liczba dni, przez które należy sprawdzić, pozostaje nadal przed wygaśnięciem istniejącego certyfikatu SSL. Wartość musi być dodatnia, a pole SSLCheck musi mieć wartość true. int
Sprawdzanie protokołu SSL Sprawdza, czy certyfikat SSL jest nadal prawidłowy. bool

WebTestPropertiesValidationRulesContentValidation

Nazwa Opis Wartość
ContentMatch Zawartość do wyszukania w zamian testu internetowego. Nie może być zerowa ani pusta. ciąg
IgnoreCase Po ustawieniu ta wartość powoduje, że wielkość liter walidacji ContentMatch jest niewrażliwa. bool
PassIfTextFound W przypadku wartości true walidacja zakończy się powodzeniem, jeśli istnieje dopasowanie ciągu ContentMatch. Jeśli wartość false, walidacja zakończy się niepowodzeniem, jeśli istnieje dopasowanie bool

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Dynamiczne tworzenie testu sieci Web

Wdróż na platformie Azure
Utwórz dowolną liczbę testów internetowych usługi App Insights (ping).
Reguła alertu dotyczącego metryk dla testu dostępności

Wdróż na platformie Azure
Ten szablon tworzy test dostępności usługi Application Insights wraz z regułą alertu metryki, która go monitoruje.

Definicja zasobu szablonu usługi ARM

Typ zasobu webtests można wdrożyć z operacjami docelowymi:

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

Format zasobu

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

{
  "type": "Microsoft.Insights/webtests",
  "apiVersion": "2020-10-05-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "kind": "string",
  "properties": {
    "Configuration": {
      "WebTest": "string"
    },
    "Description": "string",
    "Enabled": "bool",
    "Frequency": "int",
    "Kind": "string",
    "Locations": [
      {
        "Id": "string"
      }
    ],
    "Name": "string",
    "Request": {
      "FollowRedirects": "bool",
      "Headers": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "HttpVerb": "string",
      "ParseDependentRequests": "bool",
      "RequestBody": "string",
      "RequestUrl": "string"
    },
    "RetryEnabled": "bool",
    "SyntheticMonitorId": "string",
    "Timeout": "int",
    "ValidationRules": {
      "ContentValidation": {
        "ContentMatch": "string",
        "IgnoreCase": "bool",
        "PassIfTextFound": "bool"
      },
      "ExpectedHttpStatusCode": "int",
      "IgnoreHttpsStatusCode": "bool",
      "SSLCertRemainingLifetimeCheck": "int",
      "SSLCheck": "bool"
    }
  }
}

Wartości właściwości

webtests

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Insights/webtests"
apiVersion Wersja interfejsu API zasobów "2020-10-05-preview"
name Nazwa zasobu ciąg (wymagany)
location Lokalizacja zasobu ciąg (wymagany)
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
Rodzaju Rodzaj testu sieci Web, który sprawdza ten test internetowy. Opcje to polecenie ping i wielokrok. "multistep"
"ping"
properties Metadane opisujące test internetowy dla zasobu platformy Azure. WebTestProperties

WebTestProperties

Nazwa Opis Wartość
Konfigurowanie Specyfikacja konfiguracji XML dla webtestu. WebTestPropertiesConfiguration
Opis Opis zdefiniowany przez użytkownika dla tego testu sieci Web. ciąg
Enabled (Włączony) Czy test jest aktywnie monitorowany. bool
Częstotliwość Interwał w sekundach między przebiegami testów dla tego testu WebTest. Wartość domyślna to 300. int
Rodzaj Rodzaj testu internetowego jest taki, że prawidłowe opcje to ping, wieloetapowe, podstawowe i standardowe. "basic"
"multistep"
"ping"
"standard" (wymagany)
Lokalizacje Lista miejsc, z których należy fizycznie uruchamiać testy, aby zapewnić globalne pokrycie ułatwień dostępu aplikacji. WebTestGeolocation[] (wymagane)
Nazwa Nazwa zdefiniowana przez użytkownika, jeśli ten webtest. ciąg (wymagany)
Żądanie Kolekcja właściwości żądania WebTestPropertiesRequest
Ponów próbęEnabled Zezwalaj na ponawianie prób, jeśli ten test sieci Web nie powiedzie się. bool
SyntetycznyMonitorId Unikatowy identyfikator tego testu sieci Web. Zazwyczaj jest to ta sama wartość co pole Nazwa. ciąg (wymagany)
Limit czasu Sekundy do czasu przekroczenia limitu czasu i niepowodzenia testu sieci Web. Wartość domyślna to 30. int
Validationrules Kolekcja właściwości reguły walidacji WebTestPropertiesValidationRules

WebTestPropertiesConfiguration

Nazwa Opis Wartość
Webtest Specyfikacja XML narzędzia WebTest do uruchamiania względem aplikacji. ciąg

WebTestGeolocation

Nazwa Opis Wartość
Id Identyfikator lokalizacji narzędzia WebTest do uruchomienia. ciąg

WebTestPropertiesRequest

Nazwa Opis Wartość
FollowRedirects Postępuj zgodnie z przekierowaniami dla tego testu internetowego. bool
Nagłówki Lista nagłówków i ich wartości do dodania do wywołania WebTest. HeaderField[]
HttpVerb Czasownik http do użycia na potrzeby tego testu internetowego. ciąg
ParseDependentRequests Przeanalizuj żądanie zależne dla tego testu sieci Web. bool
RequestBody Treść ciągów zakodowanych w formacie Base64 do wysłania za pomocą tego testu internetowego. ciąg
RequestUrl Lokalizacja adresu URL do przetestowania. ciąg

HeaderField

Nazwa Opis Wartość
key Nazwa nagłówka. ciąg
wartość Wartość nagłówka. ciąg

WebTestPropertiesValidationRules

Nazwa Opis Wartość
ContentValidation Kolekcja właściwości weryfikacji zawartości WebTestPropertiesValidationRulesContentValidation
ExpectedHttpStatusCode Sprawdź, czy test internetowy zwraca podany kod stanu HTTP. int
IgnoreHttpsStatusCode Po ustawieniu walidacja zignoruje kod stanu. bool
SSLCertRemainingLifetimeCheck Liczba dni, przez które należy sprawdzić, pozostaje nadal przed wygaśnięciem istniejącego certyfikatu SSL. Wartość musi być dodatnia, a pole SSLCheck musi mieć wartość true. int
Sprawdzanie protokołu SSL Sprawdza, czy certyfikat SSL jest nadal prawidłowy. bool

WebTestPropertiesValidationRulesContentValidation

Nazwa Opis Wartość
ContentMatch Zawartość do wyszukania w zamian testu internetowego. Nie może być zerowa ani pusta. ciąg
IgnoreCase Po ustawieniu ta wartość powoduje, że wielkość liter walidacji ContentMatch jest niewrażliwa. bool
PassIfTextFound W przypadku wartości true walidacja zakończy się powodzeniem, jeśli istnieje dopasowanie ciągu ContentMatch. Jeśli wartość false, walidacja zakończy się niepowodzeniem, jeśli istnieje dopasowanie bool

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Dynamiczne tworzenie testu sieci Web

Wdróż na platformie Azure
Utwórz dowolną liczbę testów internetowych usługi App Insights (ping).
Reguła alertu dotyczącego metryk dla testu dostępności

Wdróż na platformie Azure
Ten szablon tworzy test dostępności usługi Application Insights wraz z regułą alertu metryki, która go monitoruje.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu webtests można wdrożyć z operacjami docelowymi:

  • Grupy zasobów

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

Format zasobu

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Insights/webtests@2020-10-05-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      Configuration = {
        WebTest = "string"
      }
      Description = "string"
      Enabled = bool
      Frequency = int
      Kind = "string"
      Locations = [
        {
          Id = "string"
        }
      ]
      Name = "string"
      Request = {
        FollowRedirects = bool
        Headers = [
          {
            key = "string"
            value = "string"
          }
        ]
        HttpVerb = "string"
        ParseDependentRequests = bool
        RequestBody = "string"
        RequestUrl = "string"
      }
      RetryEnabled = bool
      SyntheticMonitorId = "string"
      Timeout = int
      ValidationRules = {
        ContentValidation = {
          ContentMatch = "string"
          IgnoreCase = bool
          PassIfTextFound = bool
        }
        ExpectedHttpStatusCode = int
        IgnoreHttpsStatusCode = bool
        SSLCertRemainingLifetimeCheck = int
        SSLCheck = bool
      }
    }
    kind = "string"
  })
}

Wartości właściwości

webtests

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Insights/webtests@2020-10-05-preview"
name Nazwa zasobu ciąg (wymagany)
location Lokalizacja zasobu ciąg (wymagany)
parent_id Aby przeprowadzić wdrożenie w grupie zasobów, użyj identyfikatora tej grupy zasobów. ciąg (wymagany)
tags Tagi zasobów Słownik nazw tagów i wartości.
Rodzaju Rodzaj testu internetowego, który sprawdza ten test internetowy. Opcje są ping i wieloetapowe. "multistep"
"ping"
properties Metadane opisujące test internetowy dla zasobu platformy Azure. Właściwości WebTestProperties

Właściwości WebTestProperties

Nazwa Opis Wartość
Konfigurowanie Specyfikacja konfiguracji XML dla webtestu. WebTestPropertiesConfiguration
Opis Opis zdefiniowany przez użytkownika dla tego testu sieci Web. ciąg
Enabled (Włączony) Czy test jest aktywnie monitorowany. bool
Częstotliwość Interwał w sekundach między przebiegami testów dla tego testu sieci Web. Wartość domyślna to 300. int
Rodzaj Rodzaj testu internetowego to prawidłowe opcje to ping, wieloetapowe, podstawowe i standardowe. "basic"
"multistep"
"ping"
"Standardowa" (wymagana)
Lokalizacje Lista miejsc, z których należy fizycznie uruchamiać testy w celu zapewnienia globalnego pokrycia ułatwień dostępu aplikacji. WebTestGeolocation[] (wymagane)
Nazwa Nazwa zdefiniowana przez użytkownika, jeśli ten test sieci Web. ciąg (wymagany)
Żądanie Kolekcja właściwości żądania WebTestPropertiesRequest
Ponów próbęWłąd Zezwalaj na ponawianie prób, jeśli ten test sieci Web nie powiedzie się. bool
SyntheticMonitorId Unikatowy identyfikator tego testu internetowego. Zazwyczaj jest to ta sama wartość co pole Nazwa. ciąg (wymagany)
Limit czasu Sekundy do czasu przekroczenia limitu czasu i niepowodzenia tego testu internetowego. Wartość domyślna to 30. int
Validationrules Kolekcja właściwości reguły walidacji WebTestPropertiesValidationRules

WebTestPropertiesConfiguration

Nazwa Opis Wartość
Webtest Specyfikacja XML testu internetowego do uruchamiania względem aplikacji. ciąg

WebTestGeolocation

Nazwa Opis Wartość
Id Identyfikator lokalizacji dla testu internetowego do uruchomienia. ciąg

WebTestPropertiesRequest

Nazwa Opis Wartość
ŚledźRedirects Postępuj zgodnie z przekierowaniami dla tego testu internetowego. bool
Nagłówki Lista nagłówków i ich wartości do dodania do wywołania WebTest. HeaderField[]
HttpVerb Czasownik HTTP do użycia na potrzeby tego testu internetowego. ciąg
ParseDependentRequests Przeanalizuj zależne żądanie dla tego testu sieci Web. bool
RequestBody Treść ciągów zakodowanych w formacie Base64 do wysłania za pomocą tego testu internetowego. ciąg
RequestUrl Lokalizacja adresu URL do przetestowania. ciąg

Pole nagłówka

Nazwa Opis Wartość
key Nazwa nagłówka. ciąg
wartość Wartość nagłówka. ciąg

WebTestPropertiesValidationRules

Nazwa Opis Wartość
ContentValidation Kolekcja właściwości weryfikacji zawartości WebTestPropertiesValidationRulesContentValidation
ExpectedHttpStatusCode Sprawdź, czy test internetowy zwraca podany kod stanu HTTP. int
IgnoreHttpsStatusCode Po ustawieniu walidacja zignoruje kod stanu. bool
SSLCertRemainingLifetimeCheck Liczba dni, przez które należy sprawdzić, pozostaje nadal przed wygaśnięciem istniejącego certyfikatu SSL. Wartość musi być dodatnia, a pole SSLCheck musi mieć wartość true. int
Sprawdzanie protokołu SSL Sprawdza, czy certyfikat SSL jest nadal prawidłowy. bool

WebTestPropertiesValidationRulesContentValidation

Nazwa Opis Wartość
ContentMatch Zawartość do wyszukania w zamian testu internetowego. Nie może być zerowa ani pusta. ciąg
IgnoreCase Po ustawieniu ta wartość sprawia, że wielkość liter weryfikacji ContentMatch jest niewrażliwa. bool
PassIfTextFound W przypadku wartości true walidacja zostanie przekazana, jeśli istnieje dopasowanie ciągu ContentMatch. Jeśli fałsz, walidacja zakończy się niepowodzeniem, jeśli istnieje dopasowanie bool