Microsoft Azure SDK for Python

这是 Microsoft Azure Avs 管理客户端库。该软件包已在 Python 3.8+ 上进行测试。要查看 Azure 库的更完整视图，请参阅 azure sdk python release。

免责声明

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-avs
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.avs import AVSClient
import os

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

示例

该软件包的代码示例可在以下位置找到

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

故障排除

下一步

提供反馈

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

发行历史

9.0.0 (2024-09-22)

新增功能

• 客户端 AVSClient 添加了操作组 iscsi_paths
• 模型 CloudLink 添加了属性 provisioning_state
• 模型 Cluster 添加了属性 vsan_datastore_name
• 模型 ClusterUpdate 添加了属性 sku
• 模型 Datastore 添加了属性 elastic_san_volume
• 模型 Endpoints 添加了属性 nsxt_manager_ip
• 模型 Endpoints 添加了属性 vcenter_ip
• 模型 Endpoints 添加了属性 hcx_cloud_manager_ip
• 模型 HcxEnterpriseSite 添加了属性 provisioning_state
• 模型 ManagementCluster 在方法 __init__ 中添加了参数 vsan_datastore_name
• 模型 Operation 添加了属性 action_type
• 模型 PrivateCloud 添加了属性 virtual_network_id
• 模型 PrivateCloud 添加了属性 dns_zone_type
• 模型 PrivateCloudUpdate 添加了属性 sku
• 模型 PrivateCloudUpdate 添加了属性 dns_zone_type
• 模型 Resource 添加了属性 system_data
• 模型 ScriptCmdlet 添加了属性 provisioning_state
• 模型 ScriptCmdlet 添加了属性 audience
• 模型 ScriptPackage 添加了属性 provisioning_state
• 模型 Sku 添加了属性 tier
• 模型 Sku 添加了属性 size
• 模型 Sku 添加了属性 family
• 模型 Sku 添加了属性 capacity
• 模型 VirtualMachine 添加了属性 provisioning_state
• 模型 WorkloadNetworkGateway 添加了属性 provisioning_state
• 模型 WorkloadNetworkVirtualMachine 添加了属性 provisioning_state
• 添加了枚举 ActionType
• 添加了枚举 CloudLinkProvisioningState
• 添加了枚举 CreatedByType
• 添加了枚举 DnsZoneType
• 添加了模型 ElasticSanVolume
• 添加了枚举 HcxEnterpriseSiteProvisioningState
• 添加了模型 IscsiPath
• 添加了模型 IscsiPathListResult
• 添加了枚举 IscsiPathProvisioningState
• 添加了模型 OperationListResult
• 添加了枚举 Origin
• 添加了枚举 ScriptCmdletAudience
• 添加了枚举 ScriptCmdletProvisioningState
• 添加了枚举 ScriptPackageProvisioningState
• 添加了枚举 SkuTier
• 添加了模型 SystemData
• 添加了枚举 VirtualMachineProvisioningState
• 添加了枚举 WorkloadNetworkProvisioningState
• 添加了模型 IscsiPathsOperations

破坏性更改

• 模型 Operation 删除或重命名了其实例变量 properties
• 模型 PrivateCloud 的参数 location 现在是必需的
• 模型 PrivateCloudIdentity 的参数 type 现在是必需的
• 模型 TrackedResource 的参数 location 现在是必需的
• 删除或重命名了模型 ClusterProperties
• 删除或重命名了模型 CommonClusterProperties
• 删除或重命名了模型 LogSpecification
• 删除或重命名了模型 MetricDimension
• 删除或重命名了模型 MetricSpecification
• 删除或重命名了模型 OperationList
• 删除或重命名了模型 OperationProperties
• 删除或重命名了模型 PrivateCloudProperties
• 删除或重命名了模型 PrivateCloudUpdateProperties
• 删除或重命名了模型 ServiceSpecification
• 删除或重命名了模型 WorkloadNetworkName
• 方法 WorkloadNetworksOperations.get 删除或重命名了其参数 workload_network_name 的类型为 positional_or_keyword
• 模型 WorkloadNetworksOperations 将其实例变量 list_public_i_ps 重命名为 list_public_ips

9.0.0b1 (2024-06-28)

新增功能

• 添加了操作 WorkloadNetworksOperations.list_public_ips
• 添加了操作组 IscsiPathsOperations
• 模型附加组件新增参数 system_data
• 模型 CloudLink 新增参数 provisioning_state
• 模型 CloudLink 新增参数 system_data
• 模型 Cluster 新增参数 system_data
• 模型 Cluster 新增参数 vsan_datastore_name
• 模型 ClusterUpdate 新增参数 sku
• 模型 Datastore 新增参数 elastic_san_volume
• 模型 Datastore 新增参数 system_data
• 模型 Endpoints 新增参数 hcx_cloud_manager_ip
• 模型 Endpoints 新增参数 nsxt_manager_ip
• 模型 Endpoints 新增参数 vcenter_ip
• 模型 ExpressRouteAuthorization 新增参数 system_data
• 模型 GlobalReachConnection 新增参数 system_data
• 模型 HcxEnterpriseSite 新增参数 provisioning_state
• 模型 HcxEnterpriseSite 新增参数 system_data
• 模型 ManagementCluster 新增参数 vsan_datastore_name
• 模型 Operation 新增参数 action_type
• 模型 PlacementPolicy 新增参数 system_data
• 模型 PrivateCloud 新增参数 dns_zone_type
• 模型 PrivateCloud 新增参数 system_data
• 模型 PrivateCloud 新增参数 virtual_network_id
• 模型 PrivateCloudUpdate 新增参数 dns_zone_type
• 模型 PrivateCloudUpdate 新增参数 sku
• 模型 ProxyResource 新增参数 system_data
• 模型 Resource 新增参数 system_data
• 模型 ScriptCmdlet 新增参数 audience
• 模型 ScriptCmdlet 新增参数 provisioning_state
• 模型 ScriptCmdlet 新增参数 system_data
• 模型 ScriptExecution 新增参数 system_data
• 模型 ScriptPackage 新增参数 provisioning_state
• 模型 ScriptPackage 新增参数 system_data
• 模型 Sku 新增参数 capacity
• 模型 Sku 新增参数 family
• 模型 Sku 新增参数 size
• 模型 Sku 新增参数 tier
• 模型 TrackedResource 新增参数 system_data
• 模型 VirtualMachine 新增参数 provisioning_state
• 模型 VirtualMachine 新增参数 system_data
• 模型 WorkloadNetwork 新增参数 provisioning_state
• 模型 WorkloadNetwork 新增参数 system_data
• 模型 WorkloadNetworkDhcp 新增参数 system_data
• 模型 WorkloadNetworkDnsService 新增参数 system_data
• 模型 WorkloadNetworkDnsZone 新增参数 system_data
• 模型 WorkloadNetworkGateway 新增参数 provisioning_state
• 模型 WorkloadNetworkGateway 新增参数 system_data
• 模型 WorkloadNetworkPortMirroring 新增参数 system_data
• 模型 WorkloadNetworkPublicIP 新增参数 system_data
• 模型 WorkloadNetworkSegment 新增参数 system_data
• 模型 WorkloadNetworkVMGroup 新增参数 system_data
• 模型 WorkloadNetworkVirtualMachine 新增参数 provisioning_state
• 模型 WorkloadNetworkVirtualMachine 新增参数 system_data

破坏性更改

• 模型 Operation 不再具有参数 properties
• 操作 WorkloadNetworksOperations.get 不再具有参数 workload_network_name
• 模型 PrivateCloud 的参数 location 现在是必填的
• 模型 TrackedResource 的参数 location 现在是必填的
• 模型 PrivateCloudIdentity 的参数 type 现在是必填的
• 模型 AddonList 的参数 value 现在是必填的
• 模型 CloudLinkList 的参数 value 现在是必填的
• 模型 ClusterList 的参数 value 现在是必填的
• 模型 DatastoreList 的参数 value 现在是必填的
• 模型 ExpressRouteAuthorizationList 的参数 value 现在是必填的
• 模型 GlobalReachConnectionList 的参数 value 现在是必填的
• 模型 HcxEnterpriseSiteList 的参数 value 现在是必填的
• 模型 PlacementPoliciesList 的参数 value 现在是必填的
• 模型 PrivateCloudList 的参数 value 现在是必填的
• 模型 ScriptCmdletsList 的参数 value 现在是必填的
• 模型 ScriptExecutionsList 的参数 value 现在是必填的
• 模型 ScriptPackagesList 的参数 value 现在是必填的
• 模型 VirtualMachinesList 的参数 value 现在是必填的
• 模型WorkloadNetworkDhcpList的参数值现在必需
• 模型WorkloadNetworkDnsServicesList的参数值现在必需
• 模型WorkloadNetworkDnsZonesList的参数值现在必需
• 模型WorkloadNetworkGatewayList的参数值现在必需
• 模型WorkloadNetworkList的参数值现在必需
• 模型WorkloadNetworkPortMirroringList的参数值现在必需
• 模型WorkloadNetworkPublicIPsList的参数值现在必需
• 模型WorkloadNetworkSegmentsList的参数值现在必需
• 模型WorkloadNetworkVMGroupsList的参数值现在必需
• 模型WorkloadNetworkVirtualMachinesList的参数值现在必需
• 已删除操作WorkloadNetworksOperations.list_public_i_ps

8.0.0 (2023-08-25)

新增功能

• 模型ErrorResponse有一个新参数error
• 模型PrivateCloud有一个新参数extended_network_blocks
• 模型PrivateCloudProperties有一个新参数extended_network_blocks
• 模型PrivateCloudUpdate有一个新参数extended_network_blocks
• 模型PrivateCloudUpdateProperties有一个新参数extended_network_blocks

破坏性更改

• 模型ErrorResponse不再有参数additional_info
• 模型ErrorResponse不再有参数code
• 模型ErrorResponse不再有参数details
• 模型ErrorResponse不再有参数message
• 模型ErrorResponse不再有参数target

7.2.0b1 (2022-12-29)

其他更改

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

7.1.0 (2022-10-18)

新增功能

• 添加了操作ClustersOperations.list_zones
• 添加了操作WorkloadNetworksOperations.get
• 添加了操作WorkloadNetworksOperations.list
• 模型EncryptionKeyVaultProperties有一个新参数auto_detected_key_version
• 模型PlacementPolicyUpdate有一个新参数affinity_strength
• 模型PlacementPolicyUpdate有一个新参数azure_hybrid_benefit_type
• 模型PrivateCloud有一个新参数nsx_public_ip_quota_raised
• 模型PrivateCloudProperties有一个新参数nsx_public_ip_quota_raised
• 模型ScriptPackage有一个新参数company
• 模型ScriptPackage有一个新参数uri
• 模型VmHostPlacementPolicyProperties有一个新参数affinity_strength
• 模型VmHostPlacementPolicyProperties有一个新参数azure_hybrid_benefit_type
• 操作LocationsOperations.check_trial_availability有一个新参数sku

7.0.0 (2021-11-11)

功能

• 模型PrivateCloudUpdateProperties有一个新参数encryption
• 模型PrivateCloudUpdateProperties有一个新参数availability
• 模型PrivateCloud有一个新参数secondary_circuit
• 模型PrivateCloud有一个新参数identity
• 模型PrivateCloud有一个新参数encryption
• 模型PrivateCloud有一个新参数availability
• 模型PrivateCloudProperties有一个新参数secondary_circuit
• 模型PrivateCloudProperties有一个新参数encryption
• 模型PrivateCloudProperties有一个新参数availability
• 模型PrivateCloudUpdate有一个新参数identity
• 模型PrivateCloudUpdate有一个新参数encryption
• 模型PrivateCloudUpdate有一个新参数availability
• 模型GlobalReachConnection有一个新参数express_route_id
• 模型ClusterUpdate有一个新参数hosts
• 模型ExpressRouteAuthorization有一个新参数express_route_id
• 模型Datastore有一个新参数status
• 添加了操作组VirtualMachinesOperations
• 添加了操作组PlacementPoliciesOperations

7.0.0b1 (2021-07-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 属性不再存在，配置应作为关键字参数传递。例如：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 进行类型注解。SDK已准备好使用mypy。
• 此客户端现在稳定且官方支持异步。检查您的包中的 aio 命名空间以查找异步客户端。
• 此客户端现在原生支持如OpenCensus或OpenTelemetry之类的跟踪库。有关概述，请参阅此跟踪快速入门。

2.0.0 (2021-07-13)

功能

• 模型PrivateCloud有一个新参数external_cloud_links
• 模型MetricDimension有一个新参数internal_name
• 模型MetricDimension有一个新参数to_be_exported_for_shoebox
• 添加了操作PrivateCloudsOperations.rotate_vcenter_password
• 添加了操作PrivateCloudsOperations.rotate_nsxt_password
• 添加了操作组ScriptExecutionsOperations
• 添加了操作组DatastoresOperations
• 添加了操作组CloudLinksOperations
• 添加了操作组ScriptPackagesOperations
• 添加了操作组WorkloadNetworksOperations
• 添加了操作组ScriptCmdletsOperations
• 添加了操作组AddonsOperations
• 添加了操作组GlobalReachConnectionsOperations

破坏性更改

• 操作HcxEnterpriseSitesOperations.create_or_update有一个新签名
• 操作AuthorizationsOperations.create_or_update有一个新签名

1.0.0 (2020-11-11)

功能

• 模型Operation有一个新参数properties
• 模型Operation有一个新参数is_data_action
• 模型Operation有一个新参数origin
• 模型ManagementCluster有一个新参数provisioning_state

破坏性更改

• 操作ClustersOperations.create_or_update有一个新签名
• 操作ClustersOperations.create_or_update有一个新签名

1.0.0rc1 (2020-07-03)

功能

• 模型Endpoints有一个新参数hcx_cloud_manager
• 模型Cluster有一个新参数hosts
• 模型Cluster有一个新参数cluster_id
• 模型Cluster有一个新参数cluster_size
• 模型Cluster有一个新参数provisioning_state
• 添加了操作组HcxEnterpriseSitesOperations
• 添加了操作组AuthorizationsOperations

破坏性更改

• 操作ClustersOperations.update有一个新签名
• 操作ClustersOperations.create_or_update有一个新签名
• 操作PrivateCloudsOperations.update有一个新签名
• 操作ClustersOperations.create_or_update有一个新签名
• 模型Circuit不再有参数authorizations
• 模型Cluster不再有参数properties
• 模型Cluster有一个新必需参数sku
• 模型PrivateCloud有一个新签名
• 模型ExpressRouteAuthorization有一个新签名