Dela via


Web Tests - Create Or Update

Skapar eller uppdaterar en Application Insights-webbtestdefinition.

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

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

subscriptionId
path True

string

ID för målprenumerationen.

webTestName
path True

string

Namnet på Application Insights WebTest-resursen.

api-version
query True

string

Den API-version som ska användas för den här åtgärden.

Begärandetext

Name Obligatorisk Typ Description
location True

string

Resursplats

properties.Kind True

WebTestKind

Den typ av webbtest det här är, giltiga val är ping, flera steg och standard.

properties.Locations True

WebTestGeolocation[]

En lista över var du fysiskt kan köra testerna från för att ge global täckning för tillgänglighet för ditt program.

properties.Name True

string

Användardefinierat namn om detta WebTest.

properties.SyntheticMonitorId True

string

Unikt ID för detta WebTest. Detta är vanligtvis samma värde som fältet Namn.

kind

WebTestKind

Den typ av WebTest som denna webbtest klockor. Alternativen är ping, flera steg och standard.

properties.Configuration

Configuration

En XML-konfigurationsspecifikation för ett WebTest.

properties.Description

string

Användardefinierad beskrivning för detta WebTest.

properties.Enabled

boolean

Övervakas testet aktivt.

properties.Frequency

integer

Intervall i sekunder mellan testkörningar för detta WebTest. Standardvärdet är 300.

properties.Request

Request

Samlingen med egenskaper för begäranden

properties.RetryEnabled

boolean

Tillåt återförsök om webtestet misslyckas.

properties.Timeout

integer

Sekunder tills detta WebTest överskrider tidsgränsen och misslyckas. Standardvärdet är 30.

properties.ValidationRules

ValidationRules

Samlingen med egenskaper för verifieringsuttryck

tags

object

Resurstaggar

Svar

Name Typ Description
200 OK

WebTest

Ett Application Insights-webbtest har skapats eller uppdaterats.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

webTestCreate
webTestCreateStandard
webTestUpdate

webTestCreate

Exempelbegäran

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

Exempelsvar

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

Exempelbegäran

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

Exempelsvar

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

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
Configuration

En XML-konfigurationsspecifikation för ett WebTest.

ContentValidation

Samlingen med egenskaper för innehållsverifiering

HeaderField

En rubrik som ska läggas till i WebTest.

Request

Samlingen med egenskaper för begäranden

ValidationRules

Samlingen med egenskaper för verifieringsuttryck

WebTest

En Application Insights WebTest-definition.

WebTestGeolocation

Geo-fysisk plats att köra ett WebTest från. Du måste ange en eller flera platser som testet ska köras från.

WebTestKind

Den typ av WebTest som denna webbtest klockor. Alternativen är ping, flera steg och standard.

Configuration

En XML-konfigurationsspecifikation för ett WebTest.

Name Typ Description
WebTest

string

XML-specifikationen för ett WebTest som ska köras mot ett program.

ContentValidation

Samlingen med egenskaper för innehållsverifiering

Name Typ Description
ContentMatch

string

Innehåll att söka efter i returen av WebTest. Får inte vara null eller tomt.

IgnoreCase

boolean

När det här värdet anges blir ContentMatch-valideringsfallet okänsligt.

PassIfTextFound

boolean

När det är sant godkänns valideringen om det finns en matchning för ContentMatch-strängen. Om det är falskt misslyckas verifieringen om det finns en matchning

HeaderField

En rubrik som ska läggas till i WebTest.

Name Typ Description
key

string

Namnet på rubriken.

value

string

Värdet för rubriken.

Request

Samlingen med egenskaper för begäranden

Name Typ Description
FollowRedirects

boolean

Följ omdirigeringar för det här webbtestet.

Headers

HeaderField[]

Lista över rubriker och deras värden som ska läggas till i WebTest-anropet.

HttpVerb

string

Http-verb som ska användas för det här webbtestet.

ParseDependentRequests

boolean

Parsa beroende begäran för detta WebTest.

RequestBody

string

Base64-kodad strängtext som ska skickas med det här webbtestet.

RequestUrl

string

Url-plats som ska testas.

ValidationRules

Samlingen med egenskaper för verifieringsuttryck

Name Typ Description
ContentValidation

ContentValidation

Samlingen med egenskaper för innehållsverifiering

ExpectedHttpStatusCode

integer

Kontrollera att WebTest returnerar den angivna http-statuskoden.

IgnoreHttpStatusCode

boolean

När den har angetts ignoreras statuskoden vid valideringen.

SSLCertRemainingLifetimeCheck

integer

Ett antal dagar att kontrollera kvarstår innan det befintliga SSL-certifikatet upphör att gälla. Värdet måste vara positivt och SSLCheck måste anges till true.

SSLCheck

boolean

Kontrollerar om SSL-certifikatet fortfarande är giltigt.

WebTest

En Application Insights WebTest-definition.

Name Typ Standardvärde Description
id

string

Resurs-ID för Azure

kind

WebTestKind

ping

Den typ av WebTest som denna webbtest klockor. Alternativen är ping, flera steg och standard.

location

string

Resursplats

name

string

Azure-resursnamn

properties.Configuration

Configuration

En XML-konfigurationsspecifikation för ett WebTest.

properties.Description

string

Användardefinierad beskrivning för detta WebTest.

properties.Enabled

boolean

Övervakas testet aktivt.

properties.Frequency

integer

300

Intervall i sekunder mellan testkörningar för detta WebTest. Standardvärdet är 300.

properties.Kind

WebTestKind

ping

Den typ av webbtest det här är, giltiga val är ping, flera steg och standard.

properties.Locations

WebTestGeolocation[]

En lista över var du fysiskt kan köra testerna från för att ge global täckning för tillgänglighet för ditt program.

properties.Name

string

Användardefinierat namn om detta WebTest.

properties.Request

Request

Samlingen med egenskaper för begäranden

properties.RetryEnabled

boolean

Tillåt återförsök om webtestet misslyckas.

properties.SyntheticMonitorId

string

Unikt ID för detta WebTest. Detta är vanligtvis samma värde som fältet Namn.

properties.Timeout

integer

30

Sekunder tills detta WebTest överskrider tidsgränsen och misslyckas. Standardvärdet är 30.

properties.ValidationRules

ValidationRules

Samlingen med egenskaper för verifieringsuttryck

properties.provisioningState

string

Aktuellt tillstånd för den här komponenten, oavsett om den har etablerats i resursgruppen eller inte, definieras den. Användare kan inte ändra det här värdet men kan läsa från det. Värdena inkluderar Succeeded(Lyckades), Deploying (Distribuera), Canceled (Avbruten) och Failed (Misslyckades).

tags

object

Resurstaggar

type

string

Azure-resurstyp

WebTestGeolocation

Geo-fysisk plats att köra ett WebTest från. Du måste ange en eller flera platser som testet ska köras från.

Name Typ Description
Id

string

Plats-ID för WebTest som ska köras från.

WebTestKind

Den typ av WebTest som denna webbtest klockor. Alternativen är ping, flera steg och standard.

Name Typ Description
multistep

string

ping

string

standard

string