Web Tests - Get

Servicio:

Application Insights

Versión de la API:

2022-06-15

Obtenga una definición de prueba web específica de Application Insights.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string	Identificador de la suscripción de destino.
webTestName	path	True	string	Nombre del recurso WebTest de Application Insights.
api-version	query	True	string	Versión de API que se usará para la operación.

Respuestas

Nombre	Tipo	Description
200 OK	WebTest	Definición de prueba web de Ann Application Insights.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

webTestGet

Solicitud de ejemplo

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

Respuesta de muestra

status code:

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

Definiciones

Nombre	Description
Configuration	Especificación de configuración XML para webTest.
ContentValidation	Colección de propiedades de validación de contenido
HeaderField	Encabezado que se va a agregar a WebTest.
Request	Colección de propiedades de solicitud
ValidationRules	Colección de propiedades de regla de validación
WebTest	Definición de WebTest de Application Insights.
WebTestGeolocation	Ubicación física geográfica desde la que ejecutar webTest. Debe especificar una o varias ubicaciones desde las que se va a ejecutar la prueba.
WebTestKind	El tipo de WebTest que supervisa esta prueba web. Las opciones son ping, multipaso y estándar.

Configuration

Especificación de configuración XML para webTest.

Nombre	Tipo	Description
WebTest	string	Especificación XML de webTest que se va a ejecutar en una aplicación.

ContentValidation

Colección de propiedades de validación de contenido

Nombre	Tipo	Description
ContentMatch	string	Contenido que se va a buscar en la devolución de WebTest. No debe estar vacío ni ser NULL.
IgnoreCase	boolean	Cuando se establece, este valor hace que el argumento de validación contentMatch no distingue mayúsculas de minúsculas.
PassIfTextFound	boolean	Cuando es true, se pasará la validación si hay una coincidencia para la cadena ContentMatch. Si es false, se producirá un error en la validación si hay una coincidencia.

HeaderField

Encabezado que se va a agregar a WebTest.

Nombre	Tipo	Description
key	string	Nombre del encabezado.
value	string	Valor del encabezado.

Request

Colección de propiedades de solicitud

Nombre	Tipo	Description
FollowRedirects	boolean	Siga las redirecciones para esta prueba web.
Headers	HeaderField[]	Lista de encabezados y sus valores que se van a agregar a la llamada a WebTest.
HttpVerb	string	Verbo HTTP que se va a usar para esta prueba web.
ParseDependentRequests	boolean	Analizar la solicitud dependiente de este WebTest.
RequestBody	string	Cuerpo de cadena codificado en Base64 para enviar con esta prueba web.
RequestUrl	string	Ubicación de la dirección URL que se va a probar.

ValidationRules

Colección de propiedades de regla de validación

Nombre	Tipo	Description
ContentValidation	ContentValidation	Colección de propiedades de validación de contenido
ExpectedHttpStatusCode	integer	Compruebe que WebTest devuelve el código de estado HTTP proporcionado.
IgnoreHttpStatusCode	boolean	Cuando se establece, la validación omitirá el código de estado.
SSLCertRemainingLifetimeCheck	integer	Un número de días que se deben comprobar aún permanece antes de que expire el certificado SSL existente. El valor debe ser positivo y SSLCheck debe establecerse en true.
SSLCheck	boolean	Comprueba si el certificado SSL sigue siendo válido.

WebTest

Definición de WebTest de Application Insights.

Nombre	Tipo	Valor predeterminado	Description
id	string		Identificador de recurso de Azure
kind	WebTestKind	ping	El tipo de WebTest que supervisa esta prueba web. Las opciones son ping, multipaso y estándar.
location	string		Ubicación de los recursos
name	string		Nombre de recurso de Azure
properties.Configuration	Configuration		Especificación de configuración XML para webTest.
properties.Description	string		Descripción definida por el usuario para este WebTest.
properties.Enabled	boolean		Es la prueba que se está supervisando activamente.
properties.Frequency	integer	300	Intervalo en segundos entre ejecuciones de prueba para este WebTest. El valor predeterminado es 300.
properties.Kind	WebTestKind	ping	El tipo de prueba web es, las opciones válidas son ping, multistep y estándar.
properties.Locations	WebTestGeolocation[]		Lista de dónde ejecutar físicamente las pruebas para proporcionar cobertura global para la accesibilidad de la aplicación.
properties.Name	string		Nombre definido por el usuario si este WebTest.
properties.Request	Request		Colección de propiedades de solicitud
properties.RetryEnabled	boolean		Permitir reintentos debe producir un error en WebTest.
properties.SyntheticMonitorId	string		Identificador único de este WebTest. Suele ser el mismo valor que el campo Nombre.
properties.Timeout	integer	30	Segundos hasta que se produzca un tiempo de espera de WebTest y se produzca un error. El valor predeterminado es 30.
properties.ValidationRules	ValidationRules		Colección de propiedades de regla de validación
properties.provisioningState	string		Estado actual de este componente, independientemente de si se ha aprovisionado o no dentro del grupo de recursos que está definido. Los usuarios no pueden cambiar este valor, pero pueden leerlo. Los valores incluirán Succeeded, Deploying, Canceled y Failed.
tags	object		Etiquetas del recurso
type	string		Tipo de recurso de Azure

WebTestGeolocation

Ubicación física geográfica desde la que ejecutar webTest. Debe especificar una o varias ubicaciones desde las que se va a ejecutar la prueba.

Nombre	Tipo	Description
Id	string	Identificador de ubicación desde el que se va a ejecutar WebTest.

WebTestKind

El tipo de WebTest que supervisa esta prueba web. Las opciones son ping, multipaso y estándar.

Nombre	Tipo	Description
multistep	string
ping	string
standard	string