Service - Region Configuration

Serviço:: Data Box

Versão da API:: 2025-07-01

Essa API fornece detalhes de configuração específicos para determinada região/localização no nível da assinatura.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
location	path	True	string minLength: 1	O nome da região do Azure.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Tipo	Description
datacenterAddressRequest	DatacenterAddressRequest	Solicite o corpo para obter o endereço do datacenter para determinado sku.
deviceCapabilityRequest	DeviceCapabilityRequest	Solicite o corpo para obter os recursos do dispositivo para um determinado sku.
scheduleAvailabilityRequest	ScheduleAvailabilityRequest: DataBoxScheduleAvailabilityRequest DiskScheduleAvailabilityRequest HeavyScheduleAvailabilityRequest	Corpo da solicitação para obter a disponibilidade para agendamento de pedidos.
transportAvailabilityRequest	TransportAvailabilityRequest	Corpo da solicitação para obter a disponibilidade de transporte para determinado sku.

Respostas

Nome	Tipo	Description
200 OK	RegionConfigurationResponse	A solicitação foi bem-sucedida.
Other Status Codes	ApiError	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

RegionConfiguration

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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"
    ]
  }
}

Definições

Nome	Description
ApiError
DataBoxScheduleAvailabilityRequest	Corpo da solicitação para obter a disponibilidade para agendar pedidos de pedidos de caixa de dados.
DatacenterAddressInstructionResponse	Instrução do datacenter para determinado local de armazenamento.
DatacenterAddressLocationResponse	Endereço do datacenter para determinado local de armazenamento.
DatacenterAddressRequest	Solicitar corpo para obter o endereço do datacenter.
DatacenterAddressType	Tipo de endereço do data center
Details
DeviceCapabilityDetails	Detalhes da funcionalidade do dispositivo para um determinado sku para uma determinada região.
DeviceCapabilityRequest	Solicite o corpo para obter os recursos do dispositivo para determinado sku.
DeviceCapabilityResponse	Funcionalidades do dispositivo para determinado sku em uma região
DiskScheduleAvailabilityRequest	Corpo da solicitação para obter a disponibilidade para agendar pedidos de disco.
ErrorDetail
HardwareEncryption	Suporte à criptografia de hardware para um determinado sku para determinada região.
HeavyScheduleAvailabilityRequest	Corpo da solicitação para obter a disponibilidade para agendar pedidos pesados.
ModelName	O nome amigável do cliente da combinação de versão e capacidade do dispositivo. Esse campo é necessário apenas no momento da ordenação do dispositivo de geração mais recente, ou seja, AzureDataBox120 e AzureDataBox525 a partir de fevereiro de 2025
RegionConfigurationRequest	Corpo da solicitação para obter a configuração da região.
RegionConfigurationResponse	Resposta de configuração específica para uma região.
ScheduleAvailabilityResponse	Agende a disponibilidade para determinado sku em uma região.
SkuName	Nomes de SKU.
TransportAvailabilityDetails	Detalhes de disponibilidade das opções de transporte para determinada região.
TransportAvailabilityRequest	Corpo da solicitação para obter a disponibilidade de transporte para determinado sku.
TransportAvailabilityResponse	Opções de transporte disponíveis para determinado sku em uma região.
TransportShipmentTypes	Tipo de Remessa de Transporte com suporte para determinada região.

ApiError

Objeto

Nome	Tipo	Description
error	ErrorDetail	O detalhe do erro.

DataBoxScheduleAvailabilityRequest

Objeto

Corpo da solicitação para obter a disponibilidade para agendar pedidos de pedidos de caixa de dados.

Nome	Tipo	Description
country	string	País no qual o local de armazenamento deve ter suporte.
model	ModelName	O nome amigável do cliente da combinação de versão e capacidade do dispositivo. Esse campo é necessário apenas no momento da ordenação do dispositivo de geração mais recente, ou seja, AzureDataBox120 e AzureDataBox525 a partir de fevereiro de 2025
skuName	string: DataBox	Nome do SKU para o qual a ordem deve ser agendada.
storageLocation	string	Local para transferência de dados. Para verificar locais: `https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

DatacenterAddressInstructionResponse

Objeto

Instrução do datacenter para determinado local de armazenamento.

Nome	Tipo	Description
communicationInstruction	string	Instrução de comunicação do data center
dataCenterAzureLocation	string	Local do Azure onde o Data Center serve principalmente.
datacenterAddressType	string: DatacenterAddressInstruction	Tipo de endereço do data center
supportedCarriersForReturnShipment	string[]	Lista de transportadoras com suporte para remessa de retorno.

DatacenterAddressLocationResponse

Objeto

Endereço do datacenter para determinado local de armazenamento.

Nome	Tipo	Description
additionalShippingInformation	string	Instrução especial para envio
addressType	string	Tipo de endereço
city	string	Nome da cidade
company	string	Nome da empresa
contactPersonName	string	Nome da pessoa de contato
country	string	nome do país
dataCenterAzureLocation	string	Local do Azure onde o Data Center serve principalmente.
datacenterAddressType	string: DatacenterAddressLocation	Tipo de endereço do data center
phone	string	Número de telefone
phoneExtension	string	Extensão de telefone
state	string	nome do estado
street1	string	Linha de endereço de rua 1
street2	string	Endereço de rua linha 2
street3	string	Linha de endereço de rua 3
supportedCarriersForReturnShipment	string[]	Lista de transportadoras com suporte para remessa de retorno.
zip	string	CEP

DatacenterAddressRequest

Objeto

Solicitar corpo para obter o endereço do datacenter.

Nome	Tipo	Description
model	ModelName	O nome amigável do cliente da combinação de versão e capacidade do dispositivo. Esse campo é necessário apenas no momento da ordenação do dispositivo de geração mais recente, ou seja, AzureDataBox120 e AzureDataBox525 a partir de fevereiro de 2025
skuName	SkuName	Nome do SKU para o qual o endereço do data center foi solicitado.
storageLocation	string	Local de armazenamento. Para verificar locais: `https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

DatacenterAddressType

Enumeração

Tipo de endereço do data center

Valor	Description
DatacenterAddressLocation	Localização do endereço do data center.
DatacenterAddressInstruction	Instrução de endereço do data center.

Details

Objeto

Nome	Tipo	Description
code	string	Código de erro.
message	string	Mensagem de erro.

DeviceCapabilityDetails

Objeto

Detalhes da funcionalidade do dispositivo para um determinado sku para uma determinada região.

Nome	Tipo	Description
hardwareEncryption	HardwareEncryption	Suporte à criptografia de hardware para um determinado sku para determinada região.

DeviceCapabilityRequest

Objeto

Solicite o corpo para obter os recursos do dispositivo para determinado sku.

Nome	Tipo	Description
model	ModelName	O nome amigável do cliente da combinação de versão e capacidade do dispositivo. Esse campo é necessário apenas no momento da ordenação do dispositivo de geração mais recente, ou seja, AzureDataBox120 e AzureDataBox525 a partir de fevereiro de 2025
skuName	SkuName	Tipo do dispositivo.

DeviceCapabilityResponse

Objeto

Funcionalidades do dispositivo para determinado sku em uma região

Nome	Tipo	Description
deviceCapabilityDetails	DeviceCapabilityDetails[]	Lista de recursos de dispositivo disponíveis para uma determinada região e um determinado sku

DiskScheduleAvailabilityRequest

Objeto

Corpo da solicitação para obter a disponibilidade para agendar pedidos de disco.

Nome	Tipo	Description
country	string	País no qual o local de armazenamento deve ter suporte.
expectedDataSizeInTeraBytes	integer (int32)	O tamanho esperado dos dados, que precisam ser transferidos neste trabalho, em terabytes.
model	ModelName	O nome amigável do cliente da combinação de versão e capacidade do dispositivo. Esse campo é necessário apenas no momento da ordenação do dispositivo de geração mais recente, ou seja, AzureDataBox120 e AzureDataBox525 a partir de fevereiro de 2025
skuName	string: DataBoxDisk	Nome do SKU para o qual a ordem deve ser agendada.
storageLocation	string	Local para transferência de dados. Para verificar locais: `https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

ErrorDetail

Objeto

Nome	Tipo	Description
code	string	Código de erro.
details	Details[]	Destino de erro.
message	string	Mensagem de erro.
target	string	Informações adicionais sobre o erro.

HardwareEncryption

Enumeração

Suporte à criptografia de hardware para um determinado sku para determinada região.

Valor	Description
Enabled	A criptografia baseada em hardware está habilitada.
Disabled	A criptografia baseada em hardware está desabilitada.

HeavyScheduleAvailabilityRequest

Objeto

Corpo da solicitação para obter a disponibilidade para agendar pedidos pesados.

Nome	Tipo	Description
country	string	País no qual o local de armazenamento deve ter suporte.
model	ModelName	O nome amigável do cliente da combinação de versão e capacidade do dispositivo. Esse campo é necessário apenas no momento da ordenação do dispositivo de geração mais recente, ou seja, AzureDataBox120 e AzureDataBox525 a partir de fevereiro de 2025
skuName	string: DataBoxHeavy	Nome do SKU para o qual a ordem deve ser agendada.
storageLocation	string	Local para transferência de dados. Para verificar locais: `https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01`

ModelName

Enumeração

O nome amigável do cliente da combinação de versão e capacidade do dispositivo. Esse campo é necessário apenas no momento da ordenação do dispositivo de geração mais recente, ou seja, AzureDataBox120 e AzureDataBox525 a partir de fevereiro de 2025

Valor	Description
DataBox	Caixa de dados.
DataBoxDisk	Disco do Data Box.
DataBoxHeavy	Data Box Heavy.
DataBoxCustomerDisk	Disco do cliente do Data Box
AzureDataBox120	Data Box V2 com capacidade utilizável de 120 TB.
AzureDataBox525	Data Box V2 com capacidade utilizável de 525 TB.

RegionConfigurationRequest

Objeto

Corpo da solicitação para obter a configuração da região.

Nome	Tipo	Description
datacenterAddressRequest	DatacenterAddressRequest	Solicite o corpo para obter o endereço do datacenter para determinado sku.
deviceCapabilityRequest	DeviceCapabilityRequest	Solicite o corpo para obter os recursos do dispositivo para um determinado sku.
scheduleAvailabilityRequest	ScheduleAvailabilityRequest: DataBoxScheduleAvailabilityRequest DiskScheduleAvailabilityRequest HeavyScheduleAvailabilityRequest	Corpo da solicitação para obter a disponibilidade para agendamento de pedidos.
transportAvailabilityRequest	TransportAvailabilityRequest	Corpo da solicitação para obter a disponibilidade de transporte para determinado sku.

RegionConfigurationResponse

Objeto

Resposta de configuração específica para uma região.

Nome	Tipo	Description
datacenterAddressResponse	DatacenterAddressResponse: DatacenterAddressInstructionResponse DatacenterAddressLocationResponse	Endereço do datacenter para determinado sku em uma região.
deviceCapabilityResponse	DeviceCapabilityResponse	Funcionalidades de dispositivo disponíveis para um determinado sku em uma região.
scheduleAvailabilityResponse	ScheduleAvailabilityResponse	Agende a disponibilidade para determinado sku em uma região.
transportAvailabilityResponse	TransportAvailabilityResponse	Opções de transporte disponíveis para determinado sku em uma região.

ScheduleAvailabilityResponse

Objeto

Agende a disponibilidade para determinado sku em uma região.

Nome	Tipo	Description
availableDates	string[] (date-time)	Lista de datas disponíveis para agendamento

SkuName

Enumeração

Nomes de SKU.

Valor	Description
DataBox	Caixa de dados.
DataBoxDisk	Disco do Data Box.
DataBoxHeavy	Data Box Heavy.
DataBoxCustomerDisk	Disco do cliente do Data Box

TransportAvailabilityDetails

Objeto

Detalhes de disponibilidade das opções de transporte para determinada região.

Nome	Tipo	Description
shipmentType	TransportShipmentTypes	Tipo de Remessa de Transporte com suporte para determinada região.

TransportAvailabilityRequest

Objeto

Corpo da solicitação para obter a disponibilidade de transporte para determinado sku.

Nome	Tipo	Description
model	ModelName	O nome amigável do cliente da combinação de versão e capacidade do dispositivo. Esse campo é necessário apenas no momento da ordenação do dispositivo de geração mais recente, ou seja, AzureDataBox120 e AzureDataBox525 a partir de fevereiro de 2025
skuName	SkuName	Tipo do dispositivo.

TransportAvailabilityResponse

Objeto

Opções de transporte disponíveis para determinado sku em uma região.

Nome	Tipo	Description
transportAvailabilityDetails	TransportAvailabilityDetails[]	Lista de detalhes de disponibilidade de transporte para determinada região

TransportShipmentTypes

Enumeração

Tipo de Remessa de Transporte com suporte para determinada região.

Valor	Description
CustomerManaged	A logística de remessa é tratada pelo cliente.
MicrosoftManaged	A Logística de Remessa é tratada pela Microsoft.

Compartilhar via

Service - Region Configuration

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

RegionConfiguration

Solicitação de exemplo

Resposta de exemplo

Definições

ApiError

DataBoxScheduleAvailabilityRequest

DatacenterAddressInstructionResponse

DatacenterAddressLocationResponse

DatacenterAddressRequest

DatacenterAddressType

Details

DeviceCapabilityDetails

DeviceCapabilityRequest

DeviceCapabilityResponse

DiskScheduleAvailabilityRequest

ErrorDetail

HardwareEncryption

HeavyScheduleAvailabilityRequest

ModelName

RegionConfigurationRequest

RegionConfigurationResponse

ScheduleAvailabilityResponse

SkuName

TransportAvailabilityDetails

TransportAvailabilityRequest

TransportAvailabilityResponse

TransportShipmentTypes