Microsoft Azure SDK for Python

这是Microsoft Azure DNS管理客户端库。此包已与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-dns
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.dns import DnsManagementClient
import os

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

示例

此包的代码示例可以在

• docs.microsoft.com 上搜索 DNS 管理
• Azure Python Mgmt SDK 样例库

故障排除

下一步操作

提供反馈

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

发布历史

8.1.0 (2023-06-14)

新增功能

• 添加了 DnssecConfigsOperations 操作组
• Model RecordSet 有一个新参数 ds_records
• Model RecordSet 有一个新参数 naptr_records
• Model RecordSet 有一个新参数 tlsa_records
• Model Zone 有一个新参数 signing_keys
• Model Zone 有一个新参数 system_data

8.1.0b1 (2023-02-10)

其他更改

• 在 github 仓库中添加了生成示例
• 不再支持 python<3.7.0

8.0.0 (2021-04-14)

• GA 发布

8.0.0b1 (2021-03-10)

这是 beta 预览版本。有关详细的变更日志，请参阅等效的稳定版本 10.2.0 (https://pypi.ac.cn/project/azure-mgmt-network/10.2.0/)

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

一般性重大更改

• 凭证系统已完全重写

  • 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 请求文档中的参数接受

一般性新功能

• 支持使用 typing 进行类型注解。SDKs 已准备好使用 mypy。
• 此客户端现在稳定且官方支持异步。检查您的包中的 aio 命名空间以找到异步客户端。
• 此客户端现在原生支持像 OpenCensus 或 OpenTelemetry 这样的跟踪库。有关概述，请参阅此 跟踪快速入门

3.0.0 (2019-06-18)

一般性重大更改

本版本使用下一代代码生成器，如果在从v20xx_yy_zz API文件夹导入时，可能会引入破坏性更改。总的来说，一些模块的可见性/导入不正确，已被重命名。这修复了由于使用本不应该使用的方法类而引起的一些问题。

• 无法从 azure.mgmt.dns.v20xx_yy_zz.dns_management_client 导入 DnsManagementClient anymore（从 azure.mgmt.dns.v20xx_yy_zz 导入的行为与之前相同）
• 已将 DnsManagementClientConfiguration 的导入从 azure.mgmt.dns.v20xx_yy_zz.dns_management_client 移动到 azure.mgmt.dns.v20xx_yy_zz
• 来自 "models" 子模块的模型 MyClass 不能再使用 azure.mgmt.dns.v20xx_yy_zz.models.my_class 导入（从 azure.mgmt.dns.v20xx_yy_zz.models 导入的行为与之前相同）
• 来自 operations 子模块的操作类 MyClassOperations 不能再使用 azure.mgmt.dns.v20xx_yy_zz.operations.my_class_operations 导入（从 azure.mgmt.dns.v20xx_yy_zz.operations 导入的行为与之前相同）

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

2.1.0 (2018-09-10)

功能

• 模型 RecordSet 添加了新的参数 target_resource
• 添加了操作组 DnsResourceReferenceOperations

2.0.0 (2018-07-01)

错误修复

• 修复ARM兼容性（正确设置位置、标记等）

2.0.0rc2（2018-07-05）

功能

• 客户端类可以作为上下文管理器使用，以保持底层HTTP会话打开以提高性能

一般性重大更改

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

• 模型签名现在仅使用关键字参数语法。所有位置参数都必须重写为关键字参数。为了在大多数情况下保持自动完成，模型现在为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，则不会引发错误，而是立即执行回调。

错误修复

• 与wheel 0.31.0的sdist兼容性

2.0.0rc1（2018-03-14）

功能

• 添加公共/私有区域
• 添加记录集列表操作 record_sets.list_all_by_dns_zone
• 添加区域更新操作 zones.update

破坏性更改

• 创建区域时现在需要 'zone_type'（'Public'等效于之前的操作）

新API版本 2018-03-01-preview

1.2.0 (2017-10-26)

• 添加记录类型 CAA
• 删除删除操作的无意义返回类型

API版本从2016-04-01更改为2017-09-01

1.1.0 (2017-10-10)

• 将"recordsetnamesuffix"过滤器参数添加到列表操作

1.0.1 (2017-04-20)

此wheel软件包现在使用azure wheel扩展构建

1.0.0 (2016-12-12)

• 初始发布