Microsoft Azure SDK for Python

这是Microsoft Azure Storage Cache Management Client Library。此软件包已在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-storagecache
pip install azure-identity

身份验证

默认情况下，Azure Active Directory令牌身份验证依赖于以下环境变量的正确配置。

• AZURE_CLIENT_ID 为Azure客户端ID。
• AZURE_TENANT_ID 为Azure租户ID。
• AZURE_CLIENT_SECRET 为Azure客户端密钥。

此外，Azure订阅ID可以通过环境变量 AZURE_SUBSCRIPTION_ID 进行配置。

以上配置下，可以通过以下代码进行客户端认证

from azure.identity import DefaultAzureCredential
from azure.mgmt.storagecache import StorageCacheManagementClient
import os

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

示例

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

• 在 docs.microsoft.com 搜索存储缓存管理
• Azure Python 管理SDK 示例仓库

故障排除

下一步操作

提供反馈

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

发行历史

2.0.0 (2024-05-20)

新增功能

• 添加了操作组 ImportJobsOperations
• 模型 AmlFilesystem 有一个新参数 root_squash_settings
• 模型 AmlFilesystemHsmSettings 有一个新参数 import_prefixes_initial
• 模型 AmlFilesystemUpdate 有一个新参数 root_squash_settings
• 模型 ErrorResponse 有一个新参数 error
• 模型 AscOperation.error 类型从 ErrorResponse 更改为 AscOperationErrorResponse

重大变更

• 模型 ErrorResponse 不再具有参数 code
• 模型 ErrorResponse 不再具有参数 message

1.6.0b1 (2024-02-22)

新增功能

• 模型 AmlFilesystem 有一个新参数 root_squash_settings
• 模型 AmlFilesystemUpdate 有一个新参数 root_squash_settings

1.5.0 (2023-06-16)

新增功能

• 添加了操作组 AmlFilesystemsOperations
• 添加了操作组 StorageCacheManagementClientOperationsMixin

1.4.0 (2023-02-15)

新增功能

• 添加了操作 StorageTargetsOperations.begin_restore_defaults
• 模型 BlobNfsTarget 有一个新参数 verification_timer
• 模型 BlobNfsTarget 有一个新参数 write_back_timer
• 模型 Nfs3Target 有一个新参数 verification_timer
• 模型 Nfs3Target 有一个新参数 write_back_timer

重大变更

• 将操作 CachesOperations.update 重命名为 CachesOperations.begin_update

1.4.0b1 (2022-12-12)

其他更改

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

1.3.0 (2022-07-07)

功能

• 添加了操作 CachesOperations.begin_pause_priming_job
• 添加了操作 CachesOperations.begin_resume_priming_job
• 添加了操作 CachesOperations.begin_space_allocation
• 添加了操作 CachesOperations.begin_start_priming_job
• 添加了操作 CachesOperations.begin_stop_priming_job
• 模型 ApiOperationPropertiesServiceSpecification 有一个新参数 log_specifications
• 模型 Cache 有一个新参数 priming_jobs
• 模型 Cache 有一个新参数 space_allocation
• 模型 Cache 有一个新参数 upgrade_settings
• 模型 StorageTarget 有一个新参数 allocation_percentage

1.2.0 (2022-03-22)

功能

• 添加了操作 StorageTargetOperations.begin_invalidate
• 添加了操作组 AscUsagesOperations
• 模型 Cache 有一个新参数 zones

1.1.0 (2021-09-30)

功能

• 模型 StorageTarget 有一个新参数 state

1.0.0 (2021-07-29)

功能

• 模型 CacheEncryptionSettings 有一个新参数 rotation_to_latest_key_version_enabled
• 模型 CacheIdentity 有一个新参数 user_assigned_identities
• 添加了操作组 StorageTargetOperations

重大变更

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

1.0.0b1 (2021-05-13)

这是测试预览版本。

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

一般重大变更

• 凭证系统已被完全重写

  • 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.3.0 (2020-03-01)

功能

• 模型缓存新增参数 security_settings。
• 模型缓存新增参数 network_settings。
• 模型缓存新增参数 identity。
• 模型缓存新增参数 encryption_settings。

0.2.0 (2019-11-12)

功能

• 添加操作 CachesOperations.create_or_update。
• 添加操作 StorageTargetsOperations.create_or_update。

重大变更

• 移除操作 CachesOperations.create。
• 移除操作 StorageTargetsOperations.create。
• 移除操作 StorageTargetsOperations.update。

0.1.0rc1 (2019-09-03)

• 初始发布