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 |
---|---|---|---|---|
resource
|
path | True |
string |
O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas. |
subscription
|
path | True |
string |
A ID da assinatura de destino. |
web
|
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 |
O tipo de teste na Web é: opções válidas são ping, multietapa e padrão. |
|
properties.Locations | True |
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 |
O tipo de WebTest que este teste da Web observa. As opções são ping, várias etapas e padrão. |
||
properties.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 |
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 |
A coleção de propriedades da regra de validação |
||
tags |
object |
Marcações de recursos |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
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
web |
web |
web |
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. |
Content |
A coleção de propriedades de validação de conteúdo |
Header |
Um cabeçalho a ser adicionado ao WebTest. |
Request |
A coleção de propriedades de solicitação |
Validation |
A coleção de propriedades da regra de validação |
Web |
Uma definição do Application Insights WebTest. |
Web |
Localização geográfica física da qual executar um WebTest. Você deve especificar um ou mais locais para que o teste seja executado. |
Web |
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 |
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 |
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 | 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 |
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 | ping |
O tipo de teste na Web é: opções válidas são ping, multietapa e padrão. |
|
properties.Locations |
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 |
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 |
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 |