你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
适用于 JavaScript 的 Azure 模板客户端库 - 版本 1.0.0-beta.1
此项目用作 Azure SDK for JavaScript 的模板包。 它旨在帮助 Azure SDK 开发人员启动新包,并提供有关如何为 Azure 服务组织客户端库的代码和文档的示例。
入门
目前支持的环境
- LTS 版本的 Node.js
- 最新版本的 Safari、Chrome、Edge 和 Firefox。
有关更多详细信息,请参阅我们的支持政策。
先决条件
- 一个 Azure 订阅。
通常,你会在此处放置一个用于预配必要 Azure 服务的 shell 命令。
安装 @azure/template
包
使用 安装适用于 JavaScript 的 npm
模板客户端库:
npm install @azure/template
浏览器支持
JavaScript 捆绑包
若要在浏览器中使用此客户端库,首先需要使用捆绑程序。 有关如何执行此操作的详细信息,请参阅捆绑 文档。
CORS
如果需要针对浏览器进行开发,则需要为存储帐户设置 跨域资源共享 (CORS) 规则。 转到Azure 门户并Azure 存储资源管理器,找到存储帐户,为 blob/队列/文件/表服务 () 创建新的 CORS 规则。
例如,可以创建以下 CORS 设置进行调试。 但是,请在生产环境中根据要求仔细自定义设置。
- 允许的来源:*
- 允许的谓词:DELETE、GET、HEAD、MERGE、POST、OPTIONS、PUT
- 允许的标头:*
- 公开的标头:*
- 最长期限 (秒) :86400
更多示例
顶级示例通常包括创建和验证 main 客户端等内容。 如果服务支持多种 (身份验证方法,例如基于密钥和 Azure Active Directory) 则可以提供每种方法的单独示例。
关键概念
ConfigurationClient
请在此处描述主客户端。 讨论它可以执行的操作以及开发人员何时想要使用它。
其他示例
为要解释的每个顶级服务概念创建一个部分。
示例
第一个示例
创建几个代码示例,说明某人如何使用库完成该服务的常见任务。
疑难解答
日志记录
启用日志记录可能有助于发现有关故障的有用信息。 若要查看 HTTP 请求和响应的日志,请将 AZURE_LOG_LEVEL
环境变量设置为 info
。 或者,可以在运行时通过调用 @azure/logger
中的 setLogLevel
来启用日志记录:
const { setLogLevel } = require("@azure/logger");
setLogLevel("info");
有关如何启用日志的更详细说明,请查看 @azure/logger 包文档。
后续步骤
有关演示如何使用客户端库的详细示例,请查看 示例 目录。
贡献
若要为此库做出贡献,请阅读贡献指南,详细了解如何生成和测试代码。