Get Subscription Deployment Locations - Get Subscription Deployment Locations
Description for Gets list of available geo regions plus ministamps
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Web/deploymentLocations?api-version=2023-12-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
subscription
|
path | True |
string |
Your Azure subscription ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000). |
api-version
|
query | True |
string |
API Version |
Responses
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
App Service error response. |
Security
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Definitions
Name | Description |
---|---|
App |
Description of an App Service Environment. |
AseV3Networking |
Full view of networking configuration for an ASE. |
Custom |
Full view of the custom domain suffix configuration for ASEv3. |
Custom |
|
Default |
App Service error response. |
Deployment |
List of available locations (regions or App Service Environments) for deployment of App Service resources. |
Details | |
Error |
Error model. |
Geo |
Geographical region. |
Hosting |
Information needed to create resources on an App Service Environment. |
Hosting |
Current status of the App Service Environment. |
Load |
Specifies which endpoints to serve internally in the Virtual Network for the App Service Environment. |
Name |
Name value pair. |
Provisioning |
Provisioning state of the App Service Environment. |
Upgrade |
Whether an upgrade is available for this App Service Environment. |
Upgrade |
Upgrade Preference |
Virtual |
Specification for using a Virtual Network. |
AppServiceEnvironment
Description of an App Service Environment.
Name | Type | Default Value | Description |
---|---|---|---|
clusterSettings |
Custom settings for changing the behavior of the App Service Environment. |
||
customDnsSuffixConfiguration |
Full view of the custom domain suffix configuration for ASEv3. |
||
dedicatedHostCount |
integer |
Dedicated Host Count |
|
dnsSuffix |
string |
DNS suffix of the App Service Environment. |
|
frontEndScaleFactor |
integer |
Scale factor for front-ends. |
|
hasLinuxWorkers |
boolean |
Flag that displays whether an ASE has linux workers or not |
|
internalLoadBalancingMode |
Specifies which endpoints to serve internally in the Virtual Network for the App Service Environment. |
||
ipsslAddressCount |
integer |
Number of IP SSL addresses reserved for the App Service Environment. |
|
maximumNumberOfMachines |
integer |
Maximum number of VMs in the App Service Environment. |
|
multiRoleCount |
integer |
Number of front-end instances. |
|
multiSize |
string |
Front-end VM size, e.g. "Medium", "Large". |
|
networkingConfiguration |
Full view of networking configuration for an ASE. |
||
provisioningState |
Provisioning state of the App Service Environment. |
||
status |
Current status of the App Service Environment. |
||
suspended |
boolean |
|
|
upgradeAvailability |
Whether an upgrade is available for this App Service Environment. |
||
upgradePreference | None |
Upgrade Preference |
|
userWhitelistedIpRanges |
string[] |
User added ip ranges to whitelist on ASE db |
|
virtualNetwork |
Description of the Virtual Network. |
||
zoneRedundant |
boolean |
Whether or not this App Service Environment is zone-redundant. |
AseV3NetworkingConfiguration
Full view of networking configuration for an ASE.
Name | Type | Description |
---|---|---|
id |
string |
Resource Id. |
kind |
string |
Kind of resource. |
name |
string |
Resource Name. |
properties.allowNewPrivateEndpointConnections |
boolean |
Property to enable and disable new private endpoint connection creation on ASE |
properties.externalInboundIpAddresses |
string[] |
|
properties.ftpEnabled |
boolean |
Property to enable and disable FTP on ASEV3 |
properties.inboundIpAddressOverride |
string |
Customer provided Inbound IP Address. Only able to be set on Ase create. |
properties.internalInboundIpAddresses |
string[] |
|
properties.linuxOutboundIpAddresses |
string[] |
|
properties.remoteDebugEnabled |
boolean |
Property to enable and disable Remote Debug on ASEV3 |
properties.windowsOutboundIpAddresses |
string[] |
|
type |
string |
Resource type. |
CustomDnsSuffixConfiguration
Full view of the custom domain suffix configuration for ASEv3.
Name | Type | Description |
---|---|---|
id |
string |
Resource Id. |
kind |
string |
Kind of resource. |
name |
string |
Resource Name. |
properties.certificateUrl |
string |
The URL referencing the Azure Key Vault certificate secret that should be used as the default SSL/TLS certificate for sites with the custom domain suffix. |
properties.dnsSuffix |
string |
The default custom domain suffix to use for all sites deployed on the ASE. |
properties.keyVaultReferenceIdentity |
string |
The user-assigned identity to use for resolving the key vault certificate reference. If not specified, the system-assigned ASE identity will be used if available. |
properties.provisioningDetails |
string |
|
properties.provisioningState | ||
type |
string |
Resource type. |
CustomDnsSuffixProvisioningState
Name | Type | Description |
---|---|---|
Degraded |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
DefaultErrorResponse
App Service error response.
Name | Type | Description |
---|---|---|
error |
Error model. |
DeploymentLocations
List of available locations (regions or App Service Environments) for deployment of App Service resources.
Name | Type | Description |
---|---|---|
hostingEnvironmentDeploymentInfos |
Available App Service Environments with basic information. |
|
hostingEnvironments |
Available App Service Environments with full descriptions of the environments. |
|
locations |
Available regions. |
Details
Name | Type | Description |
---|---|---|
code |
string |
Standardized string to programmatically identify the error. |
message |
string |
Detailed error description and debugging information. |
target |
string |
Detailed error description and debugging information. |
Error
Error model.
Name | Type | Description |
---|---|---|
code |
string |
Standardized string to programmatically identify the error. |
details |
Details[] |
Detailed errors. |
innererror |
string |
More information to debug error. |
message |
string |
Detailed error description and debugging information. |
target |
string |
Detailed error description and debugging information. |
GeoRegion
Geographical region.
Name | Type | Description |
---|---|---|
id |
string |
Resource Id. |
kind |
string |
Kind of resource. |
name |
string |
Resource Name. |
properties.description |
string |
Region description. |
properties.displayName |
string |
Display name for region. |
properties.orgDomain |
string |
Display name for region. |
type |
string |
Resource type. |
HostingEnvironmentDeploymentInfo
Information needed to create resources on an App Service Environment.
Name | Type | Description |
---|---|---|
location |
string |
Location of the App Service Environment. |
name |
string |
Name of the App Service Environment. |
HostingEnvironmentStatus
Current status of the App Service Environment.
Name | Type | Description |
---|---|---|
Deleting |
string |
|
Preparing |
string |
|
Ready |
string |
|
Scaling |
string |
LoadBalancingMode
Specifies which endpoints to serve internally in the Virtual Network for the App Service Environment.
Name | Type | Description |
---|---|---|
None |
string |
|
Publishing |
string |
|
Web |
string |
|
Web, Publishing |
string |
NameValuePair
Name value pair.
Name | Type | Description |
---|---|---|
name |
string |
Pair name. |
value |
string |
Pair value. |
ProvisioningState
Provisioning state of the App Service Environment.
Name | Type | Description |
---|---|---|
Canceled |
string |
|
Deleting |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
UpgradeAvailability
Whether an upgrade is available for this App Service Environment.
Name | Type | Description |
---|---|---|
None |
string |
No upgrade is currently available for this App Service Environment |
Ready |
string |
An upgrade is ready to be manually initiated on this App Service Environment |
UpgradePreference
Upgrade Preference
Name | Type | Description |
---|---|---|
Early |
string |
This App Service Environment will be upgraded before others in the same region that have Upgrade Preference 'Late' |
Late |
string |
This App Service Environment will be upgraded after others in the same region that have Upgrade Preference 'Early' |
Manual |
string |
ASEv3 only. Once an upgrade is available, this App Service Environment will wait 10 days for the upgrade to be manually initiated. After 10 days the upgrade will begin automatically |
None |
string |
No preference on when this App Service Environment will be upgraded |
VirtualNetworkProfile
Specification for using a Virtual Network.
Name | Type | Description |
---|---|---|
id |
string |
Resource id of the Virtual Network. |
name |
string |
Name of the Virtual Network (read-only). |
subnet |
string |
Subnet within the Virtual Network. |
type |
string |
Resource type of the Virtual Network (read-only). |