Environment Provisioning - Get Supported Locations

Service:: Power Platform API

API Version:: 2024-10-01

Gets the list of supported locations for environment provisioning.

GET https://api.powerplatform.com/environmentmanagement/provisioning/locations?api-version=2024-10-01

URI Parameters

Name	In	Required	Type	Description
api-version	query	True	string	The API version.

Responses

Name	Type	Description
200 OK	ProvisioningLocations	OK Media Types: "text/plain", "application/json", "text/json"
400 Bad Request	ValidationResponse	Bad Request Media Types: "text/plain", "application/json", "text/json"
401 Unauthorized		Unauthorized Media Types: "text/plain", "application/json", "text/json"
403 Forbidden		Forbidden Media Types: "text/plain", "application/json", "text/json"
404 Not Found		Not Found Media Types: "text/plain", "application/json", "text/json"
429 Too Many Requests		Too Many Requests Media Types: "text/plain", "application/json", "text/json"

Security

oauth2

Microsoft Entra ID OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=https://api.powerplatform.com

Scopes

Name	Description
.default	.default

Definitions

Name	Description
FieldError	The error detail for a single field.
Location	Represents a location/geo for environment provisioning.
LocationSelectionMode	Describes how a tenant selects a provisioning location. Returned alongside the supported locations to tell callers whether to pick a specific location or a macro region.
MacroRegion	Represents a macro region that groups one or more provisioning locations.
OperationErrorDetail	Structured error detail for a failed request.
ProvisioningLocations	Response envelope for the list-provisioning-locations endpoint. Surfaces the list of locations at the top level alongside tenant-scoped provisioning metadata.
ValidationResponse	Represents the response for validation of an operation.

FieldError

Object

The error detail for a single field.

Name	Type	Description
errorMessages	string[]	The error messages describing what is wrong with the field.
suggestedValue	string	A suggested or accepted value that would resolve the error.

Location

Object

Represents a location/geo for environment provisioning.

Name	Type	Description
canProvisionDatabase	boolean	Whether database provisioning is allowed.
code	string	The location code.
displayName	string	The display name.
hasFirstReleaseIslandAvailableForProvisioning	boolean	Whether a first-release island is available for provisioning in this location.
isDefault	boolean	Whether this is the default location.
isDisabled	boolean	Whether this location is disabled.
name	string	The location name.

LocationSelectionMode

Enumeration

Describes how a tenant selects a provisioning location. Returned alongside the supported locations to tell callers whether to pick a specific location or a macro region.

Value	Description
Region
MacroRegion

MacroRegion

Object

Represents a macro region that groups one or more provisioning locations.

Name	Type	Description
dataResidencyNote	string	The data residency note shown to customers for this macro region.
displayName	string	The display name of the macro region.
macroRegionId	string	The macro region identifier.

OperationErrorDetail

Object

Structured error detail for a failed request.

Name	Type	Description
code	string	The error code.
fieldErrors	<string, FieldError>	Per-field error detail, keyed by field name.

ProvisioningLocations

Object

Response envelope for the list-provisioning-locations endpoint. Surfaces the list of locations at the top level alongside tenant-scoped provisioning metadata.

Name	Type	Description
collection	Location[]	The list of provisioning locations available to the tenant.
locationSelectionMode	LocationSelectionMode	Describes how a tenant selects a provisioning location. Returned alongside the supported locations to tell callers whether to pick a specific location or a macro region.
macroRegions	MacroRegion[]	The list of macro regions available to the tenant.

ValidationResponse

Object

Represents the response for validation of an operation.

Name	Type	Description
errorDetail	OperationErrorDetail	Structured error detail for a failed request.