REST API를 사용하여 Storage용 Defender 사용 및 구성

REST API를 사용하여 구독 수준에서 Defender for Storage를 사용하도록 설정하고 구성하려면 다음 엔드포인트를 사용하여 PUT 요청을 만듭니다. 엔드포인트 URL의 subscriptionId 값을 사용자 고유의 Azure 구독 ID로 바꿉니다.

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

다음 요청 본문을 추가합니다.

{
    "properties": {
        "extensions": [
            {
                "name": "OnUploadMalwareScanning",
                "isEnabled": "True",
                "additionalExtensionProperties": {
                    "CapGBPerMonthPerStorageAccount": "10000",
          "BlobScanResultsOptions": "BlobIndexTags"/"None"
          "AutomatedResponse": "BlobSoftDelete"/"None"
                }
            },
            {
                "name": "SensitiveDataDiscovery",
                "isEnabled": "True"
            }
        ],
        "subPlan": "DefenderForStorageV2",
        "pricingTier": "Standard"
    }
}

이 코드를 사용자 지정하면 다음을 수행할 수 있습니다.

• 맬웨어 검사에 대한 월별 임계값 수정: 매개 변수를 CapGBPerMonthPerStorageAccount 원하는 값으로 조정합니다. 이 매개 변수는 스토리지 계정당 매월 맬웨어를 검사할 수 있는 최대 데이터의 한도를 설정합니다. 무제한 검사를 허용하려면 값을 -1할당합니다. 기본 제한은 10,000GB입니다.
• 업로드 시 맬웨어 검색 또는 중요 데이터 위협 탐지 기능을 끄기: isEnabled 아래의 값을 False에서 SensitiveDataDiscovery로 변경합니다.
• Blob 인덱스 태그 사용 끄기: BlobScanResultsOptions 값을 None로 변경합니다. 이 값을 설정하지 않으면 모든 검사 결과가 Blob 인덱스 태그에 게시됩니다.
• Defender for Storage 계획 전체를 비활성화합니다: pricingTier 속성 값을 Free로 설정하고, subPlan 및 extensions 속성을 제거합니다.

HTTP, Java, Go 및 JavaScript에서 REST API를 사용하여 Defender 계획을 업데이트하는 방법에 대해 자세히 알아봅니다.

REST API를 사용하여 스토리지 계정 수준에서 Storage용 Defender를 사용하도록 설정하고 구성하려면 다음 엔드포인트를 사용하여 PUT 요청을 만듭니다. 엔드포인트 URL의 subscriptionId값을 resourceGroupNameaccountName사용자 고유의 Azure 구독 ID, 리소스 그룹 및 스토리지 계정 이름으로 바꿉니다.

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

다음 요청 본문을 추가합니다.

{
   "properties": {
        "isEnabled": true,
        "malwareScanning": {
            "onUpload": {
                "isEnabled": true,
                "capGBPerMonth": 10000,
                "filters": {
                    "excludeBlobsWithPrefix": [
                        "<excluded-container>/",
                        "<container>/<excluded-blob-prefix>"
                        "<excluded-containers-prefix>"
                    ],
                    "excludeBlobsWithSuffix": [
                        ".parquet",
                        ".tmp",
                        "<excluded-blob-name-suffix>.json"
                    ],
                    "excludeBlobsLargerThan": 2147483648
        }
            },
            
      "automatedResponse": "BlobSoftDelete",
      "scanResultsEventGridTopicResourceId": "/subscriptions/<Subscription>/resourceGroups/<resourceGroup>/providers/Microsoft.EventGrid/topics/<topicName>"
        },
        "sensitiveDataDiscovery": {
            "isEnabled": true
        },
        "overrideSubscriptionLevelSettings": true
    },
    "scope": "[resourceId('Microsoft.Storage/storageAccounts', parameters('StorageAccountName'))]"
}

이 코드를 사용자 지정하면 다음을 수행할 수 있습니다.

• 맬웨어 검사에 대한 월별 임계값 수정: 매개 변수를 capGBPerMonth 원하는 값으로 조정합니다. 이 매개 변수는 스토리지 계정당 매월 맬웨어를 검사할 수 있는 최대 데이터의 한도를 설정합니다. 무제한 검사를 허용하려면 값을 -1할당합니다. 기본 제한은 10,000GB입니다.
• 업로드 시 맬웨어 검색을 보다 세부적으로 제어하고 특정 컨테이너, Blob 형식 또는 크기를 제외합니다. 속성을 사용합니다 filters . 업로드 중인 맬웨어 검사 필터에 대해 자세히 알아봅니다.
• 업로드 시 맬웨어 스캔 또는 민감한 데이터 위협 탐지 기능 비활성화: isEnabled 또는 False 속성의 섹션에서 값을 malwareScanning로 변경하십시오.
• Blob 인덱스 태그 사용 끄기: BlobScanResultsOptions 값을 None로 변경합니다. 이 값을 설정하지 않으면 모든 검사 결과가 Blob 인덱스 태그에 게시됩니다.
• 전체 Defender for Storage 계획을 사용하지 않도록 설정합니다: isEnabled 속성 값을 False로 설정하고, 속성에서 malwareScanning 및 sensitiveDataDiscovery 섹션을 제거합니다.

자세한 내용은 Microsoft.Security/DefenderForStorageSettings API 설명서를 참조하세요.