Defender For Storage - Create
지정된 스토리지 계정에서 스토리지용 Defender 설정을 만들거나 업데이트합니다.
PUT https://management.azure.com/{resourceId}/providers/Microsoft.Security/defenderForStorageSettings/current?api-version=2022-12-01-preview
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
resource
|
path | True |
string |
리소스의 식별자입니다. |
setting
|
path | True |
스토리지용 Defender 설정 이름입니다. Regex pattern: |
|
api-version
|
query | True |
string |
작업에 대한 API 버전 |
요청 본문
Name | 형식 | Description |
---|---|---|
properties.isEnabled |
boolean |
이 스토리지 계정에서 스토리지용 Defender를 사용할 수 있는지 여부를 나타냅니다. |
properties.malwareScanning.onUpload.capGBPerMonth |
integer |
월별 검사할 최대 GB를 정의합니다. 상한이 필요하지 않은 경우 -1로 설정합니다. |
properties.malwareScanning.onUpload.isEnabled |
boolean |
업로드할 때 맬웨어 검사를 사용하도록 설정해야 하는지 여부를 나타냅니다. |
properties.malwareScanning.scanResultsEventGridTopicResourceId |
string |
선택 사항입니다. 검사 결과를 보낼 Event Grid 토픽의 리소스 ID입니다. |
properties.overrideSubscriptionLevelSettings |
boolean |
이 스토리지 계정에 대해 정의된 설정이 구독에 대해 정의된 설정을 재정의해야 하는지 여부를 나타냅니다. |
properties.sensitiveDataDiscovery.isEnabled |
boolean |
중요한 데이터 검색을 사용하도록 설정해야 하는지 여부를 나타냅니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
스토리지용 Defender 설정을 만들거나 업데이트하는 요청이 성공했습니다. |
|
201 Created |
스토리지용 Defender 설정을 만들거나 업데이트하라는 요청이 부분적으로 성공했습니다. |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
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
}
}
정의
Name | Description |
---|---|
Cloud |
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. OData 오류 응답 형식도 따릅니다. |
Cloud |
오류 세부 정보입니다. |
Defender |
스토리지용 Defender 리소스입니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Operation |
사용/사용 안 함 작업의 성공/실패를 설명하는 상태. |
setting |
스토리지용 Defender 설정 이름입니다. |
CloudError
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. OData 오류 응답 형식도 따릅니다.
Name | 형식 | Description |
---|---|---|
error.additionalInfo |
오류 추가 정보입니다. |
|
error.code |
string |
오류 코드입니다. |
error.details |
오류 세부 정보입니다. |
|
error.message |
string |
오류 메시지입니다. |
error.target |
string |
오류 대상입니다. |
CloudErrorBody
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
DefenderForStorageSetting
스토리지용 Defender 리소스입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스 ID |
name |
string |
리소스 이름 |
properties.isEnabled |
boolean |
이 스토리지 계정에서 스토리지용 Defender를 사용할 수 있는지 여부를 나타냅니다. |
properties.malwareScanning.onUpload.capGBPerMonth |
integer |
월별 검사할 최대 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
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
OperationStatus
사용/사용 안 함 작업의 성공/실패를 설명하는 상태.
Name | 형식 | Description |
---|---|---|
code |
string |
작업 상태 코드입니다. |
message |
string |
작업의 성공/실패에 대한 추가 정보입니다. |
settingName
스토리지용 Defender 설정 이름입니다.
Name | 형식 | Description |
---|---|---|
current |
string |
스토리지용 Defender 설정 이름의 이름입니다. |