Microsoft.ApiManagement service/diagnostics 2022-08-01

Artikel
07/24/2024

Bicep-resursdefinition

Resurstypen tjänst/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/diagnostics-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.ApiManagement/service/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'
  }
}

Egenskapsvärden

tjänst/diagnostik

Namn	Beskrivning	Värde
Namn	Resursnamnet Se hur du anger namn och typer för underordnade resurser i Bicep.	sträng (krävs) Teckengräns: 1–80 Giltiga tecken: Alfanumeriska tecken och bindestreck. Börja med bokstav och slut med alfanumeriskt.
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: tjänst
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"

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall	Beskrivning
Skapa API Management i internt VNet med App Gateway	Den här mallen visar hur du skapar en instans av Azure API Management i ett privat nätverk som skyddas av Azure Application Gateway.
Application Gateway med intern API Management och Web App	Application Gateway dirigerar Internettrafik till en API Management-instans för virtuellt nätverk (internt läge) som servar ett webb-API som finns i en Azure-webbapp.

Resursdefinition för ARM-mall

Resurstypen tjänst/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/diagnostics-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.ApiManagement/service/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"
  }
}

Egenskapsvärden

tjänst/diagnostik

Namn	Beskrivning	Värde
typ	Resurstypen	"Microsoft.ApiManagement/service/diagnostics"
apiVersion	Resurs-API-versionen	'2022-08-01'
Namn	Resursnamnet Se hur du anger namn och typer för underordnade resurser i JSON ARM-mallar.	sträng (krävs) Teckengräns: 1–80 Giltiga tecken: Alfanumeriska tecken och bindestreck. Börja med bokstav och slut med alfanumeriskt.
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"

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall	Beskrivning
Skapa API Management i internt VNet med App Gateway	Den här mallen visar hur du skapar en instans av Azure API Management i ett privat nätverk som skyddas av Azure Application Gateway.
Application Gateway med intern API Management och Web App	Application Gateway dirigerar Internettrafik till en API Management-instans för virtuellt nätverk (internt läge) som servar ett webb-API som finns i en Azure-webbapp.

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen tjänst/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/diagnostics-resurs lägger du till följande Terraform i mallen.

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

Egenskapsvärden

tjänst/diagnostik

Namn	Beskrivning	Värde
typ	Resurstypen	"Microsoft.ApiManagement/service/diagnostics@2022-08-01"
Namn	Resursnamnet	sträng (krävs) Teckengräns: 1–80 Giltiga tecken: Alfanumeriska tecken och bindestreck. Börja med bokstav och slut med alfanumeriskt.
parent_id	ID för resursen som är överordnad för den här resursen.	ID för resurs av typen: tjänst
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/diagnostics 2022-08-01

Bicep-resursdefinition

Resursformat

Egenskapsvärden

tjänst/diagnostik

DiagnosticContractProperties

PipelineDiagnosticSettings

HttpMessageDiagnostic

BodyDiagnosticSettings

Datamaskering

DataMaskingEntity

SamplingSettings

Snabbstartsmallar

Resursdefinition för ARM-mall

Resursformat

Egenskapsvärden

tjänst/diagnostik

DiagnosticContractProperties

PipelineDiagnosticSettings

HttpMessageDiagnostic

BodyDiagnosticSettings

Datamaskering

DataMaskingEntity

SamplingSettings

Snabbstartsmallar

Resursdefinition för Terraform (AzAPI-provider)

Resursformat

Egenskapsvärden

tjänst/diagnostik

DiagnosticContractProperties

PipelineDiagnosticSettings

HttpMessageDiagnostic

BodyDiagnosticSettings

Datamaskering

DataMaskingEntity

SamplingSettings

Feedback

Ytterligare resurser