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 パラメーター

名前 / 必須 型 説明
subscriptionId
path True

string (uuid)

ターゲット サブスクリプションの ID。 値は UUID である必要があります。

api-version
query True

string

minLength: 1

この操作に使用する API バージョン。

includeExtendedLocations
query

boolean

拡張された場所を含めるかどうか。

応答

名前 型 説明
200 OK

LocationListResult

Azureの運用は無事に完了しました。

Other Status Codes

CloudError

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

例

GetLocationsWithASubscriptionId
GetLocationsWithExtendedLocations

GetLocationsWithASubscriptionId

要求のサンプル

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

応答のサンプル

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

要求のサンプル

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

応答のサンプル

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

定義

名前 説明
AvailabilityZoneMappings

リージョンの可用性ゾーン マッピング

CloudError

リソース管理要求のエラー応答。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

Location

場所の情報。

LocationListResult

場所一覧の操作応答。

LocationMetadata

場所メタデータ情報

LocationType

場所の種類。

PairedRegion

ペアリージョンに関する情報。

RegionCategory

リージョンのカテゴリ。

RegionType

リージョンの種類。

AvailabilityZoneMappings

リージョンの可用性ゾーン マッピング

名前 型 説明
logicalZone

string

可用性ゾーンの論理ゾーン ID

physicalZone

string

論理ゾーン ID がマップされる可用性ゾーンの完全修飾物理ゾーン ID

CloudError

リソース管理要求のエラー応答。

名前 型 説明
error

ErrorResponse

エラー応答
失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API の一般的なエラー応答。 (これは、OData エラー応答形式にも従います)。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前 型 説明
info

object

追加情報。

type

string

追加情報の種類。

ErrorDetail

エラーの詳細。

名前 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細。

message

string

エラー メッセージ。

target

string

エラーターゲット。

ErrorResponse

エラー応答

名前 型 説明
error

ErrorDetail

エラー オブジェクト。

Location

場所の情報。

名前 型 説明
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

場所一覧の操作応答。

名前 型 説明
nextLink

string

次の結果セットを取得する URL。

value

Location[]

場所の配列。

LocationMetadata

場所メタデータ情報

名前 型 説明
geography

string

場所の地理。

geographyGroup

string

場所の geography グループ。

homeLocation

string

エッジ ゾーンのホーム位置。

latitude

string

場所の緯度。

longitude

string

場所の経度。

pairedRegion

PairedRegion[]

このリージョンとペアになっているリージョン。

physicalLocation

string

Azure の場所の物理的な場所。

regionCategory

RegionCategory

リージョンのカテゴリ。

regionType

RegionType

リージョンの種類。

LocationType

場所の種類。

値 説明
Region

リージョン

EdgeZone

エッジゾーン

PairedRegion

ペアリージョンに関する情報。

名前 型 説明
id

string

場所の完全修飾 ID。 たとえば、/subscriptions/8d65815f-a5b6-402f-9298-045155da7d74/locations/westus などです。

name

string

ペアのリージョンの名前。

subscriptionId

string

サブスクリプション ID。

RegionCategory

リージョンのカテゴリ。

値 説明
Recommended

推奨

Extended

延長された

Other

その他

RegionType

リージョンの種類。

値 説明
Physical

物理的

Logical

Logical