Microsoft Azure SDK for Python

这是Microsoft Azure Hybrid Compute Management客户端库。此软件包已在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-hybridcompute
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.hybridcompute import HybridComputeManagementClient
import os

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

示例

本包的代码示例可以在 docs.microsoft.com 的 Hybrid Compute Management 和 Samples Repo 找到。

故障排除

下一步

提供反馈

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

发布历史

8.0.0 (2023-02-15)

新增功能

• 添加了操作组 HybridComputeManagementClientOperationsMixin
• 模型 HybridComputePrivateLinkScopeProperties 新增参数 private_endpoint_connections
• 模型 MachineExtensionProperties 新增参数 enable_automatic_upgrade
• 模型 MachineProperties 新增参数 agent_configuration
• 模型 MachineProperties 新增参数 cloud_metadata
• 模型 MachineProperties 新增参数 mssql_discovered
• 模型 MachineProperties 新增参数 os_type
• 模型 MachineProperties 新增参数 service_statuses
• 模型 MachineUpdateProperties 新增参数 cloud_metadata
• 模型 MachineUpdateProperties 新增参数 os_profile
• 模型 OSProfile 新增参数 linux_configuration
• 模型 OSProfile 新增参数 windows_configuration
• 模型 OperationValue 新增参数 is_data_action
• 模型 PrivateEndpointConnectionProperties 新增参数 group_ids

8.0.0b1 (2022-11-18)

新增功能

• 添加了操作组 ExtensionMetadataOperations
• 添加了操作组 HybridComputeManagementClientOperationsMixin
• 模型 HybridComputePrivateLinkScopeProperties 新增参数 private_endpoint_connections
• 模型 Machine 新增参数 ad_fqdn
• 模型 Machine 新增参数 agent_configuration
• 模型 Machine 新增参数 agent_version
• 模型 Machine 新增参数 client_public_key
• 模型 Machine 新增参数 cloud_metadata
• 模型 Machine 新增参数 detected_properties
• 模型 Machine 新增参数 display_name
• 模型 Machine 新增参数 dns_fqdn
• 模型 Machine 新增参数 domain_name
• 模型 Machine 新增参数 error_details
• 模型 Machine 新增参数 last_status_change
• 模型 Machine 新增参数 location_data
• 模型 Machine 新增参数 machine_fqdn
• 模型 Machine 新增参数 mssql_discovered
• 模型 Machine 新增参数 os_name
• 模型 Machine 新增参数 os_profile
• 模型 Machine 新增参数 os_sku
• 模型 Machine 新增参数 os_type
• 模型 Machine 新增参数 os_version
• 模型 Machine 新增参数 parent_cluster_resource_id
• 模型 Machine 新增参数 private_link_scope_resource_id
• 模型 Machine 新增参数 provisioning_state
• 模型 Machine 新增参数 resources
• 模型 Machine 新增参数 service_statuses
• 模型 Machine 新增参数 status
• 模型 Machine 新增参数 vm_id
• 模型 Machine 新增参数 vm_uuid
• 模型 MachineExtension 新增参数 auto_upgrade_minor_version
• 模型 MachineExtension 新增参数 enable_automatic_upgrade
• 模型 MachineExtension 新增参数 force_update_tag
• 模型 MachineExtension 新增参数 instance_view
• 模型 MachineExtension 新增参数 protected_settings
• 模型 MachineExtension 新增参数 provisioning_state
• 模型 MachineExtension 新增参数 publisher
• 模型 MachineExtension 新增参数 settings
• 模型 MachineExtension 新增参数 type_handler_version
• 模型 MachineExtension 新增参数 type_properties_type
• 模型 MachineExtensionUpdate 新增参数 auto_upgrade_minor_version
• 模型 MachineExtensionUpdate 新增参数 enable_automatic_upgrade
• 模型 MachineExtensionUpdate 新增参数 force_update_tag
• 模型 MachineExtensionUpdate 新增了参数 protected_settings
• 模型 MachineExtensionUpdate 新增了参数 publisher
• 模型 MachineExtensionUpdate 新增了参数 settings
• 模型 MachineExtensionUpdate 新增了参数 type
• 模型 MachineExtensionUpdate 新增了参数 type_handler_version
• 模型 MachineUpdate 新增了参数 cloud_metadata
• 模型 MachineUpdate 新增了参数 location_data
• 模型 MachineUpdate 新增了参数 os_profile
• 模型 MachineUpdate 新增了参数 parent_cluster_resource_id
• 模型 MachineUpdate 新增了参数 private_link_scope_resource_id
• 模型 OSProfile 新增参数 linux_configuration
• 模型 OSProfile 新增参数 windows_configuration
• 模型 OperationValue 新增参数 is_data_action
• 模型 PrivateEndpointConnectionProperties 新增参数 group_ids
• 模型 ProxyResource 新增了参数 system_data
• 模型 Resource 新增了参数 system_data
• 模型 TrackedResource 新增了参数 system_data

重大变更

• 模型 Machine 不再包含参数 properties
• 模型 MachineExtension 不再包含参数 properties
• 模型 MachineExtensionUpdate 不再包含参数 properties
• 模型 MachineUpdate 不再包含参数 properties

7.0.0 (2021-04-15)

新特性

• 模型 MachineUpdateProperties 新增了参数 private_link_scope_resource_id
• 模型 MachineUpdateProperties 新增了参数 parent_cluster_resource_id
• 模型 MachineProperties 新增了参数 private_link_scope_resource_id
• 模型 MachineProperties 新增了参数 parent_cluster_resource_id
• 模型 MachineProperties 新增了参数 detected_properties
• 新增操作组 PrivateLinkResourcesOperations
• 新增操作组 PrivateEndpointConnectionsOperations
• 新增操作组 PrivateLinkScopesOperations

重大变更

• 操作 MachinesOperations.delete 有新的签名
• 操作 MachinesOperations.get 有新的签名
• 模型 ErrorDetail 有新的签名
• 模型 OperationValue 有新的签名
• 模型 Machine 有新的签名
• 模型 MachineExtension 有新的签名
• 模型 MachineExtensionInstanceViewStatus 有新的签名
• 模型 MachineUpdate 有新的签名
• 模型 MachineExtensionUpdate 有新的签名

7.0.0b1 (2020-12-07)

这是beta预览版本。

该版本使用下一代代码生成器，引入了重要的重大变更，但也引入了重要的新特性（如统一认证和异步编程）。

一般重大变更

• 凭证系统已完全重新设计

  • 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)。有关支持的完整选项集，请参阅[https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies](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 响应的访问
  • 有关支持的完整选项集，请参阅[https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies](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等跟踪库。请参阅此跟踪快速入门以获取概述。

2.0.0 (2020-09-08)

新特性

• 模型 Machine 新增参数 ad_fqdn
• 模型 Machine 新增参数 os_sku
• 模型 Machine 新增参数 domain_name
• 模型 Machine 新增参数 dns_fqdn
• 模型 Machine 新增参数 vm_uuid
• 模型MachineProperties有一个新参数ad_fqdn
• 模型MachineProperties有一个新参数os_sku
• 模型MachineProperties有一个新参数domain_name
• 模型MachineProperties有一个新参数dns_fqdn
• 模型MachineProperties有一个新参数vm_uuid

重大变更

• 模型ErrorResponse有一个新签名
• 模型 MachineExtensionInstanceViewStatus 有新的签名

1.0.0 (2020-08-19)

新特性

• 模型Machine有一个新参数identity
• 模型 Machine 新增参数 location_data
• 模型 MachineUpdate 新增了参数 location_data
• 添加了操作组MachineExtensionsOperations

重大变更

• 模型MachineExtension不再有参数tenant_id
• 模型MachineExtension不再有参数principal_id
• 模型MachineExtension不再有参数type1
• 模型Machine不再有参数tenant_id
• 模型Machine不再有参数physical_location
• 模型Machine不再有参数principal_id
• 模型Machine不再有参数type1
• 模型MachineUpdate不再有参数physical_location
• 模型Resource不再有参数tenant_id
• 模型Resource不再有参数principal_id
• 模型Resource不再有参数location
• 模型Resource不再有参数type1
• 模型Resource不再有参数tags
• 模型ErrorResponse有一个新签名

0.1.1 (2019-10-30)

• 更新项目描述和标题

0.1.0 (2019-10-29)

重大变更

• 移除了MachineExtensionsOperations

0.1.0rc1 (2019-10-23)

• 初始发布