Service - Region Configuration

Servizio:: Data Box

Versione API:: 2025-07-01

Questa API fornisce dettagli di configurazione specifici per l'area o la località a livello di sottoscrizione.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
location	path	True	string minLength: 1	Nome dell'area di Azure.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	La versione dell'API da utilizzare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
datacenterAddressRequest	DatacenterAddressRequest	Corpo della richiesta per ottenere l'indirizzo del data center per lo SKU specificato.
deviceCapabilityRequest	DeviceCapabilityRequest	Corpo della richiesta per ottenere le funzionalità del dispositivo per uno SKU specifico.
scheduleAvailabilityRequest	ScheduleAvailabilityRequest: DataBoxScheduleAvailabilityRequest DiskScheduleAvailabilityRequest HeavyScheduleAvailabilityRequest	Corpo della richiesta per ottenere la disponibilità per la pianificazione degli ordini.
transportAvailabilityRequest	TransportAvailabilityRequest	Corpo della richiesta per ottenere la disponibilità del trasporto per lo SKU specificato.

Risposte

Nome	Tipo	Descrizione
200 OK	RegionConfigurationResponse	La richiesta è andata a buon fine.
Other Status Codes	ApiError	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

RegionConfiguration

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
    ]
  }
}

Definizioni

Nome	Descrizione
ApiError
DataBoxScheduleAvailabilityRequest	Corpo della richiesta per ottenere la disponibilità per la pianificazione degli ordini di data box.
DatacenterAddressInstructionResponse	Istruzione del data center per la posizione di archiviazione specificata.
DatacenterAddressLocationResponse	Indirizzo del data center per la posizione di archiviazione specificata.
DatacenterAddressRequest	Corpo della richiesta per ottenere l'indirizzo del data center.
DatacenterAddressType	Tipo di indirizzo del data center
Details
DeviceCapabilityDetails	Dettagli sulle funzionalità del dispositivo per uno SKU specifico per una determinata area.
DeviceCapabilityRequest	Corpo della richiesta per ottenere le funzionalità del dispositivo per lo SKU specificato.
DeviceCapabilityResponse	Funzionalità del dispositivo per lo SKU specificato in un'area
DiskScheduleAvailabilityRequest	Corpo della richiesta per ottenere la disponibilità per la pianificazione degli ordini dei dischi.
ErrorDetail
HardwareEncryption	Supporto della crittografia hardware per uno SKU specifico per una determinata area.
HeavyScheduleAvailabilityRequest	Corpo della richiesta per ottenere la disponibilità per la pianificazione di ordini pesanti.
ModelName	Nome descrittivo del cliente della combinazione di versione e capacità del dispositivo. Questo campo è necessario solo al momento dell'ordinamento del dispositivo di generazione più recente, ad esempio AzureDataBox120 e AzureDataBox525 a partire da febbraio/2025
RegionConfigurationRequest	Corpo della richiesta per ottenere la configurazione per l'area.
RegionConfigurationResponse	Risposta di configurazione specifica di un'area.
ScheduleAvailabilityResponse	Pianificare la disponibilità per lo SKU specificato in un'area.
SkuName	Nomi SKU.
TransportAvailabilityDetails	Dettagli sulla disponibilità delle opzioni di trasporto per un'area specifica.
TransportAvailabilityRequest	Corpo della richiesta per ottenere la disponibilità del trasporto per lo SKU specificato.
TransportAvailabilityResponse	Opzioni di trasporto disponibili per lo SKU specificato in un'area.
TransportShipmentTypes	Tipo di spedizione di trasporto supportato per l'area specificata.

ApiError

Object

Nome	Tipo	Descrizione
error	ErrorDetail	Dettagli dell'errore.

DataBoxScheduleAvailabilityRequest

Object

Corpo della richiesta per ottenere la disponibilità per la pianificazione degli ordini di data box.

Nome	Tipo	Descrizione
country	string	Paese in cui deve essere supportata la posizione di archiviazione.
model	ModelName	Nome descrittivo del cliente della combinazione di versione e capacità del dispositivo. Questo campo è necessario solo al momento dell'ordinamento del dispositivo di generazione più recente, ad esempio AzureDataBox120 e AzureDataBox525 a partire da febbraio/2025
skuName	string: DataBox	Sku Name per cui l'ordine deve essere pianificato.
storageLocation	string	Posizione per il trasferimento dei dati. Per la verifica delle posizioni: `https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

DatacenterAddressInstructionResponse

Object

Istruzione del data center per la posizione di archiviazione specificata.

Nome	Tipo	Descrizione
communicationInstruction	string	Istruzione di comunicazione del data center
dataCenterAzureLocation	string	Posizione di Azure in cui il data center serve principalmente.
datacenterAddressType	string: DatacenterAddressInstruction	Tipo di indirizzo del data center
supportedCarriersForReturnShipment	string[]	Elenco dei vettori supportati per la spedizione di ritorno.

DatacenterAddressLocationResponse

Object

Indirizzo del data center per la posizione di archiviazione specificata.

Nome	Tipo	Descrizione
additionalShippingInformation	string	Istruzioni speciali per la spedizione
addressType	string	Tipo di indirizzo
city	string	Nome città
company	string	Nome della società
contactPersonName	string	Nome persona contatto
country	string	nome del paese
dataCenterAzureLocation	string	Posizione di Azure in cui il data center serve principalmente.
datacenterAddressType	string: DatacenterAddressLocation	Tipo di indirizzo del data center
phone	string	Numero di telefono
phoneExtension	string	Estensione telefono
state	string	nome dello stato
street1	string	Indirizzo 1
street2	string	Indirizzo 2
street3	string	Indirizzo 3
supportedCarriersForReturnShipment	string[]	Elenco dei vettori supportati per la spedizione di ritorno.
zip	string	CAP

DatacenterAddressRequest

Object

Corpo della richiesta per ottenere l'indirizzo del data center.

Nome	Tipo	Descrizione
model	ModelName	Nome descrittivo del cliente della combinazione di versione e capacità del dispositivo. Questo campo è necessario solo al momento dell'ordinamento del dispositivo di generazione più recente, ad esempio AzureDataBox120 e AzureDataBox525 a partire da febbraio/2025
skuName	SkuName	Sku Name per cui è stato richiesto l'indirizzo del data center.
storageLocation	string	Posizione di archiviazione. Per la verifica delle posizioni: `https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

DatacenterAddressType

Enumerazione

Tipo di indirizzo del data center

Valore	Descrizione
DatacenterAddressLocation	Posizione dell'indirizzo del data center.
DatacenterAddressInstruction	Istruzioni per l'indirizzo del data center.

Details

Object

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore.

DeviceCapabilityDetails

Object

Dettagli sulle funzionalità del dispositivo per uno SKU specifico per una determinata area.

Nome	Tipo	Descrizione
hardwareEncryption	HardwareEncryption	Supporto della crittografia hardware per uno SKU specifico per una determinata area.

DeviceCapabilityRequest

Object

Corpo della richiesta per ottenere le funzionalità del dispositivo per lo SKU specificato.

Nome	Tipo	Descrizione
model	ModelName	Nome descrittivo del cliente della combinazione di versione e capacità del dispositivo. Questo campo è necessario solo al momento dell'ordinamento del dispositivo di generazione più recente, ad esempio AzureDataBox120 e AzureDataBox525 a partire da febbraio/2025
skuName	SkuName	Tipo di dispositivo.

DeviceCapabilityResponse

Object

Funzionalità del dispositivo per lo SKU specificato in un'area

Nome	Tipo	Descrizione
deviceCapabilityDetails	DeviceCapabilityDetails[]	Elenco delle funzionalità del dispositivo disponibili per una determinata area e uno SKU specifico

DiskScheduleAvailabilityRequest

Object

Corpo della richiesta per ottenere la disponibilità per la pianificazione degli ordini dei dischi.

Nome	Tipo	Descrizione
country	string	Paese in cui deve essere supportata la posizione di archiviazione.
expectedDataSizeInTeraBytes	integer (int32)	Dimensioni previste dei dati, che devono essere trasferiti in questo processo, in terabyte.
model	ModelName	Nome descrittivo del cliente della combinazione di versione e capacità del dispositivo. Questo campo è necessario solo al momento dell'ordinamento del dispositivo di generazione più recente, ad esempio AzureDataBox120 e AzureDataBox525 a partire da febbraio/2025
skuName	string: DataBoxDisk	Sku Name per cui l'ordine deve essere pianificato.
storageLocation	string	Posizione per il trasferimento dei dati. Per la verifica delle posizioni: `https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

ErrorDetail

Object

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	Details[]	Destinazione errore.
message	string	Messaggio di errore.
target	string	Ulteriori informazioni sull'errore.

HardwareEncryption

Enumerazione

Supporto della crittografia hardware per uno SKU specifico per una determinata area.

Valore	Descrizione
Enabled	La crittografia basata su hardware è abilitata.
Disabled	La crittografia basata su hardware è disabilitata.

HeavyScheduleAvailabilityRequest

Object

Corpo della richiesta per ottenere la disponibilità per la pianificazione di ordini pesanti.

Nome	Tipo	Descrizione
country	string	Paese in cui deve essere supportata la posizione di archiviazione.
model	ModelName	Nome descrittivo del cliente della combinazione di versione e capacità del dispositivo. Questo campo è necessario solo al momento dell'ordinamento del dispositivo di generazione più recente, ad esempio AzureDataBox120 e AzureDataBox525 a partire da febbraio/2025
skuName	string: DataBoxHeavy	Sku Name per cui l'ordine deve essere pianificato.
storageLocation	string	Posizione per il trasferimento dei dati. Per la verifica delle posizioni: `https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

ModelName

Enumerazione

Nome descrittivo del cliente della combinazione di versione e capacità del dispositivo. Questo campo è necessario solo al momento dell'ordinamento del dispositivo di generazione più recente, ad esempio AzureDataBox120 e AzureDataBox525 a partire da febbraio/2025

Valore	Descrizione
DataBox	Casella dati.
DataBoxDisk	Disco Data Box.
DataBoxHeavy	Data Box Heavy.
DataBoxCustomerDisk	Disco del cliente di Data Box
AzureDataBox120	Data Box V2 con capacità utilizzabile di 120 TB.
AzureDataBox525	Data Box V2 con capacità utilizzabile di 525 TB.

RegionConfigurationRequest

Object

Corpo della richiesta per ottenere la configurazione per l'area.

Nome	Tipo	Descrizione
datacenterAddressRequest	DatacenterAddressRequest	Corpo della richiesta per ottenere l'indirizzo del data center per lo SKU specificato.
deviceCapabilityRequest	DeviceCapabilityRequest	Corpo della richiesta per ottenere le funzionalità del dispositivo per uno SKU specifico.
scheduleAvailabilityRequest	ScheduleAvailabilityRequest: DataBoxScheduleAvailabilityRequest DiskScheduleAvailabilityRequest HeavyScheduleAvailabilityRequest	Corpo della richiesta per ottenere la disponibilità per la pianificazione degli ordini.
transportAvailabilityRequest	TransportAvailabilityRequest	Corpo della richiesta per ottenere la disponibilità del trasporto per lo SKU specificato.

RegionConfigurationResponse

Object

Risposta di configurazione specifica di un'area.

Nome	Tipo	Descrizione
datacenterAddressResponse	DatacenterAddressResponse: DatacenterAddressInstructionResponse DatacenterAddressLocationResponse	Indirizzo del data center per lo SKU specificato in un'area.
deviceCapabilityResponse	DeviceCapabilityResponse	Funzionalità del dispositivo disponibili per uno SKU specifico in un'area.
scheduleAvailabilityResponse	ScheduleAvailabilityResponse	Pianificare la disponibilità per lo SKU specificato in un'area.
transportAvailabilityResponse	TransportAvailabilityResponse	Opzioni di trasporto disponibili per lo SKU specificato in un'area.

ScheduleAvailabilityResponse

Object

Pianificare la disponibilità per lo SKU specificato in un'area.

Nome	Tipo	Descrizione
availableDates	string[] (date-time)	Elenco delle date disponibili per la pianificazione

SkuName

Enumerazione

Nomi SKU.

Valore	Descrizione
DataBox	Casella dati.
DataBoxDisk	Disco Data Box.
DataBoxHeavy	Data Box Heavy.
DataBoxCustomerDisk	Disco del cliente di Data Box

TransportAvailabilityDetails

Object

Dettagli sulla disponibilità delle opzioni di trasporto per un'area specifica.

Nome	Tipo	Descrizione
shipmentType	TransportShipmentTypes	Tipo di spedizione di trasporto supportato per l'area specificata.

TransportAvailabilityRequest

Object

Corpo della richiesta per ottenere la disponibilità del trasporto per lo SKU specificato.

Nome	Tipo	Descrizione
model	ModelName	Nome descrittivo del cliente della combinazione di versione e capacità del dispositivo. Questo campo è necessario solo al momento dell'ordinamento del dispositivo di generazione più recente, ad esempio AzureDataBox120 e AzureDataBox525 a partire da febbraio/2025
skuName	SkuName	Tipo di dispositivo.

TransportAvailabilityResponse

Object

Opzioni di trasporto disponibili per lo SKU specificato in un'area.

Nome	Tipo	Descrizione
transportAvailabilityDetails	TransportAvailabilityDetails[]	Elenco dei dettagli della disponibilità del trasporto per un'area specifica

TransportShipmentTypes

Enumerazione

Tipo di spedizione di trasporto supportato per l'area specificata.

Valore	Descrizione
CustomerManaged	La logistica delle spedizioni viene gestita dal cliente.
MicrosoftManaged	La logistica delle spedizioni viene gestita da Microsoft.

Condividi tramite

Service - Region Configuration

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

RegionConfiguration

Esempio di richiesta

Risposta di esempio

Definizioni

ApiError

DataBoxScheduleAvailabilityRequest

DatacenterAddressInstructionResponse

DatacenterAddressLocationResponse

DatacenterAddressRequest

DatacenterAddressType

Details

DeviceCapabilityDetails

DeviceCapabilityRequest

DeviceCapabilityResponse

DiskScheduleAvailabilityRequest

ErrorDetail

HardwareEncryption

HeavyScheduleAvailabilityRequest

ModelName

RegionConfigurationRequest

RegionConfigurationResponse

ScheduleAvailabilityResponse

SkuName

TransportAvailabilityDetails

TransportAvailabilityRequest

TransportAvailabilityResponse

TransportShipmentTypes