Microsoft.ApiManagement service/workspaces/diagnostics 2024-06-01-preview

Artículo
12/21/2024

Definición de recursos de Bicep

El tipo de recurso service/workspaces/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/workspaces/diagnostics, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.ApiManagement/service/workspaces/diagnostics@2024-06-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'
    largeLanguageModel: {
      logs: 'string'
      requests: {
        maxSizeInBytes: int
        messages: 'string'
      }
      responses: {
        maxSizeInBytes: int
        messages: 'string'
      }
    }
    logClientIp: bool
    loggerId: 'string'
    metrics: bool
    operationNameFormat: 'string'
    sampling: {
      percentage: int
      samplingType: 'string'
    }
    verbosity: 'string'
  }
}

Valores de propiedad

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

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'
largeLanguageModel	Configuración de diagnóstico de modelos de lenguaje grande	LLMDiagnosticSettings
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'

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[]

LLMDiagnosticSettings

Nombre	Descripción	Valor
trozas	Especifica si se debe habilitar el diagnóstico predeterminado para modelos de lenguaje grande o no.	'disabled' 'habilitado'
Solicitudes	Configuración de diagnóstico para solicitudes de modelos de lenguaje grande.	LLMMessageDiagnosticSettings
Respuestas	Configuración de diagnóstico para respuestas de modelos de lenguaje grande.	LLMMessageDiagnosticSettings

LLMMessageDiagnosticSettings

Nombre	Descripción	Valor
maxSizeInBytes	Tamaño máximo del mensaje a los registros en bytes. El tamaño predeterminado es de 32 KB.	Int Restricciones: Valor mínimo = 1 Valor máximo = 262144
Mensajes	Especifica qué mensaje se debe registrar. Actualmente solo hay la opción "all".	'all'

Microsoft.ApiManagement/service/workspaces/diagnostics

Nombre	Descripción	Valor
nombre	El nombre del recurso	cuerda Restricciones: Longitud mínima = 1 Longitud máxima = 1 Patrón = `^[^*#&+:<>?]+$` (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: servicio o áreas de trabajo
Propiedades	Propiedades del contrato de entidad de diagnóstico.	DiagnosticContractProperties

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

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/workspaces/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/workspaces/diagnostics, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.ApiManagement/service/workspaces/diagnostics",
  "apiVersion": "2024-06-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",
    "largeLanguageModel": {
      "logs": "string",
      "requests": {
        "maxSizeInBytes": "int",
        "messages": "string"
      },
      "responses": {
        "maxSizeInBytes": "int",
        "messages": "string"
      }
    },
    "logClientIp": "bool",
    "loggerId": "string",
    "metrics": "bool",
    "operationNameFormat": "string",
    "sampling": {
      "percentage": "int",
      "samplingType": "string"
    },
    "verbosity": "string"
  }
}

Valores de propiedad

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

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'
largeLanguageModel	Configuración de diagnóstico de modelos de lenguaje grande	LLMDiagnosticSettings
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'

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[]

LLMDiagnosticSettings

Nombre	Descripción	Valor
trozas	Especifica si se debe habilitar el diagnóstico predeterminado para modelos de lenguaje grande o no.	'disabled' 'habilitado'
Solicitudes	Configuración de diagnóstico para solicitudes de modelos de lenguaje grande.	LLMMessageDiagnosticSettings
Respuestas	Configuración de diagnóstico para respuestas de modelos de lenguaje grande.	LLMMessageDiagnosticSettings

LLMMessageDiagnosticSettings

Nombre	Descripción	Valor
maxSizeInBytes	Tamaño máximo del mensaje a los registros en bytes. El tamaño predeterminado es de 32 KB.	Int Restricciones: Valor mínimo = 1 Valor máximo = 262144
Mensajes	Especifica qué mensaje se debe registrar. Actualmente solo hay la opción "all".	'all'

Microsoft.ApiManagement/service/workspaces/diagnostics

Nombre	Descripción	Valor
apiVersion	La versión de api	'2024-06-01-preview'
nombre	El nombre del recurso	cuerda Restricciones: Longitud mínima = 1 Longitud máxima = 1 Patrón = `^[^*#&+:<>?]+$` (obligatorio)
Propiedades	Propiedades del contrato de entidad de diagnóstico.	DiagnosticContractProperties
tipo	El tipo de recurso	"Microsoft.ApiManagement/service/workspaces/diagnostics"

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

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/workspaces/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/workspaces/diagnostics, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/workspaces/diagnostics@2024-06-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"
      largeLanguageModel = {
        logs = "string"
        requests = {
          maxSizeInBytes = int
          messages = "string"
        }
        responses = {
          maxSizeInBytes = int
          messages = "string"
        }
      }
      logClientIp = bool
      loggerId = "string"
      metrics = bool
      operationNameFormat = "string"
      sampling = {
        percentage = int
        samplingType = "string"
      }
      verbosity = "string"
    }
  })
}

Valores de propiedad

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

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'
largeLanguageModel	Configuración de diagnóstico de modelos de lenguaje grande	LLMDiagnosticSettings
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'

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[]

LLMDiagnosticSettings

Nombre	Descripción	Valor
trozas	Especifica si se debe habilitar el diagnóstico predeterminado para modelos de lenguaje grande o no.	'disabled' 'habilitado'
Solicitudes	Configuración de diagnóstico para solicitudes de modelos de lenguaje grande.	LLMMessageDiagnosticSettings
Respuestas	Configuración de diagnóstico para respuestas de modelos de lenguaje grande.	LLMMessageDiagnosticSettings

LLMMessageDiagnosticSettings

Nombre	Descripción	Valor
maxSizeInBytes	Tamaño máximo del mensaje a los registros en bytes. El tamaño predeterminado es de 32 KB.	Int Restricciones: Valor mínimo = 1 Valor máximo = 262144
Mensajes	Especifica qué mensaje se debe registrar. Actualmente solo hay la opción "all".	'all'

Microsoft.ApiManagement/service/workspaces/diagnostics

Nombre	Descripción	Valor
nombre	El nombre del recurso	cuerda Restricciones: Longitud mínima = 1 Longitud máxima = 1 Patrón = `^[^*#&+:<>?]+$` (obligatorio)
parent_id	Identificador del recurso que es el elemento primario de este recurso.	Identificador del recurso de tipo: servicio o áreas de trabajo
Propiedades	Propiedades del contrato de entidad de diagnóstico.	DiagnosticContractProperties
tipo	El tipo de recurso	"Microsoft.ApiManagement/service/workspaces/diagnostics@2024-06-01-preview"

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

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'

Compartir a través de

Microsoft.ApiManagement service/workspaces/diagnostics 2024-06-01-preview

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

BodyDiagnosticSettings

DataMasking

DataMaskingEntity

DiagnosticContractProperties

HttpMessageDiagnostic

LLMDiagnosticSettings

LLMMessageDiagnosticSettings

Microsoft.ApiManagement/service/workspaces/diagnostics

PipelineDiagnosticSettings

SamplingSettings

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

BodyDiagnosticSettings

DataMasking

DataMaskingEntity

DiagnosticContractProperties

HttpMessageDiagnostic

LLMDiagnosticSettings

LLMMessageDiagnosticSettings

Microsoft.ApiManagement/service/workspaces/diagnostics

PipelineDiagnosticSettings

SamplingSettings

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

BodyDiagnosticSettings

DataMasking

DataMaskingEntity

DiagnosticContractProperties

HttpMessageDiagnostic

LLMDiagnosticSettings

LLMMessageDiagnosticSettings

Microsoft.ApiManagement/service/workspaces/diagnostics

PipelineDiagnosticSettings

SamplingSettings

Comentarios

Recursos adicionales