Share via


Log Profiles - Create Or Update

Azure Monitoring 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

アクティビティ ログのストリーミング用に Event Hubs を作成するサービス バス名前空間のサービス バス ルール ID。 ルール ID の形式は、'{service bus resource ID}/authorizationrules/{key name}' です。

properties.storageAccountId

string

アクティビティ ログを送信するストレージ アカウントのリソース ID。

tags

object

リソース タグ

応答

名前 説明
200 OK

LogProfileResource

ログ プロファイルを作成または更新するための要求が成功しました

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名前 説明
user_impersonation ユーザー アカウントの借用

Create or update a log profile

Sample Request

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": ""
  }
}

Sample Response

{
  "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

アクティビティ ログのストリーミング用に Event Hubs を作成するサービス バス名前空間のサービス バス ルール ID。 ルール ID の形式は、'{service bus resource ID}/authorizationrules/{key name}' です。

properties.storageAccountId

string

アクティビティ ログを送信するストレージ アカウントのリソース ID。

tags

object

リソース タグ

type

string

Azure リソースタイプ

RetentionPolicy

ログの保持ポリシーを指定します。

名前 説明
days

integer

リテンション期間の日数を日数で指定します。 値が 0 の場合、イベントは無期限に保持されます。

enabled

boolean

アイテム保持ポリシーが有効かどうかを示す値。