你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
适用于 .NET 的Microsoft Azure 存储管理客户端库
Microsoft Azure 存储 是一项 Microsoft 托管服务,提供高度可用、安全、持久、可缩放和冗余的云存储。
此库支持管理Microsoft Azure 存储资源,包括创建新存储帐户。
此库遵循 新的 Azure SDK 准则,并提供许多核心功能:
- Support MSAL.NET, Azure.Identity is out of box for supporting MSAL.NET.
- Support [OpenTelemetry](https://opentelemetry.io/) for distributed tracing.
- HTTP pipeline with custom policies.
- Better error-handling.
- Support uniform telemetry across all languages.
入门
安装包
使用 NuGet 安装适用于 .NET 的 Microsoft Azure 存储 管理库:
dotnet add package Azure.ResourceManager.Storage
先决条件
首先,若要安装 Microsoft Azure 标识 包,请执行以下操作:
dotnet add package Azure.Identity
设置一种使用 Azure 标识向 Microsoft Azure 进行身份验证的方法。
一些选项包括:
- 通过 Azure CLI 登录。
- 通过 Visual Studio。
- 设置 环境变量。
有关详细信息以及使用 Microsoft Azure 标识的不同身份验证方法,请参阅 本文档。
对客户端进行身份验证
创建已经过身份验证的客户端的默认选项是使用 DefaultAzureCredential
。 由于所有管理 API 都通过同一终结点,因此,若要与资源交互,只需创建一个顶级 ArmClient
。
若要向 Microsoft Azure 进行身份验证并创建 ArmClient
,请执行以下代码:
using Azure.Identity;
using Azure.ResourceManager;
ArmClient armClient = new ArmClient(new DefaultAzureCredential());
本文档中提供了有关 Azure.Identity.DefaultAzureCredential
类的更多 文档。
关键概念
可在此处找到用于 .NET 的 Microsoft Azure SDK的关键概念
示例
故障排除
- 如果发现 bug 或有建议,请通过 GitHub 问题提交问题,并确保将“预览”标签添加到问题。
- 如果需要帮助,请使用 Azure 和 .NET 标记在 StackOverflow 上检查以前的问题或提出新问题。
- 如在身份验证时遇到问题,请转到 DefaultAzureCredential 文档。
后续步骤
有关 Microsoft Azure SDK 的详细信息,请参阅 此网站。
供稿
有关参与此存储库的详细信息,请参阅 参与指南。
本项目欢迎贡献和建议。 大多数贡献要求你同意贡献者许可协议 (CLA),并声明你有权(并且确实有权)授予我们使用你的贡献的权利。 有关详细信息,请访问 https://cla.microsoft.com 。
提交拉取请求时,CLA 机器人会自动确定是否需要提供 CLA 并适当修饰 PR, (例如标签、注释) 。 按照机器人提供的说明操作。 只需使用 CLA 在所有存储库中执行此操作一次。
此项目采用了 Microsoft 开放源代码行为准则。 有关详细信息,请参阅行为准则常见问题解答,如有任何其他问题或评论,请联系 opencode@microsoft.com。