Microsoft Azure SDK for Python

这是Microsoft Azure NetApp Files管理客户端库。此包已在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-netapp
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.netapp import NetAppManagementClient
import os

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

示例

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

• 在 docs.microsoft.com 上搜索 NetApp 文件管理
• Azure Python 管理套件示例仓库

故障排除

下一步

提供反馈

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

发行历史

13.2.0 (2024-08-19)

新增功能

• 模型复制有一个新的参数 replication_id

13.1.0 (2024-07-22)

新增功能

• 模型 VolumePatch 有一个新参数 protocol_types

13.0.0 (2024-05-20)

新增功能

• 添加了操作 BackupsOperations.begin_create
• 添加了操作 BackupsOperations.begin_delete
• 添加了操作 BackupsOperations.begin_update
• 添加了操作 BackupsOperations.get
• 添加了操作 BackupsOperations.get_latest_status
• 添加了操作 BackupsOperations.get_volume_latest_restore_status
• 添加了操作 BackupsOperations.list_by_vault
• 添加了操作组 BackupVaultsOperations
• 添加了操作组 BackupsUnderAccountOperations
• 添加了操作组 BackupsUnderBackupVaultOperations
• 添加了操作组 BackupsUnderVolumeOperations
• 添加了操作组 NetAppResourceRegionInfosOperations
• 模型 VolumeBackups 有一个新参数 volume_resource_id
• 模型 VolumePatchPropertiesDataProtection 有一个新参数 backup
• 模型 VolumePropertiesDataProtection 有一个新参数 backup

重大变更

• 移除了操作 BackupsOperations.get_volume_restore_status

12.0.0 (2024-03-18)

重大变更

• 模型 VolumeGroupMetaData 不再具有参数 deployment_spec_id

12.0.0b1 (2023-12-22)

新增功能

• 添加了操作 AccountsOperations.begin_migrate_encryption_key
• 添加了操作 BackupsOperations.begin_create
• 添加了操作 BackupsOperations.begin_delete
• 添加了操作 BackupsOperations.begin_update
• 添加了操作 BackupsOperations.get
• 添加了操作 BackupsOperations.get_latest_status
• 添加了操作 BackupsOperations.list_by_vault
• 添加了操作 VolumesOperations.begin_split_clone_from_parent
• 添加了操作组 AccountBackupsOperations
• 添加了操作组 BackupVaultsOperations
• 添加了操作组 BackupsUnderAccountOperations
• 添加了操作组 BackupsUnderBackupVaultOperations
• 添加了操作组 BackupsUnderVolumeOperations
• 添加了操作组 NetAppResourceRegionInfosOperations
• 模型 NetAppAccount 有一个新参数 is_multi_ad_enabled
• 模型 NetAppAccount 有一个新参数 nfs_v4_id_domain
• 模型 NetAppAccountPatch 有一个新参数 is_multi_ad_enabled
• 模型 NetAppAccountPatch 有一个新参数 nfs_v4_id_domain
• 模型 ReplicationObject 有一个新参数 remote_path
• 模型 Volume 有一个新参数 inherited_size_in_bytes
• 模型 VolumeGroupVolumeProperties 有一个新参数 inherited_size_in_bytes
• 模型 VolumePatchPropertiesDataProtection 有一个新参数 backup
• 模型 VolumePropertiesDataProtection 有一个新参数 backup

重大变更

• 模型 VolumeGroupMetaData 不再具有参数 deployment_spec_id

11.0.0 (2023-10-23)

新增功能

• 添加了操作 NetAppResourceOperations.begin_update_network_sibling_set
• 添加了操作 NetAppResourceOperations.query_network_sibling_set
• 添加了操作 VolumesOperations.begin_populate_availability_zone
• 模型 Volume 有一个新参数 cool_access_retrieval_policy
• 模型 VolumeGroupVolumeProperties 有一个新参数 cool_access_retrieval_policy
• 模型 VolumeGroupVolumeProperties 有一个新参数 zones
• 模型 VolumePatch 有一个新参数 cool_access_retrieval_policy
• 模型 VolumePatch 有一个新参数 smb_access_based_enumeration
• 模型 VolumePatch 有一个新参数 smb_non_browsable

重大变更

• 模型 VolumePatchPropertiesDataProtection 不再具有参数 backup
• 模型 VolumePropertiesDataProtection 不再具有参数 backup
• 移除了操作 BackupsOperations.begin_create
• 移除了操作 BackupsOperations.begin_delete
• 移除了操作 BackupsOperations.begin_restore_files
• 移除了操作 BackupsOperations.begin_update
• 移除了操作 BackupsOperations.get
• 移除了操作 BackupsOperations.get_status
• 移除了操作 BackupsOperations.list
• 移除了操作组 AccountBackupsOperations

10.1.0 (2023-07-21)

新增功能

• 添加了操作 VolumesOperations.begin_list_get_group_id_list_for_ldap_user
• 模型 NetAppAccountPatch 有一个新参数 identity
• 模型 Volume 有一个新参数 actual_throughput_mibps
• 模型 Volume 有一个新参数 originating_resource_id
• 模型 VolumeGroupVolumeProperties 有一个新参数 actual_throughput_mibps
• 模型 VolumeGroupVolumeProperties 有一个新参数 originating_resource_id
• 模型 VolumePatch 有一个新参数 snapshot_directory_visible

10.0.0 (2023-04-20)

新增功能

• 添加了操作 BackupsOperations.begin_restore_files
• 添加了操作 VolumesOperations.begin_break_file_locks
• 模型 ActiveDirectory 有一个新参数 preferred_servers_for_ldap_client
• 模型 Backup 有一个新参数 system_data
• 模型 BackupPolicyDetails 有一个新参数 system_data
• 模型快照新增了系统数据参数
• 模型容量新增了数据存储资源ID参数
• 模型容量新增了文件访问日志参数
• 模型容量新增了是否为大容量参数
• 模型容量新增了已分配可用区参数
• 模型 VolumeGroupVolumeProperties 新增了数据存储资源ID参数
• 模型 VolumeGroupVolumeProperties 新增了文件访问日志参数
• 模型 VolumeGroupVolumeProperties 新增了是否为大容量参数
• 模型 VolumeGroupVolumeProperties 新增了已分配可用区参数
• 模型 VolumePropertiesDataProtection 新增了卷迁移参数
• 模型 VolumeQuotaRulePatch 新增了标签参数
• 模型 VolumeRelocationProperties 新增了准备就绪参数

重大变更

• 模型 VolumeBackupProperties 不再具有 vault_id 参数
• 模型 VolumeRelocationProperties 不再具有 old_bare_metal_tenant_id 参数
• 模型 VolumeRelocationProperties 不再具有 old_volume_id 参数
• 模型 BackupPolicyDetails 的 location 参数现在是必需的
• 删除了操作组 VaultsOperations

9.0.2b1 (2023-02-16)

其他更改

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

9.0.1 (2022-10-26)

已修复的错误

• 为 AccountsOperations.begin_renew_credentials 操作添加了缺少的参数 api_version

9.0.0 (2022-09-26)

新增功能

• 添加了操作 AccountsOperations.begin_renew_credentials
• 添加了操作 NetAppResourceOperations.query_region_info
• 模型 AccountEncryption 新增了 identity 参数
• 模型 AccountEncryption 新增了 key_vault_properties 参数
• 模型 NetAppAccount 新增了 disable_showmount 参数
• 模型 NetAppAccount 新增了 identity 参数
• 模型 NetAppAccountPatch 新增了 disable_showmount 参数
• 模型 Volume 新增了 delete_base_snapshot 参数
• 模型 Volume 新增了 smb_access_based_enumeration 参数
• 模型 Volume 新增了 smb_non_browsable 参数
• 模型 VolumeGroupVolumeProperties 新增了 delete_base_snapshot 参数
• 模型 VolumeGroupVolumeProperties 新增了 smb_access_based_enumeration 参数
• 模型 VolumeGroupVolumeProperties 新增了 smb_non_browsable 参数

重大变更

• 模型 Vault 不再具有 location 参数
• 操作 VolumesOperations.begin_relocate 新增了 body 参数

8.1.0 (2022-08-02)

功能

• 添加了操作 VolumesOperations.begin_reestablish_replication
• 模型 CapacityPoolPatch 新增了 cool_access 参数
• 模型 Volume 新增了 key_vault_private_endpoint_resource_id 参数
• 模型 VolumeGroupVolumeProperties 新增了 key_vault_private_endpoint_resource_id 参数
• 模型 VolumePatch 新增了 cool_access 参数
• 模型 VolumePatch 新增了 coolness_period 参数

8.0.0 (2022-06-13)

功能

• 添加了操作 VolumesOperations.begin_finalize_relocation
• 添加了操作 VolumesOperations.begin_relocate
• 添加了操作 VolumesOperations.begin_reset_cifs_password
• 添加了操作 VolumesOperations.begin_revert_relocation
• 添加了操作 VolumesOperations.list_replications
• 添加了操作组 VolumeQuotaRulesOperations
• 模型 ProxyResource 新增了 system_data 参数
• 模型 Resource 新增了 system_data 参数
• 模型 Volume 新增了 encrypted 参数
• 模型 Volume 新增了 zones 参数
• 模型 VolumeGroupVolumeProperties 新增了 encrypted 参数

破坏性更改

• 模型 VolumeGroup 不再具有 tags 参数
• 模型 VolumeGroupDetails 不再具有 tags 参数

7.0.0 (2022-03-15)

功能

• 添加了操作 SnapshotsOperations.begin_restore_files
• 添加了操作组 SubvolumesOperations
• 模型 ActiveDirectory 新增了 ldap_search_scope 参数
• 模型 BackupPolicy 新增了 system_data 参数
• 模型 CapacityPool 新增了 system_data 参数
• 模型 SnapshotPolicy 新增了 system_data 参数
• 模型 Volume 新增了 enable_subvolumes 参数
• 模型 Volume 新增了 maximum_number_of_files 参数
• 模型 Volume 新增了 system_data 参数
• 模型 VolumeGroupVolumeProperties 新增了 enable_subvolumes 参数
• 模型 VolumeGroupVolumeProperties 新增了 maximum_number_of_files 参数
• 模型 VolumePatch 新增了 unix_permissions 参数

破坏性更改

• 操作 VolumesOperations.begin_delete 具有新的签名

6.0.1 (2022-01-12)

修复

• 添加对 Python 3.6 的支持

6.0.0 (2022-01-06)

功能

• 添加了操作组 VolumeGroupsOperations
• 模型 ActiveDirectory 新增了 encrypt_dc_connections 参数
• 模型 Volume 新增了 capacity_pool_resource_id 参数
• 模型体积新增参数 placement_rules
• 模型体积新增参数 proximity_placement_group
• 模型体积新增参数 t2_network
• 模型体积新增参数 volume_group_name
• 模型体积新增参数 volume_spec_name

破坏性更改

• 模型备份策略不再具有参数 name_properties_name
• 模型备份策略详情不再具有参数 name_properties_name
• 模型备份策略修补不再具有参数 name_properties_name
• 模型订阅配额项不再具有参数 name_properties_name

5.1.0 (2021-09-22)

功能

• 模型服务规范新增参数 log_specifications
• 模型指标规范新增参数 enable_regional_mdm_account
• 模型指标规范新增参数 is_internal
• 模型体积新增参数 network_sibling_set_id
• 模型体积新增参数 storage_to_network_proximity
• 模型体积新增参数 network_features
• 添加了操作组 NetAppResourceQuotaLimitsOperations

5.0.0 (2021-08-20)

功能

• 模型备份策略新增参数 etag
• 模型备份策略新增参数 backup_policy_id
• 模型备份策略修补新增参数 backup_policy_id
• 模型 NetAppAccount 新增参数 etag
• 模型体积修补新增参数 is_default_quota_enabled
• 模型体积修补新增参数 default_user_quota_in_ki_bs
• 模型体积修补新增参数 default_group_quota_in_ki_bs
• 模型备份策略详情新增参数 backup_policy_id
• 模型体积新增参数 clone_progress
• 模型体积新增参数 default_group_quota_in_ki_bs
• 模型体积新增参数 is_default_quota_enabled
• 模型体积新增参数 default_user_quota_in_ki_bs
• 模型体积新增参数 avs_data_store
• 模型体积新增参数 etag
• 模型指标规范新增参数 supported_aggregation_types
• 模型指标规范新增参数 supported_time_grain_types
• 模型指标规范新增参数 internal_metric_name
• 模型指标规范新增参数 source_mdm_namespace
• 模型指标规范新增参数 source_mdm_account
• 模型容量池新增参数 encryption_type
• 模型容量池新增参数 etag
• 模型快照策略新增参数 etag
• 添加了操作 AccountsOperations.list_by_subscription

破坏性更改

• 模型备份策略不再具有参数 yearly_backups_to_keep
• 模型备份策略修补不再具有参数 yearly_backups_to_keep
• 模型备份策略详情不再具有参数 yearly_backups_to_keep

4.0.0 (2021-06-11)

功能

• 模型导出策略规则新增参数 chown_mode
• 模型备份状态新增参数 last_transfer_size
• 模型备份状态新增参数 total_transfer_bytes
• 模型备份状态新增参数 last_transfer_type
• 模型体积新增参数 cool_access
• 模型体积新增参数 unix_permissions
• 模型体积新增参数 coolness_period
• 模型容量池新增参数 cool_access
• 模型活动目录新增参数 administrators
• 添加了操作 BackupsOperations.get_volume_restore_status

破坏性更改

• 操作 NetAppResourceOperations.check_file_path_availability 新增签名

3.0.0 (2021-05-21)

功能

• 模型备份新增参数 use_existing_snapshot
• 模型体积修补属性数据保护新增参数 snapshot
• 模型备份修补新增参数 use_existing_snapshot
• 添加了操作 BackupPoliciesOperations.begin_update
• 添加了操作 BackupsOperations.get_status

破坏性更改

• 移除了操作 BackupPoliciesOperations.update
• 移除了操作组 VolumeBackupStatusOperations

2.0.0 (2021-03-16)

功能

• 模型体积新增参数 ldap_enabled
• 模型备份新增参数 volume_name
• 模型活动目录新增参数 allow_local_nfs_users_with_ldap
• 模型备份修补新增参数 volume_name
• 添加了操作 BackupsOperations.begin_update
• 添加了操作组 VolumeBackupStatusOperations

破坏性更改

• 模型快照策略详情不再具有参数 name_properties_name
• 模型快照策略修补不再具有参数 name_properties_name
• 模型体积不再具有参数 name_properties_name
• 模型快照策略不再具有参数 name_properties_name
• 移除了操作 BackupsOperations.update

1.0.0 (2021-02-04)

功能

• 模型体积列表新增参数 next_link
• 模型备份修补新增参数 failure_reason
• 模型备份新增参数 failure_reason
• 模型 NetAppAccountList 新增参数 next_link
• 模型 ActiveDirectory 新增参数 security_operators
• 模型 ActiveDirectory 新增参数 ldap_over_tls
• 模型 NetAppAccountPatch 新增参数 encryption
• 模型 CapacityPoolList 新增参数 next_link
• 模型 Volume 新增参数 encryption_key_source
• 模型 Volume 新增参数 smb_encryption
• 模型 Volume 新增参数 smb_continuously_available
• 模型 Volume 新增参数 name_properties_name
• 模型 NetAppAccount 新增参数 system_data
• 模型 NetAppAccount 新增参数 encryption
• 添加操作 SnapshotPoliciesOperations.begin_update

破坏性更改

• 移除操作 SnapshotPoliciesOperations.update

1.0.0b1 (2020-12-01)

这是测试预览版本。

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

一般破坏性更改

• 凭证系统已被彻底重构成

  • 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 类型注解。SDK 已准备 mypy。
• 此客户端现在提供稳定的官方异步支持。检查您的包中的 aio 命名空间以找到异步客户端。
• 此客户端现在原生支持像 OpenCensus 或 OpenTelemetry 这样的跟踪库。有关概述，请参阅此 [跟踪快速入门](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/core/azure-core-tracing-opentelemetry)

0.10.0 (2020-04-21)

功能

• 模型 MountTarget 新增参数 end_ip
• 模型 MountTarget 新增参数 start_ip
• 模型 MountTarget 新增参数 netmask
• 模型 MountTarget 新增参数 gateway
• 模型 MountTarget 新增参数 subnet

0.9.0 (2020-04-02)

功能

• 模型 ActiveDirectory 新增参数 site
• 添加操作 VolumesOperations.revert

破坏性更改

• 操作 SnapshotsOperations.update 具有新的签名
• 操作 SnapshotsOperations.update 具有新的签名
• 操作 SnapshotsOperations.create 具有新的签名
• 模型 Snapshot 不再具有参数 tags
• 模型 MountTarget 不再具有参数 netmask
• 模型 MountTarget 不再具有参数 subnet
• 模型 MountTarget 不再具有参数 start_ip
• 模型 MountTarget 不再具有参数 provisioning_state
• 模型 MountTarget 不再具有参数 gateway
• 模型 MountTarget 不再具有参数 end_ip
• 移除操作组 MountTargetsOperations

0.8.0 (2020-01-12)

功能

• 模型 Volume 新增参数 is_restoring
• 模型 ReplicationObject 新增参数 remote_volume_region
• 添加操作 VolumesOperations.delete_replication
• 添加操作 VolumesOperations.break_replication
• 添加操作 VolumesOperations.resync_replication
• 添加操作 VolumesOperations.authorize_replication
• 添加了操作 VolumesOperations.replication_status_method

0.7.0 (2019-11-12)

功能

• Model MountTarget 有一个新的参数类型
• Model Volume 有一个新的参数 data_protection
• Model Volume 有一个新的参数 volume_type
• 添加了操作组 NetAppResourceOperations

破坏性更改

• 移除了操作组 AzureNetAppFilesManagementClientOperationsMixin

0.6.0 (2019-09-26)

功能

• Model Snapshot 有一个新的参数 created
• Model ExportPolicyRule 有一个新的参数 nfsv41
• 添加了操作组 AzureNetAppFilesManagementClientOperationsMixin

破坏性更改

• Model Snapshot 不再包含参数 creation_date
• Model ExportPolicyRule 不再包含参数 nfsv4

0.5.0 (2019-07-03)

功能

• Model Volume 有一个新的参数 protocol_types
• Model Volume 有一个新的参数 mount_targets

破坏性更改

• Model Volume 的参数 subnet_id 现在是必需的
• Model Volume 的参数 usage_threshold 现在是必需的
• Model CapacityPool 的参数 service_level 现在是必需的
• Model CapacityPool 的参数 size 现在是必需的

0.4.0 (2019-04-29)

功能

• Model Volume 有一个新的参数 baremetal_tenant_id
• Model Volume 有一个新的参数 snapshot_id

破坏性更改

• Model ActiveDirectory 将 d_ns 修复为 dns，将 s_mb_server_name 修复为 smb_server_name

0.3.0 (2019-03-25)

功能

• Model VolumePatch 有一个新的参数 export_policy
• Model NetAppAccount 有一个新的参数 active_directories
• Model Volume 有一个新的参数 export_policy
• Model MountTarget 有一个新的参数 smb_server_fqdn
• 模型 MountTarget 新增参数 subnet

破坏性更改

• Operation PoolsOperations.update 有一个新的签名
• Model MountTarget 不再包含参数 vlan_id
• Operation AccountsOperations.update 有一个新的签名
• Operation AccountsOperations.create_or_update 有一个新的签名
• Model CapacityPoolPatch 有一个新的签名
• Model NetAppAccountPatch 有一个新的签名

0.2.0 (2019-03-04)

破坏性更改

• MountTargetsOperations.list 中的 resource_group 参数已更改为 resource_group_name
• SnapshotsOperations.get 中的 resource_group 参数已更改为 resource_group_name
• SnapshotsOperations.create 中的 resource_group 参数已更改为 resource_group_name
• SnapshotsOperations.list 中的 resource_group 参数已更改为 resource_group_name
• SnapshotsOperations.delete 中的 resource_group 参数已更改为 resource_group_name
• SnapshotsOperations.update 中的 resource_group 参数已更改为 resource_group_name

0.1.0 (2018-01-02)

• 初始发布