About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation consistently presents Azure PowerShell (a Windows-centric tool) examples first, followed by CLI and REST API, without providing any native Linux shell or bash examples. There is an implicit assumption that users are familiar with PowerShell, and no explicit Linux command-line (bash) or native SAP/Linux system commands are shown. The documentation also references PowerShell-specific cmdlets and does not mention Linux-specific tools or patterns.
Recommendations:
- Provide bash or shell script examples for Linux users, especially for invoking Azure CLI commands.
- Alternate the order of examples, sometimes presenting CLI (cross-platform) before PowerShell to avoid implying Windows primacy.
- Explicitly mention that Azure CLI commands can be run natively on Linux, macOS, and Windows, and provide sample shell environments.
- Where possible, include native SAP/Linux commands for soft stopping instances/databases, or at least reference how to do this outside of Azure tooling.
- Clarify that PowerShell is available cross-platform, but that many Linux users may prefer bash or zsh, and tailor examples accordingly.
Create pull request
Flagged Code Snippets
### Soft stop system using REST API
Use this [sample payload](/rest/api/workloads/2023-04-01/sap-virtual-instances/stop?tabs=HTTP#sapvirtualinstances_stop) to soft stop an SAP system. You can specify the soft stop timeout value in seconds.
## Soft stop SAP Application server instance
You can soft stop a specific application server in Azure Center for SAP solutions using Azure PowerShell, CLI and REST API interfaces. Once you initiate soft stop on application server and the operation is successfully triggered, then monitor Health and Status of the application server instance to check if it has stopped.
To soft stop an application server represented as an *App server instance for SAP solutions* resource:
### Using PowerShell
Use the [Stop-AzWorkloadsSapApplicationInstance](/powershell/module/az.workloads/stop-azworkloadssapapplicationinstance) command:
### Using REST API
Use this [sample payload](/rest/api/workloads/2023-04-01/sap-application-server-instances/stop-instance?tabs=HTTP#stop-the-sap-application-server-instance) to soft stop an application server instance. You can specify the soft stop timeout value in seconds.
## Soft stop HANA database
You can soft stop the HANA database so that the database stops gracefully after all running statements have finished. You can use the Azure PowerShell, CLI and REST API interfaces to soft stop database. Once you initiate soft stop on HANA database and the operation is successfully triggered on the database instance, then monitor the status of the database instance on the VIS to check if it has stopped.
> [!NOTE]
> When attempting to soft stop HANA database instance using Azure Center for SAP solutions, soft stop timeout value must be greater than 0 and less than 1800 seconds.
### Using PowerShell
Use the [Stop-AzWorkloadsSapDatabaseInstance](/powershell/module/az.workloads/stop-azworkloadssapdatabaseinstance) command: