Actions31
- Instance Actions
- Alert Rule Actions
- Automation Rule Actions
- Incident Actions
- Incident Comment Actions
- Query Actions
Instance → Get Instances
AI-generatedOverview
This node interacts with Microsoft Sentinel to retrieve Sentinel instances. Specifically, the 'Get Instances' operation fetches a list of Sentinel instances using the Microsoft Resource Graph API. This is useful for users who want to programmatically access and manage their Sentinel instances within Azure, for example, to list available Sentinel workspaces for monitoring or automation purposes.
Use Case Examples
- A security analyst wants to list all Sentinel instances in their Azure subscription to monitor security alerts.
- An automation workflow needs to dynamically select a Sentinel instance to run queries or manage incidents.
Properties
| Name | Meaning |
|---|---|
| Sentinel Instance | The Sentinel instance to use. It can be selected from a list, entered as a path in the format {subscriptionId}/{resourceGroupName}/{workspaceName}, or provided as a valid Azure Portal/Management URL. |
| Debug | Enable or disable debug mode for the node to log request and response details. |
| Request Options | Settings to control batching, SSL certificate validation, proxy usage, and request timeout for API calls. |
Output
JSON
data- The list of Sentinel instances returned by the Microsoft Resource Graph API.
Dependencies
- Requires an OAuth2 API credential for Microsoft Sentinel to authenticate API requests.
Troubleshooting
- Ensure the Sentinel instance input is correctly formatted as a path, URL, or selected from the list to avoid validation errors.
- If API requests fail, check the OAuth2 credentials and network settings such as proxy and SSL options.
- Timeout errors can occur if the server does not respond within the configured timeout period; increase the timeout if necessary.
Links
- Microsoft Sentinel Documentation - Official documentation for Microsoft Sentinel, including API references and usage guides.
- Azure Resource Graph - Documentation for Azure Resource Graph used to query resources including Sentinel instances.