Partilhar via


Microsoft.Insights webtests 2022-06-15

Definição de recurso do Bicep

O tipo de recurso webtests pode ser implementado com operações que visam:

Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.Insights/webtests, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.Insights/webtests@2022-06-15' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  kind: 'string'
  properties: {
    Configuration: {
      WebTest: 'string'
    }
    Description: 'string'
    Enabled: bool
    Frequency: int
    Kind: 'string'
    Locations: [
      {
        Id: 'string'
      }
    ]
    Name: 'string'
    Request: {
      FollowRedirects: bool
      Headers: [
        {
          key: 'string'
          value: 'string'
        }
      ]
      HttpVerb: 'string'
      ParseDependentRequests: bool
      RequestBody: 'string'
      RequestUrl: 'string'
    }
    RetryEnabled: bool
    SyntheticMonitorId: 'string'
    Timeout: int
    ValidationRules: {
      ContentValidation: {
        ContentMatch: 'string'
        IgnoreCase: bool
        PassIfTextFound: bool
      }
      ExpectedHttpStatusCode: int
      IgnoreHttpStatusCode: bool
      SSLCertRemainingLifetimeCheck: int
      SSLCheck: bool
    }
  }
}

Valores de propriedade

webtests

Nome Descrição Valor
name O nome do recurso cadeia (obrigatório)
localização Localização do recurso cadeia (obrigatório)
etiquetas Etiquetas de recursos Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
tipo O tipo de WebTest que este teste Web observa. As opções são ping, multistep e standard. "vários passos"
'ping'
"standard"
propriedades Metadados que descrevem um teste Web para um recurso do Azure. WebTestProperties

WebTestProperties

Nome Descrição Valor
Configuração Uma especificação de configuração XML para um WebTest. WebTestPropertiesConfiguration
Description Descrição definida pelo utilizador para este WebTest. string
Ativado O teste está a ser monitorizado ativamente. bool
Frequência Intervalo em segundos entre execuções de teste para este WebTest. O valor predefinido é 300. int
Tipo O tipo de teste Web que isto é, as escolhas válidas são ping, multistep e standard. "vários passos"
'ping'
"standard" (obrigatório)
Localizações Uma lista de onde executar fisicamente os testes para dar cobertura global para acessibilidade da sua aplicação. WebTestGeolocation[] (obrigatório)
Name Nome definido pelo utilizador se este WebTest. cadeia (obrigatório)
Pedir A coleção de propriedades do pedido WebTestPropertiesRequest
RetryEnabled Permitir repetições caso este WebTest falhe. bool
SyntheticMonitorId ID exclusivo deste WebTest. Normalmente, este é o mesmo valor que o campo Nome. cadeia (obrigatório)
Tempo Limite Segundos até este WebTest exceder o tempo limite e falhar. O valor predefinido é 30. int
ValidationRules A coleção de propriedades da regra de validação WebTestPropertiesValidationRules

WebTestPropertiesConfiguration

Nome Descrição Valor
Teste Web A especificação XML de um WebTest para executar numa aplicação. string

WebTestGeolocation

Nome Descrição Valor
Id ID de Localização para o WebTest a executar. string

WebTestPropertiesRequest

Nome Descrição Valor
SeguirRedirects Siga os redirecionamentos para este teste Web. bool
Cabeçalhos Lista de cabeçalhos e respetivos valores a adicionar à chamada WebTest. HeaderField[]
HttpVerb Verbo http a utilizar para este teste Web. string
ParseDependentRequests Analisar pedido dependente para este WebTest. bool
RequestBody Corpo da cadeia codificada base64 para enviar com este teste Web. string
RequestUrl Localização do URL a testar. string

Campo de Cabeçalho

Nome Descrição Valor
chave O nome do cabeçalho. string
valor O valor do cabeçalho. string

WebTestPropertiesValidationRules

Nome Descrição Valor
ContentValidation A coleção de propriedades de validação de conteúdo WebTestPropertiesValidationRulesContentValidation
EsperadoHttpStatusCode Confirme que o WebTest devolve o código de estado http fornecido. int
IgnoreHttpStatusCode Quando definida, a validação ignorará o código de estado. bool
SSLCertRemainingLifetimeCheck 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. int
Verificação SSL Verifica se o certificado SSL ainda é válido. bool

WebTestPropertiesValidationRulesContentValidation

Nome Descrição Valor
ContentMatch Conteúdo a procurar na devolução do WebTest. Não pode ser nulo ou estar vazio. string
IgnoreCase Quando definido, este valor torna as maiúsculas e minúsculas de validação ContentMatch insensíveis. bool
PassIfTextFound 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 bool

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Criação de Testes Web Dinâmicos

Implementar no Azure
Crie qualquer número de testes Web (ping) do App Insights.
Regra de alerta de métricas para um teste de disponibilidade

Implementar no Azure
Este modelo cria um teste de disponibilidade do Application Insights juntamente com uma regra de alerta de métricas que o monitoriza.

Definição de recurso do modelo arm

O tipo de recurso webtests pode ser implementado com operações que visam:

Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.Insights/webtests, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.Insights/webtests",
  "apiVersion": "2022-06-15",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "kind": "string",
  "properties": {
    "Configuration": {
      "WebTest": "string"
    },
    "Description": "string",
    "Enabled": "bool",
    "Frequency": "int",
    "Kind": "string",
    "Locations": [
      {
        "Id": "string"
      }
    ],
    "Name": "string",
    "Request": {
      "FollowRedirects": "bool",
      "Headers": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "HttpVerb": "string",
      "ParseDependentRequests": "bool",
      "RequestBody": "string",
      "RequestUrl": "string"
    },
    "RetryEnabled": "bool",
    "SyntheticMonitorId": "string",
    "Timeout": "int",
    "ValidationRules": {
      "ContentValidation": {
        "ContentMatch": "string",
        "IgnoreCase": "bool",
        "PassIfTextFound": "bool"
      },
      "ExpectedHttpStatusCode": "int",
      "IgnoreHttpStatusCode": "bool",
      "SSLCertRemainingLifetimeCheck": "int",
      "SSLCheck": "bool"
    }
  }
}

Valores de propriedade

webtests

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Insights/webtests"
apiVersion A versão da API de recursos '2022-06-15'
name O nome do recurso cadeia (obrigatório)
localização Localização do recurso cadeia (obrigatório)
etiquetas Etiquetas de recursos Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
tipo O tipo de WebTest que este teste Web observa. As opções são ping, multistep e standard. "múltiplos passos"
'ping'
"standard"
propriedades Metadados que descrevem um teste Web para um recurso do Azure. WebTestProperties

WebTestProperties

Nome Descrição Valor
Configuração Uma especificação de configuração XML para um WebTest. WebTestPropertiesConfiguration
Description Descrição definida pelo utilizador para este WebTest. string
Ativado O teste está a ser monitorizado ativamente. bool
Frequência Intervalo em segundos entre execuções de teste para este WebTest. O valor predefinido é 300. int
Tipo O tipo de teste Web que isto é, as opções válidas são ping, multistep e standard. "múltiplos passos"
'ping'
"standard" (obrigatório)
Localizações Uma lista de onde executar fisicamente os testes para dar cobertura global para a acessibilidade da sua aplicação. WebTestGeolocation[] (obrigatório)
Name Nome definido pelo utilizador se este WebTest. cadeia (obrigatório)
Pedir A coleção de propriedades do pedido WebTestPropertiesRequest
RetryEnabled Permitir repetições caso este WebTest falhe. bool
SyntheticMonitorId ID exclusivo deste WebTest. Normalmente, este é o mesmo valor que o campo Nome. cadeia (obrigatório)
Tempo Limite Segundos até este WebTest exceder o tempo limite e falhar. O valor predefinido é 30. int
ValidationRules A coleção de propriedades da regra de validação WebTestPropertiesValidationRules

WebTestPropertiesConfiguration

Nome Descrição Valor
WebTest A especificação XML de um WebTest para executar numa aplicação. string

WebTestGeolocation

Nome Descrição Valor
Id ID de localização do WebTest a partir do qual pode ser executado. string

WebTestPropertiesRequest

Nome Descrição Valor
FollowRedirects Siga os redirecionamentos para este teste Web. bool
Cabeçalhos Lista de cabeçalhos e respetivos valores a adicionar à chamada WebTest. HeaderField[]
HttpVerb Verbo Http a utilizar para este teste Web. string
ParseDependentRequests Analisar pedido dependente para este WebTest. bool
RequestBody Corpo de cadeia codificada base64 para enviar com este teste Web. string
RequestUrl Localização do URL a testar. string

HeaderField

Nome Descrição Valor
chave O nome do cabeçalho. string
valor O valor do cabeçalho. string

WebTestPropertiesValidationRules

Nome Descrição Valor
ContentValidation A coleção de propriedades de validação de conteúdos WebTestPropertiesValidationRulesContentValidation
ExpectedHttpStatusCode Confirme que o WebTest devolve o código de estado http fornecido. int
IgnorarHttpStatusCode Quando definida, a validação ignorará o código de estado. bool
SSLCertRemainingLifetimeCheck 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. int
Verificação SSL Verifica se o certificado SSL ainda é válido. bool

WebTestPropertiesValidationRulesContentValidation

Nome Descrição Valor
ContentMatch Conteúdo a procurar na devolução do WebTest. Não pode ser nulo ou estar vazio. string
IgnoreCase Quando definido, este valor torna as maiúsculas e minúsculas de validação ContentMatch insensíveis. bool
PassIfTextFound 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 bool

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Criação de Testes Web Dinâmicos

Implementar no Azure
Crie qualquer número de testes Web (ping) do App Insights.
Regra de alerta de métrica para um teste de disponibilidade

Implementar no Azure
Este modelo cria um teste de disponibilidade do Application Insights juntamente com uma regra de alerta de métrica que o monitoriza.

Definição de recurso do Terraform (fornecedor AzAPI)

O tipo de recurso webtests pode ser implementado com operações que visam:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.Insights/webtests, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Insights/webtests@2022-06-15"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      Configuration = {
        WebTest = "string"
      }
      Description = "string"
      Enabled = bool
      Frequency = int
      Kind = "string"
      Locations = [
        {
          Id = "string"
        }
      ]
      Name = "string"
      Request = {
        FollowRedirects = bool
        Headers = [
          {
            key = "string"
            value = "string"
          }
        ]
        HttpVerb = "string"
        ParseDependentRequests = bool
        RequestBody = "string"
        RequestUrl = "string"
      }
      RetryEnabled = bool
      SyntheticMonitorId = "string"
      Timeout = int
      ValidationRules = {
        ContentValidation = {
          ContentMatch = "string"
          IgnoreCase = bool
          PassIfTextFound = bool
        }
        ExpectedHttpStatusCode = int
        IgnoreHttpStatusCode = bool
        SSLCertRemainingLifetimeCheck = int
        SSLCheck = bool
      }
    }
    kind = "string"
  })
}

Valores de propriedade

webtests

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Insights/webtests@2022-06-15"
name O nome do recurso cadeia (obrigatório)
localização Localização do recurso cadeia (obrigatório)
parent_id Para implementar num grupo de recursos, utilize o ID desse grupo de recursos. cadeia (obrigatório)
etiquetas Etiquetas de recursos Dicionário de nomes e valores de etiquetas.
tipo O tipo de WebTest que este teste Web observa. As opções são ping, multistep e standard. "vários passos"
"ping"
"standard"
propriedades Metadados que descrevem um teste Web para um recurso do Azure. WebTestProperties

WebTestProperties

Nome Descrição Valor
Configuração Uma especificação de configuração XML para um WebTest. WebTestPropertiesConfiguration
Description Descrição definida pelo utilizador para este WebTest. string
Ativado O teste está a ser monitorizado ativamente. bool
Frequência Intervalo em segundos entre execuções de teste para este WebTest. O valor predefinido é 300. int
Tipo O tipo de teste Web que isto é, as opções válidas são ping, multistep e standard. "vários passos"
"ping"
"standard" (obrigatório)
Localizações Uma lista de onde executar fisicamente os testes para dar cobertura global para a acessibilidade da sua aplicação. WebTestGeolocation[] (obrigatório)
Name Nome definido pelo utilizador se este WebTest. cadeia (obrigatório)
Pedir A coleção de propriedades do pedido WebTestPropertiesRequest
RetryEnabled Permitir repetições caso este WebTest falhe. bool
SyntheticMonitorId ID exclusivo deste WebTest. Normalmente, este é o mesmo valor que o campo Nome. cadeia (obrigatório)
Tempo Limite Segundos até este WebTest exceder o tempo limite e falhar. O valor predefinido é 30. int
ValidationRules A coleção de propriedades da regra de validação WebTestPropertiesValidationRules

WebTestPropertiesConfiguration

Nome Descrição Valor
WebTest A especificação XML de um WebTest para executar numa aplicação. string

WebTestGeolocation

Nome Descrição Valor
Id ID de localização do WebTest a partir do qual pode ser executado. string

WebTestPropertiesRequest

Nome Descrição Valor
FollowRedirects Siga os redirecionamentos para este teste Web. bool
Cabeçalhos Lista de cabeçalhos e respetivos valores a adicionar à chamada WebTest. HeaderField[]
HttpVerb Verbo Http a utilizar para este teste Web. string
ParseDependentRequests Analisar pedido dependente para este WebTest. bool
RequestBody Corpo de cadeia codificada base64 para enviar com este teste Web. string
RequestUrl Localização do URL a testar. string

HeaderField

Nome Descrição Valor
chave O nome do cabeçalho. string
valor O valor do cabeçalho. string

WebTestPropertiesValidationRules

Nome Descrição Valor
ContentValidation A coleção de propriedades de validação de conteúdos WebTestPropertiesValidationRulesContentValidation
ExpectedHttpStatusCode Confirme que o WebTest devolve o código de estado http fornecido. int
IgnorarHttpStatusCode Quando definida, a validação ignorará o código de estado. bool
SSLCertRemainingLifetimeCheck 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. int
Verificação SSL Verifica se o certificado SSL ainda é válido. bool

WebTestPropertiesValidationRulesContentValidation

Nome Descrição Valor
ContentMatch Conteúdo a procurar na devolução do WebTest. Não pode ser nulo ou estar vazio. string
IgnoreCase Quando definido, este valor torna as maiúsculas e minúsculas de validação ContentMatch insensíveis. bool
PassIfTextFound 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 bool