Служба Microsoft.ApiManagement/diagnostics 2019-01-01

Статья
12/20/2024

Определение ресурсов Bicep

Тип ресурса службы или диагностики можно развернуть с помощью операций, предназначенных для следующих операций:

группы ресурсов . См. команды развертывания группы ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.ApiManagement/service/diagnostics, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.ApiManagement/service/diagnostics@2019-01-01' = {
  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'
        ]
      }
    }
    httpCorrelationProtocol: 'string'
    loggerId: 'string'
    sampling: {
      percentage: int
      samplingType: 'string'
    }
    verbosity: 'string'
  }
}

Значения свойств

BodyDiagnosticSettings

Имя	Описание	Ценность
Байт	Количество байтов текста запроса для журнала.	int Ограничения целостности: Максимальное значение = 8192

DiagnosticContractProperties

Имя	Описание	Ценность
alwaysLog	Указывает, какой тип параметров выборки сообщений не должен применяться.	'allErrors'
серверная часть	Параметры диагностики для входящих и исходящих HTTP-сообщений в серверную часть	PipelineDiagnosticSettings
enableHttpCorrelationHeaders	Следует ли обрабатывать заголовки корреляции, поступающие в службу управления API. Применимо только к диагностике Application Insights. Значение по умолчанию — true.	bool
интерфейсный интерфейс	Параметры диагностики для входящих и исходящих HTTP-сообщений в шлюз.	PipelineDiagnosticSettings
httpCorrelationProtocol	Задает протокол корреляции, используемый для диагностики Application Insights.	"Устаревшая версия" "Нет" "W3C"
loggerId	Идентификатор ресурса целевого средства ведения журнала.	строка (обязательно)
выборка	Параметры выборки для диагностики.	выборкиSettings
многословие	Уровень детализации, применяемый к трассировкам, создаваемым политиками трассировки.	"error" "информация" "подробный"

HttpMessageDiagnostic

Имя	Описание	Ценность
тело	Параметры ведения журнала тела.	BodyDiagnosticSettings
Заголовки	Массив заголовков HTTP в журнал.	string[]

Microsoft.ApiManagement/service/diagnostics

Имя	Описание	Ценность
имя	Имя ресурса	струна Ограничения целостности: Минимальная длина = 1 Максимальная длина = 80 Pattern = `^[^*#&+:<>?]+$` (обязательно)
родитель	В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса. Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса.	Символьное имя ресурса типа: служба
свойства	Свойства контракта сущности диагностики.	DiagnosticContractProperties

PipelineDiagnosticSettings

Имя	Описание	Ценность
просьба	Параметры диагностики для запроса.	HttpMessageDiagnostic
ответ	Параметры диагностики для ответа.	HttpMessageDiagnostic

ВыборкаSettings

Имя	Описание	Ценность
процент	Частота выборки для выборки фиксированной частоты.	int Ограничения целостности: Минимальное значение = 0 Максимальное значение = 100
выборкаType	Тип выборки.	"исправлено"

Примеры краткого руководства

Следующие примеры краткого руководства по развертыванию этого типа ресурса.

Bicep-файл	Описание
Шлюз приложений с внутренним управлением API и веб-приложения	Шлюз приложений маршрутизации трафика Интернета в экземпляр управления API виртуальной сети (внутренний режим), который обслуживает веб-API, размещенный в веб-приложении Azure.
создание управления API в внутренней виртуальной сети с шлюза приложений	В этом шаблоне показано, как создать экземпляр службы "Управление API Azure" в частной сети, защищенной шлюзом приложений Azure.

Определение ресурса шаблона ARM

группы ресурсов . См. команды развертывания группы ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.ApiManagement/service/diagnostics, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.ApiManagement/service/diagnostics",
  "apiVersion": "2019-01-01",
  "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" ]
      }
    },
    "httpCorrelationProtocol": "string",
    "loggerId": "string",
    "sampling": {
      "percentage": "int",
      "samplingType": "string"
    },
    "verbosity": "string"
  }
}

Значения свойств

BodyDiagnosticSettings

Имя	Описание	Ценность
Байт	Количество байтов текста запроса для журнала.	int Ограничения целостности: Максимальное значение = 8192

DiagnosticContractProperties

Имя	Описание	Ценность
alwaysLog	Указывает, какой тип параметров выборки сообщений не должен применяться.	'allErrors'
серверная часть	Параметры диагностики для входящих и исходящих HTTP-сообщений в серверную часть	PipelineDiagnosticSettings
enableHttpCorrelationHeaders	Следует ли обрабатывать заголовки корреляции, поступающие в службу управления API. Применимо только к диагностике Application Insights. Значение по умолчанию — true.	bool
интерфейсный интерфейс	Параметры диагностики для входящих и исходящих HTTP-сообщений в шлюз.	PipelineDiagnosticSettings
httpCorrelationProtocol	Задает протокол корреляции, используемый для диагностики Application Insights.	"Устаревшая версия" "Нет" "W3C"
loggerId	Идентификатор ресурса целевого средства ведения журнала.	строка (обязательно)
выборка	Параметры выборки для диагностики.	выборкиSettings
многословие	Уровень детализации, применяемый к трассировкам, создаваемым политиками трассировки.	"error" "информация" "подробный"

HttpMessageDiagnostic

Имя	Описание	Ценность
тело	Параметры ведения журнала тела.	BodyDiagnosticSettings
Заголовки	Массив заголовков HTTP в журнал.	string[]

Microsoft.ApiManagement/service/diagnostics

Имя	Описание	Ценность
apiVersion	Версия API	'2019-01-01'
имя	Имя ресурса	струна Ограничения целостности: Минимальная длина = 1 Максимальная длина = 80 Pattern = `^[^*#&+:<>?]+$` (обязательно)
свойства	Свойства контракта сущности диагностики.	DiagnosticContractProperties
тип	Тип ресурса	"Microsoft.ApiManagement/service/diagnostics"

PipelineDiagnosticSettings

Имя	Описание	Ценность
просьба	Параметры диагностики для запроса.	HttpMessageDiagnostic
ответ	Параметры диагностики для ответа.	HttpMessageDiagnostic

ВыборкаSettings

Имя	Описание	Ценность
процент	Частота выборки для выборки фиксированной частоты.	int Ограничения целостности: Минимальное значение = 0 Максимальное значение = 100
выборкаType	Тип выборки.	"исправлено"

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон	Описание
Шлюз приложений с внутренним управлением API и веб-приложения развертывание	Шлюз приложений маршрутизации трафика Интернета в экземпляр управления API виртуальной сети (внутренний режим), который обслуживает веб-API, размещенный в веб-приложении Azure.
создание управления API в внутренней виртуальной сети с шлюза приложений развертывание	В этом шаблоне показано, как создать экземпляр службы "Управление API Azure" в частной сети, защищенной шлюзом приложений Azure.

Определение ресурса Terraform (поставщик AzAPI)

групп ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.ApiManagement/service/diagnostics, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/diagnostics@2019-01-01"
  name = "string"
  body = jsonencode({
    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"
          ]
        }
      }
      httpCorrelationProtocol = "string"
      loggerId = "string"
      sampling = {
        percentage = int
        samplingType = "string"
      }
      verbosity = "string"
    }
  })
}

Значения свойств

BodyDiagnosticSettings

Имя	Описание	Ценность
Байт	Количество байтов текста запроса для журнала.	int Ограничения целостности: Максимальное значение = 8192

DiagnosticContractProperties

Имя	Описание	Ценность
alwaysLog	Указывает, какой тип параметров выборки сообщений не должен применяться.	'allErrors'
серверная часть	Параметры диагностики для входящих и исходящих HTTP-сообщений в серверную часть	PipelineDiagnosticSettings
enableHttpCorrelationHeaders	Следует ли обрабатывать заголовки корреляции, поступающие в службу управления API. Применимо только к диагностике Application Insights. Значение по умолчанию — true.	bool
интерфейсный интерфейс	Параметры диагностики для входящих и исходящих HTTP-сообщений в шлюз.	PipelineDiagnosticSettings
httpCorrelationProtocol	Задает протокол корреляции, используемый для диагностики Application Insights.	"Устаревшая версия" "Нет" "W3C"
loggerId	Идентификатор ресурса целевого средства ведения журнала.	строка (обязательно)
выборка	Параметры выборки для диагностики.	выборкиSettings
многословие	Уровень детализации, применяемый к трассировкам, создаваемым политиками трассировки.	"error" "информация" "подробный"

HttpMessageDiagnostic

Имя	Описание	Ценность
тело	Параметры ведения журнала тела.	BodyDiagnosticSettings
Заголовки	Массив заголовков HTTP в журнал.	string[]

Microsoft.ApiManagement/service/diagnostics

Имя	Описание	Ценность
имя	Имя ресурса	струна Ограничения целостности: Минимальная длина = 1 Максимальная длина = 80 Pattern = `^[^*#&+:<>?]+$` (обязательно)
parent_id	Идентификатор ресурса, который является родительским для этого ресурса.	Идентификатор ресурса типа: службы
свойства	Свойства контракта сущности диагностики.	DiagnosticContractProperties
тип	Тип ресурса	"Microsoft.ApiManagement/service/diagnostics@2019-01-01"

PipelineDiagnosticSettings

Имя	Описание	Ценность
просьба	Параметры диагностики для запроса.	HttpMessageDiagnostic
ответ	Параметры диагностики для ответа.	HttpMessageDiagnostic

ВыборкаSettings

Имя	Описание	Ценность
процент	Частота выборки для выборки фиксированной частоты.	int Ограничения целостности: Минимальное значение = 0 Максимальное значение = 100
выборкаType	Тип выборки.	"исправлено"

Поделиться через

Служба Microsoft.ApiManagement/diagnostics 2019-01-01

Определение ресурсов Bicep

Формат ресурса

Значения свойств

BodyDiagnosticSettings

DiagnosticContractProperties

HttpMessageDiagnostic

Microsoft.ApiManagement/service/diagnostics

PipelineDiagnosticSettings

ВыборкаSettings

Примеры краткого руководства

Определение ресурса шаблона ARM

Формат ресурса

Значения свойств

BodyDiagnosticSettings

DiagnosticContractProperties

HttpMessageDiagnostic

Microsoft.ApiManagement/service/diagnostics

PipelineDiagnosticSettings

ВыборкаSettings

Шаблоны быстрого запуска

Определение ресурса Terraform (поставщик AzAPI)

Формат ресурса

Значения свойств

BodyDiagnosticSettings

DiagnosticContractProperties

HttpMessageDiagnostic

Microsoft.ApiManagement/service/diagnostics

PipelineDiagnosticSettings

ВыборкаSettings

Обратная связь

Дополнительные ресурсы