Freigeben über

Microsoft.Insights-Webtests 2022-06-15

  • Artikel

Bicep-Ressourcendefinition

Der Webtests-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Insights/webtests-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden Bicep hinzu.

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

Eigenschaftswerte

webtests

Name BESCHREIBUNG Wert
name Der Ressourcenname Zeichenfolge (erforderlich)
location Ressourcenspeicherort Zeichenfolge (erforderlich)
tags Ressourcentags Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen.
kind Die Art von WebTest, die dieser Webtest überwacht. Auswahlmöglichkeiten sind Ping, Mehrschritt und Standard. "Mehrschritt"
"Ping"
"Standard"
properties Metadaten, die einen Webtest für eine Azure-Ressource beschreiben. WebTestProperties

WebTestProperties

Name BESCHREIBUNG Wert
Konfiguration Eine XML-Konfigurationsspezifikation für einen WebTest. WebTestPropertiesConfiguration
BESCHREIBUNG Benutzerdefinierte Beschreibung für diesen WebTest. Zeichenfolge
Aktiviert Der Test, der aktiv überwacht wird. bool
Häufigkeit Intervall in Sekunden zwischen Testläufen für diesen WebTest. Der Standardwert ist 300. INT
Variante Die Art des Webtests ist dies, gültige Optionen sind Ping, mehrstufige und Standard. "Mehrschritt"
"Ping"
"Standard" (erforderlich)
Speicherorte Eine Liste, von der aus die Tests physisch ausgeführt werden sollen, um die Barrierefreiheit Ihrer Anwendung global abzudecken. WebTestGeolocation[] (erforderlich)
Name Benutzerdefinierter Name, wenn dieser WebTest. Zeichenfolge (erforderlich)
Anforderung Die Auflistung der Anforderungseigenschaften WebTestPropertiesRequest
RetryEnabled Lassen Sie Wiederholungsversuche zu, wenn dieser WebTest fehlschlägt. bool
SyntheticMonitorId Eindeutige ID dieses WebTest. Dies ist in der Regel derselbe Wert wie das Feld Name. Zeichenfolge (erforderlich)
Timeout Sekunden, bis für diesen WebTest ein Timeout auftritt und ein Fehler auftritt. Standardwert: 30. INT
Validationrules Die Auflistung der Eigenschaften der Validierungsregel WebTestPropertiesValidationRules

WebTestPropertiesConfiguration

Name BESCHREIBUNG Wert
WebTest Die XML-Spezifikation eines WebTest, der für eine Anwendung ausgeführt werden soll. Zeichenfolge

WebTestGeolocation

Name BESCHREIBUNG Wert
Id Standort-ID für den Auszuführenden WebTest. Zeichenfolge

WebTestPropertiesRequest

Name BESCHREIBUNG Wert
FollowRedirects Folgen Sie den Umleitungen für diesen Webtest. bool
Header Liste der Header und deren Werte, die dem WebTest-Aufruf hinzugefügt werden sollen. HeaderField[]
HttpVerb Http-Verb, das für diesen Webtest verwendet werden soll. Zeichenfolge
ParseDependentRequests Analysieren Sie die abhängige Anforderung für diesen WebTest. bool
RequestBody Base64-codierter Zeichenfolgentext, der mit diesem Webtest gesendet werden soll. Zeichenfolge
RequestUrl Zu testende URL-Speicherort. Zeichenfolge

Headerfeld

Name BESCHREIBUNG Wert
Schlüssel Der Name des Headers. Zeichenfolge
value Der Wert des Headers. Zeichenfolge

WebTestPropertiesValidationRules

Name BESCHREIBUNG Wert
ContentValidation Die Auflistung von Inhaltsüberprüfungseigenschaften WebTestPropertiesValidationRulesContentValidation
ExpectedHttpStatusCode Überprüfen Sie, ob der WebTest den bereitgestellten HTTP-status Code zurückgibt. INT
IgnoreHttpStatusCode Wenn festgelegt, ignoriert die Überprüfung den status Code. bool
SSLCertRemainingLifetimeCheck Es bleiben noch einige Tage zu überprüfen, bevor das vorhandene SSL-Zertifikat abläuft. Der Wert muss positiv sein, und der SSLCheck muss auf true festgelegt werden. INT
SSLCheck Überprüft, ob das SSL-Zertifikat noch gültig ist. bool

WebTestPropertiesValidationRulesContentValidation

Name BESCHREIBUNG Wert
ContentMatch Inhalt, nach dem bei der Rückgabe des WebTest gesucht werden soll. Darf nicht NULL oder leer sein. Zeichenfolge
IgnoreCase Wenn dieser Wert festgelegt ist, wird die Groß-/Kleinschreibung der ContentMatch-Überprüfung nicht beachtet. bool
PassIfTextFound Wenn true ist, wird die Überprüfung erfolgreich ausgeführt, wenn eine Übereinstimmung für die ContentMatch-Zeichenfolge vorhanden ist. Bei false tritt bei der Überprüfung ein Fehler auf, wenn eine Übereinstimmung vorliegt. bool

Schnellstartvorlagen

Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.

Vorlage BESCHREIBUNG
Erstellung dynamischer Webtests

Bereitstellen in Azure 		Erstellen Sie eine beliebige Anzahl von App Insights-Webtests (Ping).
Metrikwarnungsregel für einen Verfügbarkeitstest

Bereitstellen in Azure 		Diese Vorlage erstellt einen Application Insights-Verfügbarkeitstest zusammen mit einer Metrikwarnungsregel, die ihn überwacht.

Ressourcendefinition mit einer ARM-Vorlage

Der Webtests-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Insights/webtests-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

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

Eigenschaftswerte

webtests

Name BESCHREIBUNG Wert
type Ressourcentyp "Microsoft.Insights/webtests"
apiVersion Die Ressourcen-API-Version '2022-06-15'
name Der Ressourcenname Zeichenfolge (erforderlich)
location Ressourcenspeicherort Zeichenfolge (erforderlich)
tags Ressourcentags Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen.
kind Die Art von WebTest, die dieser Webtest überwacht. Auswahlmöglichkeiten sind Ping, Mehrschritt und Standard. "Mehrschritt"
"Ping"
"Standard"
properties Metadaten, die einen Webtest für eine Azure-Ressource beschreiben. WebTestProperties

WebTestProperties

Name BESCHREIBUNG Wert
Konfiguration Eine XML-Konfigurationsspezifikation für einen WebTest. WebTestPropertiesConfiguration
BESCHREIBUNG Benutzerdefinierte Beschreibung für diesen WebTest. Zeichenfolge
Aktiviert Der Test, der aktiv überwacht wird. bool
Häufigkeit Intervall in Sekunden zwischen Testläufen für diesen WebTest. Der Standardwert ist 300. INT
Variante Die Art des Webtests ist dies, gültige Optionen sind Ping, mehrstufige und Standard. "Mehrschritt"
"Ping"
"Standard" (erforderlich)
Speicherorte Eine Liste, von der aus die Tests physisch ausgeführt werden sollen, um die Barrierefreiheit Ihrer Anwendung global abzudecken. WebTestGeolocation[] (erforderlich)
Name Benutzerdefinierter Name, wenn dieser WebTest. Zeichenfolge (erforderlich)
Anforderung Die Auflistung der Anforderungseigenschaften WebTestPropertiesRequest
RetryEnabled Lassen Sie Wiederholungsversuche zu, wenn dieser WebTest fehlschlägt. bool
SyntheticMonitorId Eindeutige ID dieses WebTest. Dies ist in der Regel derselbe Wert wie das Feld Name. Zeichenfolge (erforderlich)
Timeout Sekunden, bis für diesen WebTest ein Timeout auftritt und ein Fehler auftritt. Standardwert: 30. INT
Validationrules Die Auflistung der Eigenschaften der Validierungsregel WebTestPropertiesValidationRules

WebTestPropertiesConfiguration

Name BESCHREIBUNG Wert
WebTest Die XML-Spezifikation eines WebTest, der für eine Anwendung ausgeführt werden soll. Zeichenfolge

WebTestGeolocation

Name BESCHREIBUNG Wert
Id Standort-ID für den Auszuführenden WebTest. Zeichenfolge

WebTestPropertiesRequest

Name BESCHREIBUNG Wert
FollowRedirects Folgen Sie den Umleitungen für diesen Webtest. bool
Header Liste der Header und deren Werte, die dem WebTest-Aufruf hinzugefügt werden sollen. HeaderField[]
HttpVerb Http-Verb, das für diesen Webtest verwendet werden soll. Zeichenfolge
ParseDependentRequests Analysieren Sie die abhängige Anforderung für diesen WebTest. bool
RequestBody Base64-codierter Zeichenfolgentext, der mit diesem Webtest gesendet werden soll. Zeichenfolge
RequestUrl Url-Speicherort, der getestet werden soll. Zeichenfolge

Headerfeld

Name BESCHREIBUNG Wert
Schlüssel Der Name des Headers. Zeichenfolge
value Der Wert des Headers. Zeichenfolge

WebTestPropertiesValidationRules

Name BESCHREIBUNG Wert
ContentValidation Die Auflistung von Inhaltsüberprüfungseigenschaften WebTestPropertiesValidationRulesContentValidation
ErwartetHttpStatusCode Überprüfen Sie, ob webTest den bereitgestellten HTTP-status Code zurückgibt. INT
IgnoreHttpStatusCode Wenn diese Einstellung festgelegt ist, ignoriert die Überprüfung den status Code. bool
SSLCertRemainingLifetimeCheck Es bleiben noch einige Tage zu überprüfen, bevor das vorhandene SSL-Zertifikat abläuft. Der Wert muss positiv sein, und SSLCheck muss auf true festgelegt werden. INT
SSLCheck Überprüft, ob das SSL-Zertifikat noch gültig ist. bool

WebTestPropertiesValidationRulesContentValidation

Name BESCHREIBUNG Wert
ContentMatch Inhalt, der in der Rückgabe des WebTest gesucht werden soll. Darf nicht NULL oder leer sein. Zeichenfolge
IgnoreCase Wenn dieser Wert festgelegt ist, wird bei der ContentMatch-Überprüfung die Groß-/Kleinschreibung nicht beachtet. bool
PassIfTextFound Bei true wird die Überprüfung erfolgreich ausgeführt, wenn eine Übereinstimmung für die ContentMatch-Zeichenfolge vorhanden ist. Bei false schlägt die Überprüfung fehl, wenn eine Übereinstimmung vorliegt. bool

Schnellstartvorlagen

In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage BESCHREIBUNG
Dynamische Webtesterstellung

Bereitstellen in Azure 		Erstellen Sie eine beliebige Anzahl von App Insights-Webtests (ping).
Metrikwarnungsregel für einen Verfügbarkeitstest

Bereitstellen in Azure 		Diese Vorlage erstellt einen Application Insights-Verfügbarkeitstest zusammen mit einer Metrikwarnungsregel, die ihn überwacht.

Terraform-Ressourcendefinition (AzAPI-Anbieter)

Der Webtests-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Insights/webtests-Ressource zu erstellen, fügen Sie ihrer Vorlage den folgenden Terraform hinzu.

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

Eigenschaftswerte

webtests

Name BESCHREIBUNG Wert
type Der Ressourcentyp "Microsoft.Insights/webtests@2022-06-15"
name Der Ressourcenname Zeichenfolge (erforderlich)
location Ressourcenspeicherort Zeichenfolge (erforderlich)
parent_id Verwenden Sie zum Bereitstellen in einer Ressourcengruppe die ID dieser Ressourcengruppe. Zeichenfolge (erforderlich)
tags Ressourcentags Wörterbuch der Tagnamen und -werte.
kind Die Art von WebTest, die dieser Webtest überwacht. Auswahlmöglichkeiten sind Ping, Mehrschritt und Standard. "Mehrschritt"
"ping"
"Standard"
properties Metadaten, die einen Webtest für eine Azure-Ressource beschreiben. WebTestProperties

WebTestProperties

Name BESCHREIBUNG Wert
Konfiguration Eine XML-Konfigurationsspezifikation für einen WebTest. WebTestPropertiesConfiguration
BESCHREIBUNG Benutzerdefinierte Beschreibung für diesen WebTest. Zeichenfolge
Aktiviert Der Test, der aktiv überwacht wird. bool
Häufigkeit Intervall in Sekunden zwischen Testläufen für diesen WebTest. Der Standardwert ist 300. INT
Variante Die Art des Webtests ist dies, gültige Optionen sind Ping, mehrstufige und Standard. "Mehrschritt"
"ping"
"Standard" (erforderlich)
Speicherorte Eine Liste, von der aus die Tests physisch ausgeführt werden sollen, um die Barrierefreiheit Ihrer Anwendung global abzudecken. WebTestGeolocation[] (erforderlich)
Name Benutzerdefinierter Name, wenn dieser WebTest. Zeichenfolge (erforderlich)
Anforderung Die Auflistung der Anforderungseigenschaften WebTestPropertiesRequest
RetryEnabled Lassen Sie Wiederholungsversuche zu, wenn dieser WebTest fehlschlägt. bool
SyntheticMonitorId Eindeutige ID dieses WebTest. Dies ist in der Regel derselbe Wert wie das Feld Name. Zeichenfolge (erforderlich)
Timeout Sekunden, bis für diesen WebTest ein Timeout auftritt und ein Fehler auftritt. Standardwert: 30. INT
Validationrules Die Auflistung der Eigenschaften der Validierungsregel WebTestPropertiesValidationRules

WebTestPropertiesConfiguration

Name BESCHREIBUNG Wert
WebTest Die XML-Spezifikation eines WebTest, der für eine Anwendung ausgeführt werden soll. Zeichenfolge

WebTestGeolocation

Name BESCHREIBUNG Wert
Id Standort-ID für den Auszuführenden WebTest. Zeichenfolge

WebTestPropertiesRequest

Name BESCHREIBUNG Wert
FollowRedirects Folgen Sie den Umleitungen für diesen Webtest. bool
Header Liste der Header und deren Werte, die dem WebTest-Aufruf hinzugefügt werden sollen. HeaderField[]
HttpVerb Http-Verb, das für diesen Webtest verwendet werden soll. Zeichenfolge
ParseDependentRequests Analysieren Sie die abhängige Anforderung für diesen WebTest. bool
RequestBody Base64-codierter Zeichenfolgentext, der mit diesem Webtest gesendet werden soll. Zeichenfolge
RequestUrl Url-Speicherort, der getestet werden soll. Zeichenfolge

Headerfeld

Name BESCHREIBUNG Wert
Schlüssel Der Name des Headers. Zeichenfolge
value Der Wert des Headers. Zeichenfolge

WebTestPropertiesValidationRules

Name BESCHREIBUNG Wert
ContentValidation Die Auflistung von Inhaltsüberprüfungseigenschaften WebTestPropertiesValidationRulesContentValidation
ErwartetHttpStatusCode Überprüfen Sie, ob webTest den bereitgestellten HTTP-status Code zurückgibt. INT
IgnoreHttpStatusCode Wenn diese Einstellung festgelegt ist, ignoriert die Überprüfung den status Code. bool
SSLCertRemainingLifetimeCheck Es bleiben noch einige Tage zu überprüfen, bevor das vorhandene SSL-Zertifikat abläuft. Der Wert muss positiv sein, und SSLCheck muss auf true festgelegt werden. INT
SSLCheck Überprüft, ob das SSL-Zertifikat noch gültig ist. bool

WebTestPropertiesValidationRulesContentValidation

Name BESCHREIBUNG Wert
ContentMatch Inhalt, der in der Rückgabe des WebTest gesucht werden soll. Darf nicht NULL oder leer sein. Zeichenfolge
IgnoreCase Wenn dieser Wert festgelegt ist, wird bei der ContentMatch-Überprüfung die Groß-/Kleinschreibung nicht beachtet. bool
PassIfTextFound Bei true wird die Überprüfung erfolgreich ausgeführt, wenn eine Übereinstimmung für die ContentMatch-Zeichenfolge vorhanden ist. Bei false schlägt die Überprüfung fehl, wenn eine Übereinstimmung vorliegt. bool