Delen via


Subscriptions - List Locations

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
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

{
  "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

{
  "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

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

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

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het extra informatietype.

ErrorDetail

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

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

Location

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

Antwoord van de locatielijstbewerking.

Name Type Description
value

Location[]

Een matrix met locaties.

LocationMetadata

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

Het locatietype.

Waarde Description
EdgeZone
Region

PairedRegion

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

De categorie van de regio.

Waarde Description
Extended
Other
Recommended

RegionType

Het type regio.

Waarde Description
Logical
Physical