Alerts - Simulate

Služba:

Defender for Cloud

Verze rozhraní API:

2022-01-01

Simulace výstrah zabezpečení

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
ascLocation	path	True	string	Umístění, kam ASC ukládá data předplatného. lze načíst z umístění Získat
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Typ	Description
properties	AlertSimulatorRequestProperties: AlertSimulatorBundlesRequestProperties	Data textu požadavku simulátoru upozornění

Odpovědi

Name	Typ	Description
202 Accepted		Operace prostředku byla přijata. Hlavičky Location: string Retry-After: integer
Other Status Codes	Common.CloudError	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Simulate security alerts on a subscription

Ukázkový požadavek

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"
  }
}

Ukázková odpověď

Stavový kód:

202

Definice

Name	Description
AlertSimulatorBundlesRequestProperties	Simulujte výstrahy podle těchto sad.
AlertSimulatorRequestBody	Text požadavku simulátoru upozornění
BundleType	Podporované sady sad simulátoru výstrah
Common.CloudError	Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)
Common.CloudErrorBody	Podrobnosti o chybě.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
Kind	Druh simulace výstrah.

AlertSimulatorBundlesRequestProperties

Objekt

Simulujte výstrahy podle těchto sad.

Name	Typ	Description
bundles	BundleType[]	Seznam svazků
kind	string: Bundles	Druh simulace výstrah.

AlertSimulatorRequestBody

Objekt

Text požadavku simulátoru upozornění

Name	Typ	Description
properties	AlertSimulatorRequestProperties: AlertSimulatorBundlesRequestProperties	Data textu požadavku simulátoru upozornění

BundleType

Výčet

Podporované sady sad simulátoru výstrah

Hodnota	Description
AppServices	AppServices
DNS	DNS
KeyVaults	KeyVaults
KubernetesService	KubernetesService
ResourceManager	ResourceManager
SqlServers	SqlServery
StorageAccounts	StorageAccounts
VirtualMachines	Virtuální počítače
CosmosDbs	CosmosDbs

Common.CloudError

Objekt

Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)

Name	Typ	Description
error.additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
error.code	string	Kód chyby.
error.details	Common.CloudErrorBody[]	Podrobnosti o chybě.
error.message	string	Chybová zpráva.
error.target	string	Cíl chyby.

Common.CloudErrorBody

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	Common.CloudErrorBody[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

Kind

Výčet

Druh simulace výstrah.

Hodnota	Description
Bundles	Simulujte upozornění podle balíčků