Service - Region Configuration

服務:: Data Box

API 版本:: 2025-07-01

此 API 提供訂用帳戶層級特定特定區域/位置的組態詳細數據。

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DataBox/locations/{location}/regionConfiguration?api-version=2025-07-01

URI 參數

名稱	位於	必要	類型	Description
location	path	True	string minLength: 1	Azure 區域的名稱。
subscriptionId	path	True	string minLength: 1	目標訂用帳戶的標識碼。
api-version	query	True	string minLength: 1	要用於此作業的 API 版本。

要求本文

名稱	類型	Description
datacenterAddressRequest	DatacenterAddressRequest	要求本文以取得指定 SKU 的數據中心位址。
deviceCapabilityRequest	DeviceCapabilityRequest	要求本文以取得指定 SKU 的裝置功能。
scheduleAvailabilityRequest	ScheduleAvailabilityRequest: DataBoxScheduleAvailabilityRequest DiskScheduleAvailabilityRequest HeavyScheduleAvailabilityRequest	要求本文以取得排程訂單的可用性。
transportAvailabilityRequest	TransportAvailabilityRequest	要求本文以取得指定 SKU 的傳輸可用性。

回應

名稱	類型	Description
200 OK	RegionConfigurationResponse	要求已成功。
Other Status Codes	ApiError	未預期的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

RegionConfiguration

範例要求

HTTP

POST https://management.azure.com/subscriptions/YourSubscriptionId/providers/Microsoft.DataBox/locations/westus/regionConfiguration?api-version=2025-07-01

{
  "deviceCapabilityRequest": {
    "model": "DataBoxDisk",
    "skuName": "DataBoxDisk"
  },
  "scheduleAvailabilityRequest": {
    "model": "DataBox",
    "skuName": "DataBox",
    "storageLocation": "westus"
  }
}

範例回覆

狀態碼:: 200

{
  "deviceCapabilityResponse": {
    "deviceCapabilityDetails": [
      {
        "hardwareEncryption": "Enabled"
      }
    ]
  },
  "scheduleAvailabilityResponse": {
    "availableDates": [
      "2019-07-11T00:00:00+00:00",
      "2019-07-12T00:00:00+00:00",
      "2019-07-13T00:00:00+00:00",
      "2019-07-14T00:00:00+00:00",
      "2019-07-15T00:00:00+00:00",
      "2019-07-16T00:00:00+00:00",
      "2019-07-17T00:00:00+00:00",
      "2019-07-18T00:00:00+00:00",
      "2019-07-19T00:00:00+00:00",
      "2019-07-20T00:00:00+00:00",
      "2019-07-21T00:00:00+00:00",
      "2019-07-22T00:00:00+00:00",
      "2019-07-23T00:00:00+00:00",
      "2019-07-24T00:00:00+00:00",
      "2019-07-25T00:00:00+00:00",
      "2019-07-26T00:00:00+00:00",
      "2019-07-27T00:00:00+00:00",
      "2019-07-28T00:00:00+00:00",
      "2019-07-29T00:00:00+00:00",
      "2019-07-30T00:00:00+00:00",
      "2019-07-31T00:00:00+00:00"
    ]
  }
}

定義

名稱	Description
ApiError
DataBoxScheduleAvailabilityRequest	要求本文以取得排程數據箱訂單的可用性。
DatacenterAddressInstructionResponse	指定儲存位置的數據中心指示。
DatacenterAddressLocationResponse	指定儲存位置的數據中心位址。
DatacenterAddressRequest	要求本文以取得數據中心位址。
DatacenterAddressType	數據中心地址類型
Details
DeviceCapabilityDetails	指定區域的指定 SKU 的裝置功能詳細數據。
DeviceCapabilityRequest	要求本文以取得指定 SKU 的裝置功能。
DeviceCapabilityResponse	區域中指定 SKU 的裝置功能
DiskScheduleAvailabilityRequest	要求本文以取得排程磁碟訂單的可用性。
ErrorDetail
HardwareEncryption	指定區域指定 SKU 的硬體加密支援。
HeavyScheduleAvailabilityRequest	要求本文以取得排程繁重訂單的可用性。
ModelName	裝置版本和容量組合的客戶易記名稱。只有在訂購較新一代裝置時，才需要此字段，也就是截至 2025 年 2 月/2025 年 2 月的 AzureDataBox120 和 AzureDataBox525
RegionConfigurationRequest	要求本文以取得區域的組態。
RegionConfigurationResponse	特定區域的組態回應。
ScheduleAvailabilityResponse	排程區域中指定 SKU 的可用性。
SkuName	SKU 名稱。
TransportAvailabilityDetails	指定區域的傳輸選項可用性詳細數據。
TransportAvailabilityRequest	要求本文以取得指定 SKU 的傳輸可用性。
TransportAvailabilityResponse	區域中指定 SKU 可用的傳輸選項。
TransportShipmentTypes	指定區域支援的運輸出貨類型。

ApiError

Object

名稱	類型	Description
error	ErrorDetail	錯誤詳細數據。

DataBoxScheduleAvailabilityRequest

Object

要求本文以取得排程數據箱訂單的可用性。

名稱	類型	Description
country	string	應支援儲存位置的國家/地區。
model	ModelName	裝置版本和容量組合的客戶易記名稱。只有在訂購較新一代裝置時，才需要此字段，也就是截至 2025 年 2 月/2025 年 2 月的 AzureDataBox120 和 AzureDataBox525
skuName	string: DataBox	要排程訂單的 Sku 名稱。
storageLocation	string	數據傳輸的位置。如需位置檢查：`https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

DatacenterAddressInstructionResponse

Object

指定儲存位置的數據中心指示。

名稱	類型	Description
communicationInstruction	string	數據中心通訊指示
dataCenterAzureLocation	string	數據中心主要服務的 Azure 位置。
datacenterAddressType	string: DatacenterAddressInstruction	數據中心地址類型
supportedCarriersForReturnShipment	string[]	退貨的受支援貨運公司清單。

DatacenterAddressLocationResponse

Object

指定儲存位置的數據中心位址。

名稱	類型	Description
additionalShippingInformation	string	運送的特殊指示
addressType	string	位址類型
city	string	城市名稱
company	string	公司名稱
contactPersonName	string	聯繫人名稱
country	string	國家/地區名稱
dataCenterAzureLocation	string	數據中心主要服務的 Azure 位置。
datacenterAddressType	string: DatacenterAddressLocation	數據中心地址類型
phone	string	電話號碼
phoneExtension	string	電話擴充功能
state	string	狀態的名稱
street1	string	街道地址行 1
street2	string	街道地址行 2
street3	string	街道地址行 3
supportedCarriersForReturnShipment	string[]	退貨的受支援貨運公司清單。
zip	string	郵遞區號

DatacenterAddressRequest

Object

要求本文以取得數據中心位址。

名稱	類型	Description
model	ModelName	裝置版本和容量組合的客戶易記名稱。只有在訂購較新一代裝置時，才需要此字段，也就是截至 2025 年 2 月/2025 年 2 月的 AzureDataBox120 和 AzureDataBox525
skuName	SkuName	要求數據中心位址的 SKU 名稱。
storageLocation	string	儲存位置。如需位置檢查：`https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

DatacenterAddressType

列舉型別

數據中心地址類型

值	Description
DatacenterAddressLocation	資料中心位址位置。
DatacenterAddressInstruction	資料中心位址指令。

Details

Object

名稱	類型	Description
code	string	錯誤碼。
message	string	錯誤訊息。

DeviceCapabilityDetails

Object

指定區域的指定 SKU 的裝置功能詳細數據。

名稱	類型	Description
hardwareEncryption	HardwareEncryption	指定區域指定 SKU 的硬體加密支援。

DeviceCapabilityRequest

Object

要求本文以取得指定 SKU 的裝置功能。

名稱	類型	Description
model	ModelName	裝置版本和容量組合的客戶易記名稱。只有在訂購較新一代裝置時，才需要此字段，也就是截至 2025 年 2 月/2025 年 2 月的 AzureDataBox120 和 AzureDataBox525
skuName	SkuName	裝置的類型。

DeviceCapabilityResponse

Object

區域中指定 SKU 的裝置功能

名稱	類型	Description
deviceCapabilityDetails	DeviceCapabilityDetails[]	適用於指定區域和指定 SKU 的裝置功能清單

DiskScheduleAvailabilityRequest

Object

要求本文以取得排程磁碟訂單的可用性。

名稱	類型	Description
country	string	應支援儲存位置的國家/地區。
expectedDataSizeInTeraBytes	integer (int32)	此作業中需要以 TB 為單位傳輸的數據預期大小。
model	ModelName	裝置版本和容量組合的客戶易記名稱。只有在訂購較新一代裝置時，才需要此字段，也就是截至 2025 年 2 月/2025 年 2 月的 AzureDataBox120 和 AzureDataBox525
skuName	string: DataBoxDisk	要排程訂單的 Sku 名稱。
storageLocation	string	數據傳輸的位置。如需位置檢查：`https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

ErrorDetail

Object

名稱	類型	Description
code	string	錯誤碼。
details	Details[]	錯誤目標。
message	string	錯誤訊息。
target	string	其他錯誤資訊。

HardwareEncryption

列舉型別

指定區域指定 SKU 的硬體加密支援。

值	Description
Enabled	硬體型加密已啟用。
Disabled	硬體型加密已停用。

HeavyScheduleAvailabilityRequest

Object

要求本文以取得排程繁重訂單的可用性。

名稱	類型	Description
country	string	應支援儲存位置的國家/地區。
model	ModelName	裝置版本和容量組合的客戶易記名稱。只有在訂購較新一代裝置時，才需要此字段，也就是截至 2025 年 2 月/2025 年 2 月的 AzureDataBox120 和 AzureDataBox525
skuName	string: DataBoxHeavy	要排程訂單的 Sku 名稱。
storageLocation	string	數據傳輸的位置。如需位置檢查：`https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

ModelName

列舉型別

裝置版本和容量組合的客戶易記名稱。只有在訂購較新一代裝置時，才需要此字段，也就是截至 2025 年 2 月/2025 年 2 月的 AzureDataBox120 和 AzureDataBox525

值	Description
DataBox	數據箱。
DataBoxDisk	數據箱磁碟。
DataBoxHeavy	Data Box Heavy。
DataBoxCustomerDisk	數據箱客戶磁碟
AzureDataBox120	具有 120TB 可用容量的 Data Box V2。
AzureDataBox525	具有 525TB 可用容量的 Data Box V2。

RegionConfigurationRequest

Object

要求本文以取得區域的組態。

名稱	類型	Description
datacenterAddressRequest	DatacenterAddressRequest	要求本文以取得指定 SKU 的數據中心位址。
deviceCapabilityRequest	DeviceCapabilityRequest	要求本文以取得指定 SKU 的裝置功能。
scheduleAvailabilityRequest	ScheduleAvailabilityRequest: DataBoxScheduleAvailabilityRequest DiskScheduleAvailabilityRequest HeavyScheduleAvailabilityRequest	要求本文以取得排程訂單的可用性。
transportAvailabilityRequest	TransportAvailabilityRequest	要求本文以取得指定 SKU 的傳輸可用性。

RegionConfigurationResponse

Object

特定區域的組態回應。

名稱	類型	Description
datacenterAddressResponse	DatacenterAddressResponse: DatacenterAddressInstructionResponse DatacenterAddressLocationResponse	區域中指定 SKU 的數據中心位址。
deviceCapabilityResponse	DeviceCapabilityResponse	區域中指定 SKU 可用的裝置功能。
scheduleAvailabilityResponse	ScheduleAvailabilityResponse	排程區域中指定 SKU 的可用性。
transportAvailabilityResponse	TransportAvailabilityResponse	區域中指定 SKU 可用的傳輸選項。

ScheduleAvailabilityResponse

Object

排程區域中指定 SKU 的可用性。

名稱	類型	Description
availableDates	string[] (date-time)	可供排程的日期清單

SkuName

列舉型別

SKU 名稱。

值	Description
DataBox	數據箱。
DataBoxDisk	數據箱磁碟。
DataBoxHeavy	Data Box Heavy。
DataBoxCustomerDisk	數據箱客戶磁碟

TransportAvailabilityDetails

Object

指定區域的傳輸選項可用性詳細數據。

名稱	類型	Description
shipmentType	TransportShipmentTypes	指定區域支援的運輸出貨類型。

TransportAvailabilityRequest

Object

要求本文以取得指定 SKU 的傳輸可用性。

名稱	類型	Description
model	ModelName	裝置版本和容量組合的客戶易記名稱。只有在訂購較新一代裝置時，才需要此字段，也就是截至 2025 年 2 月/2025 年 2 月的 AzureDataBox120 和 AzureDataBox525
skuName	SkuName	裝置的類型。

TransportAvailabilityResponse

Object

區域中指定 SKU 可用的傳輸選項。

名稱	類型	Description
transportAvailabilityDetails	TransportAvailabilityDetails[]	指定區域的傳輸可用性詳細數據清單

TransportShipmentTypes

列舉型別

指定區域支援的運輸出貨類型。

值	Description
CustomerManaged	貨運物流由客戶處理。
MicrosoftManaged	貨運物流由Microsoft處理。

共用方式為

Service - Region Configuration

URI 參數

要求本文

回應

安全性

azure_auth

範圍

範例

RegionConfiguration

範例要求

範例回覆

定義

ApiError

DataBoxScheduleAvailabilityRequest

DatacenterAddressInstructionResponse

DatacenterAddressLocationResponse

DatacenterAddressRequest

DatacenterAddressType

Details

DeviceCapabilityDetails

DeviceCapabilityRequest

DeviceCapabilityResponse

DiskScheduleAvailabilityRequest

ErrorDetail

HardwareEncryption

HeavyScheduleAvailabilityRequest

ModelName

RegionConfigurationRequest

RegionConfigurationResponse

ScheduleAvailabilityResponse

SkuName

TransportAvailabilityDetails

TransportAvailabilityRequest

TransportAvailabilityResponse

TransportShipmentTypes