Web Tests - Create Or Update

Cria ou atualiza uma definição de teste da 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 de URI

Nome Em Obrigatório Tipo Description
resourceGroupName
path True

string

O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.

subscriptionId
path True

string

A ID da assinatura 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 ser usada para esta operação.

Corpo da solicitação

Nome Obrigatório Tipo Description
location True

string

Localização do recurso

properties.Kind True

WebTestKind

O tipo de teste na Web é: opções válidas são ping, multietapa e padrão.

properties.Locations True

WebTestGeolocation[]

Uma lista de onde executar fisicamente os testes de para fornecer cobertura global para acessibilidade do seu aplicativo.

properties.Name True

string

Nome definido pelo usuário se este WebTest.

properties.SyntheticMonitorId True

string

ID exclusiva deste WebTest. Normalmente, esse é o mesmo valor que o campo Nome.

kind

WebTestKind

O tipo de WebTest que este teste da Web observa. As opções são ping, várias etapas e padrão.

properties.Configuration

Configuration

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

properties.Description

string

Descrição definida pelo usuário para este WebTest.

properties.Enabled

boolean

O teste está sendo monitorado ativamente.

properties.Frequency

integer

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

properties.Request

Request

A coleção de propriedades de solicitação

properties.RetryEnabled

boolean

Permitir novas tentativas caso este WebTest falhe.

properties.Timeout

integer

Segundos até que esse WebTest atesta o tempo limite e falhe. O valor padrão é 30.

properties.ValidationRules

ValidationRules

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

tags

object

Marcações de recursos

Respostas

Nome Tipo Description
200 OK

WebTest

Criou ou atualizou com êxito um teste web do Application Insights.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

webTestCreate
webTestCreateStandard
webTestUpdate

webTestCreate

Solicitação de exemplo

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 de exemplo

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

Solicitação de exemplo

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 de exemplo

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

Solicitação de exemplo

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 de exemplo

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

Nome 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 ser adicionado ao WebTest.

Request

A coleção de propriedades de solicitação

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 da qual executar um WebTest. Você deve especificar um ou mais locais para que o teste seja executado.

WebTestKind

O tipo de WebTest que este teste da Web observa. As opções são ping, várias etapas e padrão.

Configuration

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

Nome Tipo Description
WebTest

string

A especificação XML de um WebTest a ser executado em um aplicativo.

ContentValidation

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

Nome Tipo Description
ContentMatch

string

Conteúdo a ser buscado no retorno do WebTest. Não deve ser nulo ou vazio.

IgnoreCase

boolean

Quando definido, esse valor não diferencia maiúsculas de minúsculas de validação contentMatch.

PassIfTextFound

boolean

Quando true, a validação será aprovada se houver uma correspondência para a cadeia de caracteres ContentMatch. Se for false, a validação falhará se houver uma correspondência

HeaderField

Um cabeçalho a ser adicionado ao WebTest.

Nome Tipo Description
key

string

O nome do cabeçalho.

value

string

O valor do cabeçalho.

Request

A coleção de propriedades de solicitação

Nome Tipo Description
FollowRedirects

boolean

Siga os redirecionamentos para este teste na Web.

Headers

HeaderField[]

Lista de cabeçalhos e seus valores a serem adicionados à chamada webTest.

HttpVerb

string

Verbo http a ser usado para este teste na Web.

ParseDependentRequests

boolean

Analisar solicitação dependente para este WebTest.

RequestBody

string

Corpo da cadeia de caracteres codificada em Base64 a ser enviado com este teste na Web.

RequestUrl

string

Local da URL a ser testada.

ValidationRules

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

Nome Tipo Description
ContentValidation

ContentValidation

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

ExpectedHttpStatusCode

integer

Valide se o WebTest retorna o código http status fornecido.

IgnoreHttpStatusCode

boolean

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

SSLCertRemainingLifetimeCheck

integer

Alguns dias para marcar ainda permanecem antes que o certificado SSL existente expire. O valor deve ser positivo e o SSLCheck deve ser definido como true.

SSLCheck

boolean

Verifica se o certificado SSL ainda é válido.

WebTest

Uma definição do Application Insights WebTest.

Nome Tipo Valor padrão Description
id

string

ID do recurso do Azure

kind

WebTestKind

ping

O tipo de WebTest que este teste da Web observa. As opções são ping, várias etapas e padrão.

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 usuário para este WebTest.

properties.Enabled

boolean

O teste está sendo monitorado ativamente.

properties.Frequency

integer

300

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

properties.Kind

WebTestKind

ping

O tipo de teste na Web é: opções válidas são ping, multietapa e padrão.

properties.Locations

WebTestGeolocation[]

Uma lista de onde executar fisicamente os testes de para fornecer cobertura global para acessibilidade do seu aplicativo.

properties.Name

string

Nome definido pelo usuário se este WebTest.

properties.Request

Request

A coleção de propriedades de solicitação

properties.RetryEnabled

boolean

Permitir novas tentativas caso este WebTest falhe.

properties.SyntheticMonitorId

string

ID exclusiva deste WebTest. Normalmente, esse é o mesmo valor que o campo Nome.

properties.Timeout

integer

30

Segundos até que esse WebTest atesta o tempo limite e falhe. O valor padrão é 30.

properties.ValidationRules

ValidationRules

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

properties.provisioningState

string

Estado atual desse componente, se foi provisionado ou não dentro do grupo de recursos definido. Os usuários não podem alterar esse valor, mas podem lê-lo. Os valores incluirão Êxito, Implantação, Cancelamento e Falha.

tags

object

Marcações de recursos

type

string

Tipo de recurso do Azure

WebTestGeolocation

Localização geográfica física da qual executar um WebTest. Você deve especificar um ou mais locais para que o teste seja executado.

Nome Tipo Description
Id

string

ID de local do WebTest do qual executar.

WebTestKind

O tipo de WebTest que este teste da Web observa. As opções são ping, várias etapas e padrão.

Nome Tipo Description
multistep

string

ping

string

standard

string