你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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 参数

名称	在	必需	类型	说明
location	path	True	string minLength: 1	Azure 区域的名称。
subscriptionId	path	True	string minLength: 1	目标订阅的 ID。
api-version	query	True	string minLength: 1	用于此作的 API 版本。

请求正文

名称	类型	说明
datacenterAddressRequest	DatacenterAddressRequest	请求正文以获取给定 SKU 的数据中心地址。
deviceCapabilityRequest	DeviceCapabilityRequest	请求正文以获取给定 SKU 的设备功能。
scheduleAvailabilityRequest	ScheduleAvailabilityRequest: DataBoxScheduleAvailabilityRequest DiskScheduleAvailabilityRequest HeavyScheduleAvailabilityRequest	请求正文以获取计划订单的可用性。
transportAvailabilityRequest	TransportAvailabilityRequest	请求正文以获取给定 SKU 的传输可用性。

响应

名称	类型	说明
200 OK	RegionConfigurationResponse	请求已成功。
Other Status Codes	ApiError	意外错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
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"
    ]
  }
}

定义

名称	说明
ApiError
DataBoxScheduleAvailabilityRequest	请求正文以获取计划数据框订单的可用性。
DatacenterAddressInstructionResponse	给定存储位置的数据中心说明。
DatacenterAddressLocationResponse	给定存储位置的数据中心地址。
DatacenterAddressRequest	请求正文以获取数据中心地址。
DatacenterAddressType	数据中心地址类型
Details
DeviceCapabilityDetails	给定区域的给定 SKU 的设备功能详细信息。
DeviceCapabilityRequest	请求正文以获取给定 SKU 的设备功能。
DeviceCapabilityResponse	区域中给定 SKU 的设备功能
DiskScheduleAvailabilityRequest	请求正文以获取计划磁盘订单的可用性。
ErrorDetail
HardwareEncryption	给定区域的给定 SKU 的硬件加密支持。
HeavyScheduleAvailabilityRequest	请求正文以获取计划重订单的可用性。
ModelName	设备的版本和容量组合的客户友好名称。此字段仅在订购较新的一代设备（即从 2025 年 2 月起的 AzureDataBox120 和 AzureDataBox525）时是必需的
RegionConfigurationRequest	请求正文以获取区域的配置。
RegionConfigurationResponse	特定于区域的配置响应。
ScheduleAvailabilityResponse	计划区域中给定 SKU 的可用性。
SkuName	SKU 名称。
TransportAvailabilityDetails	给定区域的传输选项可用性详细信息。
TransportAvailabilityRequest	请求正文以获取给定 SKU 的传输可用性。
TransportAvailabilityResponse	可用于区域中给定 SKU 的传输选项。
TransportShipmentTypes	给定区域支持的运输运输类型。

ApiError

Object

名称	类型	说明
error	ErrorDetail	错误详细信息。

DataBoxScheduleAvailabilityRequest

Object

请求正文以获取计划数据框订单的可用性。

名称	类型	说明
country	string	应支持存储位置的国家/地区。
model	ModelName	设备的版本和容量组合的客户友好名称。此字段仅在订购较新的一代设备（即从 2025 年 2 月起的 AzureDataBox120 和 AzureDataBox525）时是必需的
skuName	string: DataBox	要为其计划订单的 SKU 名称。
storageLocation	string	数据传输的位置。有关位置检查：`https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

DatacenterAddressInstructionResponse

Object

给定存储位置的数据中心说明。

名称	类型	说明
communicationInstruction	string	数据中心通信说明
dataCenterAzureLocation	string	数据中心主要提供服务的 Azure 位置。
datacenterAddressType	string: DatacenterAddressInstruction	数据中心地址类型
supportedCarriersForReturnShipment	string[]	返回货物的受支持运输商列表。

DatacenterAddressLocationResponse

Object

给定存储位置的数据中心地址。

名称	类型	说明
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

请求正文以获取数据中心地址。

名称	类型	说明
model	ModelName	设备的版本和容量组合的客户友好名称。此字段仅在订购较新的一代设备（即从 2025 年 2 月起的 AzureDataBox120 和 AzureDataBox525）时是必需的
skuName	SkuName	请求数据中心地址的 SKU 名称。
storageLocation	string	存储位置。有关位置检查：`https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

DatacenterAddressType

枚举

数据中心地址类型

值	说明
DatacenterAddressLocation	数据中心地址位置。
DatacenterAddressInstruction	数据中心地址指令。

Details

Object

名称	类型	说明
code	string	错误代码。
message	string	错误消息。

DeviceCapabilityDetails

Object

给定区域的给定 SKU 的设备功能详细信息。

名称	类型	说明
hardwareEncryption	HardwareEncryption	给定区域的给定 SKU 的硬件加密支持。

DeviceCapabilityRequest

Object

请求正文以获取给定 SKU 的设备功能。

名称	类型	说明
model	ModelName	设备的版本和容量组合的客户友好名称。此字段仅在订购较新的一代设备（即从 2025 年 2 月起的 AzureDataBox120 和 AzureDataBox525）时是必需的
skuName	SkuName	设备的类型。

DeviceCapabilityResponse

Object

区域中给定 SKU 的设备功能

名称	类型	说明
deviceCapabilityDetails	DeviceCapabilityDetails[]	适用于给定区域和给定 SKU 的设备功能列表

DiskScheduleAvailabilityRequest

Object

请求正文以获取计划磁盘订单的可用性。

名称	类型	说明
country	string	应支持存储位置的国家/地区。
expectedDataSizeInTeraBytes	integer (int32)	需要在此作业中传输的数据的预期大小（以 TB 为单位）。
model	ModelName	设备的版本和容量组合的客户友好名称。此字段仅在订购较新的一代设备（即从 2025 年 2 月起的 AzureDataBox120 和 AzureDataBox525）时是必需的
skuName	string: DataBoxDisk	要为其计划订单的 SKU 名称。
storageLocation	string	数据传输的位置。有关位置检查：`https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

ErrorDetail

Object

名称	类型	说明
code	string	错误代码。
details	Details[]	错误目标。
message	string	错误消息。
target	string	其他错误信息。

HardwareEncryption

枚举

给定区域的给定 SKU 的硬件加密支持。

值	说明
Enabled	已启用基于硬件的加密。
Disabled	禁用基于硬件的加密。

HeavyScheduleAvailabilityRequest

Object

请求正文以获取计划重订单的可用性。

名称	类型	说明
country	string	应支持存储位置的国家/地区。
model	ModelName	设备的版本和容量组合的客户友好名称。此字段仅在订购较新的一代设备（即从 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 月起的 AzureDataBox120 和 AzureDataBox525）时是必需的

值	说明
DataBox	Data Box。
DataBoxDisk	Data Box Disk。
DataBoxHeavy	Data Box Heavy。
DataBoxCustomerDisk	Data Box 客户磁盘
AzureDataBox120	具有 120TB 可用容量的 Data Box V2。
AzureDataBox525	具有 525TB 可用容量的 Data Box V2。

RegionConfigurationRequest

Object

请求正文以获取区域的配置。

名称	类型	说明
datacenterAddressRequest	DatacenterAddressRequest	请求正文以获取给定 SKU 的数据中心地址。
deviceCapabilityRequest	DeviceCapabilityRequest	请求正文以获取给定 SKU 的设备功能。
scheduleAvailabilityRequest	ScheduleAvailabilityRequest: DataBoxScheduleAvailabilityRequest DiskScheduleAvailabilityRequest HeavyScheduleAvailabilityRequest	请求正文以获取计划订单的可用性。
transportAvailabilityRequest	TransportAvailabilityRequest	请求正文以获取给定 SKU 的传输可用性。

RegionConfigurationResponse

Object

特定于区域的配置响应。

名称	类型	说明
datacenterAddressResponse	DatacenterAddressResponse: DatacenterAddressInstructionResponse DatacenterAddressLocationResponse	区域中给定 SKU 的数据中心地址。
deviceCapabilityResponse	DeviceCapabilityResponse	区域中给定 SKU 可用的设备功能。
scheduleAvailabilityResponse	ScheduleAvailabilityResponse	计划区域中给定 SKU 的可用性。
transportAvailabilityResponse	TransportAvailabilityResponse	可用于区域中给定 SKU 的传输选项。

ScheduleAvailabilityResponse

Object

计划区域中给定 SKU 的可用性。

名称	类型	说明
availableDates	string[] (date-time)	计划可用的日期列表

SkuName

枚举

SKU 名称。

值	说明
DataBox	Data Box。
DataBoxDisk	Data Box Disk。
DataBoxHeavy	Data Box Heavy。
DataBoxCustomerDisk	Data Box 客户磁盘

TransportAvailabilityDetails

Object

给定区域的传输选项可用性详细信息。

名称	类型	说明
shipmentType	TransportShipmentTypes	给定区域支持的运输运输类型。

TransportAvailabilityRequest

Object

请求正文以获取给定 SKU 的传输可用性。

名称	类型	说明
model	ModelName	设备的版本和容量组合的客户友好名称。此字段仅在订购较新的一代设备（即从 2025 年 2 月起的 AzureDataBox120 和 AzureDataBox525）时是必需的
skuName	SkuName	设备的类型。

TransportAvailabilityResponse

Object

可用于区域中给定 SKU 的传输选项。

名称	类型	说明
transportAvailabilityDetails	TransportAvailabilityDetails[]	给定区域的传输可用性详细信息列表

TransportShipmentTypes

枚举

给定区域支持的运输运输类型。

值	说明
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