Microsoft.ApiManagement hizmeti/tanılama 2023-09-01-preview

Bicep kaynak tanımı

Hizmet/tanılama kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.ApiManagement/service/diagnostics kaynağı oluşturmak için şablonunuza aşağıdaki Bicep'i ekleyin.

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

Özellik değerleri

hizmet/tanılama

Ad Açıklama Değer
ad Kaynak adı

Bicep'nde alt kaynaklar için adları ve türleri ayarlamayı öğrenin.
dize (gerekli)

Karakter sınırı: 1-80

Geçerli karakterler:
Alfasayısallar ve kısa çizgiler.

Harfle başlayın ve alfasayısal ile bitirin.
ebeveyn Bicep'te bir alt kaynak için üst kaynak belirtebilirsiniz. Bu özelliği yalnızca alt kaynak üst kaynağın dışında bildirildiğinde eklemeniz gerekir.

Daha fazla bilgi için bkz. Alt kaynaküst kaynak dışında.
Kaynak türü için sembolik ad: hizmet
Özellikler Tanılama varlığı sözleşme özellikleri. DiagnosticContractProperties

DiagnosticContractProperties

Ad Açıklama Değer
alwaysLog Ne tür ileti örnekleme ayarlarının uygulanmaması gerektiğini belirtir. 'allErrors'
arka uç Arka uçtan gelen/giden HTTP iletileri için tanılama ayarları pipelinediagnosticSettings
ön uç Ağ geçidine gelen/giden HTTP iletileri için tanılama ayarları. pipelinediagnosticSettings
httpCorrelationProtocol Application Insights tanılaması için kullanılacak bağıntı protokollerini ayarlar. 'Eski'
'Hiçbiri'
'W3C'
logClientIp ClientIP'yi günlüğe kaydetme. Varsayılan değer false'tur. Bool
loggerId Hedef günlükçü kaynak kimliği. dize (gerekli)
Ölçüm Yayma ölçümü ilkesi aracılığıyla özel ölçümler yayma. Yalnızca Application Insights tanılama ayarları için geçerlidir. Bool
operationNameFormat Application Insights telemetrileri için İşlem Adı biçimi. Varsayılan Ad'dır. 'Ad'
'Url'
Örnekleme Tanılama için örnekleme ayarları. SamplingSettings
Ayrıntı İzleme ilkeleri tarafından yayılan izlemelere uygulanan ayrıntı düzeyi. 'error'
'information'
'ayrıntılı'

PipelineDiagnosticSettings

Ad Açıklama Değer
istek İstek için tanılama ayarları. httpmessagediagnostic
yanıt Yanıt için tanılama ayarları. httpmessagediagnostic

HttpMessageDiagnostic

Ad Açıklama Değer
beden Gövde günlüğü ayarları. BodyDiagnosticSettings
dataMasking Veri maskeleme ayarları. DataMasking
Üstbilgi Günlüğe kaydedilecek HTTP Üst Bilgileri dizisi. string[]

BodyDiagnosticSettings

Ad Açıklama Değer
Bayt Günlüğe kaydedilecek istek gövdesi bayt sayısı. Int

Kısıtlama -ları:
Maksimum değer = 8192

DataMasking

Ad Açıklama Değer
Üstbilgi Üst bilgiler için maskeleme ayarları DataMaskingEntity[]
queryParams Url sorgu parametreleri için maskeleme ayarları DataMaskingEntity[]

DataMaskingEntity

Ad Açıklama Değer
mod Veri maskeleme modu. 'Gizle'
'Maske'
değer Maskeleneceği varlığın adı (örneğin, üst bilgi adı veya sorgu parametresi). dizgi

SamplingSettings

Ad Açıklama Değer
Yüzde Sabit oranlı örnekleme için örnekleme oranı. Int

Kısıtlama -ları:
En düşük değer = 0
Maksimum değer = 100
samplingType Örnekleme türü. 'düzeltildi'

Hızlı başlangıç şablonları

Aşağıdaki hızlı başlangıç şablonları bu kaynak türünü dağıtır.

Şablon Açıklama
App Gateway ile İç Sanal Ağda API Management Oluşturma

Azure 'a dağıtma
Bu şablon, Azure Application Gateway tarafından korunan özel bir ağda Azure API Management örneği oluşturma adımlarını gösterir.
İç API Management ve Web App ile Application Gateway

Azure 'a dağıtma
Application Gateway, İnternet trafiğini Azure Web App'te barındırılan bir web API'sine hizmet veren bir sanal ağ (iç mod) API Management örneğine yönlendirir.

ARM şablonu kaynak tanımı

Hizmet/tanılama kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.ApiManagement/service/diagnostics kaynağı oluşturmak için şablonunuza aşağıdaki JSON dosyasını ekleyin.

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

Özellik değerleri

hizmet/tanılama

Ad Açıklama Değer
tür Kaynak türü 'Microsoft.ApiManagement/service/diagnostics'
apiVersion Kaynak API'sinin sürümü '2023-09-01-preview'
ad Kaynak adı

JSON ARM şablonlarında alt kaynakların adlarını ve türlerini ayarlamayı öğrenin.
dize (gerekli)

Karakter sınırı: 1-80

Geçerli karakterler:
Alfasayısallar ve kısa çizgiler.

Harfle başlayın ve alfasayısal ile bitirin.
Özellikler Tanılama varlığı sözleşme özellikleri. DiagnosticContractProperties

DiagnosticContractProperties

Ad Açıklama Değer
alwaysLog Ne tür ileti örnekleme ayarlarının uygulanmaması gerektiğini belirtir. 'allErrors'
arka uç Arka uçtan gelen/giden HTTP iletileri için tanılama ayarları pipelinediagnosticSettings
ön uç Ağ geçidine gelen/giden HTTP iletileri için tanılama ayarları. pipelinediagnosticSettings
httpCorrelationProtocol Application Insights tanılaması için kullanılacak bağıntı protokollerini ayarlar. 'Eski'
'Hiçbiri'
'W3C'
logClientIp ClientIP'yi günlüğe kaydetme. Varsayılan değer false'tur. Bool
loggerId Hedef günlükçü kaynak kimliği. dize (gerekli)
Ölçüm Yayma ölçümü ilkesi aracılığıyla özel ölçümler yayma. Yalnızca Application Insights tanılama ayarları için geçerlidir. Bool
operationNameFormat Application Insights telemetrileri için İşlem Adı biçimi. Varsayılan Ad'dır. 'Ad'
'Url'
Örnekleme Tanılama için örnekleme ayarları. SamplingSettings
Ayrıntı İzleme ilkeleri tarafından yayılan izlemelere uygulanan ayrıntı düzeyi. 'error'
'information'
'ayrıntılı'

PipelineDiagnosticSettings

Ad Açıklama Değer
istek İstek için tanılama ayarları. httpmessagediagnostic
yanıt Yanıt için tanılama ayarları. httpmessagediagnostic

HttpMessageDiagnostic

Ad Açıklama Değer
beden Gövde günlüğü ayarları. BodyDiagnosticSettings
dataMasking Veri maskeleme ayarları. DataMasking
Üstbilgi Günlüğe kaydedilecek HTTP Üst Bilgileri dizisi. string[]

BodyDiagnosticSettings

Ad Açıklama Değer
Bayt Günlüğe kaydedilecek istek gövdesi bayt sayısı. Int

Kısıtlama -ları:
Maksimum değer = 8192

DataMasking

Ad Açıklama Değer
Üstbilgi Üst bilgiler için maskeleme ayarları DataMaskingEntity[]
queryParams Url sorgu parametreleri için maskeleme ayarları DataMaskingEntity[]

DataMaskingEntity

Ad Açıklama Değer
mod Veri maskeleme modu. 'Gizle'
'Maske'
değer Maskeleneceği varlığın adı (örneğin, üst bilgi adı veya sorgu parametresi). dizgi

SamplingSettings

Ad Açıklama Değer
Yüzde Sabit oranlı örnekleme için örnekleme oranı. Int

Kısıtlama -ları:
En düşük değer = 0
Maksimum değer = 100
samplingType Örnekleme türü. 'düzeltildi'

Hızlı başlangıç şablonları

Aşağıdaki hızlı başlangıç şablonları bu kaynak türünü dağıtır.

Şablon Açıklama
App Gateway ile İç Sanal Ağda API Management Oluşturma

Azure 'a dağıtma
Bu şablon, Azure Application Gateway tarafından korunan özel bir ağda Azure API Management örneği oluşturma adımlarını gösterir.
İç API Management ve Web App ile Application Gateway

Azure 'a dağıtma
Application Gateway, İnternet trafiğini Azure Web App'te barındırılan bir web API'sine hizmet veren bir sanal ağ (iç mod) API Management örneğine yönlendirir.

Terraform (AzAPI sağlayıcısı) kaynak tanımı

Hizmet/tanılama kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • Kaynak grupları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.ApiManagement/service/diagnostics kaynağı oluşturmak için şablonunuza aşağıdaki Terraform'u ekleyin.

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

Özellik değerleri

hizmet/tanılama

Ad Açıklama Değer
tür Kaynak türü "Microsoft.ApiManagement/service/diagnostics@2023-09-01-preview"
ad Kaynak adı dize (gerekli)

Karakter sınırı: 1-80

Geçerli karakterler:
Alfasayısallar ve kısa çizgiler.

Harfle başlayın ve alfasayısal ile bitirin.
parent_id Bu kaynağın üst öğesi olan kaynağın kimliği. Kaynak türü için kimlik: hizmet
Özellikler Tanılama varlığı sözleşme özellikleri. DiagnosticContractProperties

DiagnosticContractProperties

Ad Açıklama Değer
alwaysLog Ne tür ileti örnekleme ayarlarının uygulanmaması gerektiğini belirtir. "allErrors"
arka uç Arka uçtan gelen/giden HTTP iletileri için tanılama ayarları pipelinediagnosticSettings
ön uç Ağ geçidine gelen/giden HTTP iletileri için tanılama ayarları. pipelinediagnosticSettings
httpCorrelationProtocol Application Insights tanılaması için kullanılacak bağıntı protokollerini ayarlar. "Eski"
"Yok"
"W3C"
logClientIp ClientIP'yi günlüğe kaydetme. Varsayılan değer false'tur. Bool
loggerId Hedef günlükçü kaynak kimliği. dize (gerekli)
Ölçüm Yayma ölçümü ilkesi aracılığıyla özel ölçümler yayma. Yalnızca Application Insights tanılama ayarları için geçerlidir. Bool
operationNameFormat Application Insights telemetrileri için İşlem Adı biçimi. Varsayılan Ad'dır. "Ad"
"Url"
Örnekleme Tanılama için örnekleme ayarları. SamplingSettings
Ayrıntı İzleme ilkeleri tarafından yayılan izlemelere uygulanan ayrıntı düzeyi. "error"
"bilgi"
"ayrıntılı"

PipelineDiagnosticSettings

Ad Açıklama Değer
istek İstek için tanılama ayarları. httpmessagediagnostic
yanıt Yanıt için tanılama ayarları. httpmessagediagnostic

HttpMessageDiagnostic

Ad Açıklama Değer
beden Gövde günlüğü ayarları. BodyDiagnosticSettings
dataMasking Veri maskeleme ayarları. DataMasking
Üstbilgi Günlüğe kaydedilecek HTTP Üst Bilgileri dizisi. string[]

BodyDiagnosticSettings

Ad Açıklama Değer
Bayt Günlüğe kaydedilecek istek gövdesi bayt sayısı. Int

Kısıtlama -ları:
Maksimum değer = 8192

DataMasking

Ad Açıklama Değer
Üstbilgi Üst bilgiler için maskeleme ayarları DataMaskingEntity[]
queryParams Url sorgu parametreleri için maskeleme ayarları DataMaskingEntity[]

DataMaskingEntity

Ad Açıklama Değer
mod Veri maskeleme modu. "Gizle"
"Maske"
değer Maskeleneceği varlığın adı (örneğin, üst bilgi adı veya sorgu parametresi). dizgi

SamplingSettings

Ad Açıklama Değer
Yüzde Sabit oranlı örnekleme için örnekleme oranı. Int

Kısıtlama -ları:
En düşük değer = 0
Maksimum değer = 100
samplingType Örnekleme türü. "düzeltildi"