Microsoft Azure SDK for Python

这是Microsoft Azure通信管理客户端库。此包已与Python 3.8+进行测试。要获取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.8+。
• Azure订阅

安装包

pip install azure-mgmt-communication
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.communication import CommunicationServiceManagementClient
import os

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

示例

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

• 在docs.microsoft.com上搜索通信管理
• Azure Python Mgmt SDK 样例仓库

故障排除

下一步操作

提供反馈

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

发行历史

2.1.0 (2024-03-18)

新增功能

• 模型 CommunicationServiceResource 新增参数 identity
• 模型 CommunicationServiceResourceUpdate 新增参数 identity

2.1.0b2 (2023-12-18)

新增功能

• 添加了操作组 SuppressionListAddressesOperations
• 添加了操作组 SuppressionListsOperations

2.1.0b1 (2023-09-19)

新增功能

• 模型 CommunicationServiceResource 新增参数 identity
• 模型 CommunicationServiceResourceUpdate 新增参数 identity

2.0.0 (2023-04-03)

新增功能

• 添加了操作组 CommunicationServicesOperations
• 添加了操作组 DomainsOperations
• 添加了操作组 EmailServicesOperations
• 添加了操作组 SenderUsernamesOperations
• 模型 CommunicationServiceResource 新增参数 linked_domains
• 模型 Resource 新增参数 system_data

重大变更

• 模型 CommunicationServiceResource 的 location 参数现在为必填
• 删除了操作组 CommunicationServiceOperations
• 删除了操作组 OperationStatusesOperations

2.0.0b3 (2023-03-23)

新增功能

• 添加了操作 CommunicationServicesOperations.regenerate_key
• 添加了操作 CommunicationServicesOperations.update
• 添加了操作组 SenderUsernamesOperations

重大变更

• 模型 DomainResource 不再包含参数 valid_sender_usernames
• 模型 UpdateDomainRequestParameters 不再包含参数 valid_sender_usernames
• 删除了操作 CommunicationServicesOperations.begin_regenerate_key
• 删除了操作 CommunicationServicesOperations.begin_update

2.0.0b2 (2022-11-28)

其他变更

• 在github仓库中添加了生成的示例
• 停止支持python<3.7.0

2.0.0b1 (2022-06-07)

功能

• 添加了操作组 CommunicationServicesOperations
• 添加了操作组 DomainsOperations
• 添加了操作组 EmailServicesOperations
• 模型 CommunicationServiceResource 新增参数 linked_domains
• 模型 Resource 新增参数 system_data

重大变更

• 模型 CommunicationServiceResource 的 location 参数现在为必填
• 删除了操作组 CommunicationServiceOperations
• 删除了操作组 OperationStatusesOperations

1.0.0 (2021-03-29)

功能

• 模型 CommunicationServiceResource 新增参数 system_data
• 模型 Operation 新增参数 action_type
• 模型 Operation 新增参数 is_data_action
• 添加了操作 CommunicationServiceOperations.check_name_availability

重大变更

• 模型 Operation 不再包含参数 properties

1.0.0b4 (2020-11-16)

• 更新了 azure-mgmt-communication 版本。

1.0.0b3 (2020-10-06)

• 更新了 azure-mgmt-communication 版本。

1.0.0b2 (2020-09-22)

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

一般重大变更

• 凭证系统已完全重制

  • 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)。有关支持选项的完整列表，请参阅azure-core 初始化文档中的参数接受

• 无法再导入 version 模块，请使用 __version__ 代替

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

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

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

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

一般新功能

• 支持使用 typing 进行类型注解。SDKs 已准备好 mypy。
• 此客户端现在对异步操作提供稳定且官方的支持。检查您的包中的 aio 命名空间以找到异步客户端。
• 此客户端现在原生支持 OpenCensus 或 OpenTelemetry 等跟踪库。请参阅此跟踪快速入门指南以获取概述。

1.0.0b1 (2020-09-22)

• 初始版本