Document Details
Import Api From Oas
❌
This page contains Windows bias
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:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
windows_tools
Summary:
The documentation provides examples for Azure Portal, Azure CLI, and Azure PowerShell, with PowerShell (a Windows-centric tool) given equal prominence to the cross-platform CLI. There is no mention of Linux-specific tools, shell environments, or workflows, and PowerShell is referenced as a primary automation method. The prerequisites and examples do not clarify that Azure CLI is fully cross-platform or suggest Linux-specific considerations, and the PowerShell example assumes a Windows context.
Recommendations:
- Clarify that Azure CLI is fully cross-platform and works natively on Linux, macOS, and Windows.
- Explicitly mention that PowerShell Core (pwsh) is available on Linux and macOS, or clarify if only Windows PowerShell is supported.
- Add bash/zsh shell script examples for the Azure CLI commands to demonstrate Linux-native workflows.
- Include a note or section on using the Azure CLI in Linux environments, such as installing the CLI on Ubuntu or using it in a Docker container.
- If PowerShell is included, specify when to use PowerShell Core vs. Windows PowerShell, and provide parity for Linux users.
- Avoid implying that PowerShell is the default or preferred automation tool unless it is truly cross-platform and equally supported on Linux.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-07-12 23:44 | #41 | in_progress | ❌ Biased |
| 2025-07-12 00:58 | #8 | cancelled | ✅ Clean |
| 2025-07-10 05:06 | #7 | processing | ✅ Clean |
| 2025-07-09 23:22 | #6 | cancelled | ✅ Clean |
Flagged Code Snippets
After importing the API, if needed, you can update the settings by using the [az apim api update](/cli/azure/apim/api#az-apim-api-update) command.
#### [PowerShell](#tab/powershell)
The following example uses the [Import-AzApiManagementApi](/powershell/module/az.apimanagement/import-azapimanagementapi?) Azure PowerShell cmdlet to import an OpenAPI specification from the specified URL to an API Management instance named *apim-hello-world*. To import using a path to a specification instead of a URL, use the `-SpecificationPath` parameter.