Subscriptions - List Locations

Kullanılabilir tüm coğrafi konumları alır.
Bu işlem, kaynak sağlayıcıları için kullanılabilen tüm konumları sağlar; ancak, her kaynak sağlayıcısı bu listenin bir alt kümesini destekleyemeyebilir.

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 Parametreleri

Name İçinde Gerekli Tür Description
subscriptionId
path True

string

Hedef aboneliğin kimliği.

api-version
query True

string

Bu işlem için kullanılacak API sürümü.

includeExtendedLocations
query

boolean

Genişletilmiş konumların dahil edilip edilmeyeceği.

Yanıtlar

Name Tür Description
200 OK

LocationListResult

Tamam - Bir konum dizisi döndürür.

Other Status Codes

CloudError

İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation kullanıcı hesabınızın kimliğine bürünme

Örnekler

GetLocationsWithASubscriptionId
GetLocationsWithExtendedLocations

GetLocationsWithASubscriptionId

Sample Request

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

Sample Response

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

Sample Request

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

Sample Response

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

Tanımlar

Name Description
AvailabilityZoneMappings

Bölge için kullanılabilirlik alanı eşlemeleri

CloudError

Kaynak yönetimi isteği için hata yanıtı.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Hata yanıtı

Location

Konum bilgileri.

LocationListResult

Konum listesi işlem yanıtı.

LocationMetadata

Konum meta verileri bilgileri

LocationType

Konum türü.

PairedRegion

Eşleştirilmiş bölgeyle ilgili bilgiler.

RegionCategory

Bölgenin kategorisi.

RegionType

Bölgenin türü.

AvailabilityZoneMappings

Bölge için kullanılabilirlik alanı eşlemeleri

Name Tür Description
logicalZone

string

Kullanılabilirlik alanı için mantıksal bölge kimliği

physicalZone

string

Mantıksal bölge kimliğinin eşlendiği kullanılabilirlik alanının tam fiziksel bölge kimliği

CloudError

Kaynak yönetimi isteği için hata yanıtı.

Name Tür Description
error

ErrorResponse

Hata yanıtı
Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıtı biçimini de izler.).

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

object

Ek bilgiler.

type

string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.

code

string

Hata kodu.

details

ErrorDetail[]

Hata ayrıntıları.

message

string

Hata iletisi.

target

string

Hata hedefi.

ErrorResponse

Hata yanıtı

Name Tür Description
error

ErrorDetail

Hata nesnesi.

Location

Konum bilgileri.

Name Tür Description
availabilityZoneMappings

AvailabilityZoneMappings[]

Bu bölge için kullanılabilirlik alanı eşlemeleri.

displayName

string

Konumun görünen adı.

id

string

Konumun tam kimliği. Örneğin, /subscriptions/8d65815f-a5b6-402f-9298-045155da7d74/locations/westus.

metadata

LocationMetadata

Lat/long, eşleştirilmiş bölge ve diğerleri gibi konumun meta verileri.

name

string

Konum adı.

regionalDisplayName

string

Konumun ve bölgesinin görünen adı.

subscriptionId

string

Abonelik kimliği.

type

LocationType

Konum türü.

LocationListResult

Konum listesi işlem yanıtı.

Name Tür Description
value

Location[]

Konum dizisi.

LocationMetadata

Konum meta verileri bilgileri

Name Tür Description
geography

string

Konumun coğrafyası.

geographyGroup

string

Konumun coğrafya grubu.

homeLocation

string

Kenar bölgesinin giriş konumu.

latitude

string

Konumun enlemi.

longitude

string

Konumun boylamı.

pairedRegion

PairedRegion[]

Bu bölgeyle eşleştirilmiş bölgeler.

physicalLocation

string

Azure konumunun fiziksel konumu.

regionCategory

RegionCategory

Bölgenin kategorisi.

regionType

RegionType

Bölgenin türü.

LocationType

Konum türü.

Name Tür Description
EdgeZone

string

Region

string

PairedRegion

Eşleştirilmiş bölgeyle ilgili bilgiler.

Name Tür Description
id

string

Konumun tam kimliği. Örneğin, /subscriptions/8d65815f-a5b6-402f-9298-045155da7d74/locations/westus.

name

string

Eşleştirilmiş bölgenin adı.

subscriptionId

string

Abonelik kimliği.

RegionCategory

Bölgenin kategorisi.

Name Tür Description
Extended

string

Other

string

Recommended

string

RegionType

Bölgenin türü.

Name Tür Description
Logical

string

Physical

string