Log Profiles - Create Or Update

Создайте или обновите профиль журнала в REST API мониторинга Azure.

PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Insights/logprofiles/{logProfileName}?api-version=2016-03-01

Параметры URI

Имя В Обязательно Тип Описание
logProfileName
path True

string

Имя профиля журнала.

subscriptionId
path True

string (uuid)

Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).

api-version
query True

string

minLength: 1

Версия API, используемая для этой операции.

Текст запроса

Имя Обязательно Тип Описание
location True

string

Географическое расположение, в котором находится ресурс

properties.categories True

string[]

категории журналов. Эти категории создаются так же, как удобно для пользователя. Некоторые значения: "Запись", "Удалить" и /или "Действие".

properties.locations True

string[]

Список регионов, для которых должны храниться или передаваться события журнала действий. Это разделенный запятыми список допустимых расположений ARM, включая глобальное расположение.

properties.retentionPolicy True

Microsoft.Common.RetentionPolicy

политика хранения событий в журнале.

properties.serviceBusRuleId

string

Идентификатор правила служебной шины пространства имен служебной шины, в котором требуется создать центры событий для потоковой передачи журнала действий. Идентификатор правила имеет формат: "{идентификатор ресурса служебной шины}/authorizationrules/{имя ключа}".

properties.storageAccountId

string

Идентификатор ресурса учетной записи хранения, в которую вы хотите отправить журнал действий.

tags

object

Теги ресурсов.

Ответы

Имя Тип Описание
200 OK

LogProfileResource

Операция обновления ресурса 'LogProfileResource' успешно прошла

Other Status Codes

Microsoft.Common.ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

Create or update a log profile

Образец запроса

PUT https://management.azure.com/subscriptions/df602c9c-7aa0-407d-a6fb-eb20c8bd1192/providers/Microsoft.Insights/logprofiles/Rac46PostSwapRG?api-version=2016-03-01

{
  "location": "",
  "properties": {
    "categories": [
      "Write",
      "Delete",
      "Action"
    ],
    "locations": [
      "global"
    ],
    "retentionPolicy": {
      "days": 3,
      "enabled": true
    },
    "serviceBusRuleId": "",
    "storageAccountId": "/subscriptions/df602c9c-7aa0-407d-a6fb-eb20c8bd1192/resourceGroups/JohnKemTest/providers/Microsoft.Storage/storageAccounts/johnkemtest8162"
  },
  "tags": {}
}

Пример ответа

{
  "name": "default",
  "type": "",
  "id": "/subscriptions/df602c9c-7aa0-407d-a6fb-eb20c8bd1192/providers/microsoft.insights/logprofiles/default",
  "location": "",
  "properties": {
    "categories": [
      "Delete",
      "Write",
      "Action"
    ],
    "locations": [
      "global"
    ],
    "retentionPolicy": {
      "days": 3,
      "enabled": true
    },
    "serviceBusRuleId": "",
    "storageAccountId": "/subscriptions/df602c9c-7aa0-407d-a6fb-eb20c8bd1192/resourceGroups/JohnKemTest/providers/Microsoft.Storage/storageAccounts/johnkemtest8162"
  },
  "tags": null
}

Определения

Имя Описание
createdByType

Тип удостоверения, создавшего ресурс.

LogProfileResource

Ресурс профиля журнала.

Microsoft.Common.ErrorResponse

Описывает формат ответа на ошибку.

Microsoft.Common.RetentionPolicy

Указывает политику хранения для журнала.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

createdByType

Тип удостоверения, создавшего ресурс.

Значение Описание
User
Application
ManagedIdentity
Key

LogProfileResource

Ресурс профиля журнала.

Имя Тип Описание
id

string (arm-id)

Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

Географическое расположение, в котором находится ресурс

name

string

Имя ресурса

properties.categories

string[]

категории журналов. Эти категории создаются так же, как удобно для пользователя. Некоторые значения: "Запись", "Удалить" и /или "Действие".

properties.locations

string[]

Список регионов, для которых должны храниться или передаваться события журнала действий. Это разделенный запятыми список допустимых расположений ARM, включая глобальное расположение.

properties.retentionPolicy

Microsoft.Common.RetentionPolicy

политика хранения событий в журнале.

properties.serviceBusRuleId

string

Идентификатор правила служебной шины пространства имен служебной шины, в котором требуется создать центры событий для потоковой передачи журнала действий. Идентификатор правила имеет формат: "{идентификатор ресурса служебной шины}/authorizationrules/{имя ключа}".

properties.storageAccountId

string

Идентификатор ресурса учетной записи хранения, в которую вы хотите отправить журнал действий.

systemData

systemData

Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.

tags

object

Теги ресурсов.

type

string

Тип ресурса. Например, «Microsoft. Compute/virtualMachines» или «Microsoft. Аккаунты хранения/хранения»

Microsoft.Common.ErrorResponse

Описывает формат ответа на ошибку.

Имя Тип Описание
code

string

Код ошибки

message

string

Сообщение об ошибке, указывающее, почему операция завершилась ошибкой.

Microsoft.Common.RetentionPolicy

Указывает политику хранения для журнала.

Имя Тип Описание
days

integer (int32)

minimum: 0

количество дней хранения в днях. Значение 0 будет хранить события на неопределенный срок.

enabled

boolean

значение, указывающее, включена ли политика хранения.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя Тип Описание
createdAt

string (date-time)

Метка времени создания ресурса (UTC).

createdBy

string

Удостоверение, создающее ресурс.

createdByType

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string (date-time)

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.

lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.