Freigeben über


Subscriptions - List Locations

Ruft alle verfügbaren geografischen Standorte ab.
Dieser Vorgang stellt alle Speicherorte 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

Die ID des Zielabonnements.

api-version
query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

includeExtendedLocations
query

boolean

Gibt an, ob erweiterte Speicherorte eingeschlossen werden sollen.

Antworten

Name Typ Beschreibung
200 OK

LocationListResult

OK : Gibt ein Array von Speicherorten zurück.

Other Status Codes

CloudError

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

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

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

Location

Standortinformationen.

LocationListResult

Antwort des Standortlistenvorgangs.

LocationMetadata

Standortmetadateninformationen

LocationType

Der Speicherorttyp.

PairedRegion

Informationen zu gekoppelter Region.

RegionCategory

Die Kategorie der Region.

RegionType

Der Typ der Region.

AvailabilityZoneMappings

Verfügbarkeitszonenzuordnungen für die Region

Name Typ Beschreibung
logicalZone

string

Die logische Zonen-ID für die Verfügbarkeitszone

physicalZone

string

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

CloudError

Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.

Name Typ Beschreibung
error

ErrorResponse

Fehlerantwort
Häufige Fehlerantwort für alle Azure Resource Manager-APIs, um Fehlerdetails für fehlgeschlagene Vorgänge zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

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 Speicherorts. 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 der Position und des zugehörigen Bereichs.

subscriptionId

string

Die Abonnement-ID.

type

LocationType

Der Speicherorttyp.

LocationListResult

Antwort des Standortlistenvorgangs.

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 Startort einer Edgezone.

latitude

string

Der Breitengrad des Standorts.

longitude

string

Der Längengrad des Standorts.

pairedRegion

PairedRegion[]

Die Regionen, die mit dieser Region gekoppelt sind.

physicalLocation

string

Der physische Standort des Azure-Standorts.

regionCategory

RegionCategory

Die Kategorie der Region.

regionType

RegionType

Der Typ der Region.

LocationType

Der Speicherorttyp.

Wert Beschreibung
EdgeZone
Region

PairedRegion

Informationen zu gekoppelter Region.

Name Typ Beschreibung
id

string

Die vollqualifizierte ID des Speicherorts. 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.

Wert Beschreibung
Extended
Other
Recommended

RegionType

Der Typ der Region.

Wert Beschreibung
Logical
Physical