Web Tests - Create Or Update

Referenz

Dienst:: Application Insights

API-Version:: 2022-06-15

Erstellt oder aktualisiert eine Application Insights-Webtestdefinition.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/webtests/{webTestName}?api-version=2022-06-15

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string	Hierbei handelt es sich um die ID des Zielabonnements.
webTestName	path	True	string	Der Name der Application Insights WebTest-Ressource.
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
location	True	string	Ressourcenspeicherort
properties.Kind	True	WebTestKind	Die Art des Webtests ist dies, gültige Optionen sind Ping, mehrstufige und Standard.
properties.Locations	True	WebTestGeolocation[]	Eine Liste, von der aus die Tests physisch ausgeführt werden sollen, um die Barrierefreiheit Ihrer Anwendung global abzudecken.
properties.Name	True	string	Benutzerdefinierter Name, wenn dieser WebTest.
properties.SyntheticMonitorId	True	string	Eindeutige ID dieses WebTest. Dies ist in der Regel derselbe Wert wie das Feld Name.
kind		WebTestKind	Die Art von WebTest, die dieser Webtest überwacht. Auswahlmöglichkeiten sind Ping, Mehrschritt und Standard.
properties.Configuration		Configuration	Eine XML-Konfigurationsspezifikation für einen WebTest.
properties.Description		string	Benutzerdefinierte Beschreibung für diesen WebTest.
properties.Enabled		boolean	Der Test, der aktiv überwacht wird.
properties.Frequency		integer	Intervall in Sekunden zwischen Testläufen für diesen WebTest. Der Standardwert ist 300.
properties.Request		Request	Die Auflistung der Anforderungseigenschaften
properties.RetryEnabled		boolean	Lassen Sie Wiederholungsversuche zu, wenn dieser WebTest fehlschlägt.
properties.Timeout		integer	Sekunden, bis für diesen WebTest ein Timeout auftritt und ein Fehler auftritt. Standardwert: 30.
properties.ValidationRules		ValidationRules	Die Auflistung der Eigenschaften der Validierungsregel
tags		object	Ressourcentags

Antworten

Name	Typ	Beschreibung
200 OK	WebTest	Ein Application Insights-Webtest wurde erfolgreich erstellt oder aktualisiert.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

webTestCreate

webTestCreateStandard

webTestUpdate

webTestCreate

Beispielanforderung

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


import com.azure.resourcemanager.applicationinsights.models.WebTestGeolocation;
import com.azure.resourcemanager.applicationinsights.models.WebTestKind;
import com.azure.resourcemanager.applicationinsights.models.WebTestPropertiesConfiguration;
import java.util.Arrays;

/**
 * Samples for WebTests CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/applicationinsights/resource-manager/Microsoft.Insights/stable/2022-06-15/examples/WebTestCreate.
     * json
     */
    /**
     * Sample code: webTestCreate.
     * 
     * @param manager Entry point to ApplicationInsightsManager.
     */
    public static void webTestCreate(com.azure.resourcemanager.applicationinsights.ApplicationInsightsManager manager) {
        manager.webTests().define("my-webtest-my-component").withRegion("South Central US")
            .withExistingResourceGroup("my-resource-group").withKind(WebTestKind.PING)
            .withSyntheticMonitorId("my-webtest-my-component").withWebTestName("my-webtest-my-component")
            .withDescription("Ping web test alert for mytestwebapp").withEnabled(true).withFrequency(900)
            .withTimeout(120).withWebTestKind(WebTestKind.PING).withRetryEnabled(true)
            .withLocations(Arrays.asList(new WebTestGeolocation().withLocation("us-fl-mia-edge")))
            .withConfiguration(new WebTestPropertiesConfiguration().withWebTest(
                "<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>"))
            .create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.ApplicationInsights.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.ApplicationInsights;

// Generated from example definition: specification/applicationinsights/resource-manager/Microsoft.Insights/stable/2022-06-15/examples/WebTestCreate.json
// this example is just showing the usage of "WebTests_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "subid";
string resourceGroupName = "my-resource-group";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ApplicationInsightsWebTestResource
ApplicationInsightsWebTestCollection collection = resourceGroupResource.GetApplicationInsightsWebTests();

// invoke the operation
string webTestName = "my-webtest-my-component";
ApplicationInsightsWebTestData data = new ApplicationInsightsWebTestData(new AzureLocation("South Central US"))
{
    Kind = WebTestKind.Ping,
    SyntheticMonitorId = "my-webtest-my-component",
    WebTestName = "my-webtest-my-component",
    Description = "Ping web test alert for mytestwebapp",
    IsEnabled = true,
    FrequencyInSeconds = 900,
    TimeoutInSeconds = 120,
    WebTestKind = WebTestKind.Ping,
    IsRetryEnabled = true,
    Locations =
    {
    new WebTestGeolocation()
    {
    Location = new AzureLocation("us-fl-mia-edge"),
    }
    },
    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>",
};
ArmOperation<ApplicationInsightsWebTestResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, webTestName, data);
ApplicationInsightsWebTestResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ApplicationInsightsWebTestData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:: 200

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

Beispielanforderung

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


import com.azure.resourcemanager.applicationinsights.models.HeaderField;
import com.azure.resourcemanager.applicationinsights.models.WebTestGeolocation;
import com.azure.resourcemanager.applicationinsights.models.WebTestKind;
import com.azure.resourcemanager.applicationinsights.models.WebTestPropertiesRequest;
import com.azure.resourcemanager.applicationinsights.models.WebTestPropertiesValidationRules;
import java.util.Arrays;

/**
 * Samples for WebTests CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/applicationinsights/resource-manager/Microsoft.Insights/stable/2022-06-15/examples/
     * WebTestCreateStandard.json
     */
    /**
     * Sample code: webTestCreateStandard.
     * 
     * @param manager Entry point to ApplicationInsightsManager.
     */
    public static void
        webTestCreateStandard(com.azure.resourcemanager.applicationinsights.ApplicationInsightsManager manager) {
        manager.webTests().define("my-webtest-my-component").withRegion("South Central US")
            .withExistingResourceGroup("my-resource-group").withSyntheticMonitorId("my-webtest-my-component")
            .withWebTestName("my-webtest-my-component").withDescription("Ping web test alert for mytestwebapp")
            .withEnabled(true).withFrequency(900).withTimeout(120).withWebTestKind(WebTestKind.STANDARD)
            .withRetryEnabled(true)
            .withLocations(Arrays.asList(new WebTestGeolocation().withLocation("us-fl-mia-edge")))
            .withRequest(new WebTestPropertiesRequest().withRequestUrl("https://bing.com")
                .withHeaders(Arrays.asList(
                    new HeaderField().withHeaderFieldName("fakeTokenPlaceholder").withHeaderFieldValue("de-DE"),
                    new HeaderField().withHeaderFieldName("fakeTokenPlaceholder").withHeaderFieldValue("de-DE")))
                .withHttpVerb("POST").withRequestBody("SGVsbG8gd29ybGQ="))
            .withValidationRules(
                new WebTestPropertiesValidationRules().withSslCheck(true).withSslCertRemainingLifetimeCheck(100))
            .create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.ApplicationInsights.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.ApplicationInsights;

// Generated from example definition: specification/applicationinsights/resource-manager/Microsoft.Insights/stable/2022-06-15/examples/WebTestCreateStandard.json
// this example is just showing the usage of "WebTests_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "subid";
string resourceGroupName = "my-resource-group";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ApplicationInsightsWebTestResource
ApplicationInsightsWebTestCollection collection = resourceGroupResource.GetApplicationInsightsWebTests();

// invoke the operation
string webTestName = "my-webtest-my-component";
ApplicationInsightsWebTestData data = new ApplicationInsightsWebTestData(new AzureLocation("South Central US"))
{
    SyntheticMonitorId = "my-webtest-my-component",
    WebTestName = "my-webtest-my-component",
    Description = "Ping web test alert for mytestwebapp",
    IsEnabled = true,
    FrequencyInSeconds = 900,
    TimeoutInSeconds = 120,
    WebTestKind = WebTestKind.Standard,
    IsRetryEnabled = true,
    Locations =
    {
    new WebTestGeolocation()
    {
    Location = new AzureLocation("us-fl-mia-edge"),
    }
    },
    Request = new WebTestRequest()
    {
        RequestUri = new Uri("https://bing.com"),
        Headers =
        {
        new WebTestRequestHeaderField()
        {
        HeaderFieldName = "Content-Language",
        HeaderFieldValue = "de-DE",
        },new WebTestRequestHeaderField()
        {
        HeaderFieldName = "Accept-Language",
        HeaderFieldValue = "de-DE",
        }
        },
        HttpVerb = "POST",
        RequestBody = "SGVsbG8gd29ybGQ=",
    },
    ValidationRules = new WebTestValidationRules()
    {
        CheckSsl = true,
        SslCertRemainingLifetimeCheck = 100,
    },
};
ArmOperation<ApplicationInsightsWebTestResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, webTestName, data);
ApplicationInsightsWebTestResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ApplicationInsightsWebTestData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:: 200

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

Beispielanforderung

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


import com.azure.resourcemanager.applicationinsights.models.WebTestGeolocation;
import com.azure.resourcemanager.applicationinsights.models.WebTestKind;
import com.azure.resourcemanager.applicationinsights.models.WebTestPropertiesConfiguration;
import java.util.Arrays;

/**
 * Samples for WebTests CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/applicationinsights/resource-manager/Microsoft.Insights/stable/2022-06-15/examples/WebTestUpdate.
     * json
     */
    /**
     * Sample code: webTestUpdate.
     * 
     * @param manager Entry point to ApplicationInsightsManager.
     */
    public static void webTestUpdate(com.azure.resourcemanager.applicationinsights.ApplicationInsightsManager manager) {
        manager.webTests().define("my-webtest-my-component").withRegion("South Central US")
            .withExistingResourceGroup("my-resource-group").withKind(WebTestKind.PING)
            .withSyntheticMonitorId("my-webtest-my-component").withWebTestName("my-webtest-my-component")
            .withFrequency(600).withTimeout(30).withWebTestKind(WebTestKind.PING)
            .withLocations(Arrays.asList(new WebTestGeolocation().withLocation("us-fl-mia-edge"),
                new WebTestGeolocation().withLocation("apac-hk-hkn-azr")))
            .withConfiguration(new WebTestPropertiesConfiguration().withWebTest(
                "<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>"))
            .create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.ApplicationInsights.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.ApplicationInsights;

// Generated from example definition: specification/applicationinsights/resource-manager/Microsoft.Insights/stable/2022-06-15/examples/WebTestUpdate.json
// this example is just showing the usage of "WebTests_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "subid";
string resourceGroupName = "my-resource-group";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ApplicationInsightsWebTestResource
ApplicationInsightsWebTestCollection collection = resourceGroupResource.GetApplicationInsightsWebTests();

// invoke the operation
string webTestName = "my-webtest-my-component";
ApplicationInsightsWebTestData data = new ApplicationInsightsWebTestData(new AzureLocation("South Central US"))
{
    Kind = WebTestKind.Ping,
    SyntheticMonitorId = "my-webtest-my-component",
    WebTestName = "my-webtest-my-component",
    FrequencyInSeconds = 600,
    TimeoutInSeconds = 30,
    WebTestKind = WebTestKind.Ping,
    Locations =
    {
    new WebTestGeolocation()
    {
    Location = new AzureLocation("us-fl-mia-edge"),
    },new WebTestGeolocation()
    {
    Location = new AzureLocation("apac-hk-hkn-azr"),
    }
    },
    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>",
};
ArmOperation<ApplicationInsightsWebTestResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, webTestName, data);
ApplicationInsightsWebTestResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ApplicationInsightsWebTestData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:: 200

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

Definitionen

Name	Beschreibung
Configuration	Eine XML-Konfigurationsspezifikation für einen WebTest.
ContentValidation	Die Auflistung von Inhaltsüberprüfungseigenschaften
HeaderField	Ein Header, der dem WebTest hinzugefügt werden soll.
Request	Die Auflistung der Anforderungseigenschaften
ValidationRules	Die Auflistung der Eigenschaften der Validierungsregel
WebTest	Eine Application Insights-WebTest-Definition.
WebTestGeolocation	Geo-physischer Standort, an dem ein WebTest ausgeführt werden soll. Sie müssen mindestens einen Speicherort angeben, von dem aus der Test ausgeführt werden soll.
WebTestKind	Die Art von WebTest, die dieser Webtest überwacht. Auswahlmöglichkeiten sind Ping, Mehrschritt und Standard.

Configuration

Eine XML-Konfigurationsspezifikation für einen WebTest.

Name	Typ	Beschreibung
WebTest	string	Die XML-Spezifikation eines WebTest, der für eine Anwendung ausgeführt werden soll.

ContentValidation

Die Auflistung von Inhaltsüberprüfungseigenschaften

Name	Typ	Beschreibung
ContentMatch	string	Inhalt, der in der Rückgabe des WebTest gesucht werden soll. Darf nicht NULL oder leer sein.
IgnoreCase	boolean	Wenn dieser Wert festgelegt ist, wird bei der ContentMatch-Überprüfung die Groß-/Kleinschreibung nicht beachtet.
PassIfTextFound	boolean	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.

HeaderField

Ein Header, der dem WebTest hinzugefügt werden soll.

Name	Typ	Beschreibung
key	string	Der Name des Headers.
value	string	Der Wert des Headers.

Request

Die Auflistung der Anforderungseigenschaften

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

ValidationRules

Die Auflistung der Eigenschaften der Validierungsregel

Name	Typ	Beschreibung
ContentValidation	ContentValidation	Die Auflistung von Inhaltsüberprüfungseigenschaften
ExpectedHttpStatusCode	integer	Überprüfen Sie, ob webTest den bereitgestellten HTTP-status Code zurückgibt.
IgnoreHttpStatusCode	boolean	Wenn diese Einstellung festgelegt ist, ignoriert die Überprüfung den status Code.
SSLCertRemainingLifetimeCheck	integer	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.
SSLCheck	boolean	Überprüft, ob das SSL-Zertifikat noch gültig ist.

WebTest

Eine Application Insights-WebTest-Definition.

Name	Typ	Standardwert	Beschreibung
id	string		Azure-Ressourcen-ID
kind	WebTestKind	ping	Die Art von WebTest, die dieser Webtest überwacht. Auswahlmöglichkeiten sind Ping, Mehrschritt und Standard.
location	string		Ressourcenspeicherort
name	string		Name der Azure-Ressource
properties.Configuration	Configuration		Eine XML-Konfigurationsspezifikation für einen WebTest.
properties.Description	string		Benutzerdefinierte Beschreibung für diesen WebTest.
properties.Enabled	boolean		Der Test, der aktiv überwacht wird.
properties.Frequency	integer	300	Intervall in Sekunden zwischen Testläufen für diesen WebTest. Der Standardwert ist 300.
properties.Kind	WebTestKind	ping	Die Art des Webtests ist dies, gültige Optionen sind Ping, mehrstufige und Standard.
properties.Locations	WebTestGeolocation[]		Eine Liste, von der aus die Tests physisch ausgeführt werden sollen, um die Barrierefreiheit Ihrer Anwendung global abzudecken.
properties.Name	string		Benutzerdefinierter Name, wenn dieser WebTest.
properties.Request	Request		Die Auflistung der Anforderungseigenschaften
properties.RetryEnabled	boolean		Lassen Sie Wiederholungsversuche zu, wenn dieser WebTest fehlschlägt.
properties.SyntheticMonitorId	string		Eindeutige ID dieses WebTest. Dies ist in der Regel derselbe Wert wie das Feld Name.
properties.Timeout	integer	30	Sekunden, bis für diesen WebTest ein Timeout auftritt und ein Fehler auftritt. Standardwert: 30.
properties.ValidationRules	ValidationRules		Die Auflistung der Eigenschaften der Validierungsregel
properties.provisioningState	string		Aktueller Status dieser Komponente, ob innerhalb der definierten Ressourcengruppe bereitgestellt wurde oder nicht. Benutzer können diesen Wert nicht ändern, können aber daraus lesen. Zu den Werten gehören Succeeded, Deploying, Canceled und Failed.
tags	object		Ressourcentags
type	string		Azure-Ressourcentyp

WebTestGeolocation

Geo-physischer Standort, an dem ein WebTest ausgeführt werden soll. Sie müssen mindestens einen Speicherort angeben, von dem aus der Test ausgeführt werden soll.

Name	Typ	Beschreibung
Id	string	Standort-ID für den Auszuführenden WebTest.

WebTestKind

Die Art von WebTest, die dieser Webtest überwacht. Auswahlmöglichkeiten sind Ping, Mehrschritt und Standard.

Name	Typ	Beschreibung
multistep	string
ping	string
standard	string

Freigeben über

Web Tests - Create Or Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

webTestCreate

Beispielanforderung

Beispiel für eine Antwort

webTestCreateStandard

Beispielanforderung

Beispiel für eine Antwort

webTestUpdate

Beispielanforderung

Beispiel für eine Antwort

Definitionen

Configuration

ContentValidation

HeaderField

Request

ValidationRules

WebTest

WebTestGeolocation

WebTestKind

Zusätzliche Ressourcen