Tests web Microsoft.Insights

Article
09/21/2023

Définition de ressource Bicep

Le type de ressource webtests peut être déployé avec des opérations qui ciblent :

Groupes de ressources - Voir commandes de déploiement de groupe de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Insights/webtests, ajoutez le Bicep suivant à votre modèle.

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

Valeurs de propriétés

webtests

Nom	Description	Valeur
name	Nom de la ressource	string (obligatoire)
location	Emplacement de la ressource	string (obligatoire)
tags	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
kind	Le type de WebTest que ce test web surveille. Les choix sont ping, multi-étapes et standard.	'multistep' 'ping' 'standard'
properties	Métadonnées décrivant un test web pour une ressource Azure.	WebTestProperties

WebTestProperties

Nom	Description	Valeur
Configuration	Spécification de configuration XML pour un test web.	WebTestPropertiesConfiguration
Description	Description définie par l’utilisateur pour ce Test Web.	string
activé	Le test est-il activement surveillé.	bool
Fréquence	Intervalle en secondes entre les exécutions de tests pour ce test WebTest. La valeur par défaut est 300.	int
Type	Le type de test web qu’il s’agit, les choix valides sont ping, multi-étapes et standard.	'multistep' 'ping' 'standard' (obligatoire)
Emplacements	Liste de l’emplacement à partir duquel exécuter physiquement les tests pour fournir une couverture globale de l’accessibilité de votre application.	WebTestGeolocation[] (obligatoire)
Nom	Nom défini par l’utilisateur si ce Test Web.	string (obligatoire)
Requête	Collection de propriétés de requête	WebTestPropertiesRequest
RetryEnabled	Autoriser les nouvelles tentatives en cas d’échec de ce test web.	bool
SyntheticMonitorId	ID unique de ce Test Web. Il s’agit généralement de la même valeur que le champ Nom.	string (obligatoire)
Délai d'expiration	Secondes avant que ce Test Web expire et échoue. La valeur par défaut est 30.	int
ValidationRules	Collection de propriétés de règle de validation	WebTestPropertiesValidationRules

WebTestPropertiesConfiguration

Nom	Description	Valeur
Webtest	Spécification XML d’un WebTest à exécuter sur une application.	string

WebTestGeolocation

Nom	Description	Valeur
Id	ID d’emplacement à partir duquel le WebTest doit s’exécuter.	string

WebTestPropertiesRequest

Nom	Description	Valeur
FollowRedirects	Suivez les redirections pour ce test web.	bool
headers	Liste des en-têtes et de leurs valeurs à ajouter à l’appel WebTest.	HeaderField[]
HttpVerb	Verbe Http à utiliser pour ce test web.	string
ParseDependentRequests	Analysez la requête dépendante pour ce test web.	bool
RequestBody	Corps de chaîne encodé en Base64 à envoyer avec ce test web.	string
RequestUrl	Emplacement d’URL à tester.	string

Champd’en-tête

Nom	Description	Valeur
key	Nom de l'en-tête.	string
value	Valeur de l'en-tête.	string

WebTestPropertiesValidationRules

Nom	Description	Valeur
ContentValidation	Collection de propriétés de validation de contenu	WebTestPropertiesValidationRulesContentValidation
ExpectedHttpStatusCode	Vérifiez que webTest retourne le code http status fourni.	int
IgnorerHttpStatusCode	Une fois définie, la validation ignore le code status.	bool
SSLCertRemainingLifetimeCheck	Il reste encore un certain nombre de jours à case activée avant l’expiration du certificat SSL existant. La valeur doit être positive et sslCheck doit avoir la valeur true.	int
SSLCheck	Vérifie si le certificat SSL est toujours valide.	bool

WebTestPropertiesValidationRulesContentValidation

Nom	Description	Valeur
ContentMatch	Contenu à rechercher dans le retour du WebTest. Ne doit pas être vide ou avoir la valeur null.	string
IgnoreCase	Lorsqu’elle est définie, cette valeur rend la validation ContentMatch insensible à la casse.	bool
PassIfTextFound	Lorsque la valeur est true, la validation passe s’il existe une correspondance pour la chaîne ContentMatch. Si la valeur est false, la validation échoue s’il existe une correspondance	bool

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle	Description
Création de tests web dynamiques	Créez un nombre quelconque de tests web App Insights (ping).
Règle d’alerte de métrique pour un test de disponibilité	Ce modèle crée un test de disponibilité Application Insights avec une règle d’alerte de métrique qui le surveille.

Définition de ressources de modèle ARM

Le type de ressource webtests peut être déployé avec des opérations qui ciblent :

Groupes de ressources - Voir commandes de déploiement de groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Insights/webtests, ajoutez le code JSON suivant à votre modèle.

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

Valeurs de propriétés

webtests

Nom	Description	Valeur
type	Type de ressource	« Microsoft.Insights/webtests »
apiVersion	Version de l’API de ressource	'2022-06-15'
name	Nom de la ressource	chaîne (obligatoire)
location	Emplacement de la ressource	chaîne (obligatoire)
tags	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
kind	Le type de WebTest que ce test web surveille. Les choix sont ping, multi-étapes et standard.	'multistep' 'ping' 'standard'
properties	Métadonnées décrivant un test web pour une ressource Azure.	WebTestProperties

WebTestProperties

Nom	Description	Valeur
Configuration	Spécification de configuration XML pour un Test Web.	WebTestPropertiesConfiguration
Description	Description définie par l’utilisateur pour ce Test Web.	string
activé	Le test fait-il l’objet d’une surveillance active.	bool
Fréquence	Intervalle en secondes entre les exécutions de tests pour ce test WebTest. La valeur par défaut est 300.	int
Type	Le type de test web qu’il s’agit, les choix valides sont ping, multi-étapes et standard.	'multistep' 'ping' 'standard' (obligatoire)
Emplacements	Liste de l’emplacement d’exécution physique des tests pour fournir une couverture globale de l’accessibilité de votre application.	WebTestGeolocation[] (obligatoire)
Nom	Nom défini par l’utilisateur si ce WebTest.	chaîne (obligatoire)
Requête	Collection de propriétés de requête	WebTestPropertiesRequest
RetryEnabled	Autoriser les nouvelles tentatives en cas d’échec de ce Test Web.	bool
SyntheticMonitorId	ID unique de ce test web. Il s’agit généralement de la même valeur que le champ Nom.	chaîne (obligatoire)
Délai d'expiration	Secondes jusqu’à ce que ce test web expire et échoue. La valeur par défaut est 30.	int
ValidationRules	Collection de propriétés de règle de validation	WebTestPropertiesValidationRules

WebTestPropertiesConfiguration

Nom	Description	Valeur
Webtest	Spécification XML d’un WebTest à exécuter sur une application.	string

WebTestGeolocation

Nom	Description	Valeur
Id	ID d’emplacement du WebTest à partir duquel s’exécuter.	string

WebTestPropertiesRequest

Nom	Description	Valeur
FollowRedirects	Suivez les redirections pour ce test web.	bool
headers	Liste des en-têtes et de leurs valeurs à ajouter à l’appel WebTest.	HeaderField[]
HttpVerb	Verbe Http à utiliser pour ce test web.	string
ParseDependentRequests	Analysez la requête dépendante pour ce test web.	bool
RequestBody	Corps de chaîne encodé en Base64 à envoyer avec ce test web.	string
RequestUrl	Emplacement d’URL à tester.	string

Champd’en-tête

Nom	Description	Valeur
key	Nom de l'en-tête.	string
value	Valeur de l'en-tête.	string

WebTestPropertiesValidationRules

Nom	Description	Valeur
ContentValidation	Collection de propriétés de validation de contenu	WebTestPropertiesValidationRulesContentValidation
ExpectedHttpStatusCode	Vérifiez que le WebTest retourne le code http status fourni.	int
IgnoreHttpStatusCode	Lorsqu’elle est définie, la validation ignore le code status.	bool
SSLCertRemainingLifetimeCheck	Il reste un certain nombre de jours à case activée avant l’expiration du certificat SSL existant. La valeur doit être positive et sslCheck doit avoir la valeur true.	int
SSLCheck	Vérifie si le certificat SSL est toujours valide.	bool

WebTestPropertiesValidationRulesContentValidation

Nom	Description	Valeur
ContentMatch	Contenu à rechercher dans le retour du WebTest. Ne doit pas être vide ou avoir la valeur null.	string
IgnoreCase	Lorsqu’elle est définie, cette valeur rend la validation ContentMatch non sensible à la casse.	bool
PassIfTextFound	Lorsque la valeur est true, la validation passe s’il existe une correspondance pour la chaîne ContentMatch. Si la valeur est false, la validation échoue en cas de correspondance	bool

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle	Description
Création de tests web dynamiques	Créez un nombre quelconque de tests web App Insights (ping).
Règle d’alerte de métrique pour un test de disponibilité	Ce modèle crée un test de disponibilité Application Insights avec une règle d’alerte de métrique qui le surveille.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource webtests peut être déployé avec des opérations qui ciblent :

Groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Insights/webtests, ajoutez le Terraform suivant à votre modèle.

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

Valeurs de propriétés

webtests

Nom	Description	Valeur
type	Type de ressource	« Microsoft.Insights/webtests@2022-06-15 »
name	Nom de la ressource	string (obligatoire)
location	Emplacement de la ressource	string (obligatoire)
parent_id	Pour effectuer un déploiement dans un groupe de ressources, utilisez l’ID de ce groupe de ressources.	string (obligatoire)
tags	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes.
kind	Le type de WebTest que ce test web surveille. Les choix sont ping, multi-étapes et standard.	« multi-étapes » « ping » « standard »
properties	Métadonnées décrivant un test web pour une ressource Azure.	WebTestProperties

WebTestProperties

Nom	Description	Valeur
Configuration	Spécification de configuration XML pour un test web.	WebTestPropertiesConfiguration
Description	Description définie par l’utilisateur pour ce Test Web.	string
activé	Le test est-il activement surveillé.	bool
Fréquence	Intervalle en secondes entre les exécutions de tests pour ce test WebTest. La valeur par défaut est 300.	int
Type	Le type de test web qu’il s’agit, les choix valides sont ping, multi-étapes et standard.	« multi-étapes » « ping » « standard » (obligatoire)
Emplacements	Liste de l’emplacement à partir duquel exécuter physiquement les tests pour fournir une couverture globale de l’accessibilité de votre application.	WebTestGeolocation[] (obligatoire)
Nom	Nom défini par l’utilisateur si ce Test Web.	string (obligatoire)
Requête	Collection de propriétés de requête	WebTestPropertiesRequest
RetryEnabled	Autoriser les nouvelles tentatives en cas d’échec de ce test web.	bool
SyntheticMonitorId	ID unique de ce Test Web. Il s’agit généralement de la même valeur que le champ Nom.	string (obligatoire)
Délai d'expiration	Secondes avant que ce Test Web expire et échoue. La valeur par défaut est 30.	int
ValidationRules	Collection de propriétés de règle de validation	WebTestPropertiesValidationRules

WebTestPropertiesConfiguration

Nom	Description	Valeur
Webtest	Spécification XML d’un WebTest à exécuter sur une application.	string

WebTestGeolocation

Nom	Description	Valeur
Id	ID d’emplacement à partir duquel le WebTest doit s’exécuter.	string

WebTestPropertiesRequest

Nom	Description	Valeur
FollowRedirects	Suivez les redirections pour ce test web.	bool
headers	Liste des en-têtes et de leurs valeurs à ajouter à l’appel WebTest.	HeaderField[]
HttpVerb	Verbe Http à utiliser pour ce test web.	string
ParseDependentRequests	Analyser la requête dépendante pour ce test web.	bool
RequestBody	Corps de chaîne encodé en base64 à envoyer avec ce test web.	string
RequestUrl	Emplacement url à tester.	string

Champd’en-tête

Nom	Description	Valeur
key	Nom de l'en-tête.	string
value	Valeur de l'en-tête.	string

WebTestPropertiesValidationRules

Nom	Description	Valeur
ContentValidation	Collection de propriétés de validation de contenu	WebTestPropertiesValidationRulesContentValidation
ExpectedHttpStatusCode	Vérifiez que le WebTest retourne le code http status fourni.	int
IgnoreHttpStatusCode	Lorsqu’elle est définie, la validation ignore le code status.	bool
SSLCertRemainingLifetimeCheck	Il reste un certain nombre de jours à case activée avant l’expiration du certificat SSL existant. La valeur doit être positive et sslCheck doit avoir la valeur true.	int
SSLCheck	Vérifie si le certificat SSL est toujours valide.	bool

WebTestPropertiesValidationRulesContentValidation

Nom	Description	Valeur
ContentMatch	Contenu à rechercher dans le retour du WebTest. Ne doit pas être vide ou avoir la valeur null.	string
IgnoreCase	Lorsqu’elle est définie, cette valeur rend la validation ContentMatch non sensible à la casse.	bool
PassIfTextFound	Lorsque la valeur est true, la validation passe s’il existe une correspondance pour la chaîne ContentMatch. Si la valeur est false, la validation échoue en cas de correspondance	bool

Tests web Microsoft.Insights

Définition de ressource Bicep

Format des ressources

Valeurs de propriétés

webtests

WebTestProperties

WebTestPropertiesConfiguration

WebTestGeolocation

WebTestPropertiesRequest

Champd’en-tête

WebTestPropertiesValidationRules

WebTestPropertiesValidationRulesContentValidation

Modèles de démarrage rapide

Définition de ressources de modèle ARM

Format des ressources

Valeurs de propriétés

webtests

WebTestProperties

WebTestPropertiesConfiguration

WebTestGeolocation

WebTestPropertiesRequest

Champd’en-tête

WebTestPropertiesValidationRules

WebTestPropertiesValidationRulesContentValidation

Modèles de démarrage rapide

Définition de ressource Terraform (fournisseur AzAPI)

Format des ressources

Valeurs de propriétés

webtests

WebTestProperties

WebTestPropertiesConfiguration

WebTestGeolocation

WebTestPropertiesRequest

Champd’en-tête

WebTestPropertiesValidationRules

WebTestPropertiesValidationRulesContentValidation

Commentaires

Commentaires

Ressources supplémentaires