Microsoft Azure SDK for Python

这是Microsoft Azure Data Box管理客户端库。此软件包已在Python 3.7+上进行了测试。要查看Azure库的完整视图，请参阅azure sdk python发布。

免责声明

Azure SDK Python包对Python 2.7的支持已于2022年1月1日结束。有关更多信息及问题，请参阅https://github.com/Azure/azure-sdk-for-python/issues/20691

入门

先决条件

• 使用此软件包需要Python 3.7+。
• Azure订阅

安装软件包

pip install azure-mgmt-databox
pip install azure-identity

身份验证

默认情况下，Azure Active Directory令牌身份验证依赖于以下环境变量的正确配置。

• AZURE_CLIENT_ID 用于 Azure 客户端 ID。
• AZURE_TENANT_ID 用于 Azure 租户 ID。
• AZURE_CLIENT_SECRET 用于 Azure 客户端密钥。

此外，还可以通过环境变量 AZURE_SUBSCRIPTION_ID 配置 Azure 订阅 ID。

以上配置后，客户端可以通过以下代码进行认证

from azure.identity import DefaultAzureCredential
from azure.mgmt.databox import DataBoxManagementClient
import os

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

示例

本包的代码示例可以在以下位置找到

• 在 docs.microsoft.com 上搜索 Data Box Management
• Azure Python Mgmt SDK 示例仓库

故障排除

下一步

提供反馈

如果您遇到任何错误或建议，请在项目的 问题 部分提交问题。

发布历史

2.0.0 (2023-05-22)

新增功能

• 添加了操作 JobsOperations.mark_devices_shipped
• 添加了操作组 DataBoxManagementClientOperationsMixin
• 模型 CopyProgress 新增参数 actions
• 模型 CopyProgress 新增参数 error
• 模型 DataBoxDiskCopyProgress 新增参数 actions
• 模型 DataBoxDiskCopyProgress 新增参数 error
• 模型 DataBoxDiskJobDetails 新增参数 actions
• 模型 DataBoxDiskJobDetails 新增参数 data_center_code
• 模型 DataBoxDiskJobDetails 新增参数 datacenter_address
• 模型 DataBoxDiskJobDetails 新增参数 device_erasure_details
• 模型 DataBoxDiskJobDetails 新增参数 expected_data_size_in_tera_bytes
• 模型 DataBoxDiskJobDetails 新增参数 granular_copy_log_details
• 模型 DataBoxDiskJobDetails 新增参数 granular_copy_progress
• 模型 DataBoxDiskJobDetails 新增参数 last_mitigation_action_on_job
• 模型 DataBoxDiskJobDetails 新增参数 reverse_shipping_details
• 模型 DataBoxHeavyJobDetails 新增参数 actions
• 模型 DataBoxHeavyJobDetails 新增参数 data_center_code
• 模型 DataBoxHeavyJobDetails 新增参数 datacenter_address
• 模型 DataBoxHeavyJobDetails 新增参数 device_erasure_details
• 模型 DataBoxHeavyJobDetails 新增参数 expected_data_size_in_tera_bytes
• 模型 DataBoxHeavyJobDetails 新增参数 last_mitigation_action_on_job
• 模型 DataBoxHeavyJobDetails 新增参数 reverse_shipping_details
• 模型 DataBoxJobDetails 新增参数 actions
• 模型 DataBoxJobDetails 新增参数 data_center_code
• 模型 DataBoxJobDetails 新增参数 datacenter_address
• 模型 DataBoxJobDetails 新增参数 device_erasure_details
• 模型 DataBoxJobDetails 新增参数 expected_data_size_in_tera_bytes
• 模型 DataBoxJobDetails 新增参数 last_mitigation_action_on_job
• 模型 DataBoxJobDetails 新增参数 reverse_shipping_details
• 模型 DataImportDetails 新增参数 log_collection_level
• 模型 EncryptionPreferences 新增参数 hardware_encryption
• 模型 JobDetails 新增参数 actions
• 模型 JobDetails 新增参数 data_center_code
• 模型 JobDetails 新增参数 datacenter_address
• 模型 JobDetails 新增参数 device_erasure_details
• 模型 JobDetails 新增参数 expected_data_size_in_tera_bytes
• 模型 JobDetails 新增参数 last_mitigation_action_on_job
• 模型 JobDetails 新增参数 reverse_shipping_details
• 模型 JobResource 新增参数 reverse_shipping_details_update
• 模型 JobResource 新增参数 reverse_transport_preference_update
• 模型 JobResource 新增参数 system_data
• 模型 Preferences 新增参数 reverse_transport_preferences
• 模型 Preferences 新增参数 storage_account_access_tier_preferences
• 模型 RegionConfigurationRequest 新增参数 datacenter_address_request
• 模型 RegionConfigurationResponse 新增参数 datacenter_address_response
• 模型 ShippingAddress 新增参数 skip_address_validation
• 模型 ShippingAddress 新增参数 tax_identification_number
• 模型 SkuInformation 新增参数 countries_within_commerce_boundary
• 模型 TransportPreferences 新增参数 is_updated
• 模型 UpdateJobDetails 新增参数 preferences
• 模型 UpdateJobDetails 新增参数 return_to_customer_package_details
• 模型 UpdateJobDetails 新增参数 reverse_shipping_details

重大更改

• 模型 DataBoxDiskJobDetails 不再具有参数 expected_data_size_in_terabytes
• 模型 DataBoxHeavyJobDetails 不再具有参数 expected_data_size_in_terabytes
• 模型 DataBoxJobDetails 不再具有参数 expected_data_size_in_terabytes
• 模型 DiskScheduleAvailabilityRequest 新增必需参数 expected_data_size_in_tera_bytes
• 模型 DiskScheduleAvailabilityRequest 不再具有参数 expected_data_size_in_terabytes
• 模型 JobDetails 不再具有参数 expected_data_size_in_terabytes

2.0.0b1 (2023-02-10)

新增功能

• 添加了操作 JobsOperations.mark_devices_shipped
• 添加了操作组 DataBoxManagementClientOperationsMixin
• 模型 DataBoxDiskJobDetails 新增参数 actions
• 模型 DataBoxDiskJobDetails 新增参数 data_center_code
• 模型 DataBoxDiskJobDetails 新增参数 datacenter_address
• 模型 DataBoxDiskJobDetails 新增参数 device_erasure_details
• 模型 DataBoxDiskJobDetails 新增参数 expected_data_size_in_tera_bytes
• 模型 DataBoxDiskJobDetails 新增参数 granular_copy_log_details
• 模型 DataBoxDiskJobDetails 新增参数 granular_copy_progress
• 模型 DataBoxDiskJobDetails 新增参数 last_mitigation_action_on_job
• 模型 DataBoxDiskJobDetails 新增参数 reverse_shipping_details
• 模型 DataBoxHeavyJobDetails 新增参数 actions
• 模型 DataBoxHeavyJobDetails 新增参数 data_center_code
• 模型 DataBoxHeavyJobDetails 新增参数 datacenter_address
• 模型 DataBoxHeavyJobDetails 新增参数 device_erasure_details
• 模型 DataBoxHeavyJobDetails 新增参数 expected_data_size_in_tera_bytes
• 模型 DataBoxHeavyJobDetails 新增参数 last_mitigation_action_on_job
• 模型 DataBoxHeavyJobDetails 新增参数 reverse_shipping_details
• 模型 DataBoxJobDetails 新增参数 actions
• 模型 DataBoxJobDetails 新增参数 data_center_code
• 模型 DataBoxJobDetails 新增参数 datacenter_address
• 模型 DataBoxJobDetails 新增参数 device_erasure_details
• 模型 DataBoxJobDetails 新增参数 expected_data_size_in_tera_bytes
• 模型 DataBoxJobDetails 新增参数 last_mitigation_action_on_job
• 模型 DataBoxJobDetails 新增参数 reverse_shipping_details
• 模型 DataImportDetails 新增参数 log_collection_level
• 模型 JobDetails 新增参数 actions
• 模型 JobDetails 新增参数 data_center_code
• 模型 JobDetails 新增参数 datacenter_address
• 模型 JobDetails 新增参数 device_erasure_details
• 模型 JobDetails 新增参数 expected_data_size_in_tera_bytes
• 模型 JobDetails 新增参数 last_mitigation_action_on_job
• 模型 JobDetails 新增参数 reverse_shipping_details
• 模型 JobResource 新增参数 reverse_shipping_details_update
• 模型 JobResource 新增参数 reverse_transport_preference_update
• 模型 JobResource 新增参数 system_data
• 模型 Preferences 新增参数 reverse_transport_preferences
• 模型 Preferences 新增参数 storage_account_access_tier_preferences
• 模型 RegionConfigurationRequest 新增参数 datacenter_address_request
• 模型 RegionConfigurationResponse 新增参数 datacenter_address_response
• 模型 SkuInformation 新增参数 countries_within_commerce_boundary
• 模型 TransportPreferences 新增参数 is_updated
• 模型 UpdateJobDetails 新增参数 preferences
• 模型 UpdateJobDetails 新增参数 return_to_customer_package_details
• 模型 UpdateJobDetails 新增参数 reverse_shipping_details

重大更改

• 模型 DataBoxDiskJobDetails 不再具有参数 expected_data_size_in_terabytes
• 模型 DataBoxHeavyJobDetails 不再具有参数 expected_data_size_in_terabytes
• 模型 DataBoxJobDetails 不再具有参数 expected_data_size_in_terabytes
• 模型 DiskScheduleAvailabilityRequest 新增必需参数 expected_data_size_in_tera_bytes
• 模型 DiskScheduleAvailabilityRequest 不再具有参数 expected_data_size_in_terabytes
• 模型 JobDetails 不再具有参数 expected_data_size_in_terabytes

1.0.0 (2021-03-18)

• GA 版本

1.0.0b1 (2020-11-30)

这是测试预览版本。

此版本使用下一代代码生成器，引入了重要的不兼容更改，但也引入了重要的新功能（如统一身份验证和异步编程）。

一般不兼容更改

• 凭据系统已完全重制

  • azure.common.credentials 或 msrestazure.azure_active_directory 实例不再受支持，请使用 azure-identity 类：[https://pypi.ac.cn/project/azure-identity/](https://pypi.ac.cn/project/azure-identity/)
  • credentials 参数已重命名为 credential

• 客户端上的 config 属性不再存在，配置应作为关键字参数传递。示例：MyClient(credential, subscription_id, enable_logging=True)。有关受支持选项的完整集合，请参阅[https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)中的 azure-core 初始化文档

• 您不能再导入 version 模块，请使用 __version__ 代替

• 以前返回 msrest.polling.LROPoller 的操作现在返回 azure.core.polling.LROPoller 并以 begin_ 前缀。

• 异常树已简化，大多数异常现在为 azure.core.exceptions.HttpResponseError（《CloudError》已删除）。

• 大多数操作关键字参数已更改。以下是一些最显著的更改：

  • raw 已删除。等效功能可以通过使用 cls 来找到，这是一个回调，将为高级用户提供对内部 HTTP 响应的访问。
  • 有关受支持选项的完整集合，请参阅[https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)中的 azure-core 请求文档

一般新功能

• 支持使用 typing 进行类型注解。SDK 已准备好使用 mypy。
• 此客户端现在提供稳定和官方的异步支持。检查您的包中的 aio 命名空间以查找异步客户端。
• 此客户端现在原生支持像 OpenCensus 或 OpenTelemetry 这样的跟踪库。有关概述，请参阅此[https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/core/azure-core-tracing-opentelemetry](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/core/azure-core-tracing-opentelemetry) 跟踪快速入门。

0.2.0 (2020-02-12)

功能

• 模型 DestinationAccountDetails 有一个新参数 share_password
• 模型 ValidateAddress 有一个新参数 transport_preferences
• 模型 DataBoxDiskJobSecrets 有一个新参数 dc_access_security_code
• 模型 Preferences 有一个新参数 transport_preferences
• 模型 DestinationManagedDiskDetails 有一个新参数 share_password
• 模型 AddressValidationOutput 有一个新参数 error
• 模型 DataBoxDiskJobDetails 有一个新参数 expected_data_size_in_terabytes
• 模型 DataboxJobSecrets 有一个新参数 dc_access_security_code
• 模型 JobResource 有一个新参数 delivery_info
• 模型 JobResource 有一个新参数 is_cancellable_without_fee
• 模型 JobResource 有一个新参数 delivery_type
• 模型 CopyProgress 有一个新参数 invalid_file_bytes_uploaded
• 模型 CopyProgress 有一个新参数 files_errored_out
• 模型 CopyProgress 有一个新参数 invalid_files_processed
• 模型 CopyProgress 有一个新参数 renamed_container_count
• 模型 CopyProgress 有一个新参数 data_destination_type
• 模型 DataBoxHeavyJobSecrets 有一个新参数 dc_access_security_code
• 模型 DestinationStorageAccountDetails 有一个新参数 share_password
• 模型 AccountCredentialDetails 有一个新参数 data_destination_type
• 模型 JobDetails 有一个新参数 expected_data_size_in_terabytes
• 模型 JobSecrets 有一个新参数 dc_access_security_code
• 模型 DataBoxJobDetails 有一个新参数 device_password
• 模型 DataBoxJobDetails 有一个新参数 expected_data_size_in_terabytes
• 模型 DataBoxHeavyJobDetails 新增参数 device_password
• 模型 DataBoxHeavyJobDetails 新增参数 expected_data_size_in_terabytes
• 添加操作 ServiceOperations.validate_inputs_by_resource_group
• 添加操作 ServiceOperations.validate_inputs
• 添加操作 ServiceOperations.list_available_skus_by_resource_group
• 添加操作 ServiceOperations.region_configuration

重大更改

• 操作 ServiceOperations.validate_address_method 具有新的签名
• 模型 ValidateAddress 新增必需参数 validation_type
• 模型 DataBoxDiskJobDetails 不再具有参数 expected_data_size_in_tera_bytes
• 模型 JobDetails 不再具有参数 expected_data_size_in_tera_bytes
• 模型 DataBoxJobDetails 不再具有参数 expected_data_size_in_tera_bytes
• 模型 DataBoxHeavyJobDetails 不再具有参数 expected_data_size_in_tera_bytes

0.1.0 (2020-02-05)

• 初始发布