Serviço/diagnóstico Microsoft.ApiManagement 2018-06-01-preview

Artigo
12/21/2024

Definição de recurso do Bicep

O tipo de recurso de serviço/diagnóstico pode ser implantado com operações de destino:

Grupos de recursos - Consulte comandos de implantação do grupo de recursos

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

Formato de recurso

Para criar um recurso Microsoft.ApiManagement/service/diagnostics, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.ApiManagement/service/diagnostics@2018-06-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    alwaysLog: 'string'
    backend: {
      request: {
        body: {
          bytes: int
        }
        headers: [
          'string'
        ]
      }
      response: {
        body: {
          bytes: int
        }
        headers: [
          'string'
        ]
      }
    }
    enableHttpCorrelationHeaders: bool
    frontend: {
      request: {
        body: {
          bytes: int
        }
        headers: [
          'string'
        ]
      }
      response: {
        body: {
          bytes: int
        }
        headers: [
          'string'
        ]
      }
    }
    loggerId: 'string'
    sampling: {
      percentage: int
      samplingType: 'string'
    }
  }
}

Valores de propriedade

BodyDiagnosticSettings

Nome	Descrição	Valor
Bytes	Número de bytes do corpo da solicitação a serem registrados em log.	int Restrições: Valor máximo = 8192

DiagnosticContractProperties

Nome	Descrição	Valor
alwaysLog	Especifica que tipo de configurações de amostragem de mensagens não devem ser aplicadas.	'allErrors'
back-end	Configurações de diagnóstico para mensagens HTTP de entrada/saída para o back-end	PipelineDiagnosticSettings
enableHttpCorrelationHeaders	Se os cabeçalhos de correlação devem ser processados no Serviço de Gerenciamento de API. Aplicável somente ao diagnóstico do Application Insights. O padrão é verdadeiro.	Bool
front-end	Configurações de diagnóstico para mensagens HTTP de entrada/saída para o Gateway.	PipelineDiagnosticSettings
loggerId	ID de recurso de um agente de destino.	cadeia de caracteres (obrigatório)
amostragem	Configurações de amostragem para Diagnóstico.	SamplingSettings

HttpMessageDiagnostic

Nome	Descrição	Valor
corpo	Configurações de registro em log do corpo.	BodyDiagnosticSettings
Cabeçalhos	Matriz de cabeçalhos HTTP a serem registrados em log.	string[]

Microsoft.ApiManagement/service/diagnostics

Nome	Descrição	Valor
nome	O nome do recurso	corda Restrições: Comprimento mínimo = 1 Comprimento máximo = 1 Padrão = `^[^*#&+:<>?]+$` (obrigatório)
pai	No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai. Para obter mais informações, consulte recurso filho fora do recurso pai.	Nome simbólico do recurso do tipo: de serviço
Propriedades	Propriedades do contrato de entidade de diagnóstico.	DiagnosticContractProperties

PipelineDiagnosticSettings

Nome	Descrição	Valor
pedir	Configurações de diagnóstico para solicitação.	HttpMessageDiagnostic
resposta	Configurações de diagnóstico para resposta.	HttpMessageDiagnostic

SamplingSettings

Nome	Descrição	Valor
porcentagem	Taxa de amostragem para amostragem de taxa fixa.	int Restrições: Valor mínimo = 0 Valor máximo = 100
samplingType	Tipo de amostragem.	'corrigido'

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep	Descrição
Gateway de Aplicativo com gerenciamento de API interno e de aplicativo Web	Gateway de Aplicativo roteando o tráfego da Internet para uma instância de Gerenciamento de API de rede virtual (modo interno), que atende a uma API Web hospedada em um Aplicativo Web do Azure.
criar gerenciamento de API na VNet interna com o Gateway de Aplicativo	Este modelo demonstra como criar uma instância do Gerenciamento de API do Azure em uma rede privada protegida pelo Gateway de Aplicativo do Azure.

Definição de recurso de modelo do ARM

O tipo de recurso de serviço/diagnóstico pode ser implantado com operações de destino:

Grupos de recursos - Consulte comandos de implantação do grupo de recursos

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

Formato de recurso

Para criar um recurso Microsoft.ApiManagement/service/diagnostics, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.ApiManagement/service/diagnostics",
  "apiVersion": "2018-06-01-preview",
  "name": "string",
  "properties": {
    "alwaysLog": "string",
    "backend": {
      "request": {
        "body": {
          "bytes": "int"
        },
        "headers": [ "string" ]
      },
      "response": {
        "body": {
          "bytes": "int"
        },
        "headers": [ "string" ]
      }
    },
    "enableHttpCorrelationHeaders": "bool",
    "frontend": {
      "request": {
        "body": {
          "bytes": "int"
        },
        "headers": [ "string" ]
      },
      "response": {
        "body": {
          "bytes": "int"
        },
        "headers": [ "string" ]
      }
    },
    "loggerId": "string",
    "sampling": {
      "percentage": "int",
      "samplingType": "string"
    }
  }
}

Valores de propriedade

BodyDiagnosticSettings

Nome	Descrição	Valor
Bytes	Número de bytes do corpo da solicitação a serem registrados em log.	int Restrições: Valor máximo = 8192

DiagnosticContractProperties

Nome	Descrição	Valor
alwaysLog	Especifica que tipo de configurações de amostragem de mensagens não devem ser aplicadas.	'allErrors'
back-end	Configurações de diagnóstico para mensagens HTTP de entrada/saída para o back-end	PipelineDiagnosticSettings
enableHttpCorrelationHeaders	Se os cabeçalhos de correlação devem ser processados no Serviço de Gerenciamento de API. Aplicável somente ao diagnóstico do Application Insights. O padrão é verdadeiro.	Bool
front-end	Configurações de diagnóstico para mensagens HTTP de entrada/saída para o Gateway.	PipelineDiagnosticSettings
loggerId	ID de recurso de um agente de destino.	cadeia de caracteres (obrigatório)
amostragem	Configurações de amostragem para Diagnóstico.	SamplingSettings

HttpMessageDiagnostic

Nome	Descrição	Valor
corpo	Configurações de registro em log do corpo.	BodyDiagnosticSettings
Cabeçalhos	Matriz de cabeçalhos HTTP a serem registrados em log.	string[]

Microsoft.ApiManagement/service/diagnostics

Nome	Descrição	Valor
apiVersion	A versão da API	'2018-06-01-preview'
nome	O nome do recurso	corda Restrições: Comprimento mínimo = 1 Comprimento máximo = 1 Padrão = `^[^*#&+:<>?]+$` (obrigatório)
Propriedades	Propriedades do contrato de entidade de diagnóstico.	DiagnosticContractProperties
tipo	O tipo de recurso	'Microsoft.ApiManagement/service/diagnostics'

PipelineDiagnosticSettings

Nome	Descrição	Valor
pedir	Configurações de diagnóstico para solicitação.	HttpMessageDiagnostic
resposta	Configurações de diagnóstico para resposta.	HttpMessageDiagnostic

SamplingSettings

Nome	Descrição	Valor
porcentagem	Taxa de amostragem para amostragem de taxa fixa.	int Restrições: Valor mínimo = 0 Valor máximo = 100
samplingType	Tipo de amostragem.	'corrigido'

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo	Descrição
Gateway de Aplicativo com gerenciamento de API interno e de aplicativo Web	Gateway de Aplicativo roteando o tráfego da Internet para uma instância de Gerenciamento de API de rede virtual (modo interno), que atende a uma API Web hospedada em um Aplicativo Web do Azure.
criar gerenciamento de API na VNet interna com o Gateway de Aplicativo	Este modelo demonstra como criar uma instância do Gerenciamento de API do Azure em uma rede privada protegida pelo Gateway de Aplicativo do Azure.

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

O tipo de recurso de serviço/diagnóstico pode ser implantado com operações de destino:

grupos de recursos

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

Formato de recurso

Para criar um recurso Microsoft.ApiManagement/service/diagnostics, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/diagnostics@2018-06-01-preview"
  name = "string"
  body = jsonencode({
    properties = {
      alwaysLog = "string"
      backend = {
        request = {
          body = {
            bytes = int
          }
          headers = [
            "string"
          ]
        }
        response = {
          body = {
            bytes = int
          }
          headers = [
            "string"
          ]
        }
      }
      enableHttpCorrelationHeaders = bool
      frontend = {
        request = {
          body = {
            bytes = int
          }
          headers = [
            "string"
          ]
        }
        response = {
          body = {
            bytes = int
          }
          headers = [
            "string"
          ]
        }
      }
      loggerId = "string"
      sampling = {
        percentage = int
        samplingType = "string"
      }
    }
  })
}

Valores de propriedade

BodyDiagnosticSettings

Nome	Descrição	Valor
Bytes	Número de bytes do corpo da solicitação a serem registrados em log.	int Restrições: Valor máximo = 8192

DiagnosticContractProperties

Nome	Descrição	Valor
alwaysLog	Especifica que tipo de configurações de amostragem de mensagens não devem ser aplicadas.	'allErrors'
back-end	Configurações de diagnóstico para mensagens HTTP de entrada/saída para o back-end	PipelineDiagnosticSettings
enableHttpCorrelationHeaders	Se os cabeçalhos de correlação devem ser processados no Serviço de Gerenciamento de API. Aplicável somente ao diagnóstico do Application Insights. O padrão é verdadeiro.	Bool
front-end	Configurações de diagnóstico para mensagens HTTP de entrada/saída para o Gateway.	PipelineDiagnosticSettings
loggerId	ID de recurso de um agente de destino.	cadeia de caracteres (obrigatório)
amostragem	Configurações de amostragem para Diagnóstico.	SamplingSettings

HttpMessageDiagnostic

Nome	Descrição	Valor
corpo	Configurações de registro em log do corpo.	BodyDiagnosticSettings
Cabeçalhos	Matriz de cabeçalhos HTTP a serem registrados em log.	string[]

Microsoft.ApiManagement/service/diagnostics

Nome	Descrição	Valor
nome	O nome do recurso	corda Restrições: Comprimento mínimo = 1 Comprimento máximo = 1 Padrão = `^[^*#&+:<>?]+$` (obrigatório)
parent_id	A ID do recurso que é o pai desse recurso.	ID do recurso do tipo: serviço
Propriedades	Propriedades do contrato de entidade de diagnóstico.	DiagnosticContractProperties
tipo	O tipo de recurso	"Microsoft.ApiManagement/service/diagnostics@2018-06-01-preview"

PipelineDiagnosticSettings

Nome	Descrição	Valor
pedir	Configurações de diagnóstico para solicitação.	HttpMessageDiagnostic
resposta	Configurações de diagnóstico para resposta.	HttpMessageDiagnostic

SamplingSettings

Nome	Descrição	Valor
porcentagem	Taxa de amostragem para amostragem de taxa fixa.	int Restrições: Valor mínimo = 0 Valor máximo = 100
samplingType	Tipo de amostragem.	'corrigido'

Compartilhar via

Serviço/diagnóstico Microsoft.ApiManagement 2018-06-01-preview

Definição de recurso do Bicep

Formato de recurso

Valores de propriedade

BodyDiagnosticSettings

DiagnosticContractProperties

HttpMessageDiagnostic

Microsoft.ApiManagement/service/diagnostics

PipelineDiagnosticSettings

SamplingSettings

Exemplos de início rápido

Definição de recurso de modelo do ARM

Formato de recurso

Valores de propriedade

BodyDiagnosticSettings

DiagnosticContractProperties

HttpMessageDiagnostic

Microsoft.ApiManagement/service/diagnostics

PipelineDiagnosticSettings

SamplingSettings

Modelos de início rápido

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

Formato de recurso

Valores de propriedade

BodyDiagnosticSettings

DiagnosticContractProperties

HttpMessageDiagnostic

Microsoft.ApiManagement/service/diagnostics

PipelineDiagnosticSettings

SamplingSettings

Comentários

Recursos adicionais