Microsoft.ApiManagement service/apis/diagnostics 2021-01-01-preview

• Últimas
• 2024-06-01-preview
• 2024-05-01
• 2023-09-01-preview
• 2023-05-01-preview
• 2023-03-01-preview
• 2022-09-01-preview
• 2022-08-01
• 2022-04-01-preview
• 2021-12-01-preview
• 2021-08-01
• 2021-04-01-preview
• 2021-01-01-preview
• 2020-12-01
• 2020-06-01-preview
• 2019-12-01
• 2019-12-01-preview
• 2019-01-01
• 2018-06-01-preview
• 2018-01-01
• 2017-03-01

Definição de recursos do bíceps

O tipo de recurso service/apis/diagnostics pode ser implantado com operações que visam:

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

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

Formato do recurso

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

resource symbolicname 'Microsoft.ApiManagement/service/apis/diagnostics@2021-01-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    alwaysLog: 'string'
    backend: {
      request: {
        body: {
          bytes: int
        }
        dataMasking: {
          headers: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
          queryParams: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
        }
        headers: [
          'string'
        ]
      }
      response: {
        body: {
          bytes: int
        }
        dataMasking: {
          headers: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
          queryParams: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
        }
        headers: [
          'string'
        ]
      }
    }
    frontend: {
      request: {
        body: {
          bytes: int
        }
        dataMasking: {
          headers: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
          queryParams: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
        }
        headers: [
          'string'
        ]
      }
      response: {
        body: {
          bytes: int
        }
        dataMasking: {
          headers: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
          queryParams: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
        }
        headers: [
          'string'
        ]
      }
    }
    httpCorrelationProtocol: 'string'
    logClientIp: bool
    loggerId: 'string'
    metrics: bool
    operationNameFormat: 'string'
    sampling: {
      percentage: int
      samplingType: 'string'
    }
    verbosity: 'string'
  }
}

Valores de propriedade

BodyDiagnosticSettings

Designação	Descrição	Valor
Bytes	Número de bytes do corpo da solicitação para registrar.	Int Restrições: Valor máximo = 8192

Mascaramento de dados

Designação	Descrição	Valor
cabeçalhos	Configurações de mascaramento para cabeçalhos	DataMaskingEntity[]
queryParams	Configurações de mascaramento para parâmetros de consulta Url	DataMaskingEntity[]

DataMaskingEntity

Designação	Descrição	Valor
modo	Modo de mascaramento de dados.	'Esconder' 'Máscara'
valor	O nome de uma entidade a ser mascarada (por exemplo, um nome de um cabeçalho ou um parâmetro de consulta).	string

DiagnosticContractProperties

Designação	Descrição	Valor
sempreLog	Especifica para que tipo de mensagens as configurações de amostragem 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
frontend	Configurações de diagnóstico para mensagens HTTP de entrada/saída para o Gateway.	PipelineDiagnosticSettings
httpCorrelationProtocol	Define o protocolo de correlação a ser usado para o diagnóstico do Application Insights.	'Legado' 'Nenhuma' 'W3C'
logClientIp	Registre o ClientIP. O padrão é false.	Bool
loggerId	ID do recurso de um registrador de destino.	string (obrigatório)
métricas	Emita métricas personalizadas por meio da política de métricas de emissão. Aplicável apenas às configurações de diagnóstico do Application Insights.	Bool
operationNameFormat	O formato do nome da operação para telemetrias do Application Insights. O padrão é Nome.	'Nome' 'Url'
amostragem	Configurações de amostragem para diagnóstico.	SamplingSettings
Verborragia	O nível de detalhamento aplicado aos traços emitidos pelas políticas de rastreamento.	'erro' 'informação' 'Verborrágico'

HttpMessageDiagnostic

Designação	Descrição	Valor
corpo	Configurações de registro do corpo.	BodyDiagnosticSettings
mascaramento de dados	Configurações de mascaramento de dados.	DataMasking
cabeçalhos	Matriz de cabeçalhos HTTP para registrar.	string[]

Microsoft.ApiManagement/service/apis/diagnostics

Designação	Descrição	Valor
Designação	O nome do recurso	string Restrições: Comprimento mínimo = 1 Comprimento máximo = 80 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 para recurso do tipo: service/apis
propriedades	Propriedades do contrato da entidade de diagnóstico.	DiagnosticContractProperties

PipelineDiagnosticSettings

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

Configurações de amostragem

Designação	Descrição	Valor
percentagem	Taxa de amostragem para amostragem de taxa fixa.	Int Restrições: Valor mínimo = 0 Valor máximo = 100
samplingType	Tipo de amostragem.	'Fixo'

Definição de recurso de modelo ARM

O tipo de recurso service/apis/diagnostics pode ser implantado com operações que visam:

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

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

Formato do recurso

Para criar um recurso Microsoft.ApiManagement/service/apis/diagnostics, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.ApiManagement/service/apis/diagnostics",
  "apiVersion": "2021-01-01-preview",
  "name": "string",
  "properties": {
    "alwaysLog": "string",
    "backend": {
      "request": {
        "body": {
          "bytes": "int"
        },
        "dataMasking": {
          "headers": [
            {
              "mode": "string",
              "value": "string"
            }
          ],
          "queryParams": [
            {
              "mode": "string",
              "value": "string"
            }
          ]
        },
        "headers": [ "string" ]
      },
      "response": {
        "body": {
          "bytes": "int"
        },
        "dataMasking": {
          "headers": [
            {
              "mode": "string",
              "value": "string"
            }
          ],
          "queryParams": [
            {
              "mode": "string",
              "value": "string"
            }
          ]
        },
        "headers": [ "string" ]
      }
    },
    "frontend": {
      "request": {
        "body": {
          "bytes": "int"
        },
        "dataMasking": {
          "headers": [
            {
              "mode": "string",
              "value": "string"
            }
          ],
          "queryParams": [
            {
              "mode": "string",
              "value": "string"
            }
          ]
        },
        "headers": [ "string" ]
      },
      "response": {
        "body": {
          "bytes": "int"
        },
        "dataMasking": {
          "headers": [
            {
              "mode": "string",
              "value": "string"
            }
          ],
          "queryParams": [
            {
              "mode": "string",
              "value": "string"
            }
          ]
        },
        "headers": [ "string" ]
      }
    },
    "httpCorrelationProtocol": "string",
    "logClientIp": "bool",
    "loggerId": "string",
    "metrics": "bool",
    "operationNameFormat": "string",
    "sampling": {
      "percentage": "int",
      "samplingType": "string"
    },
    "verbosity": "string"
  }
}

Valores de propriedade

BodyDiagnosticSettings

Designação	Descrição	Valor
Bytes	Número de bytes do corpo da solicitação para registrar.	Int Restrições: Valor máximo = 8192

Mascaramento de dados

Designação	Descrição	Valor
cabeçalhos	Configurações de mascaramento para cabeçalhos	DataMaskingEntity[]
queryParams	Configurações de mascaramento para parâmetros de consulta Url	DataMaskingEntity[]

DataMaskingEntity

Designação	Descrição	Valor
modo	Modo de mascaramento de dados.	'Esconder' 'Máscara'
valor	O nome de uma entidade a ser mascarada (por exemplo, um nome de um cabeçalho ou um parâmetro de consulta).	string

DiagnosticContractProperties

Designação	Descrição	Valor
sempreLog	Especifica para que tipo de mensagens as configurações de amostragem 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
frontend	Configurações de diagnóstico para mensagens HTTP de entrada/saída para o Gateway.	PipelineDiagnosticSettings
httpCorrelationProtocol	Define o protocolo de correlação a ser usado para o diagnóstico do Application Insights.	'Legado' 'Nenhuma' 'W3C'
logClientIp	Registre o ClientIP. O padrão é false.	Bool
loggerId	ID do recurso de um registrador de destino.	string (obrigatório)
métricas	Emita métricas personalizadas por meio da política de métricas de emissão. Aplicável apenas às configurações de diagnóstico do Application Insights.	Bool
operationNameFormat	O formato do nome da operação para telemetrias do Application Insights. O padrão é Nome.	'Nome' 'Url'
amostragem	Configurações de amostragem para diagnóstico.	SamplingSettings
Verborragia	O nível de detalhamento aplicado aos traços emitidos pelas políticas de rastreamento.	'erro' 'informação' 'Verborrágico'

HttpMessageDiagnostic

Designação	Descrição	Valor
corpo	Configurações de registro do corpo.	BodyDiagnosticSettings
mascaramento de dados	Configurações de mascaramento de dados.	DataMasking
cabeçalhos	Matriz de cabeçalhos HTTP para registrar.	string[]

Microsoft.ApiManagement/service/apis/diagnostics

Designação	Descrição	Valor
apiVersion	A versão api	'2021-01-01-pré-visualização'
Designação	O nome do recurso	string Restrições: Comprimento mínimo = 1 Comprimento máximo = 80 Padrão = ^[^*#&+:<>?]+$ (obrigatório)
propriedades	Propriedades do contrato da entidade de diagnóstico.	DiagnosticContractProperties
tipo	O tipo de recurso	'Microsoft.ApiManagement/service/apis/diagnostics'

PipelineDiagnosticSettings

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

Configurações de amostragem

Designação	Descrição	Valor
percentagem	Taxa de amostragem para amostragem de taxa fixa.	Int Restrições: Valor mínimo = 0 Valor máximo = 100
samplingType	Tipo de amostragem.	'Fixo'

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso service/apis/diagnostics pode ser implantado com operações que visam:

• Grupos de recursos

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

Formato do recurso

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/apis/diagnostics@2021-01-01-preview"
  name = "string"
  body = jsonencode({
    properties = {
      alwaysLog = "string"
      backend = {
        request = {
          body = {
            bytes = int
          }
          dataMasking = {
            headers = [
              {
                mode = "string"
                value = "string"
              }
            ]
            queryParams = [
              {
                mode = "string"
                value = "string"
              }
            ]
          }
          headers = [
            "string"
          ]
        }
        response = {
          body = {
            bytes = int
          }
          dataMasking = {
            headers = [
              {
                mode = "string"
                value = "string"
              }
            ]
            queryParams = [
              {
                mode = "string"
                value = "string"
              }
            ]
          }
          headers = [
            "string"
          ]
        }
      }
      frontend = {
        request = {
          body = {
            bytes = int
          }
          dataMasking = {
            headers = [
              {
                mode = "string"
                value = "string"
              }
            ]
            queryParams = [
              {
                mode = "string"
                value = "string"
              }
            ]
          }
          headers = [
            "string"
          ]
        }
        response = {
          body = {
            bytes = int
          }
          dataMasking = {
            headers = [
              {
                mode = "string"
                value = "string"
              }
            ]
            queryParams = [
              {
                mode = "string"
                value = "string"
              }
            ]
          }
          headers = [
            "string"
          ]
        }
      }
      httpCorrelationProtocol = "string"
      logClientIp = bool
      loggerId = "string"
      metrics = bool
      operationNameFormat = "string"
      sampling = {
        percentage = int
        samplingType = "string"
      }
      verbosity = "string"
    }
  })
}

Valores de propriedade

BodyDiagnosticSettings

Designação	Descrição	Valor
Bytes	Número de bytes do corpo da solicitação para registrar.	Int Restrições: Valor máximo = 8192

Mascaramento de dados

Designação	Descrição	Valor
cabeçalhos	Configurações de mascaramento para cabeçalhos	DataMaskingEntity[]
queryParams	Configurações de mascaramento para parâmetros de consulta Url	DataMaskingEntity[]

DataMaskingEntity

Designação	Descrição	Valor
modo	Modo de mascaramento de dados.	'Esconder' 'Máscara'
valor	O nome de uma entidade a ser mascarada (por exemplo, um nome de um cabeçalho ou um parâmetro de consulta).	string

DiagnosticContractProperties

Designação	Descrição	Valor
sempreLog	Especifica para que tipo de mensagens as configurações de amostragem 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
frontend	Configurações de diagnóstico para mensagens HTTP de entrada/saída para o Gateway.	PipelineDiagnosticSettings
httpCorrelationProtocol	Define o protocolo de correlação a ser usado para o diagnóstico do Application Insights.	'Legado' 'Nenhuma' 'W3C'
logClientIp	Registre o ClientIP. O padrão é false.	Bool
loggerId	ID do recurso de um registrador de destino.	string (obrigatório)
métricas	Emita métricas personalizadas por meio da política de métricas de emissão. Aplicável apenas às configurações de diagnóstico do Application Insights.	Bool
operationNameFormat	O formato do nome da operação para telemetrias do Application Insights. O padrão é Nome.	'Nome' 'Url'
amostragem	Configurações de amostragem para diagnóstico.	SamplingSettings
Verborragia	O nível de detalhamento aplicado aos traços emitidos pelas políticas de rastreamento.	'erro' 'informação' 'Verborrágico'

HttpMessageDiagnostic

Designação	Descrição	Valor
corpo	Configurações de registro do corpo.	BodyDiagnosticSettings
mascaramento de dados	Configurações de mascaramento de dados.	DataMasking
cabeçalhos	Matriz de cabeçalhos HTTP para registrar.	string[]

Microsoft.ApiManagement/service/apis/diagnostics

Designação	Descrição	Valor
Designação	O nome do recurso	string Restrições: Comprimento mínimo = 1 Comprimento máximo = 80 Padrão = ^[^*#&+:<>?]+$ (obrigatório)
parent_id	A ID do recurso que é o pai para este recurso.	ID do recurso do tipo: service/apis
propriedades	Propriedades do contrato da entidade de diagnóstico.	DiagnosticContractProperties
tipo	O tipo de recurso	"Microsoft.ApiManagement/service/apis/diagnostics@2021-01-01-preview"

PipelineDiagnosticSettings

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

Configurações de amostragem

Designação	Descrição	Valor
percentagem	Taxa de amostragem para amostragem de taxa fixa.	Int Restrições: Valor mínimo = 0 Valor máximo = 100
samplingType	Tipo de amostragem.	'Fixo'