Microsoft.Insights webtests

Artykuł
09/19/2023

Definicja zasobu Bicep

Typ zasobu webtests można wdrożyć przy użyciu operacji docelowych:

Grupy zasobów — zobacz polecenia wdrażania 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 kod Bicep do szablonu.

resource symbolicname 'Microsoft.Insights/webtests@2022-06-15' = {
  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
      IgnoreHttpStatusCode: 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 sieci Web, który sprawdza ten test internetowy. Opcje to ping, wieloetapowe i standardowe.	"multistep" "ping" "standard"
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, prawidłowe opcje to ping, wieloetapowe i standardowe.	"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ść
Ś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
IgnoreHttpStatusCode	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	Utwórz dowolną liczbę testów internetowych usługi App Insights (ping).
Reguła alertu dotyczącego metryk dla testu dostępności	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:

Grupy zasobów — zobacz polecenia wdrażania 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 kod JSON do szablonu.

{
  "type": "Microsoft.Insights/webtests",
  "apiVersion": "2022-06-15",
  "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",
      "IgnoreHttpStatusCode": "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	'2022-06-15'
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. Do wyboru są polecenia ping, wieloetapowe i standardowe.	"wieloetapowy" "ping" "standard"
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 i standardowe.	"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
IgnoreHttpStatusCode	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	Utwórz dowolną liczbę testów internetowych usługi App Insights (ping).
Reguła alertu dotyczącego metryk dla testu dostępności	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@2022-06-15"
  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
        IgnoreHttpStatusCode = bool
        SSLCertRemainingLifetimeCheck = int
        SSLCheck = bool
      }
    }
    kind = "string"
  })
}

Wartości właściwości

webtests

Nazwa	Opis	Wartość
typ	Typ zasobu	"Microsoft.Insights/webtests@2022-06-15"
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. Do wyboru są polecenia ping, wieloetapowe i standardowe.	"multistep" "ping" "standard"
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 jest taki, prawidłowe opcje to ping, wieloetapowe i standardowe.	"multistep" "ping" "standard" (wymagane)
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 metoda WebTest zwraca podany kod stanu http.	int
IgnoreHttpStatusCode	Po ustawieniu walidacja zignoruje kod stanu.	bool
SSLCertRemainingLifetimeCheck	Liczba dni, które należy sprawdzić, pozostają nadal przed wygaśnięciem istniejącego certyfikatu SSL. Wartość musi być dodatnia, a wartość SSLCheck musi być ustawiona na wartość true.	int
SslCheck	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

Microsoft.Insights webtests

Definicja zasobu Bicep

Format zasobu

Wartości właściwości

webtests

WebTestProperties

WebTestPropertiesConfiguration

WebTestGeolocation

WebTestPropertiesRequest

Pole nagłówka

WebTestPropertiesValidationRules

WebTestPropertiesValidationRulesContentValidation

Szablony szybkiego startu

Definicja zasobu szablonu usługi ARM

Format zasobu

Wartości właściwości

webtests

Właściwości WebTestProperties

WebTestPropertiesConfiguration

WebTestGeolocation

WebTestPropertiesRequest

Pole nagłówka

WebTestPropertiesValidationRules

WebTestPropertiesValidationRulesContentValidation

Szablony szybkiego startu

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Format zasobu

Wartości właściwości

webtests

Właściwości WebTestProperties

WebTestPropertiesConfiguration

WebTestGeolocation

WebTestPropertiesRequest

HeaderField

WebTestPropertiesValidationRules

WebTestPropertiesValidationRulesContentValidation

Opinia

Opinia

Dodatkowe zasoby