Partager via

Service Microsoft.ApiManagement/apis/diagnostics 2018-06-01-preview

Définition de ressource Bicep

Le type de ressource service/apis/diagnostics peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez le journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.ApiManagement/service/apis/diagnostics, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.ApiManagement/service/apis/diagnostics@2018-06-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    alwaysLog: 'string'
    backend: {
      request: {
        body: {
          bytes: int
        }
        headers: [
          'string'
        ]
      }
      response: {
        body: {
          bytes: int
        }
        headers: [
          'string'
        ]
      }
    }
    enableHttpCorrelationHeaders: bool
    frontend: {
      request: {
        body: {
          bytes: int
        }
        headers: [
          'string'
        ]
      }
      response: {
        body: {
          bytes: int
        }
        headers: [
          'string'
        ]
      }
    }
    loggerId: 'string'
    sampling: {
      percentage: int
      samplingType: 'string'
    }
  }
}

Valeurs de la propriété

Microsoft.ApiManagement/service/apis/diagnostics

Nom Descriptif Valeur
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 80
Modèle = ^[^*#&+:<>?]+$ (obligatoire)
parent Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez Ressource enfant en dehors de la ressource parente.		 Nom symbolique de la ressource de type : service/apis
Propriétés Propriétés du contrat d’entité de diagnostic. DiagnosticContractProperties

BodyDiagnosticSettings

Nom Descriptif Valeur
Octets Nombre d’octets du corps de la demande à consigner. Int

Contraintes:
Valeur maximale = 8192

DiagnosticContractProperties

Nom Descriptif Valeur
toujoursJournal Spécifie le type de paramètres d’échantillonnage des messages qui ne doivent pas s’appliquer. 'allErrors'
back-end Paramètres de diagnostic pour les messages HTTP entrants/sortants vers le serveur principal PipelineDiagnosticSettings
enableHttpCorrelationHeaders Indique s’il faut traiter les en-têtes de corrélation entrants dans le service Gestion des API. Applicable uniquement aux diagnostics Application Insights. La valeur par défaut est true. Bool
frontend Paramètres de diagnostic pour les messages HTTP entrants/sortants vers la passerelle. PipelineDiagnosticSettings
loggerId ID de ressource d’un enregistreur d’événements cible. chaîne (obligatoire)
échantillonnage Paramètres d’échantillonnage pour diagnostic. EchantillonnageParamètres

HttpMessageDiagnostic

Nom Descriptif Valeur
corps Paramètres de journalisation du corps. BodyDiagnosticSettings
En-têtes Tableau d’en-têtes HTTP à journaliser. chaîne de caractères[]

PipelineDiagnosticSettings

Nom Descriptif Valeur
demander Paramètres de diagnostic pour la demande. HttpMessageDiagnostic
réponse Paramètres de diagnostic pour la réponse. HttpMessageDiagnostic

EchantillonnageParamètres

Nom Descriptif Valeur
pourcentage Taux d’échantillonnage pour l’échantillonnage à taux fixe. Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 100
échantillonType Type d’échantillonnage. 'fixe'

Définition de ressource de modèle ARM

Le type de ressource service/apis/diagnostics peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez le journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.ApiManagement/service/apis/diagnostics, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.ApiManagement/service/apis/diagnostics",
  "apiVersion": "2018-06-01-preview",
  "name": "string",
  "properties": {
    "alwaysLog": "string",
    "backend": {
      "request": {
        "body": {
          "bytes": "int"
        },
        "headers": [ "string" ]
      },
      "response": {
        "body": {
          "bytes": "int"
        },
        "headers": [ "string" ]
      }
    },
    "enableHttpCorrelationHeaders": "bool",
    "frontend": {
      "request": {
        "body": {
          "bytes": "int"
        },
        "headers": [ "string" ]
      },
      "response": {
        "body": {
          "bytes": "int"
        },
        "headers": [ "string" ]
      }
    },
    "loggerId": "string",
    "sampling": {
      "percentage": "int",
      "samplingType": "string"
    }
  }
}

Valeurs de la propriété

Microsoft.ApiManagement/service/apis/diagnostics

Nom Descriptif Valeur
apiVersion Version de l’API '2018-06-01-preview'
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 80
Modèle = ^[^*#&+:<>?]+$ (obligatoire)
Propriétés Propriétés du contrat d’entité de diagnostic. DiagnosticContractProperties
type Type de ressource « Microsoft.ApiManagement/service/apis/diagnostics »

BodyDiagnosticSettings

Nom Descriptif Valeur
Octets Nombre d’octets du corps de la demande à consigner. Int

Contraintes:
Valeur maximale = 8192

DiagnosticContractProperties

Nom Descriptif Valeur
toujoursJournal Spécifie le type de paramètres d’échantillonnage des messages qui ne doivent pas s’appliquer. 'allErrors'
back-end Paramètres de diagnostic pour les messages HTTP entrants/sortants vers le serveur principal PipelineDiagnosticSettings
enableHttpCorrelationHeaders Indique s’il faut traiter les en-têtes de corrélation entrants dans le service Gestion des API. Applicable uniquement aux diagnostics Application Insights. La valeur par défaut est true. Bool
frontend Paramètres de diagnostic pour les messages HTTP entrants/sortants vers la passerelle. PipelineDiagnosticSettings
loggerId ID de ressource d’un enregistreur d’événements cible. chaîne (obligatoire)
échantillonnage Paramètres d’échantillonnage pour diagnostic. EchantillonnageParamètres

HttpMessageDiagnostic

Nom Descriptif Valeur
corps Paramètres de journalisation du corps. BodyDiagnosticSettings
En-têtes Tableau d’en-têtes HTTP à journaliser. chaîne de caractères[]

PipelineDiagnosticSettings

Nom Descriptif Valeur
demander Paramètres de diagnostic pour la demande. HttpMessageDiagnostic
réponse Paramètres de diagnostic pour la réponse. HttpMessageDiagnostic

EchantillonnageParamètres

Nom Descriptif Valeur
pourcentage Taux d’échantillonnage pour l’échantillonnage à taux fixe. Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 100
échantillonType Type d’échantillonnage. 'fixe'

Exemples d’utilisation

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource service/apis/diagnostics peut être déployé avec des opérations qui ciblent :

  • groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez le journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.ApiManagement/service/apis/diagnostics, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/apis/diagnostics@2018-06-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      alwaysLog = "string"
      backend = {
        request = {
          body = {
            bytes = int
          }
          headers = [
            "string"
          ]
        }
        response = {
          body = {
            bytes = int
          }
          headers = [
            "string"
          ]
        }
      }
      enableHttpCorrelationHeaders = bool
      frontend = {
        request = {
          body = {
            bytes = int
          }
          headers = [
            "string"
          ]
        }
        response = {
          body = {
            bytes = int
          }
          headers = [
            "string"
          ]
        }
      }
      loggerId = "string"
      sampling = {
        percentage = int
        samplingType = "string"
      }
    }
  }
}

Valeurs de la propriété

Microsoft.ApiManagement/service/apis/diagnostics

Nom Descriptif Valeur
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 80
Modèle = ^[^*#&+:<>?]+$ (obligatoire)
parent_id ID de la ressource qui est le parent de cette ressource. ID de ressource de type : service/apis
Propriétés Propriétés du contrat d’entité de diagnostic. DiagnosticContractProperties
type Type de ressource « Microsoft.ApiManagement/service/apis/diagnostics@2018-06-01-preview »

BodyDiagnosticSettings

Nom Descriptif Valeur
Octets Nombre d’octets du corps de la demande à consigner. Int

Contraintes:
Valeur maximale = 8192

DiagnosticContractProperties

Nom Descriptif Valeur
toujoursJournal Spécifie le type de paramètres d’échantillonnage des messages qui ne doivent pas s’appliquer. 'allErrors'
back-end Paramètres de diagnostic pour les messages HTTP entrants/sortants vers le serveur principal PipelineDiagnosticSettings
enableHttpCorrelationHeaders Indique s’il faut traiter les en-têtes de corrélation entrants dans le service Gestion des API. Applicable uniquement aux diagnostics Application Insights. La valeur par défaut est true. Bool
frontend Paramètres de diagnostic pour les messages HTTP entrants/sortants vers la passerelle. PipelineDiagnosticSettings
loggerId ID de ressource d’un enregistreur d’événements cible. chaîne (obligatoire)
échantillonnage Paramètres d’échantillonnage pour diagnostic. EchantillonnageParamètres

HttpMessageDiagnostic

Nom Descriptif Valeur
corps Paramètres de journalisation du corps. BodyDiagnosticSettings
En-têtes Tableau d’en-têtes HTTP à journaliser. chaîne de caractères[]

PipelineDiagnosticSettings

Nom Descriptif Valeur
demander Paramètres de diagnostic pour la demande. HttpMessageDiagnostic
réponse Paramètres de diagnostic pour la réponse. HttpMessageDiagnostic

EchantillonnageParamètres

Nom Descriptif Valeur
pourcentage Taux d’échantillonnage pour l’échantillonnage à taux fixe. Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 100
échantillonType Type d’échantillonnage. 'fixe'