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 |
---|---|---|---|---|
resource
|
path | True |
string |
O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas. |
subscription
|
path | True |
string |
O ID da subscrição 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 utilizar para esta operação. |
Corpo do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
location | True |
string |
Localização do recurso |
properties.Kind | True |
O tipo de teste Web que isto é, as escolhas válidas são ping, multistep e standard. |
|
properties.Locations | True |
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 |
O tipo de WebTest que este teste Web observa. As opções são ping, multistep e standard. |
||
properties.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 |
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 |
A coleção de propriedades da regra de validação |
||
tags |
object |
Etiquetas de recursos |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
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
web |
web |
web |
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. |
Content |
A coleção de propriedades de validação de conteúdo |
Header |
Um cabeçalho a adicionar ao WebTest. |
Request |
A coleção de propriedades do pedido |
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 para executar um WebTest a partir de. Tem de especificar uma ou mais localizações para o teste ser executado. |
Web |
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 |
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 |
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 | 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 |
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 | ping |
O tipo de teste Web que isto é, as escolhas válidas são ping, multistep e standard. |
|
properties.Locations |
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 |
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 |
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 |