有効化と構成を REST API で行う

REST API を使用して Microsoft Defender for Storage をサブスクリプション レベルで有効にして構成するには、次のエンドポイントで PUT 要求を作成します (エンドポイント URL 内の subscriptionId は、実際の Azure サブスクリプション ID に置き換えてください)。

PUT
https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/pricings/StorageAccounts?api-version=2023-01-01

次の要求本文を追加します。

{
    "properties": {
        "extensions": [
            {
                "name": "OnUploadMalwareScanning",
                "isEnabled": "True",
                "additionalExtensionProperties": {
                    "CapGBPerMonthPerStorageAccount": "5000"
                }
            },
            {
                "name": "SensitiveDataDiscovery",
                "isEnabled": "True"
            }
        ],
        "subPlan": "DefenderForStorageV2",
        "pricingTier": "Standard"
    }
}

ストレージ アカウントにおけるマルウェア スキャンの月次上限を変更するには、CapGBPerMonthPerStorageAccount パラメーターを目的の値に調整します。 このパラメーターでは、ストレージ アカウントごとに毎月マルウェアをスキャンできる最大データの上限を設定します。 無制限のスキャンを許可する場合は、値 -1 を割り当てます。 既定の上限は 5,000 GB に設定されています。

[アップロード時マルウェア スキャン] または [機密データの脅威検出] 機能をオフにするには、sensitiveDataDiscovery で isEnabled の値を False に変更します。

Defender プラン全体を無効にするには、pricingTier プロパティの値を Free に設定し、subPlan および extensions プロパティを削除します。

HTTP、Java、Go、JavaScript での REST API を使用した Defender プランの更新について詳細をご確認ください。

REST API を使用して Microsoft Defender for Storage をストレージ アカウント レベルで有効にして構成するには、次のエンドポイントで PUT 要求を作成します。 エンドポイント URL 内の subscriptionId、resourceGroupName、accountName は、実際の Azure サブスクリプション ID、リソース グループ名、ストレージ アカウント名に適宜置き換えてください。

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

次の要求本文を追加します。

{
   "properties": {
        "isEnabled": true,
        "malwareScanning": {
            "onUpload": {
                "isEnabled": true,
                "capGBPerMonth": 5000
            },
   "scanResultsEventGridTopicResourceId": "/subscriptions/<Subscription>/resourceGroups/<resourceGroup>/providers/Microsoft.EventGrid/topics/<topicName>"
        },
        "sensitiveDataDiscovery": {
            "isEnabled": true
        },
        "overrideSubscriptionLevelSettings": true
    },
    "scope": "[resourceId('Microsoft.Storage/storageAccounts', parameters('StorageAccountName'))]"
}

ストレージ アカウントにおけるマルウェア スキャンの月次上限を変更するには、capGBPerMonth パラメーターを目的の値に調整します。 このパラメーターでは、ストレージ アカウントごとに毎月マルウェアをスキャンできる最大データの上限を設定します。 無制限のスキャンを許可する場合は、値 -1 を割り当てます。 既定の上限は 5,000 GB に設定されています。

[アップロード時マルウェア スキャン] または [機密データの脅威検出] 機能をオフにするには、malwareScanning または sensitiveDataDiscovery プロパティのセクションで isEnabled の値を False に変更します。

ストレージ アカウントで Defender プラン全体を無効にするには、isEnabled プロパティの値を False に設定し、properties から malwareScanning および sensitiveDataDiscovery のセクションを削除します。

Microsoft.Security/DefenderForStorageSettings API ドキュメントについて詳細をご確認ください。