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 パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
resource
|
path | True |
string |
リソースの識別子。 |
setting
|
path | True |
Defender for Storage の設定名。 Regex pattern: |
|
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 |
Defender for Storage 設定を作成または更新するための要求が成功しました。 |
|
201 Created |
Defender for Storage 設定の作成または更新の要求が部分的に成功しました。 |
|
Other Status Codes |
操作に失敗した理由を説明するエラー応答。 |
セキュリティ
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
}
}
定義
名前 | 説明 |
---|---|
Cloud |
失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API に対する一般的なエラー応答 (これは OData エラー応答形式にも従います)。 |
Cloud |
エラーの詳細。 |
Defender |
Defender for Storage リソース。 |
Error |
リソース管理エラーの追加情報。 |
Operation |
有効化/無効化操作の成功/失敗を示す状態。 |
setting |
Defender for Storage の設定名。 |
CloudError
失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API に対する一般的なエラー応答 (これは OData エラー応答形式にも従います)。
名前 | 型 | 説明 |
---|---|---|
error.additionalInfo |
エラーの追加情報。 |
|
error.code |
string |
エラー コード。 |
error.details |
エラーの詳細です。 |
|
error.message |
string |
エラー メッセージ。 |
error.target |
string |
エラーのターゲット。 |
CloudErrorBody
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細です。 |
|
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 |
失敗した場合、または部分的に成功した場合。 マルウェア スキャンの有効化/無効化操作を説明する追加データ。 |
|
properties.malwareScanning.scanResultsEventGridTopicResourceId |
string |
省略可能。 スキャン結果を送信する Event Grid トピックのリソース ID。 |
properties.overrideSubscriptionLevelSettings |
boolean |
このストレージ アカウントに対して定義されている設定が、サブスクリプションに定義されている設定をオーバーライドする必要があるかどうかを示します。 |
properties.sensitiveDataDiscovery.isEnabled |
boolean |
機密データの検出を有効にするかどうかを示します。 |
properties.sensitiveDataDiscovery.operationStatus |
失敗した場合、または部分的に成功した場合。 機密データ検出の有効化/無効化操作を説明する追加データ。 |
|
type |
string |
リソースの種類 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
OperationStatus
有効化/無効化操作の成功/失敗を示す状態。
名前 | 型 | 説明 |
---|---|---|
code |
string |
操作の状態コード。 |
message |
string |
操作の成功/失敗に関する追加情報。 |
settingName
Defender for Storage の設定名。
名前 | 型 | 説明 |
---|---|---|
current |
string |
Defender for Storage の設定名の名前。 |