Alerts - Simulate

서비스:: Defender for Cloud

API 버전:: 2022-01-01

보안 경고 시뮬레이션

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/locations/{ascLocation}/alerts/default/simulate?api-version=2022-01-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
ascLocation	path	True	string	ASC가 구독의 데이터를 저장하는 위치입니다. 위치 가져오기에서 검색할 수 있습니다.
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
properties	AlertSimulatorRequestProperties: AlertSimulatorBundlesRequestProperties	경고 시뮬레이터 요청 본문 데이터입니다.

응답

Name	형식	Description
202 Accepted		자원 작업이 허용되었습니다. 헤더 Location: string Retry-After: integer
Other Status Codes	Common.CloudError	예기치 않은 오류 응답입니다.

Name

형식

Description

202 Accepted

자원 작업이 허용되었습니다.

헤더

Location: string
Retry-After: integer

Other Status Codes

Common.CloudError

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Simulate security alerts on a subscription

샘플 요청

HTTP

POST https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/locations/centralus/alerts/default/simulate?api-version=2022-01-01

{
  "properties": {
    "bundles": [
      "AppServices",
      "DNS",
      "KeyVaults",
      "KubernetesService",
      "ResourceManager",
      "SqlServers",
      "StorageAccounts",
      "VirtualMachines",
      "CosmosDbs"
    ],
    "kind": "Bundles"
  }
}

샘플 응답

상태 코드:: 202

정의

Name	Description
AlertSimulatorBundlesRequestProperties	이 번들에 따라 경고를 시뮬레이션합니다.
AlertSimulatorRequestBody	경고 시뮬레이터 요청 본문입니다.
BundleType	경고 시뮬레이터 지원 번들.
Common.CloudError	실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.
Common.CloudErrorBody	오류 세부 정보입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
Kind	경고 시뮬레이션의 종류입니다.

AlertSimulatorBundlesRequestProperties

Object

이 번들에 따라 경고를 시뮬레이션합니다.

Name	형식	Description
bundles	BundleType[]	번들 목록입니다.
kind	string: Bundles	경고 시뮬레이션의 종류입니다.

AlertSimulatorRequestBody

Object

경고 시뮬레이터 요청 본문입니다.

Name	형식	Description
properties	AlertSimulatorRequestProperties: AlertSimulatorBundlesRequestProperties	경고 시뮬레이터 요청 본문 데이터입니다.

BundleType

열거형

경고 시뮬레이터 지원 번들.

값	Description
AppServices	앱서비스
DNS	DNS
KeyVaults	KeyVaults
KubernetesService	KubernetesService
ResourceManager	ResourceManager
SqlServers	SqlServers
StorageAccounts	StorageAccounts
VirtualMachines	가상머신
CosmosDbs	코스모스DBS

Common.CloudError

Object

실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.

Name	형식	Description
error.additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
error.code	string	오류 코드입니다.
error.details	Common.CloudErrorBody[]	오류 세부 정보입니다.
error.message	string	오류 메시지입니다.
error.target	string	오류 대상입니다.

Common.CloudErrorBody

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	Common.CloudErrorBody[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

Kind

열거형

경고 시뮬레이션의 종류입니다.

값	Description
Bundles	번들에 따라 경고를 시뮬레이션하세요