Web Tests - Create Or Update

Crea o actualiza una definición de prueba web de Application Insights.

PUT 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

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.

subscriptionId
path True

string

minLength: 1

Identificador de la suscripción de destino.

webTestName
path True

string

Nombre del recurso WebTest de Application Insights.

api-version
query True

string

minLength: 1

Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
location True

string

Ubicación del recurso

properties.Kind True

WebTestKind

El tipo de prueba web es, las opciones válidas son ping, multistep y estándar.

properties.Locations True

WebTestGeolocation[]

Lista de dónde ejecutar físicamente las pruebas para proporcionar cobertura global para la accesibilidad de la aplicación.

properties.Name True

string

Nombre definido por el usuario si este WebTest.

properties.SyntheticMonitorId True

string

Identificador único de este WebTest. Normalmente es el mismo valor que el campo Nombre.

kind

WebTestKind

Tipo de WebTest que esta prueba web supervisa. Las opciones son ping, multistep y estándar.

properties.Configuration

WebTestPropertiesConfiguration

Una especificación de configuración XML para un 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 (int32)

Intervalo en segundos entre ejecuciones de pruebas para este WebTest. El valor predeterminado es 300.

properties.Request

WebTestPropertiesRequest

Colección de propiedades de solicitud

properties.RetryEnabled

boolean

Permitir reintentos debe producir un error en WebTest.

properties.Timeout

integer (int32)

Segundos hasta que se produzca un tiempo de espera de WebTest y se produzca un error. El valor predeterminado es 30.

properties.ValidationRules

WebTestPropertiesValidationRules

Colección de propiedades de regla de validación

tags

object

Etiquetas de recursos

Respuestas

Nombre Tipo Description
200 OK

WebTest

Operación de actualización del recurso 'WebTest' exitosa

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 suplantar la cuenta de usuario

Ejemplos

webTestCreate
webTestCreateStandard
webTestUpdate

webTestCreate

Solicitud de ejemplo

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

{
  "kind": "ping",
  "location": "South Central US",
  "properties": {
    "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,
    "Kind": "ping",
    "Locations": [
      {
        "Id": "us-fl-mia-edge"
      }
    ],
    "Name": "my-webtest-my-component",
    "RetryEnabled": true,
    "SyntheticMonitorId": "my-webtest-my-component",
    "Timeout": 120
  }
}

Respuesta de muestra

{
  "name": "my-webtest-my-component",
  "type": "Microsoft.Insights/webtests",
  "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-component",
  "kind": "ping",
  "location": "southcentralus",
  "properties": {
    "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,
    "Kind": "ping",
    "Locations": [
      {
        "Id": "us-fl-mia-edge"
      }
    ],
    "Name": "my-webtest-my-component",
    "RetryEnabled": true,
    "SyntheticMonitorId": "my-webtest-my-component",
    "Timeout": 120,
    "provisioningState": "Succeeded"
  },
  "tags": {
    "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component": "Resource"
  }
}

webTestCreateStandard

Solicitud de ejemplo

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": {
    "Description": "Ping web test alert for mytestwebapp",
    "Enabled": true,
    "Frequency": 900,
    "Kind": "standard",
    "Locations": [
      {
        "Id": "us-fl-mia-edge"
      }
    ],
    "Name": "my-webtest-my-component",
    "Request": {
      "Headers": [
        {
          "key": "Content-Language",
          "value": "de-DE"
        },
        {
          "key": "Accept-Language",
          "value": "de-DE"
        }
      ],
      "HttpVerb": "POST",
      "RequestBody": "SGVsbG8gd29ybGQ=",
      "RequestUrl": "https://bing.com"
    },
    "RetryEnabled": true,
    "SyntheticMonitorId": "my-webtest-my-component",
    "Timeout": 120,
    "ValidationRules": {
      "SSLCertRemainingLifetimeCheck": 100,
      "SSLCheck": true
    }
  }
}

Respuesta de muestra

{
  "name": "my-webtest-my-component",
  "type": "Microsoft.Insights/webtests",
  "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-component",
  "location": "southcentralus",
  "properties": {
    "Description": "Ping web test alert for mytestwebapp",
    "Enabled": true,
    "Frequency": 900,
    "Kind": "standard",
    "Locations": [
      {
        "Id": "us-fl-mia-edge"
      }
    ],
    "Name": "my-webtest-my-component",
    "Request": {
      "Headers": [
        {
          "key": "Content-Language",
          "value": "de-DE"
        },
        {
          "key": "Accept-Language",
          "value": "de-DE"
        }
      ],
      "HttpVerb": "POST",
      "RequestBody": "SGVsbG8gd29ybGQ=",
      "RequestUrl": "https://bing.com"
    },
    "RetryEnabled": true,
    "SyntheticMonitorId": "my-webtest-my-component",
    "Timeout": 120,
    "ValidationRules": {
      "SSLCertRemainingLifetimeCheck": 100,
      "SSLCheck": true
    },
    "provisioningState": "Succeeded"
  },
  "tags": {
    "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component": "Resource"
  }
}

webTestUpdate

Solicitud de ejemplo

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

{
  "kind": "ping",
  "location": "South Central US",
  "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,
    "Kind": "ping",
    "Locations": [
      {
        "Id": "us-fl-mia-edge"
      },
      {
        "Id": "apac-hk-hkn-azr"
      }
    ],
    "Name": "my-webtest-my-component",
    "SyntheticMonitorId": "my-webtest-my-component",
    "Timeout": 30
  }
}

Respuesta de muestra

{
  "name": "my-webtest-my-component",
  "type": "Microsoft.Insights/webtests",
  "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-component",
  "kind": "ping",
  "location": "southcentralus",
  "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>"
    },
    "Description": "Ping web test alert for mytestwebapp",
    "Enabled": true,
    "Frequency": 600,
    "Kind": "ping",
    "Locations": [
      {
        "Id": "us-fl-mia-edge"
      },
      {
        "Id": "apac-hk-hkn-azr"
      }
    ],
    "Name": "my-webtest-my-component",
    "RetryEnabled": true,
    "SyntheticMonitorId": "my-webtest-my-component",
    "Timeout": 30,
    "provisioningState": "Succeeded"
  },
  "tags": {
    "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component": "Resource"
  }
}

Definiciones

Nombre Description
HeaderField

Encabezado que se va a agregar a WebTest.

WebTest

Una definición de WebTest de Application Insights.

WebTestGeolocation

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

WebTestKind

Tipo de WebTest que esta prueba web supervisa. Las opciones son ping, multistep y estándar.

WebTestPropertiesConfiguration

Una especificación de configuración XML para un WebTest.

WebTestPropertiesRequest

Colección de propiedades de solicitud

WebTestPropertiesValidationRules

Colección de propiedades de regla de validación

WebTestPropertiesValidationRulesContentValidation

Colección de propiedades de validación de contenido

HeaderField

Encabezado que se va a agregar a WebTest.

Nombre Tipo Description
key

string

Nombre del encabezado.

value

string

Valor del encabezado.

WebTest

Una definición de WebTest de Application Insights.

Nombre Tipo Valor predeterminado Description
id

string

Identificador de recurso de Azure

kind

WebTestKind

ping

Tipo de WebTest que esta prueba web supervisa. Las opciones son ping, multistep y estándar.

location

string

Ubicación del recurso

name

string

Nombre del recurso de Azure

properties.Configuration

WebTestPropertiesConfiguration

Una especificación de configuración XML para un 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 (int32)

300

Intervalo en segundos entre ejecuciones de pruebas 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

WebTestPropertiesRequest

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. Normalmente es el mismo valor que el campo Nombre.

properties.Timeout

integer (int32)

30

Segundos hasta que se produzca un tiempo de espera de WebTest y se produzca un error. El valor predeterminado es 30.

properties.ValidationRules

WebTestPropertiesValidationRules

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 en el 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 de recursos

type

string

Tipo de recurso de Azure

WebTestGeolocation

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

Nombre Tipo Description
Id

string

Id. de ubicación desde el que se va a ejecutar WebTest.

WebTestKind

Tipo de WebTest que esta prueba web supervisa. Las opciones son ping, multistep y estándar.

Valor Description
ping

ping

multistep

Multipaso

standard

Estándar

WebTestPropertiesConfiguration

Una especificación de configuración XML para un WebTest.

Nombre Tipo Description
WebTest

string

Especificación XML de un WebTest que se va a ejecutar en una aplicación.

WebTestPropertiesRequest

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.

WebTestPropertiesValidationRules

Colección de propiedades de regla de validación

Nombre Tipo Description
ContentValidation

WebTestPropertiesValidationRulesContentValidation

Colección de propiedades de validación de contenido

ExpectedHttpStatusCode

integer (int32)

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 (int32)

Un número de días para 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.

WebTestPropertiesValidationRulesContentValidation

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 ser null ni estar vacío.

IgnoreCase

boolean

Cuando se establece, este valor hace que el caso de validación contentMatch no distingue mayúsculas de minúsculas.

PassIfTextFound

boolean

Cuando es true, la validación pasará si hay una coincidencia para la cadena ContentMatch. Si es false, se producirá un error en la validación si hay una coincidencia.