Microsoft.ApiManagement service/apis/diagnostics

Artikel
07/24/2024

Bicep-resursdefinition

Resurstypen tjänst/apis/diagnostik kan distribueras med åtgärder som mål:

Resursgrupper – Se resursgruppsdistributionskommandon

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.ApiManagement/service/apis/diagnostics-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.ApiManagement/service/apis/diagnostics@2023-09-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'
  }
}

Egenskapsvärden

service/apis/diagnostics

Namn	Beskrivning	Värde
Namn	Resursnamnet Se hur du anger namn och typer för underordnade resurser i Bicep.	sträng (krävs)
förälder	I Bicep kan du ange den överordnade resursen för en underordnad resurs. Du behöver bara lägga till den här egenskapen när den underordnade resursen deklareras utanför den överordnade resursen. Mer information finns i Underordnad resurs utanför den överordnade resursen.	Symboliskt namn för resurs av typen: api:ar
Egenskaper	Egenskaper för diagnostikentitetskontrakt.	DiagnosticContractProperties

DiagnosticContractProperties

Namn	Beskrivning	Värde
alwaysLog	Anger vilken typ av meddelandesamplingsinställningar som inte ska tillämpas.	"allErrors"
serverdel	Diagnostikinställningar för inkommande/utgående HTTP-meddelanden till serverdelen	PipelineDiagnosticSettings
klientdel	Diagnostikinställningar för inkommande/utgående HTTP-meddelanden till gatewayen.	PipelineDiagnosticSettings
httpCorrelationProtocol	Anger korrelationsprotokoll som ska användas för Application Insights-diagnostik.	"Äldre" "Ingen" "W3C"
logClientIp	Logga ClientIP. Standardvärdet är falskt.	Bool
loggerId	Resurs-ID för en målloggare.	sträng (krävs)
metrik	Generera anpassade mått via principen för utsända mått. Gäller endast diagnostikinställningar för Application Insights.	Bool
operationNameFormat	Formatet för åtgärdsnamnet för Application Insights-telemetrier. Standardvärdet är Namn.	Namn "Url"
provtagning	Samplingsinställningar för diagnostik.	SamplingSettings
Informationsnivån	Den verbositetsnivå som tillämpas på spårningar som genereras av spårningsprinciper.	"fel" "information" "utförligt"

PipelineDiagnosticSettings

Namn	Beskrivning	Värde
begäran	Diagnostikinställningar för begäran.	HttpMessageDiagnostic
svar	Diagnostikinställningar för svar.	HttpMessageDiagnostic

HttpMessageDiagnostic

Namn	Beskrivning	Värde
kropp	Inställningar för kroppsloggning.	BodyDiagnosticSettings
dataMaskering	Inställningar för datamaskering.	DataMasking
Headers	Matris med HTTP-huvuden som ska loggas.	string[]

BodyDiagnosticSettings

Namn	Beskrivning	Värde
Byte	Antal begärandetextbyte som ska loggas.	Int Begränsningar: Maxvärde = 8192

Datamaskering

Namn	Beskrivning	Värde
Headers	Maskeringsinställningar för rubriker	DataMaskingEntity[]
queryParams	Maskeringsinställningar för URL-frågeparametrar	DataMaskingEntity[]

DataMaskingEntity

Namn	Beskrivning	Värde
läge	Datamaskeringsläge.	"Dölj" "Maskera"
värde	Namnet på en entitet som ska maskeras (t.ex. ett namn på en rubrik eller en frågeparameter).	sträng

SamplingSettings

Namn	Beskrivning	Värde
procent	Samplingshastighet för fast sampling.	Int Begränsningar: Minsta värde = 0 Maxvärde = 100
samplingType	Samplingstyp.	"fast"

Resursdefinition för ARM-mall

Resurstypen tjänst/apis/diagnostik kan distribueras med åtgärder som mål:

Resursgrupper – Se resursgruppsdistributionskommandon

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.ApiManagement/service/apis/diagnostics-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.ApiManagement/service/apis/diagnostics",
  "apiVersion": "2023-09-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"
  }
}

Egenskapsvärden

service/apis/diagnostics

Namn	Beskrivning	Värde
typ	Resurstypen	"Microsoft.ApiManagement/service/apis/diagnostics"
apiVersion	Resurs-API-versionen	"2023-09-01-preview"
Namn	Resursnamnet Se hur du anger namn och typer för underordnade resurser i JSON ARM-mallar.	sträng (krävs)
Egenskaper	Egenskaper för diagnostikentitetskontrakt.	DiagnosticContractProperties

DiagnosticContractProperties

Namn	Beskrivning	Värde
alwaysLog	Anger vilken typ av meddelandesamplingsinställningar som inte ska tillämpas.	"allErrors"
serverdel	Diagnostikinställningar för inkommande/utgående HTTP-meddelanden till serverdelen	PipelineDiagnosticSettings
klientdel	Diagnostikinställningar för inkommande/utgående HTTP-meddelanden till gatewayen.	PipelineDiagnosticSettings
httpCorrelationProtocol	Anger korrelationsprotokoll som ska användas för Application Insights-diagnostik.	"Äldre" "Ingen" "W3C"
logClientIp	Logga ClientIP. Standardvärdet är falskt.	Bool
loggerId	Resurs-ID för en målloggare.	sträng (krävs)
metrik	Generera anpassade mått via principen för utsända mått. Gäller endast diagnostikinställningar för Application Insights.	Bool
operationNameFormat	Formatet för åtgärdsnamnet för Application Insights-telemetrier. Standardvärdet är Namn.	Namn "Url"
provtagning	Samplingsinställningar för diagnostik.	SamplingSettings
Informationsnivån	Den verbositetsnivå som tillämpas på spårningar som genereras av spårningsprinciper.	"fel" "information" "utförligt"

PipelineDiagnosticSettings

Namn	Beskrivning	Värde
begäran	Diagnostikinställningar för begäran.	HttpMessageDiagnostic
svar	Diagnostikinställningar för svar.	HttpMessageDiagnostic

HttpMessageDiagnostic

Namn	Beskrivning	Värde
kropp	Inställningar för kroppsloggning.	BodyDiagnosticSettings
dataMaskering	Inställningar för datamaskering.	DataMasking
Headers	Matris med HTTP-huvuden som ska loggas.	string[]

BodyDiagnosticSettings

Namn	Beskrivning	Värde
Byte	Antal begärandetextbyte som ska loggas.	Int Begränsningar: Maxvärde = 8192

Datamaskering

Namn	Beskrivning	Värde
Headers	Maskeringsinställningar för rubriker	DataMaskingEntity[]
queryParams	Maskeringsinställningar för URL-frågeparametrar	DataMaskingEntity[]

DataMaskingEntity

Namn	Beskrivning	Värde
läge	Datamaskeringsläge.	"Dölj" "Maskera"
värde	Namnet på en entitet som ska maskeras (t.ex. ett namn på en rubrik eller en frågeparameter).	sträng

SamplingSettings

Namn	Beskrivning	Värde
procent	Samplingshastighet för fast sampling.	Int Begränsningar: Minsta värde = 0 Maxvärde = 100
samplingType	Samplingstyp.	"fast"

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen tjänst/apis/diagnostik kan distribueras med åtgärder som mål:

Resursgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.ApiManagement/service/apis/diagnostics-resurs lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/apis/diagnostics@2023-09-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"
    }
  })
}

Egenskapsvärden

service/apis/diagnostics

Namn	Beskrivning	Värde
typ	Resurstypen	"Microsoft.ApiManagement/service/apis/diagnostics@2023-09-01-preview"
Namn	Resursnamnet	sträng (krävs)
parent_id	ID för resursen som är överordnad för den här resursen.	ID för resurs av typen: apis
Egenskaper	Egenskaper för diagnostikentitetskontrakt.	DiagnosticContractProperties

DiagnosticContractProperties

Namn	Beskrivning	Värde
alwaysLog	Anger vilken typ av meddelandesamplingsinställningar som inte ska tillämpas.	"allErrors"
serverdel	Diagnostikinställningar för inkommande/utgående HTTP-meddelanden till serverdelen	PipelineDiagnosticSettings
klientdel	Diagnostikinställningar för inkommande/utgående HTTP-meddelanden till gatewayen.	PipelineDiagnosticSettings
httpCorrelationProtocol	Anger korrelationsprotokoll som ska användas för Application Insights-diagnostik.	"Äldre" "Ingen" "W3C"
logClientIp	Logga ClientIP. Standardvärdet är falskt.	Bool
loggerId	Resurs-ID för en målloggare.	sträng (krävs)
metrik	Generera anpassade mått via principen för utsända mått. Gäller endast diagnostikinställningar för Application Insights.	Bool
operationNameFormat	Formatet för åtgärdsnamnet för Application Insights-telemetrier. Standardvärdet är Namn.	"Namn" "Url"
provtagning	Samplingsinställningar för diagnostik.	SamplingSettings
Informationsnivån	Den verbositetsnivå som tillämpas på spårningar som genereras av spårningsprinciper.	"fel" "information" "utförligt"

PipelineDiagnosticSettings

Namn	Beskrivning	Värde
begäran	Diagnostikinställningar för begäran.	HttpMessageDiagnostic
svar	Diagnostikinställningar för svar.	HttpMessageDiagnostic

HttpMessageDiagnostic

Namn	Beskrivning	Värde
kropp	Inställningar för kroppsloggning.	BodyDiagnosticSettings
dataMaskering	Inställningar för datamaskering.	DataMasking
Headers	Matris med HTTP-huvuden som ska loggas.	string[]

BodyDiagnosticSettings

Namn	Beskrivning	Värde
Byte	Antal begärandetextbyte som ska loggas.	Int Begränsningar: Maxvärde = 8192

Datamaskering

Namn	Beskrivning	Värde
Headers	Maskeringsinställningar för rubriker	DataMaskingEntity[]
queryParams	Maskeringsinställningar för URL-frågeparametrar	DataMaskingEntity[]

DataMaskingEntity

Namn	Beskrivning	Värde
läge	Datamaskeringsläge.	"Dölj" "Maskera"
värde	Namnet på en entitet som ska maskeras (t.ex. ett namn på en rubrik eller en frågeparameter).	sträng

SamplingSettings

Namn	Beskrivning	Värde
procent	Samplingshastighet för fast sampling.	Int Begränsningar: Minsta värde = 0 Maxvärde = 100
samplingType	Samplingstyp.	"fast"

Dela via

Microsoft.ApiManagement service/apis/diagnostics

Bicep-resursdefinition

Resursformat

Egenskapsvärden

service/apis/diagnostics

DiagnosticContractProperties

PipelineDiagnosticSettings

HttpMessageDiagnostic

BodyDiagnosticSettings

Datamaskering

DataMaskingEntity

SamplingSettings

Resursdefinition för ARM-mall

Resursformat

Egenskapsvärden

service/apis/diagnostics

DiagnosticContractProperties

PipelineDiagnosticSettings

HttpMessageDiagnostic

BodyDiagnosticSettings

Datamaskering

DataMaskingEntity

SamplingSettings

Resursdefinition för Terraform (AzAPI-provider)

Resursformat

Egenskapsvärden

service/apis/diagnostics

DiagnosticContractProperties

PipelineDiagnosticSettings

HttpMessageDiagnostic

BodyDiagnosticSettings

Datamaskering

DataMaskingEntity

SamplingSettings

Feedback

Ytterligare resurser