Defender For Storage - Create
Vytvoří nebo aktualizuje nastavení Defenderu pro úložiště v zadaném účtu úložiště.
PUT https://management.azure.com/{resourceId}/providers/Microsoft.Security/defenderForStorageSettings/current?api-version=2022-12-01-preview
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Identifikátor prostředku. |
setting
|
path | True |
Název nastavení Defenderu for Storage. Regex pattern: |
|
api-version
|
query | True |
string |
Verze rozhraní API pro operaci |
Text požadavku
Name | Typ | Description |
---|---|---|
properties.isEnabled |
boolean |
Určuje, jestli je pro tento účet úložiště povolený Defender for Storage. |
properties.malwareScanning.onUpload.capGBPerMonth |
integer |
Definuje maximální počet GB, který se má kontrolovat za měsíc. Pokud není potřeba žádné omezení, nastavte na hodnotu -1. |
properties.malwareScanning.onUpload.isEnabled |
boolean |
Určuje, jestli má být povolená kontrola malwaru při odesílání. |
properties.malwareScanning.scanResultsEventGridTopicResourceId |
string |
Nepovinný parametr. ID prostředku tématu Event Gridu, do které se mají odesílat výsledky kontroly. |
properties.overrideSubscriptionLevelSettings |
boolean |
Určuje, jestli by nastavení definovaná pro tento účet úložiště měla přepsat nastavení definovaná pro předplatné. |
properties.sensitiveDataDiscovery.isEnabled |
boolean |
Určuje, jestli má být povolené zjišťování citlivých dat. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Žádost o vytvoření nebo aktualizaci nastavení Defenderu pro úložiště byla úspěšná. |
|
201 Created |
Žádost o vytvoření nebo aktualizaci nastavení Defenderu pro úložiště byla částečně úspěšná. |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
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
}
}
Definice
Name | Description |
---|---|
Cloud |
Běžná odpověď na chybu pro všechna rozhraní API azure Resource Manager, která vrací podrobnosti o chybě pro neúspěšné operace. (To také odpovídá formátu odpovědi na chybu OData.) |
Cloud |
Podrobnosti o chybě. |
Defender |
Prostředek Defenderu pro úložiště. |
Error |
Další informace o chybě správy prostředků |
Operation |
Stav popisující úspěch/selhání operace povolení/zakázání. |
setting |
Název nastavení Defenderu for Storage. |
CloudError
Běžná odpověď na chybu pro všechna rozhraní API azure Resource Manager, která vrací podrobnosti o chybě pro neúspěšné operace. (To také odpovídá formátu odpovědi na chybu OData.)
Name | Typ | Description |
---|---|---|
error.additionalInfo |
Další informace o chybě |
|
error.code |
string |
Kód chyby |
error.details |
Podrobnosti o chybě |
|
error.message |
string |
Chybová zpráva |
error.target |
string |
Cíl chyby. |
CloudErrorBody
Podrobnosti o chybě.
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
DefenderForStorageSetting
Prostředek Defenderu pro úložiště.
Name | Typ | Description |
---|---|---|
id |
string |
ID prostředku |
name |
string |
Název prostředku |
properties.isEnabled |
boolean |
Určuje, jestli je pro tento účet úložiště povolený Defender for Storage. |
properties.malwareScanning.onUpload.capGBPerMonth |
integer |
Definuje maximální počet GB, který se má kontrolovat za měsíc. Pokud není potřeba žádné omezení, nastavte na hodnotu -1. |
properties.malwareScanning.onUpload.isEnabled |
boolean |
Určuje, jestli má být povolená kontrola malwaru při odesílání. |
properties.malwareScanning.operationStatus |
Při selhání nebo částečném úspěchu. Další data popisující operaci povolení/zakázání kontroly malwaru |
|
properties.malwareScanning.scanResultsEventGridTopicResourceId |
string |
Nepovinný parametr. ID prostředku tématu Event Gridu, do které se mají odesílat výsledky kontroly. |
properties.overrideSubscriptionLevelSettings |
boolean |
Určuje, jestli by nastavení definovaná pro tento účet úložiště měla přepsat nastavení definovaná pro předplatné. |
properties.sensitiveDataDiscovery.isEnabled |
boolean |
Určuje, jestli má být povolené zjišťování citlivých dat. |
properties.sensitiveDataDiscovery.operationStatus |
Při selhání nebo částečném úspěchu. Další data popisující operaci povolení/zakázání zjišťování citlivých dat |
|
type |
string |
Typ prostředku |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Další typ informací. |
OperationStatus
Stav popisující úspěch/selhání operace povolení/zakázání.
Name | Typ | Description |
---|---|---|
code |
string |
Stavový kód operace. |
message |
string |
Další informace týkající se úspěchu nebo selhání operace |
settingName
Název nastavení Defenderu for Storage.
Name | Typ | Description |
---|---|---|
current |
string |
Název nastavení Defenderu pro úložiště. |