Subscriptions - List Locations

Mendapatkan semua lokasi geografis yang tersedia.
Operasi ini menyediakan semua lokasi yang tersedia untuk penyedia sumber daya; namun, setiap penyedia sumber daya dapat mendukung subset daftar ini.

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}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
subscriptionId
path True

string

ID langganan target.

api-version
query True

string

Versi API yang digunakan untuk operasi ini.

includeExtendedLocations
query

boolean

Apakah akan menyertakan lokasi yang diperluas.

Respons

Nama Jenis Deskripsi
200 OK

LocationListResult

OK - Mengembalikan array lokasi.

Other Status Codes

CloudError

Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

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

Scopes

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

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

Definisi

Nama Deskripsi
AvailabilityZoneMappings

Pemetaan zona ketersediaan untuk wilayah tersebut

CloudError

Respons kesalahan untuk permintaan manajemen sumber daya.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Respons kesalahan

Location

Informasi lokasi.

LocationListResult

Respons operasi daftar lokasi.

LocationMetadata

Informasi metadata lokasi

LocationType

Jenis lokasi.

PairedRegion

Informasi mengenai wilayah yang dipasangkan.

RegionCategory

Kategori wilayah.

RegionType

Jenis wilayah.

AvailabilityZoneMappings

Pemetaan zona ketersediaan untuk wilayah tersebut

Nama Jenis Deskripsi
logicalZone

string

Id zona logis untuk zona ketersediaan

physicalZone

string

Id zona fisik zona ketersediaan yang sepenuhnya memenuhi syarat tempat id zona logis dipetakan

CloudError

Respons kesalahan untuk permintaan manajemen sumber daya.

Nama Jenis Deskripsi
error

ErrorResponse

Respons kesalahan
Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.).

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama Jenis Deskripsi
info

object

Info tambahan.

type

string

Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Detail kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan.

ErrorResponse

Respons kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

Objek kesalahan.

Location

Informasi lokasi.

Nama Jenis Deskripsi
availabilityZoneMappings

AvailabilityZoneMappings[]

Pemetaan zona ketersediaan untuk wilayah ini.

displayName

string

Nama tampilan lokasi.

id

string

ID lokasi yang sepenuhnya memenuhi syarat. Misalnya, /subscriptions/8d65815f-a5b6-402f-9298-045155da7d74/locations/westus.

metadata

LocationMetadata

Metadata lokasi, seperti lat/long, wilayah berpasangan, dan lainnya.

name

string

Nama lokasi.

regionalDisplayName

string

Nama tampilan lokasi dan wilayahnya.

subscriptionId

string

ID langganan.

type

LocationType

Jenis lokasi.

LocationListResult

Respons operasi daftar lokasi.

Nama Jenis Deskripsi
value

Location[]

Array lokasi.

LocationMetadata

Informasi metadata lokasi

Nama Jenis Deskripsi
geography

string

Geografi lokasi.

geographyGroup

string

Grup geografi lokasi.

homeLocation

string

Lokasi rumah zona tepi.

latitude

string

Garis lintang lokasi.

longitude

string

Garis bujur lokasi.

pairedRegion

PairedRegion[]

Wilayah yang dipasangkan ke wilayah ini.

physicalLocation

string

Lokasi fisik lokasi Azure.

regionCategory

RegionCategory

Kategori wilayah.

regionType

RegionType

Jenis wilayah.

LocationType

Jenis lokasi.

Nama Jenis Deskripsi
EdgeZone

string

Region

string

PairedRegion

Informasi mengenai wilayah yang dipasangkan.

Nama Jenis Deskripsi
id

string

ID lokasi yang sepenuhnya memenuhi syarat. Misalnya, /subscriptions/8d65815f-a5b6-402f-9298-045155da7d74/locations/westus.

name

string

Nama wilayah yang dipasangkan.

subscriptionId

string

ID langganan.

RegionCategory

Kategori wilayah.

Nama Jenis Deskripsi
Extended

string

Other

string

Recommended

string

RegionType

Jenis wilayah.

Nama Jenis Deskripsi
Logical

string

Physical

string