Microsoft.Insights webtests 2018-05-01-preview

  • Article

Définition de ressource Bicep

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

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@2018-05-01-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
    }
  }
}

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 et multi-étapes. 'multistep'
'ping'
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 est, les choix valides sont ping, multi-étapes, de base et standard. 'basic'
'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 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
IgnoreHttpsStatusCode 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

Déployer sur Azure 		Créez un nombre quelconque de tests web App Insights (ping).
Règle d’alerte de métrique pour un test de disponibilité

Déployer sur Azure 		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 :

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 code JSON suivant à votre modèle.

{
  "type": "Microsoft.Insights/webtests",
  "apiVersion": "2018-05-01-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"
    }
  }
}

Valeurs de propriétés

webtests

Nom Description Valeur
type Type de ressource 'Microsoft.Insights/webtests'
apiVersion Version de l’API de ressource '2018-05-01-preview'
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 et multi-étapes. 'multistep'
'ping'
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, de base et standard. 'basic'
'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 webTest retourne le code http status fourni. int
IgnoreHttpsStatusCode 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

Déployer sur Azure 		Créez un nombre quelconque de tests web App Insights (ping).
Règle d’alerte de métrique pour un test de disponibilité

Déployer sur Azure 		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 de l’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@2018-05-01-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"
  })
}

Valeurs de propriétés

webtests

Nom Description Valeur
type Type de ressource « Microsoft.Insights/webtests@2018-05-01-preview »
name Nom de la ressource chaîne (obligatoire)
location Emplacement de la ressource chaîne (obligatoire)
parent_id Pour effectuer un déploiement sur un groupe de ressources, utilisez l’ID de ce groupe de ressources. chaîne (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 et multi-étapes. « multi-étapes »
« ping »
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, de base et standard. « de base »
« multi-étapes »
« 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 webTest retourne le code http status fourni. int
IgnoreHttpsStatusCode 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