azure-mgmt-databoxedge 3.0.0b2

Microsoft Azure Databoxedge Management Client Library for Python

Microsoft Azure SDK for Python

This is the Microsoft Azure Data Box Edge Management Client Library. This package has been tested with Python 3.10+. For a more complete view of Azure libraries, see the azure sdk python release.

Disclaimer

Azure SDK Python packages support for Python 2.7 has ended 01 January 2022. For more information and questions, please refer to https://github.com/Azure/azure-sdk-for-python/issues/20691

Getting started

Prerequisites

• Python 3.10+ is required to use this package.
• Azure subscription

Install the package

pip install azure-mgmt-databoxedge
pip install azure-identity

Authentication

By default, Azure Active Directory token authentication depends on correct configuration of the following environment variables.

• AZURE_CLIENT_ID for Azure client ID.
• AZURE_TENANT_ID for Azure tenant ID.
• AZURE_CLIENT_SECRET for Azure client secret.

In addition, Azure subscription ID can be configured via environment variable AZURE_SUBSCRIPTION_ID.

With above configuration, client can be authenticated by following code:

from azure.identity import DefaultAzureCredential
from azure.mgmt.databoxedge import DataBoxEdgeManagementClient
import os

sub_id = os.getenv("AZURE_SUBSCRIPTION_ID")
client = DataBoxEdgeManagementClient(credential=DefaultAzureCredential(), subscription_id=sub_id)

Examples

Code samples for this package can be found at:

• Search Data Box Edge Management on docs.microsoft.com
• Azure Python Mgmt SDK Samples Repo

Troubleshooting

Next steps

Provide Feedback

If you encounter any bugs or have suggestions, please file an issue in the Issues section of the project.

Release History

3.0.0b2 (2026-05-26)

Features Added

• Client DataBoxEdgeManagementClient added parameter cloud_setting in method __init__
• Client DataBoxEdgeManagementClient added method send_request
• Client DataBoxEdgeManagementClient added operation group diagnostic_settings
• Client DataBoxEdgeManagementClient added operation group device_capacity_check
• Client DataBoxEdgeManagementClient added operation group support_packages
• Client DataBoxEdgeManagementClient added operation group device_capacity_info
• Model DataBoxEdgeDeviceExtendedInfo added property system_data
• Model Job added property system_data
• Model LoadBalancerConfig added property ip_range
• Model Order added property kind
• Enum SkuName added member EDGE_MR_TCP
• Enum SkuName added member EP2_128_GPU1_MX1_W
• Enum SkuName added member EP2_256_GPU2_MX1
• Enum SkuName added member EP2_64_MX1_W
• Model UpdateDetails added property friendly_version_number
• Model UpdateDetails added property installation_impact
• Added enum AccessLevel
• Added model CloudError
• Added model ClusterCapacityViewData
• Added model ClusterGpuCapacity
• Added model ClusterMemoryCapacity
• Added model ClusterStorageViewData
• Added enum ClusterWitnessType
• Added model DataResidency
• Added enum DataResidencyType
• Added model DeviceCapacityInfo
• Added model DeviceCapacityInfoProperties
• Added model DeviceCapacityRequestInfo
• Added model DeviceCapacityRequestInfoProperties
• Added model DiagnosticProactiveLogCollectionSettings
• Added model DiagnosticRemoteSupportSettings
• Added model DiagnosticRemoteSupportSettingsProperties
• Added model HostCapacity
• Added enum InstallationImpact
• Added model NumaNodeData
• Added enum ProactiveDiagnosticsConsent
• Added model ProactiveLogCollectionSettingsProperties
• Added model ProxyResource
• Added enum RemoteApplicationType
• Added model RemoteSupportSettings
• Added model Resource
• Added model SupportPackageRequestProperties
• Added model TrackedResource
• Added model TriggerSupportPackageRequest
• Added model VmMemory
• Added model VmPlacementRequestResult
• Operation group DevicesOperations added method create_or_update
• Added operation group DeviceCapacityCheckOperations
• Added operation group DeviceCapacityInfoOperations
• Added operation group DiagnosticSettingsOperations
• Added operation group SupportPackagesOperations

Breaking Changes

• This version introduces new hybrid models which have dual dictionary and model nature. Please follow https://aka.ms/azsdk/python/migrate/hybrid-models for migration.
• Model DCAccessCode moved instance variable auth_code under property properties whose type is DCAccessCodeProperties
• Model DataBoxEdgeDevicePatch moved instance variable edge_profile under property properties whose type is DataBoxEdgeDevicePropertiesPatch
• Model EdgeProfileSubscription moved instance variable tenant_id, location_placement_id, quota_id, serialized_details and registered_features under property properties whose type is SubscriptionProperties
• Model FileEventTrigger moved instance variable source_info, sink_info and custom_context_tag under property properties whose type is FileTriggerProperties
• Model PeriodicTimerEventTrigger moved instance variable source_info, sink_info and custom_context_tag under property properties whose type is PeriodicTimerProperties
• Model UploadCertificateRequest moved instance variable authentication_type and certificate under property properties whose type is RawCertificateData
• Method DevicesOperations.list_by_resource_group changed its parameter expand from positional_or_keyword to keyword_only
• Method DevicesOperations.list_by_subscription changed its parameter expand from positional_or_keyword to keyword_only
• Deleted or renamed method DevicesOperations.begin_create_or_update
• Method UsersOperations.list_by_data_box_edge_device renamed its parameter expand to filter

Other Changes

• Deleted model AddonList/AlertList/BandwidthSchedulesList/ContainerList/DataBoxEdgeDeviceList/DataBoxEdgeSkuList/MonitoringMetricConfigurationList/NodeList/OperationsList/OrderList/RoleList/ShareList/SkuInformationList/StorageAccountCredentialList/StorageAccountList/TriggerList/UserList which actually were not used by SDK users
• Deleted model DataBoxEdgeMoveRequest/ResourceTypeSku/SkuInformation which actually were not used by SDK users

3.0.0b1 (2025-08-06)

Breaking Changes

• This package now only targets the latest Api-Version available on Azure and removes APIs of other Api-Version. After this change, the package can have much smaller size. If your application requires a specific and non-latest Api-Version, it's recommended to pin this package to the previous released version; If your application always only use latest Api-Version, please ignore this change.

2.0.0 (2025-02-19)

Features Added

• Model DataBoxEdgeSku has a new parameter capabilities

Breaking Changes

• Removed subfolders of some unused Api-Versions for smaller package size. If your application requires a specific and non-latest Api-Version, it's recommended to pin this package to the previous released version; If your application always only use latest Api-Version, please ignore this change.

2.0.0b1 (2023-02-13)

Features Added

• Added operation DevicesOperations.create_or_update
• Added operation group DeviceCapacityCheckOperations
• Added operation group DeviceCapacityInfoOperations
• Added operation group DiagnosticSettingsOperations
• Added operation group SupportPackagesOperations
• Model DataBoxEdgeDevice has a new parameter data_residency
• Model DataBoxEdgeDevice has a new parameter system_data_properties_system_data
• Model DataBoxEdgeDeviceExtendedInfo has a new parameter cloud_witness_container_name
• Model DataBoxEdgeDeviceExtendedInfo has a new parameter cloud_witness_storage_account_name
• Model DataBoxEdgeDeviceExtendedInfo has a new parameter cloud_witness_storage_endpoint
• Model DataBoxEdgeDeviceExtendedInfo has a new parameter cluster_witness_type
• Model DataBoxEdgeDeviceExtendedInfo has a new parameter file_share_witness_location
• Model DataBoxEdgeDeviceExtendedInfo has a new parameter file_share_witness_username
• Model DataBoxEdgeDeviceExtendedInfo has a new parameter system_data
• Model DataBoxEdgeSku has a new parameter capabilities
• Model Order has a new parameter kind
• Model Order has a new parameter order_id
• Model UpdateDetails has a new parameter friendly_version_number
• Model UpdateDetails has a new parameter installation_impact
• Model UpdateSummary has a new parameter last_successful_install_job_date_time
• Model UpdateSummary has a new parameter last_successful_scan_job_time
• Operation UsersOperations.list_by_data_box_edge_device has a new optional parameter filter

Breaking Changes

• Operation UsersOperations.list_by_data_box_edge_device no longer has parameter expand
• Parameter user_type of model User is now required
• Removed operation DevicesOperations.begin_create_or_update

1.0.0 (2021-04-22)

Features

• Model Share has a new parameter system_data
• Model NodeList has a new parameter next_link
• Model Operation has a new parameter is_data_action
• Model IoTRole has a new parameter system_data
• Model IoTRole has a new parameter compute_resource
• Model Order has a new parameter shipment_type
• Model Order has a new parameter system_data
• Model Role has a new parameter system_data
• Model DataBoxEdgeDevice has a new parameter kind
• Model DataBoxEdgeDevice has a new parameter edge_profile
• Model DataBoxEdgeDevice has a new parameter identity
• Model DataBoxEdgeDevice has a new parameter resource_move_details
• Model DataBoxEdgeDevice has a new parameter system_data
• Model StorageAccountCredential has a new parameter system_data
• Model UpdateSummary has a new parameter last_download_job_status
• Model UpdateSummary has a new parameter last_completed_install_job_id
• Model UpdateSummary has a new parameter total_time_in_minutes
• Model UpdateSummary has a new parameter last_completed_download_job_id
• Model UpdateSummary has a new parameter last_install_job_status
• Model UpdateSummary has a new parameter updates
• Model UpdateSummary has a new parameter system_data
• Model DataBoxEdgeDeviceExtendedInfo has a new parameter channel_integrity_key_name
• Model DataBoxEdgeDeviceExtendedInfo has a new parameter channel_integrity_key_version
• Model DataBoxEdgeDeviceExtendedInfo has a new parameter key_vault_sync_status
• Model DataBoxEdgeDeviceExtendedInfo has a new parameter client_secret_store_id
• Model DataBoxEdgeDeviceExtendedInfo has a new parameter device_secrets
• Model DataBoxEdgeDeviceExtendedInfo has a new parameter client_secret_store_url
• Model FileEventTrigger has a new parameter system_data
• Model DataBoxEdgeSku has a new parameter shipment_types
• Model Alert has a new parameter system_data
• Model Container has a new parameter system_data
• Model User has a new parameter system_data
• Model Trigger has a new parameter system_data
• Model NetworkSettings has a new parameter system_data
• Model PeriodicTimerEventTrigger has a new parameter system_data
• Model BandwidthSchedule has a new parameter system_data
• Model OrderStatus has a new parameter tracking_information
• Model StorageAccount has a new parameter system_data
• Model DataBoxEdgeDevicePatch has a new parameter identity
• Model DataBoxEdgeDevicePatch has a new parameter edge_profile
• Added operation DevicesOperations.generate_certificate
• Added operation DevicesOperations.update_extended_information
• Added operation OrdersOperations.list_dc_access_code
• Added operation group AddonsOperations
• Added operation group MonitoringConfigOperations

Breaking changes

• Operation UsersOperations.list_by_data_box_edge_device has a new signature
• Parameter data_policy of model StorageAccount is now required
• Model SkuInformation no longer has parameter resource_type
• Model SkuInformation no longer has parameter capabilities
• Model SkuInformation no longer has parameter size
• Model DataBoxEdgeSku no longer has parameter restrictions
• Model ResourceTypeSku has a new signature

1.0.0b1 (2020-12-08)

This is beta preview version.

This version uses a next-generation code generator that introduces important breaking changes, but also important new features (like unified authentication and async programming).

General breaking changes

• Credential system has been completly revamped:

  • azure.common.credentials or msrestazure.azure_active_directory instances are no longer supported, use the azure-identity classes instead: https://pypi.org/project/azure-identity/
  • credentials parameter has been renamed credential

• The config attribute no longer exists on a client, configuration should be passed as kwarg. Example: MyClient(credential, subscription_id, enable_logging=True). For a complete set of supported options, see the parameters accept in init documentation of azure-core

• You can't import a version module anymore, use __version__ instead

• Operations that used to return a msrest.polling.LROPoller now returns a azure.core.polling.LROPoller and are prefixed with begin_.

• Exceptions tree have been simplified and most exceptions are now azure.core.exceptions.HttpResponseError (CloudError has been removed).

• Most of the operation kwarg have changed. Some of the most noticeable:

  • raw has been removed. Equivalent feature can be found using cls, a callback that will give access to internal HTTP response for advanced user
  • For a complete set of supported options, see the parameters accept in Request documentation of azure-core

General new features

• Type annotations support using typing. SDKs are mypy ready.
• This client has now stable and official support for async. Check the aio namespace of your package to find the async client.
• This client now support natively tracing library like OpenCensus or OpenTelemetry. See this tracing quickstart for an overview.

0.2.0 (2020-11-02)

Features

• Model IoTRole has a new parameter host_platform_type
• Model IoTRole has a new parameter io_tedge_agent_info
• Model Job has a new parameter refreshed_entity_id
• Model MountPointMap has a new parameter mount_type
• Model OrderStatus has a new parameter additional_order_details
• Added operation group ContainersOperations

0.1.0 (2020-01-08)

• Initial Release