Microsoft Azure SDK for Python

这是Microsoft Azure Maps客户端库。此软件包已在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-maps
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.maps import AzureMapsManagementClient
import os

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

示例

该包的代码示例可在

• docs.microsoft.com 上的搜索地图
• Azure Python Mgmt SDK 示例仓库

故障排除

下一步

提供反馈

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

版本历史

2.1.0 (2023-09-11)

新增功能

• 添加了 AccountsOperations.list_sas 操作
• 添加了 MapsOperations.list_subscription_operations 操作
• 模型创建器有了新的参数 system_data
• 模型维度有了新的参数 internal_metric_name
• 模型维度有了新的参数 internal_name
• 模型维度有了新的参数 source_mdm_namespace
• 模型维度有了新的参数 to_be_exported_to_shoebox
• 模型 MapsAccount 有了新的参数 identity
• 模型 MapsAccountProperties 有了新的参数 cors
• 模型 MapsAccountProperties 有了新的参数 encryption
• 模型 MapsAccountProperties 有了新的参数 linked_resources
• 模型 MapsAccountUpdateParameters 有了新的参数 cors
• 模型 MapsAccountUpdateParameters 有了新的参数 encryption
• 模型 MapsAccountUpdateParameters 有了新的参数 identity
• 模型 MapsAccountUpdateParameters 有了新的参数 linked_resources
• 模型 MetricSpecification 有了新的参数 internal_metric_name
• 模型 MetricSpecification 有了新的参数 lock_aggregation_type
• 模型 MetricSpecification 有了新的参数 source_mdm_account
• 模型 MetricSpecification 有了新的参数 source_mdm_namespace
• 模型 MetricSpecification 有了新的参数 supported_aggregation_types

2.1.0b1 (2022-11-01)

新增功能

• 添加了 AccountsOperations.list_sas 操作
• 添加了 MapsOperations.list_subscription_operations 操作
• 模型创建器有了新的参数 system_data
• 模型维度有了新的参数 internal_metric_name
• 模型维度有了新的参数 internal_name
• 模型维度有了新的参数 source_mdm_namespace
• 模型维度有了新的参数 to_be_exported_to_shoebox
• 模型 MapsAccount 有了新的参数 identity
• 模型 MapsAccountProperties 有了新的参数 cors
• 模型 MapsAccountProperties 有了新的参数 linked_resources
• 模型 MapsAccountUpdateParameters 有了新的参数 cors
• 模型 MapsAccountUpdateParameters 有了新的参数 identity
• 模型 MapsAccountUpdateParameters 有了新的参数 linked_resources
• 模型 MetricSpecification 有了新的参数 internal_metric_name
• 模型 MetricSpecification 有了新的参数 source_mdm_account

2.0.0 (2021-05-08)

功能

• 模型 CreatorUpdateParameters 有了新的参数 storage_units
• 模型 CreatorUpdateParameters 有了新的参数 provisioning_state
• 模型 MapsOperations 有了新的参数 next_link
• 模型 CreatorList 有了新的参数 next_link
• 模型 MapsAccountKeys 有了新的参数 secondary_key_last_updated
• 模型 MapsAccountKeys 有了新的参数 primary_key_last_updated
• 模型 MapsAccount 有了新的参数 kind
• 模型 MapsAccounts 有了新的参数 next_link

重大变更

• 操作 AccountsOperations.create_or_update 有了新的签名
• 操作 CreatorsOperations.create_or_update 有了新的签名
• 模型 Creator 的属性参数现在为必填
• 模型 MapsAccount 的 sku 参数现在为必填
• 模型 CreatorProperties 有了新的必填参数 storage_units
• 模型 MapsAccountKeys 不再具有参数 id
• 模型 MapsAccountUpdateParameters 有了新的签名
• 模型 MapsAccountProperties 有了新的签名
• 已移除操作组 PrivateAtlasesOperations

1.0.0 (2021-04-23)

• GA 版本

1.0.0b1 (2020-12-01)

这是一个测试预览版本。

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

一般重大变更

• 凭证系统已完全重制

  • azure.common.credentials 或 msrestazure.azure_active_directory 实例不再受支持，请改用 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.1.0 (2018-05-07)

• 初始发布