Subscriptions - List Locations

Ruft alle verfügbaren geografischen Standorte ab.
Dieser Vorgang stellt alle Standorte bereit, die für Ressourcenanbieter verfügbar sind. Jeder Ressourcenanbieter unterstützt jedoch möglicherweise eine Teilmenge dieser Liste.

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

Name In Erforderlich Typ Beschreibung
subscriptionId
path True

string

Hierbei handelt es sich um die ID des Zielabonnements.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

includeExtendedLocations
query

boolean

Gibt an, ob erweiterte Standorte einbezogen werden sollen.

Antworten

Name Typ Beschreibung
200 OK

LocationListResult

OK: Gibt ein Array von Speicherorten zurück.

Other Status Codes

CloudError

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

GetLocationsWithASubscriptionId
GetLocationsWithExtendedLocations

GetLocationsWithASubscriptionId

Beispielanforderung

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

Beispiel für eine Antwort

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

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
AvailabilityZoneMappings

Verfügbarkeitszonenzuordnungen für die Region

CloudError

Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

Location

Standortinformationen

LocationListResult

Antwort des Vorgangs "Standortliste".

LocationMetadata

Standortmetadateninformationen

LocationType

Der Standorttyp.

PairedRegion

Informationen zur gekoppelten Region.

RegionCategory

Die Kategorie der Region.

RegionType

Der Typ der Region.

AvailabilityZoneMappings

Verfügbarkeitszonenzuordnungen für die Region

Name Typ Beschreibung
logicalZone

string

Die ID der logischen Zone für die Verfügbarkeitszone

physicalZone

string

Die vollqualifizierte physische Zonen-ID der Verfügbarkeitszone, der die ID der logischen Zone zugeordnet ist

CloudError

Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.

Name Typ Beschreibung
error

ErrorResponse

Fehlerantwort
Allgemeine Fehlerantwort für alle Azure Resource Manager-APIs, zur Rückgabe von Fehlerdetails für fehlgeschlagene Vorgänge. (Dies folgt auch dem OData-Fehlerantwortformat.)

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

Location

Standortinformationen

Name Typ Beschreibung
availabilityZoneMappings

AvailabilityZoneMappings[]

Die Verfügbarkeitszonenzuordnungen für diese Region.

displayName

string

Der Anzeigename des Speicherorts.

id

string

Die vollqualifizierte ID des Standorts. Beispiel: /subscriptions/8d65815f-a5b6-402f-9298-045155da7d74/locations/westus.

metadata

LocationMetadata

Metadaten des Speicherorts, z. B. lat/long, gekoppelte Region und andere.

name

string

Der Name des Speicherorts.

regionalDisplayName

string

Der Anzeigename des Standorts und seiner Region.

subscriptionId

string

Die Abonnement-ID.

type

LocationType

Der Standorttyp.

LocationListResult

Antwort des Vorgangs "Standortliste".

Name Typ Beschreibung
value

Location[]

Ein Array von Speicherorten.

LocationMetadata

Standortmetadateninformationen

Name Typ Beschreibung
geography

string

Die Geografie des Standorts.

geographyGroup

string

Die Geografiegruppe des Standorts.

homeLocation

string

Der Startstandort einer Edgezone.

latitude

string

Die Breitenkoordinate der Position.

longitude

string

Die Längenkoordinate der Position.

pairedRegion

PairedRegion[]

Die mit dieser Region gekoppelten Regionen.

physicalLocation

string

Der physische Standort des Azure-Standorts.

regionCategory

RegionCategory

Die Kategorie der Region.

regionType

RegionType

Der Typ der Region.

LocationType

Der Standorttyp.

Name Typ Beschreibung
EdgeZone

string

Region

string

PairedRegion

Informationen zur gekoppelten Region.

Name Typ Beschreibung
id

string

Die vollqualifizierte ID des Standorts. Beispiel: /subscriptions/8d65815f-a5b6-402f-9298-045155da7d74/locations/westus.

name

string

Der Name des gekoppelten Bereichs.

subscriptionId

string

Die Abonnement-ID.

RegionCategory

Die Kategorie der Region.

Name Typ Beschreibung
Extended

string

Other

string

Recommended

string

RegionType

Der Typ der Region.

Name Typ Beschreibung
Logical

string

Physical

string