Delen via

Subscriptions - List Locations

Service:
Resource Management
API-versie:
2022-12-01

Hiermee haalt u alle beschikbare geografische locaties op.
Deze bewerking biedt alle locaties die beschikbaar zijn voor resourceproviders; Elke resourceprovider kan echter een subset van deze lijst ondersteunen.

GET https://management.azure.com/subscriptions/{subscriptionId}/locations?api-version=2022-12-01
Met optionele parameters: 
GET https://management.azure.com/subscriptions/{subscriptionId}/locations?api-version=2022-12-01&includeExtendedLocations={includeExtendedLocations}

URI-parameters

Name In Vereist Type Description
subscriptionId
 path True

string

De id van het doelabonnement.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.
includeExtendedLocations
 query

boolean

Of u uitgebreide locaties wilt opnemen.

Antwoorden

Name Type Description
200 OK

LocationListResult

OK: retourneert een matrix met locaties.
Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

GetLocationsWithASubscriptionId
GetLocationsWithExtendedLocations

GetLocationsWithASubscriptionId

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations?api-version=2022-12-01

Voorbeeldrespons

Statuscode:
200 
{
  "value": [
    {
      "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/eastus",
      "name": "eastus",
      "type": "Region",
      "displayName": "East US",
      "regionalDisplayName": "(US) East US",
      "metadata": {
        "regionType": "Physical",
        "regionCategory": "Recommended",
        "geography": "United States",
        "geographyGroup": "US",
        "longitude": "-79.8164",
        "latitude": "37.3719",
        "physicalLocation": "Virginia",
        "pairedRegion": [
          {
            "name": "westus",
            "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/westus"
          }
        ]
      },
      "availabilityZoneMappings": [
        {
          "logicalZone": "1",
          "physicalZone": "eastus-az1"
        },
        {
          "logicalZone": "2",
          "physicalZone": "eastus-az3"
        },
        {
          "logicalZone": "3",
          "physicalZone": "eastus-az2"
        }
      ]
    },
    {
      "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/eastus2",
      "name": "eastus2",
      "type": "Region",
      "displayName": "East US 2",
      "regionalDisplayName": "(US) East US 2",
      "metadata": {
        "regionType": "Physical",
        "regionCategory": "Recommended",
        "geography": "United States",
        "geographyGroup": "US",
        "longitude": "-78.3889",
        "latitude": "36.6681",
        "physicalLocation": "Virginia",
        "pairedRegion": [
          {
            "name": "centralus",
            "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/centralus"
          }
        ]
      },
      "availabilityZoneMappings": [
        {
          "logicalZone": "1",
          "physicalZone": "eastus2-az1"
        },
        {
          "logicalZone": "2",
          "physicalZone": "eastus2-az3"
        },
        {
          "logicalZone": "3",
          "physicalZone": "eastus2-az2"
        }
      ]
    }
  ]
}

GetLocationsWithExtendedLocations

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations?api-version=2022-12-01&includeExtendedLocations=true

Voorbeeldrespons

Statuscode:
200 
{
  "value": [
    {
      "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/eastus",
      "name": "eastus",
      "type": "Region",
      "displayName": "East US",
      "regionalDisplayName": "(US) East US",
      "metadata": {
        "regionType": "Physical",
        "regionCategory": "Recommended",
        "geography": "United States",
        "geographyGroup": "US",
        "longitude": "-79.8164",
        "latitude": "37.3719",
        "physicalLocation": "Virginia",
        "pairedRegion": [
          {
            "name": "westus",
            "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/westus"
          }
        ]
      },
      "availabilityZoneMappings": [
        {
          "logicalZone": "1",
          "physicalZone": "eastus-az1"
        },
        {
          "logicalZone": "2",
          "physicalZone": "eastus-az3"
        },
        {
          "logicalZone": "3",
          "physicalZone": "eastus-az2"
        }
      ]
    },
    {
      "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/eastus2",
      "name": "eastus2",
      "type": "Region",
      "displayName": "East US 2",
      "regionalDisplayName": "(US) East US 2",
      "metadata": {
        "regionType": "Physical",
        "regionCategory": "Recommended",
        "geography": "United States",
        "geographyGroup": "US",
        "longitude": "-78.3889",
        "latitude": "36.6681",
        "physicalLocation": "Virginia",
        "pairedRegion": [
          {
            "name": "centralus",
            "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/centralus"
          }
        ]
      },
      "availabilityZoneMappings": [
        {
          "logicalZone": "1",
          "physicalZone": "eastus2-az1"
        },
        {
          "logicalZone": "2",
          "physicalZone": "eastus2-az3"
        },
        {
          "logicalZone": "3",
          "physicalZone": "eastus2-az2"
        }
      ]
    },
    {
      "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/eastus/edgeZones/ezecustomerlabboston1",
      "name": "ezecustomerlabboston1",
      "type": "EdgeZone",
      "displayName": "EZE Customer Lab Boston 1",
      "regionalDisplayName": "(US) EZE Customer Lab Boston 1",
      "metadata": {
        "regionType": "Physical",
        "regionCategory": "Extended",
        "geographyGroup": "US",
        "geography": "United States",
        "longitude": "-71.219038",
        "latitude": "42.301218"
      }
    },
    {
      "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/southcentralus/edgeZones/ezecustomerlabhouston1",
      "name": "ezecustomerlabhouston1",
      "type": "EdgeZone",
      "displayName": "EZE Customer Lab Houston 1",
      "regionalDisplayName": "(US) EZE Customer Lab Houston 1",
      "metadata": {
        "regionType": "Physical",
        "regionCategory": "Extended",
        "geographyGroup": "US",
        "geography": "United States",
        "longitude": "-95.41452",
        "latitude": "29.9411"
      }
    }
  ]
}

Definities

Name Description
AvailabilityZoneMappings

Toewijzingen van beschikbaarheidszones voor de regio
CloudError

Een foutbericht voor een aanvraag voor resourcebeheer.
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
ErrorDetail

De foutdetails.
ErrorResponse

Foutreactie
Location

Locatiegegevens.
LocationListResult

Antwoord van de locatielijstbewerking.
LocationMetadata

Informatie over locatiemetagegevens
LocationType

Het locatietype.
PairedRegion

Informatie over gekoppelde regio's.
RegionCategory

De categorie van de regio.
RegionType

Het type regio.

AvailabilityZoneMappings

Object

Toewijzingen van beschikbaarheidszones voor de regio

Name Type Description
logicalZone

string

De id van de logische zone voor de beschikbaarheidszone
physicalZone

string

De volledig gekwalificeerde fysieke zone-id van de beschikbaarheidszone waaraan de id van de logische zone is toegewezen

CloudError

Object

Een foutbericht voor een aanvraag voor resourcebeheer.

Name Type Description
error

ErrorResponse

Foutreactie
Veelvoorkomende foutreactie voor alle Azure Resource Manager-API's om foutdetails te retourneren voor mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.)

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.
code

string

De foutcode.
details

ErrorDetail[]

De foutdetails.
message

string

Het foutbericht.
target

string

Het foutdoel.

ErrorResponse

Object

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

Location

Object

Locatiegegevens.

Name Type Description
availabilityZoneMappings

AvailabilityZoneMappings[]

De toewijzingen van de beschikbaarheidszone voor deze regio.
displayName

string

De weergavenaam van de locatie.
id

string

De volledig gekwalificeerde id van de locatie. Bijvoorbeeld /subscriptions/8d65815f-a5b6-402f-9298-045155da7d74/locations/westus.
metadata

LocationMetadata

Metagegevens van de locatie, zoals lat/long, gekoppelde regio en andere.
name

string

De locatienaam.
regionalDisplayName

string

De weergavenaam van de locatie en de regio.
subscriptionId

string

De ID van het abonnement.
type

LocationType

Het locatietype.

LocationListResult

Object

Antwoord van de locatielijstbewerking.

Name Type Description
value

Location[]

Een matrix met locaties.

LocationMetadata

Object

Informatie over locatiemetagegevens

Name Type Description
geography

string

De geografie van de locatie.
geographyGroup

string

De geografische groep van de locatie.
homeLocation

string

De thuislocatie van een randzone.
latitude

string

De breedtegraad van de locatie.
longitude

string

De lengtegraad van de locatie.
pairedRegion

PairedRegion[]

De regio's die aan deze regio zijn gekoppeld.
physicalLocation

string

De fysieke locatie van de Azure-locatie.
regionCategory

RegionCategory

De categorie van de regio.
regionType

RegionType

Het type regio.

LocationType

Opsomming

Het locatietype.

Waarde Description
Region
EdgeZone

PairedRegion

Object

Informatie over gekoppelde regio's.

Name Type Description
id

string

De volledig gekwalificeerde id van de locatie. Bijvoorbeeld /subscriptions/8d65815f-a5b6-402f-9298-045155da7d74/locations/westus.
name

string

De naam van de gekoppelde regio.
subscriptionId

string

De ID van het abonnement.

RegionCategory

Opsomming

De categorie van de regio.

Waarde Description
Recommended
Extended
Other

RegionType

Opsomming

Het type regio.

Waarde Description
Physical
Logical