Partilhar via


Web Tests - Create Or Update

Cria ou atualiza uma definição de teste Web do Application Insights.

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

Parâmetros do URI

Name Em Necessário Tipo Description
resourceGroupName
path True

string

O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.

subscriptionId
path True

string

O ID da subscrição de destino.

webTestName
path True

string

O nome do recurso WebTest do Application Insights.

api-version
query True

string

A versão da API a utilizar para esta operação.

Corpo do Pedido

Name Necessário Tipo Description
location True

string

Localização do recurso

properties.Kind True

WebTestKind

O tipo de teste Web que isto é, as escolhas válidas são ping, multistep e standard.

properties.Locations True

WebTestGeolocation[]

Uma lista de onde executar fisicamente os testes para dar cobertura global para acessibilidade da sua aplicação.

properties.Name True

string

Nome definido pelo utilizador se este WebTest.

properties.SyntheticMonitorId True

string

ID exclusivo deste WebTest. Normalmente, este é o mesmo valor que o campo Nome.

kind

WebTestKind

O tipo de WebTest que este teste Web observa. As opções são ping, multistep e standard.

properties.Configuration

Configuration

Uma especificação de configuração XML para um WebTest.

properties.Description

string

Descrição definida pelo utilizador para este WebTest.

properties.Enabled

boolean

O teste está a ser monitorizado ativamente.

properties.Frequency

integer

Intervalo em segundos entre execuções de teste para este WebTest. O valor predefinido é 300.

properties.Request

Request

A coleção de propriedades do pedido

properties.RetryEnabled

boolean

Permitir repetições caso este WebTest falhe.

properties.Timeout

integer

Segundos até este WebTest exceder o tempo limite e falhar. O valor predefinido é 30.

properties.ValidationRules

ValidationRules

A coleção de propriedades da regra de validação

tags

object

Etiquetas de recursos

Respostas

Name Tipo Description
200 OK

WebTest

Foi criado ou atualizado com êxito um teste Web do Application Insights.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

webTestCreate
webTestCreateStandard
webTestUpdate

webTestCreate

Pedido de amostra

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

Resposta da amostra

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

Pedido de amostra

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

Resposta da amostra

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

Pedido de amostra

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

Resposta da amostra

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

Definições

Name Description
Configuration

Uma especificação de configuração XML para um WebTest.

ContentValidation

A coleção de propriedades de validação de conteúdo

HeaderField

Um cabeçalho a adicionar ao WebTest.

Request

A coleção de propriedades do pedido

ValidationRules

A coleção de propriedades da regra de validação

WebTest

Uma definição do Application Insights WebTest.

WebTestGeolocation

Localização geográfica física para executar um WebTest a partir de. Tem de especificar uma ou mais localizações para o teste ser executado.

WebTestKind

O tipo de WebTest que este teste Web observa. As opções são ping, multistep e standard.

Configuration

Uma especificação de configuração XML para um WebTest.

Name Tipo Description
WebTest

string

A especificação XML de um WebTest para executar numa aplicação.

ContentValidation

A coleção de propriedades de validação de conteúdo

Name Tipo Description
ContentMatch

string

Conteúdo a procurar na devolução do WebTest. Não pode ser nulo ou estar vazio.

IgnoreCase

boolean

Quando definido, este valor torna as maiúsculas e minúsculas de validação ContentMatch insensíveis.

PassIfTextFound

boolean

Quando verdadeiro, a validação será transmitida se existir uma correspondência para a cadeia ContentMatch. Se for falso, a validação falhará se existir uma correspondência

HeaderField

Um cabeçalho a adicionar ao WebTest.

Name Tipo Description
key

string

O nome do cabeçalho.

value

string

O valor do cabeçalho.

Request

A coleção de propriedades do pedido

Name Tipo Description
FollowRedirects

boolean

Siga os redirecionamentos para este teste Web.

Headers

HeaderField[]

Lista de cabeçalhos e respetivos valores a adicionar à chamada WebTest.

HttpVerb

string

Verbo http a utilizar para este teste Web.

ParseDependentRequests

boolean

Analisar pedido dependente para este WebTest.

RequestBody

string

Corpo da cadeia codificada base64 para enviar com este teste Web.

RequestUrl

string

Localização do URL a testar.

ValidationRules

A coleção de propriedades da regra de validação

Name Tipo Description
ContentValidation

ContentValidation

A coleção de propriedades de validação de conteúdo

ExpectedHttpStatusCode

integer

Confirme que o WebTest devolve o código de estado http fornecido.

IgnoreHttpStatusCode

boolean

Quando definida, a validação ignorará o código de estado.

SSLCertRemainingLifetimeCheck

integer

Ainda falta um número de dias para verificar se o certificado SSL existente expira. O valor tem de ser positivo e o SSLCheck tem de ser definido como verdadeiro.

SSLCheck

boolean

Verifica se o certificado SSL ainda é válido.

WebTest

Uma definição do Application Insights WebTest.

Name Tipo Default value Description
id

string

ID do recurso do Azure

kind

WebTestKind

ping

O tipo de WebTest que este teste Web observa. As opções são ping, multistep e standard.

location

string

Localização do recurso

name

string

Nome do recurso do Azure

properties.Configuration

Configuration

Uma especificação de configuração XML para um WebTest.

properties.Description

string

Descrição definida pelo utilizador para este WebTest.

properties.Enabled

boolean

O teste está a ser monitorizado ativamente.

properties.Frequency

integer

300

Intervalo em segundos entre execuções de teste para este WebTest. O valor predefinido é 300.

properties.Kind

WebTestKind

ping

O tipo de teste Web que isto é, as escolhas válidas são ping, multistep e standard.

properties.Locations

WebTestGeolocation[]

Uma lista de onde executar fisicamente os testes para dar cobertura global para acessibilidade da sua aplicação.

properties.Name

string

Nome definido pelo utilizador se este WebTest.

properties.Request

Request

A coleção de propriedades do pedido

properties.RetryEnabled

boolean

Permitir repetições caso este WebTest falhe.

properties.SyntheticMonitorId

string

ID exclusivo deste WebTest. Normalmente, este é o mesmo valor que o campo Nome.

properties.Timeout

integer

30

Segundos até este WebTest exceder o tempo limite e falhar. O valor predefinido é 30.

properties.ValidationRules

ValidationRules

A coleção de propriedades da regra de validação

properties.provisioningState

string

Estado atual deste componente, se foi ou não aprovisionado no grupo de recursos que está definido. Os utilizadores não podem alterar este valor, mas conseguem ler a partir do mesmo. Os valores incluirão Êxito, Implementação, Cancelado e Com Falhas.

tags

object

Etiquetas de recursos

type

string

Tipo de recurso do Azure

WebTestGeolocation

Localização geográfica física para executar um WebTest a partir de. Tem de especificar uma ou mais localizações para o teste ser executado.

Name Tipo Description
Id

string

ID de Localização para o WebTest a executar.

WebTestKind

O tipo de WebTest que este teste Web observa. As opções são ping, multistep e standard.

Name Tipo Description
multistep

string

ping

string

standard

string