다음을 통해 공유


Subscriptions - List Locations

사용 가능한 모든 지역 위치를 가져옵니다.
이 작업은 리소스 공급자에 사용할 수 있는 모든 위치를 제공합니다. 그러나 각 리소스 공급자는 이 목록의 하위 집합을 지원할 수 있습니다.

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 매개 변수

Name In(다음 안에) 필수 형식 Description
subscriptionId
path True

string

대상 구독의 ID입니다.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

includeExtendedLocations
query

boolean

확장된 위치를 포함할지 여부입니다.

응답

Name 형식 Description
200 OK

LocationListResult

확인 - 위치 배열을 반환합니다.

Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

GetLocationsWithASubscriptionId
GetLocationsWithExtendedLocations

GetLocationsWithASubscriptionId

샘플 요청

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

샘플 응답

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

샘플 요청

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

샘플 응답

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

정의

Name Description
AvailabilityZoneMappings

지역에 대한 가용성 영역 매핑

CloudError

리소스 관리 요청에 대한 오류 응답입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

Location

위치 정보

LocationListResult

위치 목록 작업 응답입니다.

LocationMetadata

위치 메타데이터 정보

LocationType

위치 유형입니다.

PairedRegion

쌍을 이루는 지역에 대한 정보입니다.

RegionCategory

지역의 범주입니다.

RegionType

영역의 형식입니다.

AvailabilityZoneMappings

지역에 대한 가용성 영역 매핑

Name 형식 Description
logicalZone

string

가용성 영역에 대한 논리 영역 ID

physicalZone

string

논리 영역 ID가 매핑되는 가용성 영역의 정규화된 물리적 영역 ID

CloudError

리소스 관리 요청에 대한 오류 응답입니다.

Name 형식 Description
error

ErrorResponse

오류 응답
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. OData 오류 응답 형식도 따릅니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

Error 개체.

Location

위치 정보

Name 형식 Description
availabilityZoneMappings

AvailabilityZoneMappings[]

이 지역의 가용성 영역 매핑입니다.

displayName

string

위치의 표시 이름입니다.

id

string

위치의 정규화된 ID입니다. 예를 들어 /subscriptions/8d65815f-a5b6-402f-9298-045155da7d74/locations/westus입니다.

metadata

LocationMetadata

위치의 메타데이터(예: 위도/길이, 쌍을 이루는 지역 등)

name

string

위치 이름입니다.

regionalDisplayName

string

위치 및 해당 지역의 표시 이름입니다.

subscriptionId

string

구독 ID입니다.

type

LocationType

위치 유형입니다.

LocationListResult

위치 목록 작업 응답입니다.

Name 형식 Description
value

Location[]

위치의 배열입니다.

LocationMetadata

위치 메타데이터 정보

Name 형식 Description
geography

string

위치의 지리입니다.

geographyGroup

string

위치의 지리 그룹입니다.

homeLocation

string

에지 영역의 홈 위치입니다.

latitude

string

위치의 위도입니다.

longitude

string

위치의 경도입니다.

pairedRegion

PairedRegion[]

이 지역에 쌍을 이루는 지역입니다.

physicalLocation

string

Azure 위치의 물리적 위치입니다.

regionCategory

RegionCategory

지역의 범주입니다.

regionType

RegionType

영역의 형식입니다.

LocationType

위치 유형입니다.

Name 형식 Description
EdgeZone

string

Region

string

PairedRegion

쌍을 이루는 지역에 대한 정보입니다.

Name 형식 Description
id

string

위치의 정규화된 ID입니다. 예를 들어 /subscriptions/8d65815f-a5b6-402f-9298-045155da7d74/locations/westus입니다.

name

string

쌍을 이루는 지역의 이름입니다.

subscriptionId

string

구독 ID입니다.

RegionCategory

지역의 범주입니다.

Name 형식 Description
Extended

string

Other

string

Recommended

string

RegionType

영역의 형식입니다.

Name 형식 Description
Logical

string

Physical

string