次の方法で共有


Defender For Storage - Create

指定したストレージ アカウントの Defender for Storage 設定を作成または更新します。

PUT https://management.azure.com/{resourceId}/providers/Microsoft.Security/defenderForStorageSettings/current?api-version=2022-12-01-preview

URI パラメーター

名前 / 必須 説明
resourceId
path True

string

リソースの識別子。

settingName
path True

settingName

Defender for Storage の設定名。

Regex pattern: ^[a-z][a-z0-9]*$

api-version
query True

string

操作の API バージョン

要求本文

名前 説明
properties.isEnabled

boolean

このストレージ アカウントで Defender for Storage が有効になっているかどうかを示します。

properties.malwareScanning.onUpload.capGBPerMonth

integer

1 か月あたりにスキャンする最大 GB を定義します。 上限が必要ない場合は、-1 に設定します。

properties.malwareScanning.onUpload.isEnabled

boolean

[アップロード時] マルウェア スキャンを有効にするかどうかを示します。

properties.malwareScanning.scanResultsEventGridTopicResourceId

string

省略可能。 スキャン結果を送信する Event Grid トピックのリソース ID。

properties.overrideSubscriptionLevelSettings

boolean

このストレージ アカウントに対して定義されている設定が、サブスクリプションに定義されている設定をオーバーライドする必要があるかどうかを示します。

properties.sensitiveDataDiscovery.isEnabled

boolean

機密データの検出を有効にするかどうかを示します。

応答

名前 説明
200 OK

DefenderForStorageSetting

Defender for Storage 設定を作成または更新するための要求が成功しました。

201 Created

DefenderForStorageSetting

Defender for Storage 設定の作成または更新の要求が部分的に成功しました。

Other Status Codes

CloudError

操作に失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

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

Scopes

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

Creates or updates the Defender for Storage settings on a specified resource.

Sample Request

PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.Storage/storageAccounts/samplestorageaccount/providers/Microsoft.Security/defenderForStorageSettings/current?api-version=2022-12-01-preview

{
  "properties": {
    "isEnabled": true,
    "malwareScanning": {
      "onUpload": {
        "isEnabled": true,
        "capGBPerMonth": -1
      },
      "scanResultsEventGridTopicResourceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.EventGrid/topics/sampletopic"
    },
    "sensitiveDataDiscovery": {
      "isEnabled": true
    },
    "overrideSubscriptionLevelSettings": true
  }
}

Sample Response

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.Storage/storageAccounts/samplestorageaccount/providers/Microsoft.Security/defenderForStorageSettings/current",
  "type": "Microsoft.Security/defenderForStorageSettings",
  "name": "current",
  "properties": {
    "isEnabled": true,
    "malwareScanning": {
      "onUpload": {
        "isEnabled": true,
        "capGBPerMonth": -1
      },
      "scanResultsEventGridTopicResourceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.EventGrid/topics/sampletopic",
      "operationStatus": {
        "code": "Succeeded"
      }
    },
    "sensitiveDataDiscovery": {
      "isEnabled": true,
      "operationStatus": {
        "code": "Succeeded"
      }
    },
    "overrideSubscriptionLevelSettings": true
  }
}
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/SampleRG/providers/Microsoft.Storage/storageAccounts/samplestorageaccount/providers/Microsoft.Security/defenderForStorageSettings/current",
  "type": "Microsoft.Security/defenderForStorageSettings",
  "name": "current",
  "properties": {
    "isEnabled": true,
    "malwareScanning": {
      "onUpload": {
        "isEnabled": false,
        "capGBPerMonth": -1
      },
      "operationStatus": {
        "code": "UnknownError",
        "message": "Failed to setup data scanner."
      }
    },
    "sensitiveDataDiscovery": {
      "isEnabled": false,
      "operationStatus": {
        "code": "UnknownError",
        "message": "Failed to setup data scanner."
      }
    },
    "overrideSubscriptionLevelSettings": true
  }
}

定義

名前 説明
CloudError

失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API に対する一般的なエラー応答 (これは OData エラー応答形式にも従います)。

CloudErrorBody

エラーの詳細。

DefenderForStorageSetting

Defender for Storage リソース。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

OperationStatus

有効化/無効化操作の成功/失敗を示す状態。

settingName

Defender for Storage の設定名。

CloudError

失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API に対する一般的なエラー応答 (これは OData エラー応答形式にも従います)。

名前 説明
error.additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

error.code

string

エラー コード。

error.details

CloudErrorBody[]

エラーの詳細です。

error.message

string

エラー メッセージ。

error.target

string

エラーのターゲット。

CloudErrorBody

エラーの詳細。

名前 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

CloudErrorBody[]

エラーの詳細です。

message

string

エラー メッセージ。

target

string

エラーのターゲット。

DefenderForStorageSetting

Defender for Storage リソース。

名前 説明
id

string

リソース ID

name

string

リソース名

properties.isEnabled

boolean

このストレージ アカウントで Defender for Storage が有効になっているかどうかを示します。

properties.malwareScanning.onUpload.capGBPerMonth

integer

1 か月あたりにスキャンする最大 GB を定義します。 上限が必要ない場合は、-1 に設定します。

properties.malwareScanning.onUpload.isEnabled

boolean

[アップロード時] マルウェア スキャンを有効にするかどうかを示します。

properties.malwareScanning.operationStatus

OperationStatus

失敗した場合、または部分的に成功した場合。 マルウェア スキャンの有効化/無効化操作を説明する追加データ。

properties.malwareScanning.scanResultsEventGridTopicResourceId

string

省略可能。 スキャン結果を送信する Event Grid トピックのリソース ID。

properties.overrideSubscriptionLevelSettings

boolean

このストレージ アカウントに対して定義されている設定が、サブスクリプションに定義されている設定をオーバーライドする必要があるかどうかを示します。

properties.sensitiveDataDiscovery.isEnabled

boolean

機密データの検出を有効にするかどうかを示します。

properties.sensitiveDataDiscovery.operationStatus

OperationStatus

失敗した場合、または部分的に成功した場合。 機密データ検出の有効化/無効化操作を説明する追加データ。

type

string

リソースの種類

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前 説明
info

object

追加情報。

type

string

追加情報の種類。

OperationStatus

有効化/無効化操作の成功/失敗を示す状態。

名前 説明
code

string

操作の状態コード。

message

string

操作の成功/失敗に関する追加情報。

settingName

Defender for Storage の設定名。

名前 説明
current

string

Defender for Storage の設定名の名前。