你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Log Profiles - Create Or Update

在 Azure 监视 REST API 中创建或更新日志配置文件。

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

目标订阅的 ID。

api-version
query True

string

要用于此操作的 API 版本。

请求正文

名称 必需 类型 说明
location True

string

资源位置

properties.categories True

string[]

日志的类别。 创建这些类别是方便用户使用的。 某些值为:“Write”、“Delete”和/或“Action”。

properties.locations True

string[]

应存储或流式传输活动日志事件的区域列表。 它是有效 ARM 位置(包括“全局”位置)的逗号分隔列表。

properties.retentionPolicy True

RetentionPolicy

日志中事件的保留策略。

properties.serviceBusRuleId

string

要在其中创建事件中心以流式传输活动日志的服务总线命名空间的服务总线规则 ID。 规则 ID 的格式为:“{服务总线资源 ID}/authorizationrules/{key name}”。

properties.storageAccountId

string

要向其发送活动日志的存储帐户的资源 ID。

tags

object

资源标记

响应

名称 类型 说明
200 OK

LogProfileResource

成功请求创建或更新日志配置文件

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: 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": "",
  "tags": {},
  "properties": {
    "locations": [
      "global"
    ],
    "categories": [
      "Write",
      "Delete",
      "Action"
    ],
    "retentionPolicy": {
      "enabled": true,
      "days": 3
    },
    "storageAccountId": "/subscriptions/df602c9c-7aa0-407d-a6fb-eb20c8bd1192/resourceGroups/JohnKemTest/providers/Microsoft.Storage/storageAccounts/johnkemtest8162",
    "serviceBusRuleId": ""
  }
}

示例响应

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

定义

名称 说明
LogProfileResource

日志配置文件资源。

RetentionPolicy

指定日志的保留策略。

LogProfileResource

日志配置文件资源。

名称 类型 说明
id

string

Azure 资源 ID

location

string

资源位置

name

string

Azure 资源名称

properties.categories

string[]

日志的类别。 创建这些类别是方便用户使用的。 某些值为:“Write”、“Delete”和/或“Action”。

properties.locations

string[]

应存储或流式传输活动日志事件的区域列表。 它是有效 ARM 位置(包括“全局”位置)的逗号分隔列表。

properties.retentionPolicy

RetentionPolicy

日志中事件的保留策略。

properties.serviceBusRuleId

string

要在其中创建事件中心以流式传输活动日志的服务总线命名空间的服务总线规则 ID。 规则 ID 的格式为:“{服务总线资源 ID}/authorizationrules/{key name}”。

properties.storageAccountId

string

要向其发送活动日志的存储帐户的资源 ID。

tags

object

资源标记

type

string

Azure 资源类型

RetentionPolicy

指定日志的保留策略。

名称 类型 说明
days

integer

保留天数(以天为单位)。 值为 0 将无限期保留事件。

enabled

boolean

指示是否启用保留策略的值。