Microsoft.ApiManagement service/apis/diagnostics 2021-12-01-preview
Definición de recursos de Bicep
El tipo de recurso service/apis/diagnostics se puede implementar con operaciones destinadas a:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.ApiManagement/service/apis/diagnostics, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.ApiManagement/service/apis/diagnostics@2021-12-01-preview' = {
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 | Value |
|---|---|---|
| name | El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en Bicep. |
string (obligatorio) |
| primario | 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 más información, consulte Recurso secundario fuera del recurso primario. |
Nombre simbólico del recurso de tipo: APIs |
| properties | 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 |
| Frontend | Configuración de diagnóstico para los mensajes HTTP entrantes o 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 |
| detalle | Nivel de detalle aplicado a los seguimientos emitidos por las directivas de seguimiento. | 'error' 'information' 'verbose' |
PipelineDiagnosticSettings
| Nombre | Descripción | Valor |
|---|---|---|
| request | Configuración de diagnóstico para la solicitud. | HttpMessageDiagnostic |
| respuesta | Configuración de diagnóstico para la respuesta. | HttpMessageDiagnostic |
HttpMessageDiagnostic
| Nombre | Descripción | Valor |
|---|---|---|
| body | Configuración de registro del cuerpo. | BodyDiagnosticSettings |
| dataMasking | Configuración de enmascaramiento de datos. | DataMasking |
| headers | 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 |
DataMasking
| Nombre | Descripción | Valor |
|---|---|---|
| headers | Configuración de enmascaramiento de encabezados | DataMaskingEntity[] |
| queryParams | Configuración de enmascaramiento para parámetros de consulta url | DataMaskingEntity[] |
DataMaskingEntity
| Nombre | Descripción | Valor |
|---|---|---|
| mode | Modo de enmascaramiento de datos. | 'Ocultar' 'Máscara' |
| value | Nombre de una entidad que se va a enmascarar (por ejemplo, un nombre de un encabezado o un parámetro de consulta). | string |
SamplingSettings
| Nombre | Descripción | Valor |
|---|---|---|
| percentage | Frecuencia de muestreo para muestreo de frecuencia fija. | int |
| 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 destinadas a:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.ApiManagement/service/apis/diagnostics, agregue el siguiente JSON a la plantilla.
{
"type": "Microsoft.ApiManagement/service/apis/diagnostics",
"apiVersion": "2021-12-01-preview",
"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 | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.ApiManagement/service/apis/diagnostics" |
| apiVersion | La versión de la API de recursos | "2021-12-01-preview" |
| name | El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM JSON. |
string (obligatorio) |
| properties | 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 mensajes HTTP entrantes o salientes en el back-end | PipelineDiagnosticSettings |
| Frontend | Configuración de diagnóstico para los mensajes HTTP entrantes o salientes en la puerta de enlace. | PipelineDiagnosticSettings |
| httpCorrelationProtocol | Establece el protocolo de correlación que se va a usar para el diagnóstico 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étrica de emisión. Solo se aplica a la configuración de diagnóstico de Application Insights. | bool |
| operationNameFormat | 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 |
| detalle | Nivel de detalle aplicado a los seguimientos emitidos por las directivas de seguimiento. | 'error' 'information' 'verbose' |
PipelineDiagnosticSettings
| Nombre | Descripción | Valor |
|---|---|---|
| request | Configuración de diagnóstico para la solicitud. | HttpMessageDiagnostic |
| respuesta | Configuración de diagnóstico para la respuesta. | HttpMessageDiagnostic |
HttpMessageDiagnostic
| Nombre | Descripción | Valor |
|---|---|---|
| body | Configuración de registro del cuerpo. | BodyDiagnosticSettings |
| dataMasking | Configuración de enmascaramiento de datos. | DataMasking |
| headers | 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 |
DataMasking
| Nombre | Descripción | Valor |
|---|---|---|
| headers | Configuración de enmascaramiento de encabezados | DataMaskingEntity[] |
| queryParams | Configuración de enmascaramiento para parámetros de consulta url | DataMaskingEntity[] |
DataMaskingEntity
| Nombre | Descripción | Valor |
|---|---|---|
| mode | Modo de enmascaramiento de datos. | 'Ocultar' 'Máscara' |
| value | Nombre de una entidad que se va a enmascarar (por ejemplo, un nombre de un encabezado o un parámetro de consulta). | string |
SamplingSettings
| Nombre | Descripción | Valor |
|---|---|---|
| percentage | Frecuencia de muestreo para muestreo de frecuencia fija. | int |
| 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 destinadas a:
- Grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
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@2021-12-01-preview"
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 | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.ApiManagement/service/apis/diagnostics@2021-12-01-preview" |
| name | El nombre del recurso | string (obligatorio) |
| parent_id | Identificador del recurso que es el elemento primario de este recurso. | Identificador del recurso de tipo: APIs |
| properties | 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 mensajes HTTP entrantes o salientes en el back-end | PipelineDiagnosticSettings |
| Frontend | Configuración de diagnóstico para los mensajes HTTP entrantes o 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" "None" "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 |
| detalle | Nivel de detalle aplicado a los seguimientos emitidos por las directivas de seguimiento. | "error" "información" "detallado" |
PipelineDiagnosticSettings
| Nombre | Descripción | Valor |
|---|---|---|
| request | Configuración de diagnóstico para la solicitud. | HttpMessageDiagnostic |
| respuesta | Configuración de diagnóstico para la respuesta. | HttpMessageDiagnostic |
HttpMessageDiagnostic
| Nombre | Descripción | Valor |
|---|---|---|
| body | Configuración de registro del cuerpo. | BodyDiagnosticSettings |
| dataMasking | Configuración de enmascaramiento de datos. | DataMasking |
| headers | 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 |
DataMasking
| Nombre | Descripción | Valor |
|---|---|---|
| headers | Configuración de enmascaramiento para encabezados | DataMaskingEntity[] |
| queryParams | Configuración de enmascaramiento para parámetros de consulta url | DataMaskingEntity[] |
DataMaskingEntity
| Nombre | Descripción | Valor |
|---|---|---|
| mode | Modo de enmascaramiento de datos. | "Ocultar" "Máscara" |
| value | Nombre de una entidad que se va a enmascarar (por ejemplo, un nombre de un encabezado o un parámetro de consulta). | string |
SamplingSettings
| Nombre | Descripción | Valor |
|---|---|---|
| percentage | Frecuencia de muestreo para muestreo de frecuencia fija. | int |
| samplingType | Tipo de muestreo. | "fijo" |