Subscriptions - List Locations

Dienst:: Resource Management

API-Version:: 2022-12-01

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

Mit optionalen Parametern:

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

HTTP

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

Beispiel für eine Antwort

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

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

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

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

Objekt

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

Objekt

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

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

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

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

Location

Objekt

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

Objekt

Antwort des Standortlistenvorgangs.

Name	Typ	Beschreibung
value	Location[]	Ein Array von Speicherorten.

LocationMetadata

Objekt

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

Enumeration

Der Speicherorttyp.

Wert	Beschreibung
Region
EdgeZone

PairedRegion

Objekt

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

Enumeration

Die Kategorie der Region.

Wert	Beschreibung
Recommended
Extended
Other

RegionType

Enumeration

Der Typ der Region.

Wert	Beschreibung
Physical
Logical

Freigeben über

Subscriptions - List Locations

URI-Parameter

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

GetLocationsWithASubscriptionId

Beispielanforderung

Beispiel für eine Antwort

GetLocationsWithExtendedLocations

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AvailabilityZoneMappings

CloudError

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Location

LocationListResult

LocationMetadata

LocationType

PairedRegion

RegionCategory

RegionType