Microsoft Azure SDK for Python

这是Microsoft Azure Service Fabric Management Client Library。此包已在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-servicefabric
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.servicefabric import ServiceFabricManagementClient
import os

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

示例

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

• 在 docs.microsoft.com 上搜索服务Fabric管理
• Azure Python Mgmt SDK 示例存储库

故障排除

下一步

提供反馈

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

发布历史记录

2.1.0 (2023-12-18)

新增功能

• 添加了模型 ClusterVersionsEnvironment

2.1.0b1 (2022-11-08)

新增功能

• 添加了模型 ClusterVersionsEnvironment

2.0.0 (2021-09-02)

功能

• 模型 NodeTypeDescription 有一个新参数 multiple_availability_zones
• 模型 NodeTypeDescription 有一个新参数 is_stateless
• 模型 ApplicationResource 有一个新参数 system_data
• 模型 ApplicationResourceUpdate 有一个新参数 system_data
• 模型 Cluster 有一个新参数 wave_upgrade_paused
• 模型 Cluster 有一个新参数 system_data
• 模型 Cluster 有一个新参数 upgrade_pause_end_timestamp_utc
• 模型 Cluster 有一个新参数 notifications
• 模型 Cluster 有一个新参数 sf_zonal_upgrade_mode
• 模型 Cluster 有一个新参数 vmss_zonal_upgrade_mode
• 模型 Cluster 有一个新参数 upgrade_pause_start_timestamp_utc
• 模型 Cluster 有一个新参数 upgrade_wave
• 模型 Cluster 有一个新参数 infrastructure_service_manager
• 模型 ProxyResource 有一个新参数 system_data
• 模型 OperationResult 有一个新参数 is_data_action
• 模型 ApplicationTypeVersionResource 有一个新参数 system_data
• 模型 ServiceResourceUpdate 有一个新参数 system_data
• 模型 ClusterUpdateParameters 有一个新参数 wave_upgrade_paused
• 模型 ClusterUpdateParameters 有一个新参数 upgrade_pause_end_timestamp_utc
• 模型 ClusterUpdateParameters 有一个新参数 notifications
• 模型 ClusterUpdateParameters 有一个新参数 sf_zonal_upgrade_mode
• 模型 ClusterUpdateParameters 有一个新参数 vmss_zonal_upgrade_mode
• 模型 ClusterUpdateParameters 有一个新参数 upgrade_pause_start_timestamp_utc
• 模型 ClusterUpdateParameters 有一个新参数 upgrade_wave
• 模型 ClusterUpdateParameters 有一个新参数 infrastructure_service_manager
• 模型 ApplicationTypeResource 有一个新参数 system_data
• 模型 Resource 有一个新参数 system_data
• 模型 ServiceResource 有一个新参数 system_data
• 模型 ApplicationUpgradePolicy 有一个新参数 recreate_application
• 添加操作 ClustersOperations.list_upgradable_versions

破坏性更改

• 删除操作组 ManagedClusterVersionsOperations
• 删除操作组 ManagedclusterOperations
• 删除操作组 ManagedClustersOperations
• 删除操作组 ApplicationOperations
• 删除操作组 NodeTypesOperations
• 删除操作组 NodetypeOperations

1.0.0 (2021-06-03)

功能

• 模型 ManagedCluster 有一个新参数 addon_features
• 模型 ManagedClusterUpdateParameters 有一个新参数 addon_features
• 添加操作组 ManagedclusterOperations
• 添加操作组 ApplicationOperations
• 添加操作组 NodetypeOperations

破坏性更改

• 操作 ApplicationTypesOperations.create_or_update 有一个新的签名
• 操作 NodeTypesOperations.begin_delete_node 具有新的签名
• 操作 NodeTypesOperations.begin_reimage 具有新的签名
• 操作 NodeTypesOperations.begin_restart 具有新的签名
• 操作 NodeTypesOperations.begin_restart 具有新的签名
• 操作 NodeTypesOperations.begin_reimage 具有新的签名
• 操作 NodeTypesOperations.begin_delete_node 具有新的签名
• 操作 ApplicationTypesOperations.create_or_update 有一个新的签名
• 模型 ManagedCluster 不再具有参数 cluster_upgrade_description
• 模型 ManagedCluster 不再具有参数 cluster_upgrade_mode
• 模型 ManagedClusterUpdateParameters 不再具有参数 cluster_upgrade_description
• 模型 ManagedClusterUpdateParameters 不再具有参数 cluster_upgrade_mode

1.0.0b1 (2020-12-02)

这是测试预览版本。

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

一般破坏性变化

• 凭证系统已完全重做

  • 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 初始化文档中的参数接受](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)

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

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

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

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

  • raw 已删除。等效功能可以通过使用 cls 找到，这是一个回调，将为高级用户提供对内部 HTTP 响应的访问
  • 有关受支持的选项的完整集合，请参阅 [azure-core 请求文档中的参数接受](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)

一般新功能

• 支持使用 typing 类型注解。SDKs 是 mypy 兼容的。
• 此客户端现在具有稳定和官方的异步支持。检查您的包中的 aio 命名空间以找到异步客户端。
• 此客户端现在原生支持像 OpenCensus 或 OpenTelemetry 这样的跟踪库。查看此 [跟踪快速入门](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/core/azure-core-tracing-opentelemetry) 以获取概述。

0.5.0 (2020-07-28)

功能

• 模型 StatelessServiceProperties 具有新的参数 instance_close_delay_duration
• 模型 StatelessServiceProperties 具有新的参数 service_dns_name
• 模型 StatelessServiceUpdateProperties 具有新的参数 instance_close_delay_duration
• 模型 ServiceResource 具有新的参数 service_dns_name
• 模型 ServiceResourceProperties 具有新的参数 service_dns_name
• 模型 Cluster 具有新的参数 application_type_versions_cleanup_policy
• 模型 ApplicationResourceUpdate 具有新的参数 managed_identities
• 模型 StatefulServiceProperties 具有新的参数 service_dns_name
• 模型 ApplicationUpgradePolicy 具有新的参数 upgrade_mode
• 模型 DiagnosticsStorageAccountConfig 具有新的参数 protected_account_key_name2
• 模型 ApplicationResource 具有新的参数 identity
• 模型 ApplicationResource 具有新的参数 managed_identities
• 模型 ClusterUpdateParameters 具有新的参数 application_type_versions_cleanup_policy
• 添加了操作组 NodeTypesOperations
• 添加了操作组 ManagedClusterVersionsOperations
• 添加了操作组 ManagedClustersOperations

0.4.0 (2019-08-19)

功能

• 添加了操作 ClustersOperations.create_or_update
• 添加了操作 ServicesOperations.create_or_update
• 添加了操作 ApplicationsOperations.create_or_update
• 添加了操作 ApplicationTypesOperations.create_or_update
• 添加了操作 ApplicationTypeVersionsOperations.create_or_update

破坏性更改

• 删除了操作 ClustersOperations.create
• 删除了操作 ServicesOperations.create
• 删除了操作 ApplicationsOperations.create
• 删除了操作 ApplicationTypesOperations.create
• 删除了操作 ApplicationTypeVersionsOperations.create

一般破坏性变化

本版本使用新一代代码生成器，如果从某些导入，可能会引入破坏性更改。总的来说，一些模块的可见性/导入不正确，并已重命名。这解决了因使用最初不应该使用的类而引起的一些问题。

• 无法从 azure.mgmt.servicefabric.service_fabric_management_client 导入 ServiceFabricManagementClient（从 azure.mgmt.servicefabric 的导入仍然像以前一样工作）
• ServiceFabricManagementClientConfiguration 的导入已从 azure.mgmt.servicefabric.service_fabric_management_client 移动到 azure.mgmt.servicefabric
• 来自 "models" 子模块的模型 MyClass 无法使用 azure.mgmt.servicefabric.models.my_class 导入（从 azure.mgmt.servicefabric.models 的导入仍然像以前一样工作）
• 来自 operations 子模块的操作类 MyClassOperations 无法使用 azure.mgmt.servicefabric.operations.my_class_operations 导入（从 azure.mgmt.servicefabric.operations 的导入仍然像以前一样工作）

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

0.3.0 (2019-05-30)

破坏性更改

• ServiceTypeHealthPolicy 模型具有新的签名
• ApplicationHealthPolicy 模型具有新的签名
• ErrorModel 模型具有新的签名
• 将操作组 "application_type" 重命名为 "application_types"
• 将操作组 "service" 重命名为 "services"
• 将操作组 "application" 重命名为 "applications"
• 删除了操作组 "version"

功能

• 在支持的地方添加了标签和 etag 属性
• ClusterHealthPolicy 模型具有新的参数 application_health_policies
• ClusterUpgradeDeltaHealthPolicy 模型具有新的参数 application_delta_health_policies
• StatelessServiceProperties 模型具有新的参数 service_package_activation_mode
• ServiceResource 模型具有新的参数 service_package_activation_mode
• Cluster 模型具有新的参数 reverse_proxy_certificate_common_names
• Cluster 模型具有新的参数 certificate_common_names
• Cluster 模型具有新的参数 event_store_service_enabled
• StatefulServiceProperties 模型具有新的参数 service_package_activation_mode
• ClusterUpdateParameters 模型具有新的参数 certificate_common_names
• ClusterUpdateParameters 模型具有新的参数 event_store_service_enabled

0.2.0 (2018-08-01)

• 新的预览版本，基于 2017-07-01-preview
• 预期会有很多破坏性更改

0.1.0 (2017-08-24)

• 初始预览版本