ITADN
azure-sdk/azure-sdk-for-net
代码 动态 Issues 合并请求8508 版本
azure-sdk/azure-sdk-for-net · 文件 下载 ZIP
文件最后提交记录最后更新时间
README.md
以下内容由 AI 翻译，如有问题请点此提交 issue 反馈

Azure .NET SDK

Packages Dependencies Dependencies Graph

本仓库用于 Azure SDK for .NET 的积极开发。对于 SDK 的使用者，我们建议访问我们的公共开发者文档或我们的版本化开发者文档。

入门指南

要开始使用某个库，请参阅位于该库项目文件夹中的 README.md 文件。您可以在 /sdk 目录中找到按服务分组的这些库文件夹。

有关教程、示例、快速入门和其他文档，请访问 Azure for .NET Developers。

可用包

每个服务可能提供来自以下各类别的多个库：

Client: New Releases

我们宣布为 GA 的一批新包，以及目前处于 preview 发布阶段的多个包。这些库遵循 Azure SDK Design Guidelines for .NET，并共享许多核心功能，例如 HTTP 重试、日志记录、传输协议、身份验证协议等，因此一旦您学会了如何在某个客户端库中使用这些功能，您就知道如何在其他客户端库中使用它们。您可以在 Azure.Core 中了解这些共享功能。

这些新的客户端库可以通过其文件夹、包和命名空间所使用的命名来识别。每个名称都以 Azure 开头，后跟服务类别，然后是服务名称。例如 Azure.Storage.Blobs。

有关可用包的完整列表，请参阅最新可用包页面。

注意：如果您需要确保代码已准备好用于生产环境，我们强烈建议使用其中一个稳定的非预览版库。

客户端：早期版本

已准备好用于生产环境的包的最新稳定版本。这些库提供了与预览版包类似的功能，因为它们允许您使用和消费现有资源并与之交互，例如：上传存储 Blob。稳定库目录的名称中通常包含 'Microsoft.Azure'，例如 'Microsoft.Azure.KeyVault'。它们可能未实现指南或具有与 11 月发布版本相同的功能集。然而，它们确实提供了更广泛的服务覆盖范围。

管理：新发布

一套遵循 .NET 的 Azure SDK 设计指南并基于 Azure.Core 库的新管理库现已进入公开预览。这些新库提供了一系列在所有 Azure SDK 中共享的核心功能，包括直观的 Azure Identity 库、具有自定义策略的 HTTP 管道、错误处理、分布式跟踪等。您可以在此页面上找到新包的列表。

要开始使用这些新库，请参阅此处的快速入门指南。这些新库可以通过以 Azure.ResourceManager 开头的命名空间来识别，例如 Azure.ResourceManager.Network

注意：如果您需要确保代码可用于生产环境，请使用其中一个稳定的、非预览版的库。

管理：旧版本

如需查看可用于配置和管理 Azure 资源的管理库完整列表，请参见此处。它们可能不具备与新版本相同的功能集，但提供了更广泛的服务覆盖范围。管理库的旧版本可以通过以 Microsoft.Azure.Management 开头的命名空间来识别，例如 Microsoft.Azure.Management.Network

这些库的文档和代码示例可在此处找到。

需要帮助？

数据收集

该软件可能会收集有关您及您使用该软件的信息，并将其发送给 Microsoft。Microsoft 可能会使用此信息来提供服务并改进我们的产品和服务。您可以按照以下说明关闭遥测。您可以在帮助文档和 Microsoft 的隐私声明中了解有关数据收集和使用的更多信息。有关 Azure SDK 收集的数据的更多信息，请访问 Telemetry Guidelines 页面。

遥测配置

默认情况下，遥测收集处于开启状态。

注意：HttpClient 可能会作为 .NET 平台行为的一部分设置默认用户代理标头。 此值不包含任何 Azure SDK 遥测信息。

在创建客户端时，您可以通过在诊断选项中设置 IsTelemetryEnabled 属性来禁用遥测：

Uri serviceEndpoint = new Uri("https://example.contoso.com");
TokenCredential credential = new DefaultAzureCredential();

SampleClientOptions clientOptions = new SampleClientOptions()
{
    Diagnostics = { IsTelemetryEnabled = false }
};

SampleClient client = new SampleClient(serviceEndpoint, credential, clientOptions);

或者，您可以在创建任何客户端之前，将 AZURE_TELEMETRY_DISABLED 环境变量设置为 true 来全局禁用遥测。

社区

  • 与其他社区成员聊天 Join the chat at https://gitter.im/azure/azure-sdk-for-net

报告安全问题和安全漏洞

应通过电子邮件私下向 Microsoft 安全响应中心 (MSRC) secure@microsoft.com 报告安全问题和漏洞。 您应在 24 小时内收到回复。 如果由于某种原因您没有收到回复，请通过电子邮件跟进，以确保我们收到了您的原始消息。 更多信息，包括 MSRC PGP 密钥，可在 Security TechCenter 中找到。

我们期待您的想法！

功能请求

哪些功能对您很重要？ 您可以通过查看我们开放的 功能请求 并通过给问题点赞或点踩来分享您的想法。 （请注意，列表按点赞数降序排列。）

设计讨论

我们非常乐意将社区的输入纳入我们的库设计过程中。 以下是我们目前正在进行的 设计讨论 列表。 通过在问题中留下您的评论来参与讨论！

贡献

有关向此仓库贡献的详细信息，请参阅贡献指南。

对于与此仓库协作的 AI 代理和自动化工具，请参阅 AGENTS.md 以了解安全有效的自动化模式指南。

本项目欢迎贡献和建议。大多数贡献要求您同意贡献者许可协议（CLA），声明您有权且确实授予我们使用您贡献的权利。有关详细信息，请访问 https://cla.microsoft.com。

当您提交拉取请求时，CLA-bot 将自动确定您是否需要提供 CLA，并相应地标记 PR（例如，标签、评论）。只需按照机器人提供的说明操作即可。您只需在所有使用我们 CLA 的仓库中执行一次此操作。

本项目已采纳微软开源行为准则。有关更多信息，请参阅行为准则常见问题解答或联系 opencode@microsoft.com 提出任何额外的问题或意见。