Microsoft.Insights-Webtests

Artikel
09/19/2023

Bicep-Ressourcendefinition

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

Ressourcengruppen : Siehe Ressourcengruppenbereitstellungsbefehle

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 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. Siehe Tags in Vorlagen
kind	Die Art von WebTest, die dieser Webtest überwacht. Die Wahlmö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	Ist 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, Mehrschritt und Standard.	"mehrschritt" "Ping" "Standard" (erforderlich)
Speicherorte	Eine Liste, von wo aus die Tests physisch ausgeführt werden sollen, um eine globale Abdeckung für die Barrierefreiheit Ihrer Anwendung zu gewährleisten.	WebTestGeolocation[] (erforderlich)
Name	Benutzerdefinierter Name, wenn dieser WebTest.	Zeichenfolge (erforderlich)
Anforderung	Die Auflistung der Anforderungseigenschaften	WebTestPropertiesRequest
RetryEnabled	Lassen Sie Wiederholungen 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 WebTests, der für eine Anwendung ausgeführt werden soll.	Zeichenfolge

WebTestGeolocation

Name	BESCHREIBUNG	Wert
Id	Standort-ID für den WebTest, von dem aus ausgeführt werden soll.	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	Erstellen Sie eine beliebige Anzahl von App Insights-Webtests (ping).
Metrikwarnungsregel für einen Verfügbarkeitstest	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 auf Folgendes abzielen:

Ressourcengruppen – Siehe Bereitstellungsbefehle für 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 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	Der Ressourcentyp	"Microsoft.Insights/webtests"
apiVersion	Die Version der Ressourcen-API	'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	Erstellen Sie eine beliebige Anzahl von App Insights-Webtests (ping).
Metrikwarnungsregel für einen Verfügbarkeitstest	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, Mehrschritt und Standard.	"mehrschritt" "Ping" "Standard" (erforderlich)
Speicherorte	Eine Liste, von wo aus die Tests physisch ausgeführt werden sollen, um eine globale Abdeckung für die Barrierefreiheit Ihrer Anwendung zu gewährleisten.	WebTestGeolocation[] (erforderlich)
Name	Benutzerdefinierter Name, wenn dieser WebTest.	Zeichenfolge (erforderlich)
Anforderung	Die Auflistung der Anforderungseigenschaften	WebTestPropertiesRequest
RetryEnabled	Lassen Sie Wiederholungen 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 WebTests, der für eine Anwendung ausgeführt werden soll.	Zeichenfolge

WebTestGeolocation

Name	BESCHREIBUNG	Wert
Id	Standort-ID für den WebTest, von dem aus ausgeführt werden soll.	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 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

Microsoft.Insights-Webtests

Bicep-Ressourcendefinition

Ressourcenformat

Eigenschaftswerte

webtests

WebTestProperties

WebTestPropertiesConfiguration

WebTestGeolocation

WebTestPropertiesRequest

Headerfeld

WebTestPropertiesValidationRules

WebTestPropertiesValidationRulesContentValidation

Schnellstartvorlagen

Ressourcendefinition mit einer ARM-Vorlage

Ressourcenformat

Eigenschaftswerte

webtests

WebTestProperties

WebTestPropertiesConfiguration

WebTestGeolocation

WebTestPropertiesRequest

Headerfeld

WebTestPropertiesValidationRules

WebTestPropertiesValidationRulesContentValidation

Schnellstartvorlagen

Terraform-Ressourcendefinition (AzAPI-Anbieter)

Ressourcenformat

Eigenschaftswerte

webtests

WebTestProperties

WebTestPropertiesConfiguration

WebTestGeolocation

WebTestPropertiesRequest

Headerfeld

WebTestPropertiesValidationRules

WebTestPropertiesValidationRulesContentValidation

Feedback

Feedback

Zusätzliche Ressourcen