Web Tests - Create Or Update
Создает или обновляет определение веб-теста Application Insights.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/webtests/{webTestName}?api-version=2022-06-15
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
resource
|
path | True |
string |
Имя группы ресурсов. Регистр букв в имени не учитывается. |
subscription
|
path | True |
string |
Идентификатор целевой подписки. |
web
|
path | True |
string |
Имя ресурса Application Insights WebTest. |
api-version
|
query | True |
string |
Версия API, используемая для данной операции. |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
location | True |
string |
Расположение ресурса |
properties.Kind | True |
Тип веб-теста это, допустимые варианты: ping, multistep и standard. |
|
properties.Locations | True |
Список физических запусков тестов, чтобы обеспечить глобальное покрытие доступности приложения. |
|
properties.Name | True |
string |
Определяемое пользователем имя, если это WebTest. |
properties.SyntheticMonitorId | True |
string |
Уникальный идентификатор этого веб-теста. Обычно это значение совпадает с полем Имя. |
kind |
Тип WebTest, который просматривает этот веб-тест. Возможные варианты: ping, multistep и standard. |
||
properties.Configuration |
Спецификация конфигурации XML для WebTest. |
||
properties.Description |
string |
Определенное пользователем описание для этого веб-теста. |
|
properties.Enabled |
boolean |
Тест активно отслеживается. |
|
properties.Frequency |
integer |
Интервал в секундах между запусками тестов для этого веб-теста. Значение по умолчанию — 300. |
|
properties.Request |
Коллекция свойств запроса |
||
properties.RetryEnabled |
boolean |
Разрешите повторные попытки в случае сбоя веб-теста. |
|
properties.Timeout |
integer |
В секундах до этого веб-теста истекло время ожидания и завершится сбоем. Значение по умолчанию — 30. |
|
properties.ValidationRules |
Коллекция свойств правила проверки |
||
tags |
object |
Теги ресурсов |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Веб-тест Application Insights успешно создан или обновлен. |
Безопасность
azure_auth
Поток OAuth2 в Azure Active Directory.
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
Имя | Описание |
---|---|
user_impersonation | олицетворения учетной записи пользователя |
Примеры
web |
web |
web |
webTestCreate
Образец запроса
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"
}
]
}
}
Пример ответа
{
"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
Образец запроса
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"
}
]
}
}
Пример ответа
{
"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
Образец запроса
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"
}
}
Пример ответа
{
"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"
}
}
Определения
Имя | Описание |
---|---|
Configuration |
Спецификация конфигурации XML для WebTest. |
Content |
Коллекция свойств проверки содержимого |
Header |
Заголовок, добавляемый в WebTest. |
Request |
Коллекция свойств запроса |
Validation |
Коллекция свойств правила проверки |
Web |
Определение Веб-теста Application Insights. |
Web |
Географическое расположение для запуска WebTest. Необходимо указать одно или несколько расположений для запуска теста. |
Web |
Тип WebTest, который просматривает этот веб-тест. Возможные варианты: ping, multistep и standard. |
Configuration
Спецификация конфигурации XML для WebTest.
Имя | Тип | Описание |
---|---|---|
WebTest |
string |
Спецификация XML WebTest для запуска в приложении. |
ContentValidation
Коллекция свойств проверки содержимого
Имя | Тип | Описание |
---|---|---|
ContentMatch |
string |
Содержимое для поиска в возвращаемом веб-тесте. Не должен иметь значение NULL или быть пустым. |
IgnoreCase |
boolean |
Если задано это значение, регистр проверки ContentMatch не учитывается. |
PassIfTextFound |
boolean |
Если значение равно true, проверка будет пройдена, если для строки ContentMatch имеется совпадение. Если задано значение false, проверка завершится ошибкой при наличии совпадения |
HeaderField
Заголовок, добавляемый в WebTest.
Имя | Тип | Описание |
---|---|---|
key |
string |
Имя заголовка. |
value |
string |
Значение заголовка. |
Request
Коллекция свойств запроса
Имя | Тип | Описание |
---|---|---|
FollowRedirects |
boolean |
Следуйте перенаправлениям для этого веб-теста. |
Headers |
Список заголовков и их значений, добавляемых в вызов WebTest. |
|
HttpVerb |
string |
Http-команда, используемая для этого веб-теста. |
ParseDependentRequests |
boolean |
Анализ зависимого запроса для этого веб-теста. |
RequestBody |
string |
Текст строки в кодировке Base64 для отправки с помощью этого веб-теста. |
RequestUrl |
string |
Расположение URL-адреса для проверки. |
ValidationRules
Коллекция свойств правила проверки
Имя | Тип | Описание |
---|---|---|
ContentValidation |
Коллекция свойств проверки содержимого |
|
ExpectedHttpStatusCode |
integer |
Убедитесь, что WebTest возвращает предоставленный код состояния HTTP. |
IgnoreHttpStatusCode |
boolean |
Если этот параметр задан, проверка будет игнорировать код состояния. |
SSLCertRemainingLifetimeCheck |
integer |
До истечения срока действия существующего SSL-сертификата остается несколько дней до проверка. Значение должно быть положительным, а значение SSLCheck должно иметь значение true. |
SSLCheck |
boolean |
Проверяет, действителен ли SSL-сертификат. |
WebTest
Определение Веб-теста Application Insights.
Имя | Тип | Default value | Описание |
---|---|---|---|
id |
string |
Идентификатор ресурса Azure |
|
kind | ping |
Тип WebTest, который просматривает этот веб-тест. Возможные варианты: ping, multistep и standard. |
|
location |
string |
Расположение ресурса |
|
name |
string |
Имя ресурса Azure |
|
properties.Configuration |
Спецификация конфигурации XML для WebTest. |
||
properties.Description |
string |
Определенное пользователем описание для этого веб-теста. |
|
properties.Enabled |
boolean |
Тест активно отслеживается. |
|
properties.Frequency |
integer |
300 |
Интервал в секундах между запусками тестов для этого веб-теста. Значение по умолчанию — 300. |
properties.Kind | ping |
Тип веб-теста это, допустимые варианты: ping, multistep и standard. |
|
properties.Locations |
Список физических запусков тестов, чтобы обеспечить глобальное покрытие доступности приложения. |
||
properties.Name |
string |
Определяемое пользователем имя, если это WebTest. |
|
properties.Request |
Коллекция свойств запроса |
||
properties.RetryEnabled |
boolean |
Разрешите повторные попытки в случае сбоя веб-теста. |
|
properties.SyntheticMonitorId |
string |
Уникальный идентификатор этого веб-теста. Обычно это значение совпадает с полем Имя. |
|
properties.Timeout |
integer |
30 |
В секундах до этого веб-теста истекло время ожидания и завершится сбоем. Значение по умолчанию — 30. |
properties.ValidationRules |
Коллекция свойств правила проверки |
||
properties.provisioningState |
string |
Текущее состояние этого компонента, независимо от того, подготовлено ли оно к работе в определенной группе ресурсов. Пользователи не могут изменить это значение, но могут считывать его. Значения будут включать Succeeded, Deploying, Canceled и Failed. |
|
tags |
object |
Теги ресурсов |
|
type |
string |
Тип ресурса Azure |
WebTestGeolocation
Географическое расположение для запуска WebTest. Необходимо указать одно или несколько расположений для запуска теста.
Имя | Тип | Описание |
---|---|---|
Id |
string |
Идентификатор расположения для веб-теста для запуска. |
WebTestKind
Тип WebTest, который просматривает этот веб-тест. Возможные варианты: ping, multistep и standard.
Имя | Тип | Описание |
---|---|---|
multistep |
string |
|
ping |
string |
|
standard |
string |