Microsoft.ApiManagement service/apis/diagnostics 2022-08-01

Artículo
07/24/2024

Definición de recursos de Bicep

El tipo de recurso service/apis/diagnostics se puede implementar con operaciones que tienen como destino:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.ApiManagement/service/apis/diagnostics, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.ApiManagement/service/apis/diagnostics@2022-08-01' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    alwaysLog: 'allErrors'
    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: 'fixed'
    }
    verbosity: 'string'
  }
}

Valores de propiedad

service/apis/diagnostics

Nombre	Descripción	Valor
nombre	El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en Bicep.	string (obligatorio)
padre	En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario. Para obtener más información, consulte recurso secundario fuera del recurso primario.	Nombre simbólico del recurso de tipo: api de
Propiedades	Propiedades del contrato de entidad de diagnóstico.	DiagnosticContractProperties

DiagnosticContractProperties

Nombre	Descripción	Valor
alwaysLog	Especifica para qué tipo de configuración de muestreo de mensajes no se debe aplicar.	'allErrors'
back-end	Configuración de diagnóstico para los mensajes HTTP entrantes o salientes en el back-end	pipelineDiagnosticSettings
front-end	Configuración de diagnóstico para los mensajes HTTP entrantes y salientes a la puerta de enlace.	pipelineDiagnosticSettings
httpCorrelationProtocol	Establece el protocolo de correlación que se usará para los diagnósticos de Application Insights.	'Heredado' 'Ninguno' 'W3C'
logClientIp	Registre clientIP. El valor predeterminado es false.	Bool
loggerId	Identificador de recurso de un registrador de destino.	string (obligatorio)
Métricas	Emita métricas personalizadas a través de la directiva de métricas de emisión. Solo se aplica a la configuración de diagnóstico de Application Insights.	Bool
operationNameFormat	El formato del nombre de la operación para los datos de telemetría de Application Insights. El valor predeterminado es Name.	'Name' 'Url'
muestreo	Configuración de muestreo para Diagnóstico.	samplingSettings
verbosidad	Nivel de detalle aplicado a seguimientos emitidos por directivas de seguimiento.	'error' 'information' 'verbose'

PipelineDiagnosticSettings

Nombre	Descripción	Valor
pedir	Configuración de diagnóstico para la solicitud.	httpMessageDiagnostic
respuesta	Configuración de diagnóstico para la respuesta.	httpMessageDiagnostic

HttpMessageDiagnostic

Nombre	Descripción	Valor
cuerpo	Configuración de registro del cuerpo.	BodyDiagnosticSettings
dataMasking	Configuración de enmascaramiento de datos.	DataMasking
Encabezados	Matriz de encabezados HTTP que se van a registrar.	string[]

BodyDiagnosticSettings

Nombre	Descripción	Valor
Bytes	Número de bytes del cuerpo de la solicitud que se van a registrar.	Int Restricciones: Valor máximo = 8192

DataMasking

Nombre	Descripción	Valor
Encabezados	Configuración de enmascaramiento de encabezados	DataMaskingEntity []
queryParams	Configuración de enmascaramiento para parámetros de consulta url	DataMaskingEntity []

DataMaskingEntity

Nombre	Descripción	Valor
modo	Modo de enmascaramiento de datos.	'Ocultar' 'Mask'
valor	Nombre de una entidad que se va a enmascarar (por ejemplo, un nombre de un encabezado o un parámetro de consulta).	cuerda

SamplingSettings

Nombre	Descripción	Valor
porcentaje	Frecuencia de muestreo para el muestreo de frecuencia fija.	Int Restricciones: Valor mínimo = 0 Valor máximo = 100
samplingType	Tipo de muestreo.	'fixed'

Definición de recursos de plantilla de ARM

El tipo de recurso service/apis/diagnostics se puede implementar con operaciones que tienen como destino:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.ApiManagement/service/apis/diagnostics, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.ApiManagement/service/apis/diagnostics",
  "apiVersion": "2022-08-01",
  "name": "string",
  "properties": {
    "alwaysLog": "allErrors",
    "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": "fixed"
    },
    "verbosity": "string"
  }
}

Valores de propiedad

service/apis/diagnostics

Nombre	Descripción	Valor
tipo	El tipo de recurso	"Microsoft.ApiManagement/service/apis/diagnostics"
apiVersion	La versión de la API de recursos	'2022-08-01'
nombre	El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM json.	string (obligatorio)
Propiedades	Propiedades del contrato de entidad de diagnóstico.	DiagnosticContractProperties

DiagnosticContractProperties

Nombre	Descripción	Valor
alwaysLog	Especifica para qué tipo de configuración de muestreo de mensajes no se debe aplicar.	'allErrors'
back-end	Configuración de diagnóstico para los mensajes HTTP entrantes o salientes en el back-end	pipelineDiagnosticSettings
front-end	Configuración de diagnóstico para los mensajes HTTP entrantes y salientes a la puerta de enlace.	pipelineDiagnosticSettings
httpCorrelationProtocol	Establece el protocolo de correlación que se usará para los diagnósticos de Application Insights.	'Heredado' 'Ninguno' 'W3C'
logClientIp	Registre clientIP. El valor predeterminado es false.	Bool
loggerId	Identificador de recurso de un registrador de destino.	string (obligatorio)
Métricas	Emita métricas personalizadas a través de la directiva de métricas de emisión. Solo se aplica a la configuración de diagnóstico de Application Insights.	Bool
operationNameFormat	El formato del nombre de la operación para los datos de telemetría de Application Insights. El valor predeterminado es Name.	'Name' 'Url'
muestreo	Configuración de muestreo para Diagnóstico.	samplingSettings
verbosidad	Nivel de detalle aplicado a seguimientos emitidos por directivas de seguimiento.	'error' 'information' 'verbose'

PipelineDiagnosticSettings

Nombre	Descripción	Valor
pedir	Configuración de diagnóstico para la solicitud.	httpMessageDiagnostic
respuesta	Configuración de diagnóstico para la respuesta.	httpMessageDiagnostic

HttpMessageDiagnostic

Nombre	Descripción	Valor
cuerpo	Configuración de registro del cuerpo.	BodyDiagnosticSettings
dataMasking	Configuración de enmascaramiento de datos.	DataMasking
Encabezados	Matriz de encabezados HTTP que se van a registrar.	string[]

BodyDiagnosticSettings

Nombre	Descripción	Valor
Bytes	Número de bytes del cuerpo de la solicitud que se van a registrar.	Int Restricciones: Valor máximo = 8192

DataMasking

Nombre	Descripción	Valor
Encabezados	Configuración de enmascaramiento de encabezados	DataMaskingEntity []
queryParams	Configuración de enmascaramiento para parámetros de consulta url	DataMaskingEntity []

DataMaskingEntity

Nombre	Descripción	Valor
modo	Modo de enmascaramiento de datos.	'Ocultar' 'Mask'
valor	Nombre de una entidad que se va a enmascarar (por ejemplo, un nombre de un encabezado o un parámetro de consulta).	cuerda

SamplingSettings

Nombre	Descripción	Valor
porcentaje	Frecuencia de muestreo para el muestreo de frecuencia fija.	Int Restricciones: Valor mínimo = 0 Valor máximo = 100
samplingType	Tipo de muestreo.	'fixed'

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso service/apis/diagnostics se puede implementar con operaciones que tienen como destino:

grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.ApiManagement/service/apis/diagnostics, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/apis/diagnostics@2022-08-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      alwaysLog = "allErrors"
      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 = "fixed"
      }
      verbosity = "string"
    }
  })
}

Valores de propiedad

service/apis/diagnostics

Nombre	Descripción	Valor
tipo	El tipo de recurso	"Microsoft.ApiManagement/service/apis/diagnostics@2022-08-01"
nombre	El nombre del recurso	string (obligatorio)
parent_id	Identificador del recurso que es el elemento primario de este recurso.	Identificador del recurso de tipo: api de
Propiedades	Propiedades del contrato de entidad de diagnóstico.	DiagnosticContractProperties

DiagnosticContractProperties

Nombre	Descripción	Valor
alwaysLog	Especifica para qué tipo de configuración de muestreo de mensajes no se debe aplicar.	"allErrors"
back-end	Configuración de diagnóstico para los mensajes HTTP entrantes o salientes en el back-end	pipelineDiagnosticSettings
front-end	Configuración de diagnóstico para los mensajes HTTP entrantes y salientes a la puerta de enlace.	pipelineDiagnosticSettings
httpCorrelationProtocol	Establece el protocolo de correlación que se usará para los diagnósticos de Application Insights.	"Heredado" "Ninguno" "W3C"
logClientIp	Registre clientIP. El valor predeterminado es false.	Bool
loggerId	Identificador de recurso de un registrador de destino.	string (obligatorio)
Métricas	Emita métricas personalizadas a través de la directiva de métricas de emisión. Solo se aplica a la configuración de diagnóstico de Application Insights.	Bool
operationNameFormat	El formato del nombre de la operación para los datos de telemetría de Application Insights. El valor predeterminado es Name.	"Nombre" "Url"
muestreo	Configuración de muestreo para Diagnóstico.	samplingSettings
verbosidad	Nivel de detalle aplicado a seguimientos emitidos por directivas de seguimiento.	"error" "información" "detallado"

PipelineDiagnosticSettings

Nombre	Descripción	Valor
pedir	Configuración de diagnóstico para la solicitud.	httpMessageDiagnostic
respuesta	Configuración de diagnóstico para la respuesta.	httpMessageDiagnostic

HttpMessageDiagnostic

Nombre	Descripción	Valor
cuerpo	Configuración de registro del cuerpo.	BodyDiagnosticSettings
dataMasking	Configuración de enmascaramiento de datos.	DataMasking
Encabezados	Matriz de encabezados HTTP que se van a registrar.	string[]

BodyDiagnosticSettings

Nombre	Descripción	Valor
Bytes	Número de bytes del cuerpo de la solicitud que se van a registrar.	Int Restricciones: Valor máximo = 8192

DataMasking

Nombre	Descripción	Valor
Encabezados	Configuración de enmascaramiento de encabezados	DataMaskingEntity []
queryParams	Configuración de enmascaramiento para parámetros de consulta url	DataMaskingEntity []

DataMaskingEntity

Nombre	Descripción	Valor
modo	Modo de enmascaramiento de datos.	"Ocultar" "Máscara"
valor	Nombre de una entidad que se va a enmascarar (por ejemplo, un nombre de un encabezado o un parámetro de consulta).	cuerda

SamplingSettings

Nombre	Descripción	Valor
porcentaje	Frecuencia de muestreo para el muestreo de frecuencia fija.	Int Restricciones: Valor mínimo = 0 Valor máximo = 100
samplingType	Tipo de muestreo.	"fijo"

Compartir a través de

Microsoft.ApiManagement service/apis/diagnostics 2022-08-01

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

service/apis/diagnostics

DiagnosticContractProperties

PipelineDiagnosticSettings

HttpMessageDiagnostic

BodyDiagnosticSettings

DataMasking

DataMaskingEntity

SamplingSettings

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

service/apis/diagnostics

DiagnosticContractProperties

PipelineDiagnosticSettings

HttpMessageDiagnostic

BodyDiagnosticSettings

DataMasking

DataMaskingEntity

SamplingSettings

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

service/apis/diagnostics

DiagnosticContractProperties

PipelineDiagnosticSettings

HttpMessageDiagnostic

BodyDiagnosticSettings

DataMasking

DataMaskingEntity

SamplingSettings

Comentarios

Recursos adicionales