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

• neueste
• 2024-06-01-Preview-
• 2024-05-01
• 2023-09-01-Preview-
• 2023-05-01-Preview-
• 2023-03-01-Preview-
• 2022-09-01-Preview-
• 2022-08-01
• 2022-04-01-Vorschau-
• 2021-12-01-Preview-
• 2021-08-01
• 2021-04-01-preview
• 2021-01-01-Preview-
• 2020-12-01
• 2020-06-01-Preview-
• 2019-12-01
• 2019-12-01-Preview-
• 2019-01-01
• 2018-06-01-Preview-
• 2018-01-01
• 2017-03-01

Bicep-Ressourcendefinition

Der Ressourcentyp "service/apis/diagnostics" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

• Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.ApiManagement/service/apis/diagnostics-Ressource zu erstellen, fügen Sie Der Vorlage den folgenden Bicep hinzu.

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

Eigenschaftswerte

BodyDiagnosticSettings

Name	Beschreibung	Wert
Bytes	Anzahl der zu protokollierenden Anforderungstextbytes.	Int Zwänge: Maximalwert = 8192

DataMasking

Name	Beschreibung	Wert
Header	Maskieren von Einstellungen für Kopfzeilen	DataMaskingEntity-[]
queryParams	Maskierungseinstellungen für URL-Abfrageparameter	DataMaskingEntity-[]

DataMaskingEntity

Name	Beschreibung	Wert
Modus	Datenformatierungsmodus.	"Ausblenden" "Maske"
Wert	Der Name einer zu maskierenden Entität (z. B. ein Name eines Headers oder eines Abfrageparameters).	Schnur

DiagnosticContractProperties

Name	Beschreibung	Wert
alwaysLog	Gibt an, welche Art von Nachrichten-Samplingeinstellungen nicht angewendet werden sollen.	"allErrors"
Back-End	Diagnoseeinstellungen für eingehende/ausgehende HTTP-Nachrichten im Back-End	PipelineDiagnosticSettings
Frontend	Diagnoseeinstellungen für eingehende/ausgehende HTTP-Nachrichten an das Gateway.	PipelineDiagnosticSettings
httpCorrelationProtocol	Legt das Korrelationsprotokoll fest, das für die Application Insights-Diagnose verwendet werden soll.	'Legacy' 'None' "W3C"
largeLanguageModel	Diagnoseeinstellungen für große Sprachmodelle	LLMDiagnosticSettings
logClientIp	Protokollieren Sie clientIP. Der Standardwert ist "false".	Bool
loggerId	Ressourcen-ID eines Zielprotokollierers.	Zeichenfolge (erforderlich)
Metrik	Geben Sie benutzerdefinierte Metriken über die Emit-metrische Richtlinie aus. Gilt nur für Die Diagnoseeinstellungen von Application Insights.	Bool
operationNameFormat	Das Format des Vorgangsnamens für Application Insights-Telemetriedaten. Der Standardwert ist Name.	'Name' 'URL'
Probenahme	Samplingeinstellungen für Diagnose.	SamplingSettings
Wortfülle	Die Ausführlichkeitsebene, die auf Ablaufverfolgungen angewendet wird, die von Ablaufverfolgungsrichtlinien ausgegeben werden.	'error' "Informationen" "ausführlich"

HttpMessageDiagnostic

Name	Beschreibung	Wert
Körper	Einstellungen für die Textkörperprotokollierung.	BodyDiagnosticSettings
dataMasking	Datenformatierungseinstellungen.	DataMasking-
Header	Array von HTTP-Headern, die protokolliert werden sollen.	string[]

LLMDiagnosticSettings

Name	Beschreibung	Wert
baumstämme	Gibt an, ob die Standarddiagnose für große Sprachmodelle aktiviert werden soll oder nicht.	"Deaktiviert" "aktiviert"
Aufforderungen	Diagnoseeinstellungen für Anforderungen für große Sprachmodelle.	LLMMessageDiagnosticSettings
Antworten	Diagnoseeinstellungen für Antworten auf große Sprachmodelle.	LLMMessageDiagnosticSettings

LLMMessageDiagnosticSettings

Name	Beschreibung	Wert
maxSizeInBytes	Maximale Nachrichtengröße für Protokolle in Byte. Die Standardgröße beträgt 32 KB.	Int Zwänge: Min.-Wert = 1 Max. Wert = 262144
Meldungen	Gibt an, welche Nachricht protokolliert werden soll. Derzeit gibt es nur die Option "alle".	"alle"

Microsoft.ApiManagement/service/apis/diagnostics

Name	Beschreibung	Wert
Name	Der Ressourcenname	Schnur Zwänge: Min. Länge = 1 Max. Länge = 1 Pattern = ^[^*#&+:<>?]+$ (erforderlich)
Elternteil	In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird. Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.	Symbolischer Name für Ressource vom Typ: Dienst/APIs
Eigenschaften	Eigenschaften des Diagnoseentitätsvertrags.	DiagnosticContractProperties-

PipelineDiagnosticSettings

Name	Beschreibung	Wert
bitten	Diagnoseeinstellungen für die Anforderung.	HttpMessageDiagnostic-
Antwort	Diagnoseeinstellungen für die Antwort.	HttpMessageDiagnostic-

SamplingSettings

Name	Beschreibung	Wert
Prozentsatz	Abtastrate für stichprobenfreie Stichproben.	Int Zwänge: Min.-Wert = 0 Max. Wert = 100
samplingType	Samplingtyp.	"behoben"

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "service/apis/diagnostics" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

• Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.ApiManagement/service/apis/diagnostics-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.

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

Eigenschaftswerte

BodyDiagnosticSettings

Name	Beschreibung	Wert
Bytes	Anzahl der zu protokollierenden Anforderungstextbytes.	Int Zwänge: Maximalwert = 8192

DataMasking

Name	Beschreibung	Wert
Header	Maskieren von Einstellungen für Kopfzeilen	DataMaskingEntity-[]
queryParams	Maskierungseinstellungen für URL-Abfrageparameter	DataMaskingEntity-[]

DataMaskingEntity

Name	Beschreibung	Wert
Modus	Datenformatierungsmodus.	"Ausblenden" "Maske"
Wert	Der Name einer zu maskierenden Entität (z. B. ein Name eines Headers oder eines Abfrageparameters).	Schnur

DiagnosticContractProperties

Name	Beschreibung	Wert
alwaysLog	Gibt an, welche Art von Nachrichten-Samplingeinstellungen nicht angewendet werden sollen.	"allErrors"
Back-End	Diagnoseeinstellungen für eingehende/ausgehende HTTP-Nachrichten im Back-End	PipelineDiagnosticSettings
Frontend	Diagnoseeinstellungen für eingehende/ausgehende HTTP-Nachrichten an das Gateway.	PipelineDiagnosticSettings
httpCorrelationProtocol	Legt das Korrelationsprotokoll fest, das für die Application Insights-Diagnose verwendet werden soll.	'Legacy' 'None' "W3C"
largeLanguageModel	Diagnoseeinstellungen für große Sprachmodelle	LLMDiagnosticSettings
logClientIp	Protokollieren Sie clientIP. Der Standardwert ist "false".	Bool
loggerId	Ressourcen-ID eines Zielprotokollierers.	Zeichenfolge (erforderlich)
Metrik	Geben Sie benutzerdefinierte Metriken über die Emit-metrische Richtlinie aus. Gilt nur für Die Diagnoseeinstellungen von Application Insights.	Bool
operationNameFormat	Das Format des Vorgangsnamens für Application Insights-Telemetriedaten. Der Standardwert ist Name.	'Name' 'URL'
Probenahme	Samplingeinstellungen für Diagnose.	SamplingSettings
Wortfülle	Die Ausführlichkeitsebene, die auf Ablaufverfolgungen angewendet wird, die von Ablaufverfolgungsrichtlinien ausgegeben werden.	'error' "Informationen" "ausführlich"

HttpMessageDiagnostic

Name	Beschreibung	Wert
Körper	Einstellungen für die Textkörperprotokollierung.	BodyDiagnosticSettings
dataMasking	Datenformatierungseinstellungen.	DataMasking-
Header	Array von HTTP-Headern, die protokolliert werden sollen.	string[]

LLMDiagnosticSettings

Name	Beschreibung	Wert
baumstämme	Gibt an, ob die Standarddiagnose für große Sprachmodelle aktiviert werden soll oder nicht.	"Deaktiviert" "aktiviert"
Aufforderungen	Diagnoseeinstellungen für Anforderungen für große Sprachmodelle.	LLMMessageDiagnosticSettings
Antworten	Diagnoseeinstellungen für Antworten auf große Sprachmodelle.	LLMMessageDiagnosticSettings

LLMMessageDiagnosticSettings

Name	Beschreibung	Wert
maxSizeInBytes	Maximale Nachrichtengröße für Protokolle in Byte. Die Standardgröße beträgt 32 KB.	Int Zwänge: Min.-Wert = 1 Max. Wert = 262144
Meldungen	Gibt an, welche Nachricht protokolliert werden soll. Derzeit gibt es nur die Option "alle".	"alle"

Microsoft.ApiManagement/service/apis/diagnostics

Name	Beschreibung	Wert
apiVersion	Die API-Version	"2024-06-01-preview"
Name	Der Ressourcenname	Schnur Zwänge: Min. Länge = 1 Max. Länge = 1 Pattern = ^[^*#&+:<>?]+$ (erforderlich)
Eigenschaften	Eigenschaften des Diagnoseentitätsvertrags.	DiagnosticContractProperties-
Art	Der Ressourcentyp	"Microsoft.ApiManagement/service/apis/diagnostics"

PipelineDiagnosticSettings

Name	Beschreibung	Wert
bitten	Diagnoseeinstellungen für die Anforderung.	HttpMessageDiagnostic-
Antwort	Diagnoseeinstellungen für die Antwort.	HttpMessageDiagnostic-

SamplingSettings

Name	Beschreibung	Wert
Prozentsatz	Abtastrate für stichprobenfreie Stichproben.	Int Zwänge: Min.-Wert = 0 Max. Wert = 100
samplingType	Samplingtyp.	"behoben"

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "service/apis/diagnostics" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

• Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.ApiManagement/service/apis/diagnostics-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

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

Eigenschaftswerte

BodyDiagnosticSettings

Name	Beschreibung	Wert
Bytes	Anzahl der zu protokollierenden Anforderungstextbytes.	Int Zwänge: Maximalwert = 8192

DataMasking

Name	Beschreibung	Wert
Header	Maskieren von Einstellungen für Kopfzeilen	DataMaskingEntity-[]
queryParams	Maskierungseinstellungen für URL-Abfrageparameter	DataMaskingEntity-[]

DataMaskingEntity

Name	Beschreibung	Wert
Modus	Datenformatierungsmodus.	"Ausblenden" "Maske"
Wert	Der Name einer zu maskierenden Entität (z. B. ein Name eines Headers oder eines Abfrageparameters).	Schnur

DiagnosticContractProperties

Name	Beschreibung	Wert
alwaysLog	Gibt an, welche Art von Nachrichten-Samplingeinstellungen nicht angewendet werden sollen.	"allErrors"
Back-End	Diagnoseeinstellungen für eingehende/ausgehende HTTP-Nachrichten im Back-End	PipelineDiagnosticSettings
Frontend	Diagnoseeinstellungen für eingehende/ausgehende HTTP-Nachrichten an das Gateway.	PipelineDiagnosticSettings
httpCorrelationProtocol	Legt das Korrelationsprotokoll fest, das für die Application Insights-Diagnose verwendet werden soll.	'Legacy' 'None' "W3C"
largeLanguageModel	Diagnoseeinstellungen für große Sprachmodelle	LLMDiagnosticSettings
logClientIp	Protokollieren Sie clientIP. Der Standardwert ist "false".	Bool
loggerId	Ressourcen-ID eines Zielprotokollierers.	Zeichenfolge (erforderlich)
Metrik	Geben Sie benutzerdefinierte Metriken über die Emit-metrische Richtlinie aus. Gilt nur für Die Diagnoseeinstellungen von Application Insights.	Bool
operationNameFormat	Das Format des Vorgangsnamens für Application Insights-Telemetriedaten. Der Standardwert ist Name.	'Name' 'URL'
Probenahme	Samplingeinstellungen für Diagnose.	SamplingSettings
Wortfülle	Die Ausführlichkeitsebene, die auf Ablaufverfolgungen angewendet wird, die von Ablaufverfolgungsrichtlinien ausgegeben werden.	'error' "Informationen" "ausführlich"

HttpMessageDiagnostic

Name	Beschreibung	Wert
Körper	Einstellungen für die Textkörperprotokollierung.	BodyDiagnosticSettings
dataMasking	Datenformatierungseinstellungen.	DataMasking-
Header	Array von HTTP-Headern, die protokolliert werden sollen.	string[]

LLMDiagnosticSettings

Name	Beschreibung	Wert
baumstämme	Gibt an, ob die Standarddiagnose für große Sprachmodelle aktiviert werden soll oder nicht.	"Deaktiviert" "aktiviert"
Aufforderungen	Diagnoseeinstellungen für Anforderungen für große Sprachmodelle.	LLMMessageDiagnosticSettings
Antworten	Diagnoseeinstellungen für Antworten auf große Sprachmodelle.	LLMMessageDiagnosticSettings

LLMMessageDiagnosticSettings

Name	Beschreibung	Wert
maxSizeInBytes	Maximale Nachrichtengröße für Protokolle in Byte. Die Standardgröße beträgt 32 KB.	Int Zwänge: Min.-Wert = 1 Max. Wert = 262144
Meldungen	Gibt an, welche Nachricht protokolliert werden soll. Derzeit gibt es nur die Option "alle".	"alle"

Microsoft.ApiManagement/service/apis/diagnostics

Name	Beschreibung	Wert
Name	Der Ressourcenname	Schnur Zwänge: Min. Länge = 1 Max. Länge = 1 Pattern = ^[^*#&+:<>?]+$ (erforderlich)
parent_id	Die ID der Ressource, die das übergeordnete Element für diese Ressource ist.	ID für Ressource des Typs: Dienst/APIs
Eigenschaften	Eigenschaften des Diagnoseentitätsvertrags.	DiagnosticContractProperties-
Art	Der Ressourcentyp	"Microsoft.ApiManagement/service/apis/diagnostics@2024-06-01-preview"

PipelineDiagnosticSettings

Name	Beschreibung	Wert
bitten	Diagnoseeinstellungen für die Anforderung.	HttpMessageDiagnostic-
Antwort	Diagnoseeinstellungen für die Antwort.	HttpMessageDiagnostic-

SamplingSettings

Name	Beschreibung	Wert
Prozentsatz	Abtastrate für stichprobenfreie Stichproben.	Int Zwänge: Min.-Wert = 0 Max. Wert = 100
samplingType	Samplingtyp.	"behoben"