Subscriptions - List Locations

Hizmet:: Resource Management

API Sürümü:: 2022-12-01

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

İsteğe bağlı parametrelerle:

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 (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	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	Azure işlemi başarıyla tamamlandı.
Other Status Codes	CloudError	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

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

Örnekler

GetLocationsWithASubscriptionId

GetLocationsWithExtendedLocations

GetLocationsWithASubscriptionId

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.resource.subscriptions import SubscriptionClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-resource-subscriptions
# USAGE
    python get_locations.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SubscriptionClient(
        credential=DefaultAzureCredential(),
    )

    response = client.subscriptions.list_locations(
        subscription_id="a1ffc958-d2c7-493e-9f1e-125a0477f536",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/subscriptions/stable/2022-12-01/examples/GetLocations.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Örnek yanıt

Durum kodu:: 200

{
  "value": [
    {
      "name": "eastus",
      "type": "Region",
      "availabilityZoneMappings": [
        {
          "logicalZone": "1",
          "physicalZone": "eastus-az1"
        },
        {
          "logicalZone": "2",
          "physicalZone": "eastus-az3"
        },
        {
          "logicalZone": "3",
          "physicalZone": "eastus-az2"
        }
      ],
      "displayName": "East US",
      "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/eastus",
      "metadata": {
        "geography": "United States",
        "geographyGroup": "US",
        "latitude": "37.3719",
        "longitude": "-79.8164",
        "pairedRegion": [
          {
            "name": "westus",
            "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/westus"
          }
        ],
        "physicalLocation": "Virginia",
        "regionCategory": "Recommended",
        "regionType": "Physical"
      },
      "regionalDisplayName": "(US) East US"
    },
    {
      "name": "eastus2",
      "type": "Region",
      "availabilityZoneMappings": [
        {
          "logicalZone": "1",
          "physicalZone": "eastus2-az1"
        },
        {
          "logicalZone": "2",
          "physicalZone": "eastus2-az3"
        },
        {
          "logicalZone": "3",
          "physicalZone": "eastus2-az2"
        }
      ],
      "displayName": "East US 2",
      "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/eastus2",
      "metadata": {
        "geography": "United States",
        "geographyGroup": "US",
        "latitude": "36.6681",
        "longitude": "-78.3889",
        "pairedRegion": [
          {
            "name": "centralus",
            "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/centralus"
          }
        ],
        "physicalLocation": "Virginia",
        "regionCategory": "Recommended",
        "regionType": "Physical"
      },
      "regionalDisplayName": "(US) East US 2"
    }
  ]
}

GetLocationsWithExtendedLocations

Örnek isteği

HTTP
Python

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.resource.subscriptions import SubscriptionClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-resource-subscriptions
# USAGE
    python get_locations_with_extended_locations.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SubscriptionClient(
        credential=DefaultAzureCredential(),
    )

    response = client.subscriptions.list_locations(
        subscription_id="a1ffc958-d2c7-493e-9f1e-125a0477f536",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/subscriptions/stable/2022-12-01/examples/GetLocationsWithExtendedLocations.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Örnek yanıt

Durum kodu:: 200

{
  "value": [
    {
      "name": "eastus",
      "type": "Region",
      "availabilityZoneMappings": [
        {
          "logicalZone": "1",
          "physicalZone": "eastus-az1"
        },
        {
          "logicalZone": "2",
          "physicalZone": "eastus-az3"
        },
        {
          "logicalZone": "3",
          "physicalZone": "eastus-az2"
        }
      ],
      "displayName": "East US",
      "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/eastus",
      "metadata": {
        "geography": "United States",
        "geographyGroup": "US",
        "latitude": "37.3719",
        "longitude": "-79.8164",
        "pairedRegion": [
          {
            "name": "westus",
            "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/westus"
          }
        ],
        "physicalLocation": "Virginia",
        "regionCategory": "Recommended",
        "regionType": "Physical"
      },
      "regionalDisplayName": "(US) East US"
    },
    {
      "name": "eastus2",
      "type": "Region",
      "availabilityZoneMappings": [
        {
          "logicalZone": "1",
          "physicalZone": "eastus2-az1"
        },
        {
          "logicalZone": "2",
          "physicalZone": "eastus2-az3"
        },
        {
          "logicalZone": "3",
          "physicalZone": "eastus2-az2"
        }
      ],
      "displayName": "East US 2",
      "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/eastus2",
      "metadata": {
        "geography": "United States",
        "geographyGroup": "US",
        "latitude": "36.6681",
        "longitude": "-78.3889",
        "pairedRegion": [
          {
            "name": "centralus",
            "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/centralus"
          }
        ],
        "physicalLocation": "Virginia",
        "regionCategory": "Recommended",
        "regionType": "Physical"
      },
      "regionalDisplayName": "(US) East US 2"
    },
    {
      "name": "ezecustomerlabboston1",
      "type": "EdgeZone",
      "displayName": "EZE Customer Lab Boston 1",
      "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/eastus/edgeZones/ezecustomerlabboston1",
      "metadata": {
        "geography": "United States",
        "geographyGroup": "US",
        "latitude": "42.301218",
        "longitude": "-71.219038",
        "regionCategory": "Extended",
        "regionType": "Physical"
      },
      "regionalDisplayName": "(US) EZE Customer Lab Boston 1"
    },
    {
      "name": "ezecustomerlabhouston1",
      "type": "EdgeZone",
      "displayName": "EZE Customer Lab Houston 1",
      "id": "/subscriptions/a1ffc958-d2c7-493e-9f1e-125a0477f536/locations/southcentralus/edgeZones/ezecustomerlabhouston1",
      "metadata": {
        "geography": "United States",
        "geographyGroup": "US",
        "latitude": "29.9411",
        "longitude": "-95.41452",
        "regionCategory": "Extended",
        "regionType": "Physical"
      },
      "regionalDisplayName": "(US) EZE Customer Lab Houston 1"
    }
  ]
}

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 veri bilgileri
LocationType	Konum türü.
PairedRegion	Eşleştirilmiş bölgeyle ilgili bilgiler.
RegionCategory	Bölgenin kategorisi.
RegionType	Bölgenin türü.

AvailabilityZoneMappings

Nesne

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

Nesne

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

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

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

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

Location

Nesne

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

Nesne

Konum listesi işlem yanıtı.

Name	Tür	Description
nextLink	string	Sonraki sonuç kümesini almak için URL.
value	Location[]	Konum dizisi.

LocationMetadata

Nesne

Konum meta veri bilgileri

Name	Tür	Description
geography	string	Konumun coğrafyası.
geographyGroup	string	Konumun coğrafya grubu.
homeLocation	string	Bir kenar bölgesinin giriş konumu.
latitude	string	Konumun enlemi.
longitude	string	Konumun boylamı.
pairedRegion	PairedRegion[]	Bu bölgeyle eşleştirilen bölgeler.
physicalLocation	string	Azure konumunun fiziksel konumu.
regionCategory	RegionCategory	Bölgenin kategorisi.
regionType	RegionType	Bölgenin türü.

LocationType

Numaralandırma

Konum türü.

Değer	Description
Region	Bölge
EdgeZone	EdgeZone

PairedRegion

Nesne

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

Numaralandırma

Bölgenin kategorisi.

Değer	Description
Recommended	Önerilir
Extended	Genişletilmiş
Other	Other

RegionType

Numaralandırma

Bölgenin türü.

Değer	Description
Physical	Fiziksel
Logical	Logical