Microsoft Azure SDK for Python

这是Microsoft Azure Traffic Manager管理客户端库。此包已在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-trafficmanager
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.trafficmanager import TrafficManagerManagementClient
import os

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

示例

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

• 在 docs.microsoft.com 上搜索 Traffic Manager 管理
• Azure Python Mgmt SDK 示例仓库

故障排除

下一步

提供反馈

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

版本历史

1.1.0 (2023-06-16)

新增功能

• 添加了操作 ProfilesOperations.check_traffic_manager_name_availability_v2
• 模型端点有一个新参数 always_serve

1.1.0b1 (2022-11-17)

新增功能

• 模型端点有一个新参数 always_serve

1.0.0 (2022-01-19)

功能

• 添加了模型 EndpointType

1.0.0b1 (2021-05-13)

这是测试预览版本。

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

一般破坏性更改

• 凭证系统已完全重制

  • 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 这样的跟踪库。请参阅此跟踪快速入门以获取概述。

0.51.0 (2019-01-08)

功能

• 模型端点有一个新参数 subnets
• 模型 Profile 有一个新参数 max_return
• 添加了操作组 TrafficManagerUserMetricsKeysOperations

0.50.0 (2018-05-25)

功能

• 模型端点有一个新参数 custom_headers
• 模型 MonitorConfig 有一个新参数 custom_headers
• 模型 MonitorConfig 有一个新参数 expected_status_code_ranges
• 模型 Profile 有一个新参数 traffic_view_enrollment_status
• 添加了操作组 HeatMapOperations
• 客户端类可以用作上下文管理器以保持底层 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 在轮询完成后调用时将不再引发异常，而是立即执行回调。

错误修复

• sdist 与 wheel 0.31.0 的兼容性

0.40.0 (2017-07-03)

功能

• 新的 MonitorConfig 设置
• 新的 Api 版本 2017-05-01

破坏性更改

• 将 "list_by_in_resource_group" 重命名为 "list_by_resource_group"
• 将 "list_all" 重命名为 "list_by_subscription"

0.30.0 (2017-04-20)

• 初始发布（ApiVersion 2017-03-01）

此 wheel 软件包是用 azure wheel 扩展构建的