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

Name	In(다음 안에)	필수	형식	Description
location	path	True	string minLength: 1	Azure 지역의 이름입니다.
subscriptionId	path	True	string minLength: 1	대상 구독의 ID입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
datacenterAddressRequest	DatacenterAddressRequest	지정된 sku에 대한 데이터 센터 주소를 가져오기 위한 요청 본문입니다.
deviceCapabilityRequest	DeviceCapabilityRequest	지정된 sku에 대한 디바이스 기능을 가져오기 위해 본문을 요청합니다.
scheduleAvailabilityRequest	ScheduleAvailabilityRequest: DataBoxScheduleAvailabilityRequest DiskScheduleAvailabilityRequest HeavyScheduleAvailabilityRequest	주문 예약에 대한 가용성을 가져오기 위한 요청 본문입니다.
transportAvailabilityRequest	TransportAvailabilityRequest	지정된 sku에 대한 전송 가용성을 가져오기 위한 요청 본문입니다.

응답

Name	형식	Description
200 OK	RegionConfigurationResponse	요청이 성공했습니다.
Other Status Codes	ApiError	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

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

범위

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

정의

Name	Description
ApiError
DataBoxScheduleAvailabilityRequest	데이터 상자 주문 주문 예약에 대한 가용성을 가져오기 위한 요청 본문입니다.
DatacenterAddressInstructionResponse	지정된 스토리지 위치에 대한 데이터 센터 명령입니다.
DatacenterAddressLocationResponse	지정된 스토리지 위치에 대한 데이터 센터 주소입니다.
DatacenterAddressRequest	데이터 센터 주소를 가져오기 위한 요청 본문입니다.
DatacenterAddressType	데이터 센터 주소 유형
Details
DeviceCapabilityDetails	지정된 지역에 대한 지정된 sku에 대한 디바이스 기능 세부 정보입니다.
DeviceCapabilityRequest	지정된 sku에 대한 디바이스 기능을 가져오기 위해 본문을 요청합니다.
DeviceCapabilityResponse	지역에서 지정된 sku에 대한 디바이스 기능
DiskScheduleAvailabilityRequest	디스크 주문 예약에 대한 가용성을 가져오기 위한 요청 본문입니다.
ErrorDetail
HardwareEncryption	지정된 지역에 대해 지정된 sku에 대한 하드웨어 암호화 지원.
HeavyScheduleAvailabilityRequest	대량 주문 예약에 대한 가용성을 얻기 위한 요청 본문입니다.
ModelName	디바이스의 버전 및 용량 조합에 대한 고객 친화적인 이름입니다. 이 필드는 최신 세대 디바이스(예: AzureDataBox120 및 AzureDataBox525)를 2025년 2월 기준으로 주문할 때만 필요합니다.
RegionConfigurationRequest	지역에 대한 구성을 가져오기 위한 요청 본문입니다.
RegionConfigurationResponse	지역별 구성 응답입니다.
ScheduleAvailabilityResponse	지역에서 지정된 sku에 대한 가용성을 예약합니다.
SkuName	SKU 이름.
TransportAvailabilityDetails	지정된 지역에 대한 전송 옵션 가용성 세부 정보입니다.
TransportAvailabilityRequest	지정된 sku에 대한 전송 가용성을 가져오기 위한 요청 본문입니다.
TransportAvailabilityResponse	지역에서 지정된 sku에 사용할 수 있는 전송 옵션입니다.
TransportShipmentTypes	지정된 지역에 대해 지원되는 전송 배송 유형입니다.

ApiError

Object

Name	형식	Description
error	ErrorDetail	오류 세부 정보입니다.

DataBoxScheduleAvailabilityRequest

Object

데이터 상자 주문 주문 예약에 대한 가용성을 가져오기 위한 요청 본문입니다.

Name	형식	Description
country	string	스토리지 위치를 지원해야 하는 국가입니다.
model	ModelName	디바이스의 버전 및 용량 조합에 대한 고객 친화적인 이름입니다. 이 필드는 최신 세대 디바이스(예: AzureDataBox120 및 AzureDataBox525)를 2025년 2월 기준으로 주문할 때만 필요합니다.
skuName	string: DataBox	주문을 예약할 Sku 이름입니다.
storageLocation	string	데이터 전송 위치입니다. 위치 확인: `https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

DatacenterAddressInstructionResponse

Object

지정된 스토리지 위치에 대한 데이터 센터 명령입니다.

Name	형식	Description
communicationInstruction	string	데이터 센터 통신 지침
dataCenterAzureLocation	string	데이터 센터가 주로 사용되는 Azure 위치입니다.
datacenterAddressType	string: DatacenterAddressInstruction	데이터 센터 주소 유형
supportedCarriersForReturnShipment	string[]	반송 배송에 지원되는 운송업체 목록입니다.

DatacenterAddressLocationResponse

Object

지정된 스토리지 위치에 대한 데이터 센터 주소입니다.

Name	형식	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

데이터 센터 주소를 가져오기 위한 요청 본문입니다.

Name	형식	Description
model	ModelName	디바이스의 버전 및 용량 조합에 대한 고객 친화적인 이름입니다. 이 필드는 최신 세대 디바이스(예: AzureDataBox120 및 AzureDataBox525)를 2025년 2월 기준으로 주문할 때만 필요합니다.
skuName	SkuName	데이터 센터 주소가 요청한 SKU 이름입니다.
storageLocation	string	스토리지 위치입니다. 위치 확인: `https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

DatacenterAddressType

열거형

데이터 센터 주소 유형

값	Description
DatacenterAddressLocation	데이터 센터 주소 위치.
DatacenterAddressInstruction	데이터 센터 주소 명령.

Details

Object

Name	형식	Description
code	string	오류 코드입니다.
message	string	오류 메시지입니다.

DeviceCapabilityDetails

Object

지정된 지역에 대한 지정된 sku에 대한 디바이스 기능 세부 정보입니다.

Name	형식	Description
hardwareEncryption	HardwareEncryption	지정된 지역에 대해 지정된 sku에 대한 하드웨어 암호화 지원.

DeviceCapabilityRequest

Object

지정된 sku에 대한 디바이스 기능을 가져오기 위해 본문을 요청합니다.

Name	형식	Description
model	ModelName	디바이스의 버전 및 용량 조합에 대한 고객 친화적인 이름입니다. 이 필드는 최신 세대 디바이스(예: AzureDataBox120 및 AzureDataBox525)를 2025년 2월 기준으로 주문할 때만 필요합니다.
skuName	SkuName	디바이스의 유형입니다.

DeviceCapabilityResponse

Object

지역에서 지정된 sku에 대한 디바이스 기능

Name	형식	Description
deviceCapabilityDetails	DeviceCapabilityDetails[]	지정된 지역 및 지정된 sku에 사용할 수 있는 디바이스 기능 목록

DiskScheduleAvailabilityRequest

Object

디스크 주문 예약에 대한 가용성을 가져오기 위한 요청 본문입니다.

Name	형식	Description
country	string	스토리지 위치를 지원해야 하는 국가입니다.
expectedDataSizeInTeraBytes	integer (int32)	이 작업에서 전송해야 하는 데이터의 예상 크기(테라바이트)입니다.
model	ModelName	디바이스의 버전 및 용량 조합에 대한 고객 친화적인 이름입니다. 이 필드는 최신 세대 디바이스(예: AzureDataBox120 및 AzureDataBox525)를 2025년 2월 기준으로 주문할 때만 필요합니다.
skuName	string: DataBoxDisk	주문을 예약할 Sku 이름입니다.
storageLocation	string	데이터 전송 위치입니다. 위치 확인: `https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

ErrorDetail

Object

Name	형식	Description
code	string	오류 코드입니다.
details	Details[]	오류 대상입니다.
message	string	오류 메시지입니다.
target	string	추가 오류 정보.

HardwareEncryption

열거형

지정된 지역에 대해 지정된 sku에 대한 하드웨어 암호화 지원.

값	Description
Enabled	하드웨어 기반 암호화를 사용할 수 있습니다.
Disabled	하드웨어 기반 암호화가 비활성화됩니다.

HeavyScheduleAvailabilityRequest

Object

대량 주문 예약에 대한 가용성을 얻기 위한 요청 본문입니다.

Name	형식	Description
country	string	스토리지 위치를 지원해야 하는 국가입니다.
model	ModelName	디바이스의 버전 및 용량 조합에 대한 고객 친화적인 이름입니다. 이 필드는 최신 세대 디바이스(예: AzureDataBox120 및 AzureDataBox525)를 2025년 2월 기준으로 주문할 때만 필요합니다.
skuName	string: DataBoxHeavy	주문을 예약할 Sku 이름입니다.
storageLocation	string	데이터 전송 위치입니다. 위치 확인: `https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

ModelName

열거형

디바이스의 버전 및 용량 조합에 대한 고객 친화적인 이름입니다. 이 필드는 최신 세대 디바이스(예: AzureDataBox120 및 AzureDataBox525)를 2025년 2월 기준으로 주문할 때만 필요합니다.

값	Description
DataBox	데이터 박스.
DataBoxDisk	Data Box 디스크.
DataBoxHeavy	데이터 상자가 무겁습니다.
DataBoxCustomerDisk	Data Box 고객 디스크
AzureDataBox120	120TB의 가용 용량이 있는 Data Box V2입니다.
AzureDataBox525	525TB의 가용 용량이 있는 Data Box V2입니다.

RegionConfigurationRequest

Object

지역에 대한 구성을 가져오기 위한 요청 본문입니다.

Name	형식	Description
datacenterAddressRequest	DatacenterAddressRequest	지정된 sku에 대한 데이터 센터 주소를 가져오기 위한 요청 본문입니다.
deviceCapabilityRequest	DeviceCapabilityRequest	지정된 sku에 대한 디바이스 기능을 가져오기 위해 본문을 요청합니다.
scheduleAvailabilityRequest	ScheduleAvailabilityRequest: DataBoxScheduleAvailabilityRequest DiskScheduleAvailabilityRequest HeavyScheduleAvailabilityRequest	주문 예약에 대한 가용성을 가져오기 위한 요청 본문입니다.
transportAvailabilityRequest	TransportAvailabilityRequest	지정된 sku에 대한 전송 가용성을 가져오기 위한 요청 본문입니다.

RegionConfigurationResponse

Object

지역별 구성 응답입니다.

Name	형식	Description
datacenterAddressResponse	DatacenterAddressResponse: DatacenterAddressInstructionResponse DatacenterAddressLocationResponse	지역의 지정된 sku에 대한 데이터 센터 주소입니다.
deviceCapabilityResponse	DeviceCapabilityResponse	지역에서 지정된 sku에 사용할 수 있는 디바이스 기능입니다.
scheduleAvailabilityResponse	ScheduleAvailabilityResponse	지역에서 지정된 sku에 대한 가용성을 예약합니다.
transportAvailabilityResponse	TransportAvailabilityResponse	지역에서 지정된 sku에 사용할 수 있는 전송 옵션입니다.

ScheduleAvailabilityResponse

Object

지역에서 지정된 sku에 대한 가용성을 예약합니다.

Name	형식	Description
availableDates	string[] (date-time)	예약할 수 있는 날짜 목록

SkuName

열거형

SKU 이름.

값	Description
DataBox	데이터 박스.
DataBoxDisk	Data Box 디스크.
DataBoxHeavy	데이터 상자가 무겁습니다.
DataBoxCustomerDisk	Data Box 고객 디스크

TransportAvailabilityDetails

Object

지정된 지역에 대한 전송 옵션 가용성 세부 정보입니다.

Name	형식	Description
shipmentType	TransportShipmentTypes	지정된 지역에 대해 지원되는 전송 배송 유형입니다.

TransportAvailabilityRequest

Object

지정된 sku에 대한 전송 가용성을 가져오기 위한 요청 본문입니다.

Name	형식	Description
model	ModelName	디바이스의 버전 및 용량 조합에 대한 고객 친화적인 이름입니다. 이 필드는 최신 세대 디바이스(예: AzureDataBox120 및 AzureDataBox525)를 2025년 2월 기준으로 주문할 때만 필요합니다.
skuName	SkuName	디바이스의 유형입니다.

TransportAvailabilityResponse

Object

지역에서 지정된 sku에 사용할 수 있는 전송 옵션입니다.

Name	형식	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