📚 Course: AZD For Beginners | ⏱️ Duration: 1-1.5 hours | ⭐ Complexity: Intermediate
This chapter helps you diagnose and resolve common issues when working with Azure Developer CLI. From deployment failures to AI-specific problems.
Validated against
azd 1.23.12in March 2026.
By completing this chapter, you will:
- Diagnose common AZD deployment failures
- Debug authentication and permission issues
- Resolve AI service connectivity problems
- Use Azure Portal and CLI for troubleshooting
| # | Lesson | Description | Time |
|---|---|---|---|
| 1 | Common Issues | Frequently encountered problems | 30 min |
| 2 | Debugging Guide | Step-by-step debugging strategies | 45 min |
| 3 | AI Troubleshooting | AI-specific issues | 30 min |
# Required for AZD workflows
azd auth login
# Optional if you are also using Azure CLI commands directly
az login
azd auth statusazd show
azd monitor --logs
az deployment sub list --query "[?properties.provisioningState!='Succeeded']"azd down --force --purge
azd env new different-name
azd upaz vm list-usage --location eastus --output table
azd env set AZURE_LOCATION westus2
azd up| Error | Cause | Solution |
|---|---|---|
AuthenticationError |
Not logged in | azd auth login |
ResourceNotFound |
Missing resource | Check resource names |
QuotaExceeded |
Subscription limits | Request quota increase |
InvalidTemplate |
Bicep syntax error | az bicep build |
Conflict |
Resource exists | Use new name or delete |
Forbidden |
Insufficient permissions | Check RBAC roles |
# Soft reset (keep resources, redeploy code)
azd deploy --force
# Hard reset (delete everything, start fresh)
azd down --force --purge
azd up| Direction | Chapter |
|---|---|
| Previous | Chapter 6: Pre-Deployment |
| Next | Chapter 8: Production |