Microsoft.Security (preview:2024-08-01)

2025/04/07 • 2 new methods

DefenderForStorage_Get (new)
Description :  Gets the Defender for Storage settings for the specified storage account.
Reference :  Link ¶

⚼ Request

GET:  /{resourceId}/providers/Microsoft.Security/defenderForStorageSettings/{settingName}
{
api-version:
{
Description: API version for the operation ,
Required: True ,
}
string ,
resourceId:
{
Description: The identifier of the resource. ,
Required: True ,
}
string ,
settingName:
{
Description: Defender for Storage setting name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Defender for Storage resource properties. ,
Required: False ,
}
{
isEnabled:
{
Description: Indicates whether Defender for Storage is enabled on this storage account. ,
Required: False ,
}
boolean ,
malwareScanning:
{
Description: Properties of Malware Scanning. ,
Required: False ,
}
{
onUpload:
{
Description: Properties of On Upload malware scanning. ,
Required: False ,
}
{
isEnabled:
{
Description: Indicates whether On Upload malware scanning should be enabled. ,
Required: False ,
}
boolean ,
capGBPerMonth:
{
Description: Defines the max GB to be scanned per Month. Set to -1 if no capping is needed. ,
Format: int32 ,
Required: False ,
}
integer ,
filters:
{
Description: Optional. Determine which blobs get scanned by On Upload malware scanning. An Or operation is performed between each filter type. ,
Required: False ,
}
{
excludeBlobsWithPrefix:
{
Description: Optional. A list of prefixes to exclude from on-upload malware scanning. Format: `container-name/blob-name` (start with the container name; do not include the storage account name). Exclude entire containers: Use prefix of container names you want to exclude without a trailing `/`. Exclude a single container: Add a trailing slash `/` after the container name to avoid excluding other containers with similar prefixes. ,
Required: False ,
}
[
string ,
]
,
excludeBlobsWithSuffix:
{
Description: Optional. A list of suffixes to exclude from on-upload malware scanning. Suffixes match only the end of blob names, and should be used for file extensions or blob name endings only. ,
Required: False ,
}
[
string ,
]
,
excludeBlobsLargerThan:
{
Description: Optional. Specifies the maximum size in bytes for blobs to be scanned. This parameter accepts a single positive integer value. Blobs larger than this value will be excluded from scanning. ,
Format: int64 ,
Required: False ,
}
string ,
}
,
}
,
scanResultsEventGridTopicResourceId:
{
Description: Optional. Resource id of an Event Grid Topic to send scan results to. ,
Required: False ,
}
string ,
operationStatus:
{
Description: Upon failure or partial success. Additional data describing Malware Scanning enable/disable operation. ,
Required: False ,
}
{
code:
{
Description: The operation status code. ,
Required: False ,
}
string ,
message:
{
Description: Additional information regarding the success/failure of the operation. ,
Required: False ,
}
string ,
}
,
}
,
sensitiveDataDiscovery:
{
Description: Properties of Sensitive Data Discovery. ,
Required: False ,
}
{
isEnabled:
{
Description: Indicates whether Sensitive Data Discovery should be enabled. ,
Required: False ,
}
boolean ,
operationStatus:
{
Description: Upon failure or partial success. Additional data describing Sensitive Data Discovery enable/disable operation. ,
Required: False ,
}
{
code:
{
Description: The operation status code. ,
Required: False ,
}
string ,
message:
{
Description: Additional information regarding the success/failure of the operation. ,
Required: False ,
}
string ,
}
,
}
,
overrideSubscriptionLevelSettings:
{
Description: Indicates whether the settings defined for this storage account should override the settings defined for the subscription. ,
Required: False ,
}
boolean ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
DefenderForStorage_Create (new)
Description :  Creates or updates the Defender for Storage settings on a specified storage account.
Reference :  Link ¶

⚼ Request

PUT:  /{resourceId}/providers/Microsoft.Security/defenderForStorageSettings/{settingName}
{
api-version:
{
Description: API version for the operation ,
Required: True ,
}
string ,
resourceId:
{
Description: The identifier of the resource. ,
Required: True ,
}
string ,
settingName:
{
Description: Defender for Storage setting name. ,
Required: True ,
}
string ,
defenderForStorageSetting:
{
Description: Defender for Storage Settings ,
Required: True ,
}
{
properties:
{
Description: Defender for Storage resource properties. ,
Required: False ,
}
{
isEnabled:
{
Description: Indicates whether Defender for Storage is enabled on this storage account. ,
Required: False ,
}
boolean ,
malwareScanning:
{
Description: Properties of Malware Scanning. ,
Required: False ,
}
{
onUpload:
{
Description: Properties of On Upload malware scanning. ,
Required: False ,
}
{
isEnabled:
{
Description: Indicates whether On Upload malware scanning should be enabled. ,
Required: False ,
}
boolean ,
capGBPerMonth:
{
Description: Defines the max GB to be scanned per Month. Set to -1 if no capping is needed. ,
Format: int32 ,
Required: False ,
}
integer ,
filters:
{
Description: Optional. Determine which blobs get scanned by On Upload malware scanning. An Or operation is performed between each filter type. ,
Required: False ,
}
{
excludeBlobsWithPrefix:
{
Description: Optional. A list of prefixes to exclude from on-upload malware scanning. Format: `container-name/blob-name` (start with the container name; do not include the storage account name). Exclude entire containers: Use prefix of container names you want to exclude without a trailing `/`. Exclude a single container: Add a trailing slash `/` after the container name to avoid excluding other containers with similar prefixes. ,
Required: False ,
}
[
string ,
]
,
excludeBlobsWithSuffix:
{
Description: Optional. A list of suffixes to exclude from on-upload malware scanning. Suffixes match only the end of blob names, and should be used for file extensions or blob name endings only. ,
Required: False ,
}
[
string ,
]
,
excludeBlobsLargerThan:
{
Description: Optional. Specifies the maximum size in bytes for blobs to be scanned. This parameter accepts a single positive integer value. Blobs larger than this value will be excluded from scanning. ,
Format: int64 ,
Required: False ,
}
string ,
}
,
}
,
scanResultsEventGridTopicResourceId:
{
Description: Optional. Resource id of an Event Grid Topic to send scan results to. ,
Required: False ,
}
string ,
operationStatus:
{
Description: Upon failure or partial success. Additional data describing Malware Scanning enable/disable operation. ,
Required: False ,
}
{
code:
{
Description: The operation status code. ,
Required: False ,
}
string ,
message:
{
Description: Additional information regarding the success/failure of the operation. ,
Required: False ,
}
string ,
}
,
}
,
sensitiveDataDiscovery:
{
Description: Properties of Sensitive Data Discovery. ,
Required: False ,
}
{
isEnabled:
{
Description: Indicates whether Sensitive Data Discovery should be enabled. ,
Required: False ,
}
boolean ,
operationStatus:
{
Description: Upon failure or partial success. Additional data describing Sensitive Data Discovery enable/disable operation. ,
Required: False ,
}
{
code:
{
Description: The operation status code. ,
Required: False ,
}
string ,
message:
{
Description: Additional information regarding the success/failure of the operation. ,
Required: False ,
}
string ,
}
,
}
,
overrideSubscriptionLevelSettings:
{
Description: Indicates whether the settings defined for this storage account should override the settings defined for the subscription. ,
Required: False ,
}
boolean ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Defender for Storage resource properties. ,
Required: False ,
}
{
isEnabled:
{
Description: Indicates whether Defender for Storage is enabled on this storage account. ,
Required: False ,
}
boolean ,
malwareScanning:
{
Description: Properties of Malware Scanning. ,
Required: False ,
}
{
onUpload:
{
Description: Properties of On Upload malware scanning. ,
Required: False ,
}
{
isEnabled:
{
Description: Indicates whether On Upload malware scanning should be enabled. ,
Required: False ,
}
boolean ,
capGBPerMonth:
{
Description: Defines the max GB to be scanned per Month. Set to -1 if no capping is needed. ,
Format: int32 ,
Required: False ,
}
integer ,
filters:
{
Description: Optional. Determine which blobs get scanned by On Upload malware scanning. An Or operation is performed between each filter type. ,
Required: False ,
}
{
excludeBlobsWithPrefix:
{
Description: Optional. A list of prefixes to exclude from on-upload malware scanning. Format: `container-name/blob-name` (start with the container name; do not include the storage account name). Exclude entire containers: Use prefix of container names you want to exclude without a trailing `/`. Exclude a single container: Add a trailing slash `/` after the container name to avoid excluding other containers with similar prefixes. ,
Required: False ,
}
[
string ,
]
,
excludeBlobsWithSuffix:
{
Description: Optional. A list of suffixes to exclude from on-upload malware scanning. Suffixes match only the end of blob names, and should be used for file extensions or blob name endings only. ,
Required: False ,
}
[
string ,
]
,
excludeBlobsLargerThan:
{
Description: Optional. Specifies the maximum size in bytes for blobs to be scanned. This parameter accepts a single positive integer value. Blobs larger than this value will be excluded from scanning. ,
Format: int64 ,
Required: False ,
}
string ,
}
,
}
,
scanResultsEventGridTopicResourceId:
{
Description: Optional. Resource id of an Event Grid Topic to send scan results to. ,
Required: False ,
}
string ,
operationStatus:
{
Description: Upon failure or partial success. Additional data describing Malware Scanning enable/disable operation. ,
Required: False ,
}
{
code:
{
Description: The operation status code. ,
Required: False ,
}
string ,
message:
{
Description: Additional information regarding the success/failure of the operation. ,
Required: False ,
}
string ,
}
,
}
,
sensitiveDataDiscovery:
{
Description: Properties of Sensitive Data Discovery. ,
Required: False ,
}
{
isEnabled:
{
Description: Indicates whether Sensitive Data Discovery should be enabled. ,
Required: False ,
}
boolean ,
operationStatus:
{
Description: Upon failure or partial success. Additional data describing Sensitive Data Discovery enable/disable operation. ,
Required: False ,
}
{
code:
{
Description: The operation status code. ,
Required: False ,
}
string ,
message:
{
Description: Additional information regarding the success/failure of the operation. ,
Required: False ,
}
string ,
}
,
}
,
overrideSubscriptionLevelSettings:
{
Description: Indicates whether the settings defined for this storage account should override the settings defined for the subscription. ,
Required: False ,
}
boolean ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Defender for Storage resource properties. ,
Required: False ,
}
{
isEnabled:
{
Description: Indicates whether Defender for Storage is enabled on this storage account. ,
Required: False ,
}
boolean ,
malwareScanning:
{
Description: Properties of Malware Scanning. ,
Required: False ,
}
{
onUpload:
{
Description: Properties of On Upload malware scanning. ,
Required: False ,
}
{
isEnabled:
{
Description: Indicates whether On Upload malware scanning should be enabled. ,
Required: False ,
}
boolean ,
capGBPerMonth:
{
Description: Defines the max GB to be scanned per Month. Set to -1 if no capping is needed. ,
Format: int32 ,
Required: False ,
}
integer ,
filters:
{
Description: Optional. Determine which blobs get scanned by On Upload malware scanning. An Or operation is performed between each filter type. ,
Required: False ,
}
{
excludeBlobsWithPrefix:
{
Description: Optional. A list of prefixes to exclude from on-upload malware scanning. Format: `container-name/blob-name` (start with the container name; do not include the storage account name). Exclude entire containers: Use prefix of container names you want to exclude without a trailing `/`. Exclude a single container: Add a trailing slash `/` after the container name to avoid excluding other containers with similar prefixes. ,
Required: False ,
}
[
string ,
]
,
excludeBlobsWithSuffix:
{
Description: Optional. A list of suffixes to exclude from on-upload malware scanning. Suffixes match only the end of blob names, and should be used for file extensions or blob name endings only. ,
Required: False ,
}
[
string ,
]
,
excludeBlobsLargerThan:
{
Description: Optional. Specifies the maximum size in bytes for blobs to be scanned. This parameter accepts a single positive integer value. Blobs larger than this value will be excluded from scanning. ,
Format: int64 ,
Required: False ,
}
string ,
}
,
}
,
scanResultsEventGridTopicResourceId:
{
Description: Optional. Resource id of an Event Grid Topic to send scan results to. ,
Required: False ,
}
string ,
operationStatus:
{
Description: Upon failure or partial success. Additional data describing Malware Scanning enable/disable operation. ,
Required: False ,
}
{
code:
{
Description: The operation status code. ,
Required: False ,
}
string ,
message:
{
Description: Additional information regarding the success/failure of the operation. ,
Required: False ,
}
string ,
}
,
}
,
sensitiveDataDiscovery:
{
Description: Properties of Sensitive Data Discovery. ,
Required: False ,
}
{
isEnabled:
{
Description: Indicates whether Sensitive Data Discovery should be enabled. ,
Required: False ,
}
boolean ,
operationStatus:
{
Description: Upon failure or partial success. Additional data describing Sensitive Data Discovery enable/disable operation. ,
Required: False ,
}
{
code:
{
Description: The operation status code. ,
Required: False ,
}
string ,
message:
{
Description: Additional information regarding the success/failure of the operation. ,
Required: False ,
}
string ,
}
,
}
,
overrideSubscriptionLevelSettings:
{
Description: Indicates whether the settings defined for this storage account should override the settings defined for the subscription. ,
Required: False ,
}
boolean ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}