Sdílet prostřednictvím

Web Tests - Create Or Update

Služba:
Application Insights
Verze rozhraní API:
2022-06-15

Vytvoří nebo aktualizuje definici webového testu Application Insights.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId
 path True

string

minLength: 1

ID cílového předplatného.
webTestName
 path True

string

Název prostředku Application Insights WebTest.
api-version
 query True

string

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name Vyžadováno Typ Description
location True

string

Umístění prostředku
properties.Kind True

WebTestKind

Druh webového testu je, platné volby jsou ping, multistep a standard.
properties.Locations True

WebTestGeolocation[]

Seznam toho, odkud se mají testy fyzicky spouštět, abyste získali globální pokrytí přístupnosti vaší aplikace.
properties.Name True

string

Uživatelem definované jméno, pokud tento webový test.
properties.SyntheticMonitorId True

string

Jedinečné ID tohoto webového testu. Obvykle se jedná o stejnou hodnotu jako pole Název.
kind

WebTestKind

Druh webového testu, který tento webový test sleduje. Volby jsou ping, multistep a standard.
properties.Configuration

Configuration

Specifikace konfigurace XML pro WebTest.
properties.Description

string

Popis definovaný uživatelem pro tento webový test
properties.Enabled

boolean

Je test aktivně monitorovaný.
properties.Frequency

integer (int32)

Interval v sekundách mezi testovacími běhy pro tento webový test. Výchozí hodnota je 300.
properties.Request

Request

Kolekce vlastností požadavku
properties.RetryEnabled

boolean

Pokud tento webový test selže, povolte opakování.
properties.Timeout

integer (int32)

Sekundy, než tento webový test vyprší časový limit a selže. Výchozí hodnota je 30.
properties.ValidationRules

ValidationRules

Kolekce vlastností ověřovacího pravidla
tags

object

Značky prostředků

Odpovědi

Name Typ Description
200 OK

WebTest

Úspěšně se vytvořil nebo aktualizoval webový test Application Insights.

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

webTestCreate
webTestCreateStandard
webTestUpdate

webTestCreate

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
  }
}

Definice

Name Description
Configuration

Specifikace konfigurace XML pro WebTest.
ContentValidation

Kolekce vlastností ověření obsahu
HeaderField

Hlavička, která se má přidat do webového testu.
Request

Kolekce vlastností požadavku
ValidationRules

Kolekce vlastností ověřovacího pravidla
WebTest

Definice webového testu Application Insights.
WebTestGeolocation

Geograficky fyzické umístění pro spuštění webového testu z. Je nutné zadat jedno nebo více umístění, ze kterých se má test spustit.
WebTestKind

Druh webového testu, který tento webový test sleduje. Volby jsou ping, multistep a standard.

Configuration

Objekt

Specifikace konfigurace XML pro WebTest.

Name Typ Description
WebTest

string

Specifikace XML webového testu, která se má spustit v aplikaci.

ContentValidation

Objekt

Kolekce vlastností ověření obsahu

Name Typ Description
ContentMatch

string

Obsah, který se má hledat v návratu webového testu. Nesmí být null ani prázdný.
IgnoreCase

boolean

Při nastavení tato hodnota nerozlišuje malá a malá písmena ověřování ContentMatch.
PassIfTextFound

boolean

Pokud je hodnota true, ověření se předá, pokud existuje shoda pro řetězec ContentMatch. Pokud je false, ověření selže, pokud existuje shoda.

HeaderField

Objekt

Hlavička, která se má přidat do webového testu.

Name Typ Description
key

string

Název záhlaví.
value

string

Hodnota záhlaví.

Request

Objekt

Kolekce vlastností požadavku

Name Typ Description
FollowRedirects

boolean

Postupujte podle přesměrování pro tento webový test.
Headers

HeaderField[]

Seznam hlaviček a jejich hodnot, které chcete přidat do volání WebTest.
HttpVerb

string

Příkaz HTTP, který se má použít pro tento webový test.
ParseDependentRequests

boolean

Parsovat závislý požadavek pro tento webový test.
RequestBody

string

Text řetězce s kódováním Base64, který se má odeslat pomocí tohoto webového testu
RequestUrl

string

Umístění adresy URL, které se má otestovat.

ValidationRules

Objekt

Kolekce vlastností ověřovacího pravidla

Name Typ Description
ContentValidation

ContentValidation

Kolekce vlastností ověření obsahu
ExpectedHttpStatusCode

integer (int32)

Ověřte, že webový test vrací zadaný stavový kód HTTP.
IgnoreHttpStatusCode

boolean

Při nastavení bude ověření ignorovat stavový kód.
SSLCertRemainingLifetimeCheck

integer (int32)

Před vypršením platnosti existujícího certifikátu SSL stále zbývá zkontrolovat několik dnů. Hodnota musí být kladná a sslCheck musí být nastavena na true.
SSLCheck

boolean

Zkontroluje, jestli je certifikát SSL stále platný.

WebTest

Objekt

Definice webového testu Application Insights.

Name Typ Default value Description
id

string

ID prostředku Azure
kind

WebTestKind

ping

Druh webového testu, který tento webový test sleduje. Volby jsou ping, multistep a standard.
location

string

Umístění prostředku
name

string

Název prostředku Azure
properties.Configuration

Configuration

Specifikace konfigurace XML pro WebTest.
properties.Description

string

Popis definovaný uživatelem pro tento webový test
properties.Enabled

boolean

Je test aktivně monitorovaný.
properties.Frequency

integer (int32)

300

Interval v sekundách mezi testovacími běhy pro tento webový test. Výchozí hodnota je 300.
properties.Kind

WebTestKind

ping

Druh webového testu je, platné volby jsou ping, multistep a standard.
properties.Locations

WebTestGeolocation[]

Seznam toho, odkud se mají testy fyzicky spouštět, abyste získali globální pokrytí přístupnosti vaší aplikace.
properties.Name

string

Uživatelem definované jméno, pokud tento webový test.
properties.Request

Request

Kolekce vlastností požadavku
properties.RetryEnabled

boolean

Pokud tento webový test selže, povolte opakování.
properties.SyntheticMonitorId

string

Jedinečné ID tohoto webového testu. Obvykle se jedná o stejnou hodnotu jako pole Název.
properties.Timeout

integer (int32)

30

Sekundy, než tento webový test vyprší časový limit a selže. Výchozí hodnota je 30.
properties.ValidationRules

ValidationRules

Kolekce vlastností ověřovacího pravidla
properties.provisioningState

string

Aktuální stav této komponenty bez ohledu na to, jestli byla zřízena v rámci skupiny prostředků, je definována. Uživatelé nemohou tuto hodnotu změnit, ale mohou z ní číst. Hodnoty budou zahrnovat úspěch, nasazení, zrušení a selhání.
tags

object

Značky prostředků
type

string

Typ prostředku Azure

WebTestGeolocation

Objekt

Geograficky fyzické umístění pro spuštění webového testu z. Je nutné zadat jedno nebo více umístění, ze kterých se má test spustit.

Name Typ Description
Id

string

ID umístění, ze kterých se má webTest spustit.

WebTestKind

Výčet

Druh webového testu, který tento webový test sleduje. Volby jsou ping, multistep a standard.

Hodnota Description
ping
multistep
standard