你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Web Tests - Get

服务:

Application Insights

API 版本:

2022-06-15

获取特定的 Application Insights Web 测试定义。

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

URI 参数

名称	在	必需	类型	说明
resourceGroupName	path	True	string	资源组的名称。 此名称不区分大小写。
subscriptionId	path	True	string	目标订阅的 ID。
webTestName	path	True	string	Application Insights WebTest 资源的名称。
api-version	query	True	string	要用于此操作的 API 版本。

响应

名称	类型	说明
200 OK	WebTest	Ann Application Insights Web 测试定义。

安全性

azure_auth

Azure Active Directory OAuth2 流。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

webTestGet

示例请求

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-01-mywebservice?api-version=2022-06-15

Java

/** Samples for WebTests GetByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file: specification/applicationinsights/resource-manager/Microsoft.Insights/stable/2022-06-15/examples/WebTestGet.json
     */
    /**
     * Sample code: webTestGet.
     *
     * @param manager Entry point to ApplicationInsightsManager.
     */
    public static void webTestGet(com.azure.resourcemanager.applicationinsights.ApplicationInsightsManager manager) {
        manager
            .webTests()
            .getByResourceGroupWithResponse(
                "my-resource-group", "my-webtest-01-mywebservice", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential
from azure.mgmt.applicationinsights import ApplicationInsightsManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-applicationinsights
# USAGE
    python web_test_get.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ApplicationInsightsManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="subid",
    )

    response = client.web_tests.get(
        resource_group_name="my-resource-group",
        web_test_name="my-webtest-01-mywebservice",
    )
    print(response)


# x-ms-original-file: specification/applicationinsights/resource-manager/Microsoft.Insights/stable/2022-06-15/examples/WebTestGet.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.ApplicationInsights.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.ApplicationInsights;

// Generated from example definition: specification/applicationinsights/resource-manager/Microsoft.Insights/stable/2022-06-15/examples/WebTestGet.json
// this example is just showing the usage of "WebTests_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ApplicationInsightsWebTestResource created on azure
// for more information of creating ApplicationInsightsWebTestResource, please refer to the document of ApplicationInsightsWebTestResource
string subscriptionId = "subid";
string resourceGroupName = "my-resource-group";
string webTestName = "my-webtest-01-mywebservice";
ResourceIdentifier applicationInsightsWebTestResourceId = ApplicationInsightsWebTestResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, webTestName);
ApplicationInsightsWebTestResource applicationInsightsWebTest = client.GetApplicationInsightsWebTestResource(applicationInsightsWebTestResourceId);

// invoke the operation
ApplicationInsightsWebTestResource result = await applicationInsightsWebTest.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ApplicationInsightsWebTestData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

示例响应

状态代码:

200

{
  "id": "/subscriptions/subid/resourceGroups/my-test-resources/providers/Microsoft.Insights/webtests/my-webtest-01-mywebservice",
  "name": "my-webtest-01-mywebservice",
  "type": "Microsoft.Insights/webtests",
  "location": "southcentralus",
  "tags": {
    "hidden-link:/subscriptions/subid/resourceGroups/my-test-resources/providers/Microsoft.Insights/components/mytester": "Resource"
  },
  "kind": "ping",
  "properties": {
    "SyntheticMonitorId": "my-webtest-01-mywebservice",
    "Name": "mytest-webtest-01",
    "Description": "",
    "Enabled": false,
    "Frequency": 900,
    "Timeout": 30,
    "Kind": "ping",
    "RetryEnabled": true,
    "Locations": [
      {
        "Id": "us-fl-mia-edge"
      },
      {
        "Id": "apac-hk-hkn-azr"
      }
    ],
    "Configuration": {
      "WebTest": "<WebTest Name=\"mytest-webtest-01\" Id=\"0317d26b-8672-4370-bd6b-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=\"a55ce143-4f1e-a7e6-b69e-123456789abc\" Version=\"1.1\" Url=\"http://mytester.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"30\" ParseDependentRequests=\"False\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
    },
    "provisioningState": "Succeeded"
  }
}

定义

名称	说明
Configuration	WebTest 的 XML 配置规范。
ContentValidation	内容验证属性的集合
HeaderField	要添加到 WebTest 的标头。
Request	请求属性的集合
ValidationRules	验证规则属性的集合
WebTest	Application Insights WebTest 定义。
WebTestGeolocation	要从中运行 WebTest 的地理位置。 必须指定一个或多个位置，以便从中运行测试。
WebTestKind	此 Web 测试监视的 WebTest 类型。 选项包括 ping、多步骤和标准。

Configuration

WebTest 的 XML 配置规范。

名称	类型	说明
WebTest	string	要针对应用程序运行的 WebTest 的 XML 规范。

ContentValidation

内容验证属性的集合

名称	类型	说明
ContentMatch	string	在 WebTest 的返回中要查找的内容。 不得为 null 或为空。
IgnoreCase	boolean	设置此值后，ContentMatch 验证不区分大小写。
PassIfTextFound	boolean	如果为 true，则如果存在与 ContentMatch 字符串匹配的匹配项，将通过验证。 如果为 false，则存在匹配项时验证将失败

HeaderField

要添加到 WebTest 的标头。

名称	类型	说明
key	string	标头的名称。
value	string	标头的值。

Request

请求属性的集合

名称	类型	说明
FollowRedirects	boolean	遵循此 Web 测试的重定向。
Headers	HeaderField[]	要添加到 WebTest 调用的标头及其值的列表。
HttpVerb	string	用于此 Web 测试的 Http 谓词。
ParseDependentRequests	boolean	分析此 WebTest 的依赖请求。
RequestBody	string	使用此 Web 测试发送的 Base64 编码字符串正文。
RequestUrl	string	要测试的 URL 位置。

ValidationRules

验证规则属性的集合

名称	类型	说明
ContentValidation	ContentValidation	内容验证属性的集合
ExpectedHttpStatusCode	integer	验证 WebTest 是否返回提供的 http 状态代码。
IgnoreHttpStatusCode	boolean	设置后，验证将忽略状态代码。
SSLCertRemainingLifetimeCheck	integer	在现有 SSL 证书过期之前，仍有几天检查。 值必须为正值，并且 SSLCheck 必须设置为 true。
SSLCheck	boolean	检查 SSL 证书是否仍然有效。

WebTest

Application Insights WebTest 定义。

名称	类型	默认值	说明
id	string		Azure 资源 ID
kind	WebTestKind	ping	此 Web 测试监视的 WebTest 类型。 选项包括 ping、多步骤和标准。
location	string		资源位置
name	string		Azure 资源名称
properties.Configuration	Configuration		WebTest 的 XML 配置规范。
properties.Description	string		此 WebTest 的用户定义说明。
properties.Enabled	boolean		测试是否受到主动监视。
properties.Frequency	integer	300	此 WebTest 的测试运行之间的间隔（以秒为单位）。 默认值为 300。
properties.Kind	WebTestKind	ping	这是 Web 测试的类型，有效选项为 ping、多步骤和标准。
properties.Locations	WebTestGeolocation[]		一个列表，其中列出了从何处实际运行测试，以便为应用程序的可访问性提供全球覆盖。
properties.Name	string		如果此 WebTest，则为用户定义的名称。
properties.Request	Request		请求属性的集合
properties.RetryEnabled	boolean		如果此 Web 测试失败，请允许重试。
properties.SyntheticMonitorId	string		此 WebTest 的唯一 ID。 这通常与“名称”字段的值相同。
properties.Timeout	integer	30	直到此 WebTest 超时并失败的秒数。 默认值为 30。
properties.ValidationRules	ValidationRules		验证规则属性的集合
properties.provisioningState	string		此组件的当前状态，无论 是否已在定义的资源组中预配。 用户无法更改此值，但可以从中读取此值。 值将包括 Succeeded、Deploying、Canceled 和 Failed。
tags	object		资源标记
type	string		Azure 资源类型

WebTestGeolocation

要从中运行 WebTest 的地理位置。 必须指定一个或多个位置，以便从中运行测试。

名称	类型	说明
Id	string	要从其运行的 WebTest 的位置 ID。

WebTestKind

此 Web 测试监视的 WebTest 类型。 选项包括 ping、多步骤和标准。

名称	类型	说明
multistep	string
ping	string
standard	string