Web Tests - Create Or Update
Crée ou met à jour une définition de test web Application Insights.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/webtests/{webTestName}?api-version=2022-06-15
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
subscription
|
path | True |
string |
ID de l’abonnement cible. |
web
|
path | True |
string |
Nom de la ressource WebTest Application Insights. |
api-version
|
query | True |
string |
Version de l’API à utiliser pour cette opération. |
Corps de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
location | True |
string |
Emplacement de la ressource |
properties.Kind | True |
Le type de test web qu’il s’agit, les choix valides sont ping, multi-étapes et standard. |
|
properties.Locations | True |
Liste de l’emplacement d’exécution physique des tests pour fournir une couverture globale de l’accessibilité de votre application. |
|
properties.Name | True |
string |
Nom défini par l’utilisateur si ce WebTest. |
properties.SyntheticMonitorId | True |
string |
ID unique de ce test web. Il s’agit généralement de la même valeur que le champ Nom. |
kind |
Le type de WebTest que ce test web surveille. Les choix sont ping, multi-étapes et standard. |
||
properties.Configuration |
Spécification de configuration XML pour un Test Web. |
||
properties.Description |
string |
Description définie par l’utilisateur pour ce Test Web. |
|
properties.Enabled |
boolean |
Le test fait-il l’objet d’une surveillance active. |
|
properties.Frequency |
integer |
Intervalle en secondes entre les exécutions de tests pour ce test WebTest. La valeur par défaut est 300. |
|
properties.Request |
Collection de propriétés de requête |
||
properties.RetryEnabled |
boolean |
Autoriser les nouvelles tentatives en cas d’échec de ce Test Web. |
|
properties.Timeout |
integer |
Secondes jusqu’à ce que ce test web expire et échoue. La valeur par défaut est 30. |
|
properties.ValidationRules |
Collection de propriétés de règle de validation |
||
tags |
object |
Balises de ressource |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Création ou mise à jour réussie d’un test web Application Insights. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory.
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
web |
web |
web |
webTestCreate
Exemple de requête
PUT https://management.azure.com/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-component?api-version=2022-06-15
{
"location": "South Central US",
"kind": "ping",
"properties": {
"Name": "my-webtest-my-component",
"SyntheticMonitorId": "my-webtest-my-component",
"Configuration": {
"WebTest": "<WebTest Name=\"my-webtest\" Id=\"678ddf96-1ab8-44c8-9274-123456789abc\" Enabled=\"True\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"120\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\" ><Items><Request Method=\"GET\" Guid=\"a4162485-9114-fcfc-e086-123456789abc\" Version=\"1.1\" Url=\"http://my-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"120\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
},
"Description": "Ping web test alert for mytestwebapp",
"Enabled": true,
"Frequency": 900,
"Timeout": 120,
"Kind": "ping",
"RetryEnabled": true,
"Locations": [
{
"Id": "us-fl-mia-edge"
}
]
}
}
Exemple de réponse
{
"id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-component",
"name": "my-webtest-my-component",
"type": "Microsoft.Insights/webtests",
"location": "southcentralus",
"tags": {
"hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component": "Resource"
},
"kind": "ping",
"properties": {
"Name": "my-webtest-my-component",
"SyntheticMonitorId": "my-webtest-my-component",
"Description": "Ping web test alert for mytestwebapp",
"Enabled": true,
"Frequency": 900,
"Timeout": 120,
"Kind": "ping",
"RetryEnabled": true,
"Locations": [
{
"Id": "us-fl-mia-edge"
}
],
"Configuration": {
"WebTest": "<WebTest Name=\"my-webtest\" Id=\"678ddf96-1ab8-44c8-9274-123456789abc\" Enabled=\"True\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"120\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\" ><Items><Request Method=\"GET\" Guid=\"a4162485-9114-fcfc-e086-123456789abc\" Version=\"1.1\" Url=\"http://my-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"120\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
},
"provisioningState": "Succeeded"
}
}
webTestCreateStandard
Exemple de requête
PUT https://management.azure.com/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-component?api-version=2022-06-15
{
"location": "South Central US",
"properties": {
"Name": "my-webtest-my-component",
"SyntheticMonitorId": "my-webtest-my-component",
"Description": "Ping web test alert for mytestwebapp",
"Enabled": true,
"Frequency": 900,
"Timeout": 120,
"Kind": "standard",
"RetryEnabled": true,
"Request": {
"RequestUrl": "https://bing.com",
"Headers": [
{
"key": "Content-Language",
"value": "de-DE"
},
{
"key": "Accept-Language",
"value": "de-DE"
}
],
"HttpVerb": "POST",
"RequestBody": "SGVsbG8gd29ybGQ="
},
"ValidationRules": {
"SSLCheck": true,
"SSLCertRemainingLifetimeCheck": 100
},
"Locations": [
{
"Id": "us-fl-mia-edge"
}
]
}
}
Exemple de réponse
{
"id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-component",
"name": "my-webtest-my-component",
"type": "Microsoft.Insights/webtests",
"location": "southcentralus",
"tags": {
"hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component": "Resource"
},
"properties": {
"Name": "my-webtest-my-component",
"SyntheticMonitorId": "my-webtest-my-component",
"Description": "Ping web test alert for mytestwebapp",
"Enabled": true,
"Frequency": 900,
"Timeout": 120,
"Kind": "standard",
"RetryEnabled": true,
"Locations": [
{
"Id": "us-fl-mia-edge"
}
],
"Request": {
"RequestUrl": "https://bing.com",
"Headers": [
{
"key": "Content-Language",
"value": "de-DE"
},
{
"key": "Accept-Language",
"value": "de-DE"
}
],
"HttpVerb": "POST",
"RequestBody": "SGVsbG8gd29ybGQ="
},
"ValidationRules": {
"SSLCheck": true,
"SSLCertRemainingLifetimeCheck": 100
},
"provisioningState": "Succeeded"
}
}
webTestUpdate
Exemple de requête
PUT https://management.azure.com/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-component?api-version=2022-06-15
{
"location": "South Central US",
"kind": "ping",
"properties": {
"Configuration": {
"WebTest": "<WebTest Name=\"my-webtest\" Id=\"678ddf96-1ab8-44c8-9274-123456789abc\" Enabled=\"True\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"30\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\" ><Items><Request Method=\"GET\" Guid=\"a4162485-9114-fcfc-e086-123456789abc\" Version=\"1.1\" Url=\"http://my-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"30\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
},
"Frequency": 600,
"Timeout": 30,
"Locations": [
{
"Id": "us-fl-mia-edge"
},
{
"Id": "apac-hk-hkn-azr"
}
],
"Kind": "ping",
"Name": "my-webtest-my-component",
"SyntheticMonitorId": "my-webtest-my-component"
}
}
Exemple de réponse
{
"id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-component",
"name": "my-webtest-my-component",
"type": "Microsoft.Insights/webtests",
"location": "southcentralus",
"tags": {
"hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component": "Resource"
},
"kind": "ping",
"properties": {
"Name": "my-webtest-my-component",
"SyntheticMonitorId": "my-webtest-my-component",
"Description": "Ping web test alert for mytestwebapp",
"Enabled": true,
"Frequency": 600,
"Timeout": 30,
"Kind": "ping",
"RetryEnabled": true,
"Locations": [
{
"Id": "us-fl-mia-edge"
},
{
"Id": "apac-hk-hkn-azr"
}
],
"Configuration": {
"WebTest": "<WebTest Name=\"my-webtest\" Id=\"678ddf96-1ab8-44c8-9274-123456789abc\" Enabled=\"True\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"30\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\" ><Items><Request Method=\"GET\" Guid=\"a4162485-9114-fcfc-e086-123456789abc\" Version=\"1.1\" Url=\"http://my-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"30\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
},
"provisioningState": "Succeeded"
}
}
Définitions
Nom | Description |
---|---|
Configuration |
Spécification de configuration XML pour un Test Web. |
Content |
Collection de propriétés de validation de contenu |
Header |
En-tête à ajouter à WebTest. |
Request |
Collection de propriétés de requête |
Validation |
Collection de propriétés de règle de validation |
Web |
Définition De test web Application Insights. |
Web |
Emplacement géo-physique à partir duquel exécuter un Test Web. Vous devez spécifier un ou plusieurs emplacements à partir duquel le test doit s’exécuter. |
Web |
Le type de WebTest que ce test web surveille. Les choix sont ping, multi-étapes et standard. |
Configuration
Spécification de configuration XML pour un Test Web.
Nom | Type | Description |
---|---|---|
WebTest |
string |
Spécification XML d’un WebTest à exécuter sur une application. |
ContentValidation
Collection de propriétés de validation de contenu
Nom | Type | Description |
---|---|---|
ContentMatch |
string |
Contenu à rechercher dans le retour du WebTest. Ne doit pas être vide ou avoir la valeur null. |
IgnoreCase |
boolean |
Lorsqu’elle est définie, cette valeur rend la validation ContentMatch insensible à la casse. |
PassIfTextFound |
boolean |
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 |
HeaderField
En-tête à ajouter à WebTest.
Nom | Type | Description |
---|---|---|
key |
string |
Nom de l'en-tête. |
value |
string |
Valeur de l'en-tête. |
Request
Collection de propriétés de requête
Nom | Type | Description |
---|---|---|
FollowRedirects |
boolean |
Suivez les redirections pour ce test web. |
Headers |
Liste des en-têtes et de leurs valeurs à ajouter à l’appel WebTest. |
|
HttpVerb |
string |
Verbe Http à utiliser pour ce test web. |
ParseDependentRequests |
boolean |
Analysez la requête dépendante pour ce test web. |
RequestBody |
string |
Corps de chaîne encodé en Base64 à envoyer avec ce test web. |
RequestUrl |
string |
Emplacement d’URL à tester. |
ValidationRules
Collection de propriétés de règle de validation
Nom | Type | Description |
---|---|---|
ContentValidation |
Collection de propriétés de validation de contenu |
|
ExpectedHttpStatusCode |
integer |
Vérifiez que webTest retourne le code http status fourni. |
IgnoreHttpStatusCode |
boolean |
Une fois définie, la validation ignore le code status. |
SSLCertRemainingLifetimeCheck |
integer |
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. |
SSLCheck |
boolean |
Vérifie si le certificat SSL est toujours valide. |
WebTest
Définition De test web Application Insights.
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
id |
string |
ID de ressource Azure |
|
kind | ping |
Le type de WebTest que ce test web surveille. Les choix sont ping, multi-étapes et standard. |
|
location |
string |
Emplacement de la ressource |
|
name |
string |
Nom de la ressource Azure |
|
properties.Configuration |
Spécification de configuration XML pour un Test Web. |
||
properties.Description |
string |
Description définie par l’utilisateur pour ce Test Web. |
|
properties.Enabled |
boolean |
Le test fait-il l’objet d’une surveillance active. |
|
properties.Frequency |
integer |
300 |
Intervalle en secondes entre les exécutions de tests pour ce test WebTest. La valeur par défaut est 300. |
properties.Kind | ping |
Le type de test web qu’il s’agit, les choix valides sont ping, multi-étapes et standard. |
|
properties.Locations |
Liste de l’emplacement d’exécution physique des tests pour fournir une couverture globale de l’accessibilité de votre application. |
||
properties.Name |
string |
Nom défini par l’utilisateur si ce WebTest. |
|
properties.Request |
Collection de propriétés de requête |
||
properties.RetryEnabled |
boolean |
Autoriser les nouvelles tentatives en cas d’échec de ce Test Web. |
|
properties.SyntheticMonitorId |
string |
ID unique de ce test web. Il s’agit généralement de la même valeur que le champ Nom. |
|
properties.Timeout |
integer |
30 |
Secondes jusqu’à ce que ce test web expire et échoue. La valeur par défaut est 30. |
properties.ValidationRules |
Collection de propriétés de règle de validation |
||
properties.provisioningState |
string |
État actuel de ce composant, s’il a été provisionné ou non dans le groupe de ressources qu’il est défini. Les utilisateurs ne peuvent pas modifier cette valeur, mais peuvent la lire. Les valeurs incluent Réussi, Déploiement, Annulé et Échec. |
|
tags |
object |
Balises de ressource |
|
type |
string |
Type de ressource Azure |
WebTestGeolocation
Emplacement géo-physique à partir duquel exécuter un Test Web. Vous devez spécifier un ou plusieurs emplacements à partir duquel le test doit s’exécuter.
Nom | Type | Description |
---|---|---|
Id |
string |
ID d’emplacement du WebTest à partir duquel s’exécuter. |
WebTestKind
Le type de WebTest que ce test web surveille. Les choix sont ping, multi-étapes et standard.
Nom | Type | Description |
---|---|---|
multistep |
string |
|
ping |
string |
|
standard |
string |