Microsoft Azure SDK for Python

这是Microsoft Azure日志分析管理客户端库。此软件包已在Python 2.7、3.5、3.6、3.7和3.8上进行了测试。要获取Azure库的更完整视图，请参阅azure sdk python发布。

用法

要了解如何使用此软件包，请参阅快速入门指南

有关文档和参考，请参阅Python SDK参考。有关此软件包的代码示例，请访问日志分析管理在docs.microsoft.com。有关不同Azure服务的其他代码示例，请访问示例存储库

提供反馈

如果在使用过程中遇到任何错误或有建议，请在项目的问题部分提交问题。

发布历史

12.0.0 (2021-11-16)

功能

• 模型表新增参数is_troubleshooting_allowed
• 模型表新增参数last_troubleshoot_date
• 模型表新增参数is_troubleshoot_enabled
• 新增操作TablesOperations.create
• 新增操作ClustersOperations.begin_update

重大变更

• 移除操作ClustersOperations.update

11.0.0 (2021-07-12)

功能

• 模型ClusterPatch新增参数billing_type
• 模型Workspace新增参数features
• 模型WorkspacePatch新增参数features
• 模型WorkspaceFeatures新增参数disable_local_auth

重大变更

• 模型Workspace不再有参数immediate_purge_data_on30_days
• 模型Workspace不再有参数enable_log_access_using_only_resource_permissions
• 模型Workspace不再有参数cluster_resource_id
• 模型Workspace不再有参数enable_data_export
• 模型WorkspacePatch不再有参数immediate_purge_data_on30_days
• 模型WorkspacePatch不再有参数enable_log_access_using_only_resource_permissions
• 模型WorkspacePatch不再有参数cluster_resource_id
• 模型WorkspacePatch不再有参数enable_data_export
• 模型CapacityReservationProperties不再有参数max_capacity

10.0.0 (2021-05-13)

功能

• 模型WorkspacePatch新增参数cluster_resource_id
• 模型WorkspacePatch新增参数immediate_purge_data_on30_days
• 模型WorkspacePatch新增参数enable_data_export
• 模型WorkspacePatch新增参数enable_log_access_using_only_resource_permissions
• 模型Workspace新增参数cluster_resource_id
• 模型Workspace新增参数immediate_purge_data_on30_days
• 模型Workspace新增参数enable_data_export
• 模型Workspace新增参数enable_log_access_using_only_resource_permissions

重大变更

• 模型WorkspacePatch不再有参数features
• 模型Table不再有参数is_troubleshooting_allowed
• 模型Table不再有参数is_troubleshoot_enabled
• 模型Table不再有参数last_troubleshoot_date
• 模型WorkspaceSku不再有参数max_capacity_reservation_level
• 模型Workspace不再有参数features

9.0.0 (2021-04-06)

功能

• 模型WorkspacePatch新增参数created_date
• 模型WorkspacePatch新增参数features
• 模型WorkspacePatch新增参数modified_date
• 模型WorkspacePatch新增参数force_cmk_for_query
• 模型Cluster新增参数last_modified_date
• 模型Cluster新增参数billing_type
• 模型Cluster新增参数is_double_encryption_enabled
• 模型Cluster新增参数is_availability_zones_enabled
• 模型Cluster新增参数created_date
• 模型Cluster新增参数capacity_reservation_properties
• 模型Cluster新增参数associated_workspaces
• 模型表新增参数is_troubleshooting_allowed
• 模型表新增参数last_troubleshoot_date
• 模型表新增参数is_troubleshoot_enabled
• 模型Identity新增参数user_assigned_identities
• 模型ClusterPatch新增参数identity
• 模型KeyVaultProperties新增参数key_rsa_size
• 模型Workspace新增参数created_date
• 模型Workspace新增参数features
• 模型Workspace新增参数modified_date
• 模型Workspace新增参数force_cmk_for_query

重大变更

• 模型Cluster不再有参数next_link
• 模型ErrorResponse新增签名

8.0.0 (2020-12-25)

重大变更

• 将客户端名称从OperationalInsightsManagementClient更改为LogAnalyticsManagementClient

7.0.0 (2020-12-17)

• GA版本

7.0.0b1 (2020-11-16)

这是测试预览版本。

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

一般重大变更

• 凭证系统已彻底重构

  • 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 属性不再存在，配置应通过 kwarg 传递。例如：MyClient(credential, subscription_id, enable_logging=True)。有关完整支持的选项，请参阅 azure-core 初始化文档中的参数接受

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

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

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

• 大多数操作 kwarg 都已更改。其中一些最明显的变化

  • raw 已被移除。等效功能可以通过使用 cls 来找到，这是一个回调，将允许高级用户访问内部 HTTP 响应
  • 有关完整支持的选项，请参阅 azure-core 请求文档中的参数接受

2.0.0(2020-11-09)

重大变更

• Model DataExport 不再具有参数 all_tables

1.0.0 (2020-08-31)

功能

• REST 调用的 api-version 从 2020-03-01-preview 更改为 2020-08-01
• DataSourceType 有新的枚举值

0.7.0 (2020-07-09)

功能

• Model DataSource 有一个新的参数 etag
• Model SavedSearch 有一个新的参数 etag

重大变更

• Model DataSource 不再具有参数 e_tag
• Model SavedSearch 不再具有参数 e_tag

0.6.0 (2020-05-28)

功能

• Model SavedSearch 有一个新的参数 function_parameters
• Model SavedSearch 有一个新的参数 function_alias
• Model WorkspacePatch 有一个新的参数 workspace_capping
• Model Workspace 有一个新的参数 workspace_capping
• 添加了操作组 AvailableServiceTiersOperations
• 添加了操作组 TablesOperations
• 添加了操作组 DeletedWorkspacesOperations

重大变更

• 操作 WorkspacesOperations.delete 有一个新的签名
• 删除了操作 WorkspacesOperations.available_service_tiers
• Model WorkspaceSku 有一个新的签名

0.5.0 (2020-04-22)

重大变更

• 将客户端名称恢复为 LogAnalyticsManagementClient，因为之前的更改不是故意的

0.4.0 (2020-04-20)

功能

• Model LinkedService 有一个新的参数 provisioning_state
• 添加了操作 WorkspacesOperations.available_service_tiers
• 添加了操作组 ManagementGroupsOperations
• 添加了操作组 GatewaysOperations
• 添加了操作组 OperationStatusesOperations
• 添加了操作组 SchemaOperations
• 添加了操作组 WorkspacePurgeOperations
• 添加了操作组 UsagesOperations
• 添加了操作组 SharedKeysOperations
• 添加了操作组 StorageInsightConfigsOperations
• 添加了操作组 IntelligencePacksOperations

重大变更

• 删除了操作 WorkspacesOperations.list_usages
• 删除了操作 WorkspacesOperations.get_shared_keys
• 删除了操作 WorkspacesOperations.disable_intelligence_pack
• 删除了操作 WorkspacesOperations.list_intelligence_packs
• 删除了操作 WorkspacesOperations.list_management_groups
• 删除了操作 WorkspacesOperations.enable_intelligence_pack
• 删除了操作组 StorageInsightsOperations
• 删除了操作组 OperationalInsightsManagementClientOperationsMixin

0.3.0 (2020-04-08)

功能

• Model OperationDisplay 有一个新的参数 description
• Model LinkedService 有一个新的参数 write_access_resource_id
• Model Workspace 有一个新的参数 public_network_access_for_ingestion
• Model Workspace 有一个新的参数 public_network_access_for_query
• Model Workspace 有一个新的参数 private_link_scoped_resources
• 添加了操作组 DataExportsOperations
• 添加了操作组 LinkedStorageAccountsOperations
• 添加了操作组 OperationalInsightsManagementClientOperationsMixin
• 添加了操作组 ClustersOperations

重大变更

• 模型 Workspace 的 location 参数现在是必需的
• 操作 LinkedServicesOperations.create_or_update 有一个新的签名
• 操作 SavedSearchesOperations.delete 有一个新的签名
• 操作 SavedSearchesOperations.create_or_update 有一个新的签名
• 操作 SavedSearchesOperations.get 有一个新的签名
• 操作 LinkedServicesOperations.create_or_update 有一个新的签名
• Model ProxyResource 不再具有参数 tags
• Model SavedSearchesListResult 不再具有参数 metadata
• Model Resource 不再具有参数 location
• Model Resource 不再具有参数 tags
• 模型工作区不再有参数来源
• 模型工作区不再有参数 portal_url
• 已删除操作 WorkspacesOperations.purge
• 已删除操作 WorkspacesOperations.get_search_results
• 已删除操作 WorkspacesOperations.list_link_targets
• 已删除操作 WorkspacesOperations.get_schema
• 已删除操作 WorkspacesOperations.update_search_results

一般性重大更改

本版本使用下一代代码生成器，可能会引入重大更改。总结来说，一些模块可见性/导入不正确，并且已被重命名。这修复了由最初不应使用的一些类引起的几个问题。

• 无法从 azure.mgmt.loganalytics.log_analytics_management_client 导入 LogAnalyticsManagementClient（从 azure.mgmt.loganalytics 导入 OperationalInsightsManagementClient 与之前相同）
• LogAnalyticsManagementClientConfiguration 的导入已从 azure.mgmt.loganalytics.log_analytics_management_client 移动到 azure.mgmt.loganalytics
• 从 "models" 子模块中无法再使用 azure.mgmt.loganalytics.models.my_class 导入模型 MyClass（从 azure.mgmt.loganalytics.models 导入与之前相同）
• 从 azure.mgmt.loganalytics.operations.my_class_operations 无法再导入来自 operations 子模块的操作类 MyClassOperations（从 azure.mgmt.loganalytics.operations 导入与之前相同）

最后但同样重要的是，HTTP 连接池现在默认启用。您应始终使用客户端作为上下文管理器，或调用 close()，或每个进程使用不超过一个客户端。

0.2.0 (2018-05-29)

功能

• 模型 IntelligencePack 有一个新参数 display_name
• 模型 SavedSearch 有一个新参数 name
• 模型 SavedSearch 有一个新参数 type
• 添加了操作 WorkspacesOperations.purge
• 添加了操作 WorkspacesOperations.update
• 添加了操作组 Operations
• 客户端类可以用作上下文管理器，以保持底层 HTTP 会话打开以提高性能

重大变更

• 模型 SavedSearch 不再有参数 etag（由 e_tag 替代）
• 模型 SearchMetadata 不再有参数 etag（由 e_tag 替代）

一般性重大更改

本版本使用下一代代码生成器，可能会引入重大更改。

• 模型签名现在仅使用关键字参数语法。所有位置参数必须重写为关键字参数。为了在大多数情况下保持自动完成，现在为 Python 2 和 Python 3 生成模型。Python 3 使用 "*" 语法用于关键字仅参数。
• 枚举类型现在使用 "str" 混合（类 AzureEnum(str, Enum)）以提高遇到未识别枚举值时的行为。虽然这不是一个重大更改，但区别很重要，并在此处记录：https://docs.pythonlang.cn/3/library/enum.html#others 简要概述
  • "is" 应该完全不用。
  • "format" 将返回字符串值，其中 "%s" 字符串格式化将返回 NameOfEnum.stringvalue。应首选格式化语法。
• 新长时间运行的操作
  • 返回类型从 msrestazure.azure_operation.AzureOperationPoller 更改为 msrest.polling.LROPoller。外部 API 与之前相同。
  • 现在返回类型始终为 msrest.polling.LROPoller，无论使用的是哪个可选参数。
  • 使用 raw=True 时的行为已更改。现在不再返回初始调用结果作为 ClientRawResponse 而不轮询，而是返回一个 LROPoller。轮询后，最终资源将作为 ClientRawResponse 返回。
  • 新增 polling 参数。默认行为是 Polling=True，它将使用 ARM 算法轮询。当 Polling=False 时，将返回初始调用的响应，而不轮询。
  • polling 参数接受 msrest.polling.PollingMethod 子类的实例。
  • add_done_callback 在轮询完成后调用时将不再引发异常，而是立即执行回调。

错误修复

• sdist 与 wheel 0.31.0 的兼容性

0.1.0 (2017-11-01)

• 初始发布

感谢 jmalobicky 对测试该包的帮助。