Share via

Service - List Available Skus By Resource Group

Service:
Data Box
API Version:
2025-02-01

This method provides the list of available skus for the given subscription, resource group and location.

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

URI Parameters

Name In Required Type Description
location
 path True

string

The location of the resource
resourceGroupName
 path True

string

The Resource Group Name
subscriptionId
 path True

string

The Subscription Id
api-version
 query True

string

The API Version

Request Body

Name Required Type Description
country True

string

ISO country code. Country for hardware shipment. For codes check: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements
location True

string

Location for data transfer. For locations check: https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01
transferType True

TransferType

Type of the transfer.
skuNames

SkuName[]

Sku Names to filter for available skus

Responses

Name Type Description
200 OK

AvailableSkusResult

The list of available skus under Resource group.
Other Status Codes

ApiError

Error response describing reason for operation failure.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

AvailableSkusPost

Sample request

POST https://management.azure.com/subscriptions/YourSubscriptionId/resourceGroups/YourResourceGroupName/providers/Microsoft.DataBox/locations/westus/availableSkus?api-version=2025-02-01

{
  "transferType": "ImportToAzure",
  "country": "XX",
  "location": "westus"
}

Sample response

Status code:
200 
{
  "value": [
    {
      "sku": {
        "name": "DataBox",
        "model": "DataBox"
      },
      "enabled": true,
      "properties": {
        "dataLocationToServiceLocationMap": [
          {
            "dataLocation": "westus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "centralus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "eastus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "eastus2",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "northcentralus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "southcentralus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "westcentralus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "westus2",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "centraluseuap",
            "serviceLocation": "centraluseuap"
          },
          {
            "dataLocation": "eastus2euap",
            "serviceLocation": "eastus2euap"
          }
        ],
        "capacity": {
          "usable": "80",
          "maximum": "100",
          "individualSkuUsable": "80"
        },
        "costs": [
          {
            "meterId": "0cf23ffc-0b64-49e6-9bdd-1db885349042",
            "meterType": "DataBoxServiceFee",
            "multiplier": 1
          },
          {
            "meterId": "a701f058-119b-4713-a923-bed7da4b7801",
            "meterType": "DataBoxShippingFee",
            "multiplier": 1
          },
          {
            "meterId": "049fa331-0a48-4a81-9991-a6bef3c79fed",
            "meterType": "DataBoxExtraDayFee",
            "multiplier": 1
          },
          {
            "meterId": "c3ea978d-6a0a-4632-b094-4fffcafcb057",
            "meterType": "DataBoxLostOrDamagedDeviceFee",
            "multiplier": 1
          }
        ],
        "apiVersions": [
          "2018-01-01"
        ],
        "disabledReason": "None",
        "countriesWithinCommerceBoundary": [
          "XX"
        ]
      }
    },
    {
      "sku": {
        "name": "DataBoxDisk",
        "model": "DataBoxDisk"
      },
      "enabled": true,
      "properties": {
        "dataLocationToServiceLocationMap": [
          {
            "dataLocation": "westus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "centralus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "eastus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "eastus2",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "northcentralus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "southcentralus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "westcentralus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "westus2",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "centraluseuap",
            "serviceLocation": "centraluseuap"
          },
          {
            "dataLocation": "eastus2euap",
            "serviceLocation": "eastus2euap"
          }
        ],
        "capacity": {
          "usable": "35",
          "maximum": "40",
          "individualSkuUsable": "7"
        },
        "costs": [
          {
            "meterId": "d95cd8b5-b6f1-4cd9-ae86-a016d1945d6f",
            "meterType": "DataBoxDiskServiceFee",
            "multiplier": 1
          },
          {
            "meterId": "4b8cf572-cb04-4ef3-9528-2cda4e9b544e",
            "meterType": "DataBoxDiskShippingFee",
            "multiplier": 1
          },
          {
            "meterId": "b6ae9bbf-815d-49dd-bb2b-77c497b72ba4",
            "meterType": "DataBoxDiskDailyUsageFee",
            "multiplier": 1
          },
          {
            "meterId": "08bc0ea1-6c82-421b-b953-2a7a65810d2e",
            "meterType": "DataBoxDiskLostDeviceFee",
            "multiplier": 1
          }
        ],
        "apiVersions": [
          "2018-01-01"
        ],
        "disabledReason": "None",
        "countriesWithinCommerceBoundary": [
          "XX"
        ]
      }
    },
    {
      "sku": {
        "name": "DataBoxHeavy",
        "model": "DataBoxHeavy"
      },
      "enabled": true,
      "properties": {
        "dataLocationToServiceLocationMap": [
          {
            "dataLocation": "westus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "centralus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "eastus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "eastus2",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "northcentralus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "southcentralus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "westcentralus",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "westus2",
            "serviceLocation": "westus"
          },
          {
            "dataLocation": "centraluseuap",
            "serviceLocation": "centraluseuap"
          },
          {
            "dataLocation": "eastus2euap",
            "serviceLocation": "eastus2euap"
          }
        ],
        "capacity": {
          "usable": "800",
          "maximum": "1000",
          "individualSkuUsable": "800"
        },
        "costs": [
          {
            "meterId": "d0dccaaf-3de9-4c7a-ba97-f83551b90126",
            "meterType": "DataBoxHeavyServiceFee",
            "multiplier": 1
          },
          {
            "meterId": "7b49d11f-d4f7-4029-a197-04998fd282f9",
            "meterType": "DataBoxHeavyShippingFee",
            "multiplier": 1
          },
          {
            "meterId": "c2c66d53-11b4-4f11-9642-43c7c336f0b7",
            "meterType": "DataBoxHeavyExtraDayFee",
            "multiplier": 1
          },
          {
            "meterId": "188dcd7e-fbd7-4a41-aa42-162b81b0510f",
            "meterType": "DataBoxHeavyLostOrDamagedDeviceFee",
            "multiplier": 1
          }
        ],
        "apiVersions": [
          "2018-01-01"
        ],
        "disabledReason": "None",
        "requiredFeature": "HeavyCreateAccess",
        "countriesWithinCommerceBoundary": [
          "XX"
        ]
      }
    }
  ]
}

Definitions

Name Description
ApiError
AvailableSkuRequest

The filters for showing the available skus.
AvailableSkusResult

The available skus operation response.
DataLocationToServiceLocationMap

Map of data location to service location
Details
ErrorDetail
ModelName

The customer friendly name of the combination of version and capacity of the device. This field is necessary only at the time of ordering the newer generation device i.e. AzureDataBox120 and AzureDataBox525 as of Feb/2025
Sku

The Sku.
SkuCapacity

Capacity of the sku.
SkuCost

Describes metadata for retrieving price info.
SkuDisabledReason

Reason why the Sku is disabled.
SkuInformation

Information of the sku.
SkuName

Sku Names to filter for available skus
TransferType

Type of the transfer.

ApiError

Object
Name Type Description
error

ErrorDetail

AvailableSkuRequest

Object

The filters for showing the available skus.

Name Type Description
country

string

ISO country code. Country for hardware shipment. For codes check: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements
location

string

Location for data transfer. For locations check: https://management.azure.com/subscriptions/SUBSCRIPTIONID/locations?api-version=2018-01-01
skuNames

SkuName[]

Sku Names to filter for available skus
transferType

TransferType

Type of the transfer.

AvailableSkusResult

Object

The available skus operation response.

Name Type Description
nextLink

string

Link for the next set of skus.
value

SkuInformation[]

List of available skus.

DataLocationToServiceLocationMap

Object

Map of data location to service location

Name Type Description
dataLocation

string

Location of the data.
serviceLocation

string

Location of the service.

Details

Object
Name Type Description
code

string

message

string

ErrorDetail

Object
Name Type Description
code

string

details

Details[]

message

string

target

string

ModelName

Enumeration

The customer friendly name of the combination of version and capacity of the device. This field is necessary only at the time of ordering the newer generation device i.e. AzureDataBox120 and AzureDataBox525 as of Feb/2025

Value Description
DataBox

Data Box.
DataBoxDisk

Data Box Disk.
DataBoxHeavy

Data Box Heavy.
DataBoxCustomerDisk

Data Box Customer Disk
AzureDataBox120

Data Box V2 with 125TB usable capacity.
AzureDataBox525

Data Box V2 with 500TB usable capacity.

Sku

Object

The Sku.

Name Type Description
displayName

string

The display name of the sku.
family

string

The sku family.
model

ModelName

The customer friendly name of the combination of version and capacity of the device. This field is necessary only at the time of ordering the newer generation device i.e. AzureDataBox120 and AzureDataBox525 as of Feb/2025
name

SkuName

The sku name.

SkuCapacity

Object

Capacity of the sku.

Name Type Description
individualSkuUsable

string

Maximum capacity per device in TB.
maximum

string

Maximum capacity in TB.
usable

string

Usable capacity in TB.

SkuCost

Object

Describes metadata for retrieving price info.

Name Type Description
meterId

string

Meter id of the Sku.
meterType

string

The type of the meter.
multiplier

number (double)

Multiplier specifies the region specific value to be multiplied with 1$ guid. Eg: Our new regions will be using 1$ shipping guid with appropriate multiplier specific to region.

SkuDisabledReason

Enumeration

Reason why the Sku is disabled.

Value Description
None

SKU is not disabled.
Country

SKU is not available in the requested country.
Region

SKU is not available to push data to the requested Azure region.
Feature

Required features are not enabled for the SKU.
OfferType

Subscription does not have required offer types for the SKU.
NoSubscriptionInfo

Subscription has not registered to Microsoft.DataBox and Service does not have the subscription notification.

SkuInformation

Object

Information of the sku.

Name Type Description
enabled

boolean

The sku is enabled or not.
properties.apiVersions

string[]

Api versions that support this Sku.
properties.capacity

SkuCapacity

Capacity of the Sku.
properties.costs

SkuCost[]

Cost of the Sku.
properties.countriesWithinCommerceBoundary

string[]

List of all the Countries in the SKU specific commerce boundary
properties.dataLocationToServiceLocationMap

DataLocationToServiceLocationMap[]

The map of data location to service location.
properties.disabledReason

SkuDisabledReason

Reason why the Sku is disabled.
properties.disabledReasonMessage

string

Message for why the Sku is disabled.
properties.requiredFeature

string

Required feature to access the sku.
sku

Sku

The Sku.

SkuName

Enumeration

Sku Names to filter for available skus

Value Description
DataBox

Data Box.
DataBoxDisk

Data Box Disk.
DataBoxHeavy

Data Box Heavy.
DataBoxCustomerDisk

Data Box Customer Disk

TransferType

Enumeration

Type of the transfer.

Value Description
ImportToAzure

Import data to azure.
ExportFromAzure

Export data from azure.