开始使用 Azure Blob 存储和 JavaScript 或 TypeScript

npm install @azure/storage-blob @azure/identity

npm install typescript @azure/storage-blob @azure/identity

若要通过 Microsoft Entra ID 授权，需要使用安全主体。 需要哪种类型的安全主体取决于应用的运行位置。 使用下表作为指南：

使用 DefaultAzureCredential 授权访问

要授予访问权限并连接到 Blob 存储，一种简单且安全的方法是通过创建 DefaultAzureCredential 实例来获取 OAuth 令牌。 然后，你可以使用该凭据创建 BlobServiceClient 对象。

以下示例使用 DefaultAzureCredential 创建 BlobServiceClient 对象:

const accountName = "<account-name>";
const accountURL = `https://${accountName}.blob.core.chinacloudapi.cn`;
const blobServiceClient = new BlobServiceClient(
  accountURL,
  new DefaultAzureCredential()
);

此代码示例可用于 JavaScript 或 TypeScript 项目。

要使用共享访问签名 (SAS) 令牌，请将令牌追加到用 ? 分隔符分隔的帐户 URL 字符串。 然后，使用 URL 创建 BlobServiceClient 对象。

const accountName = "<account-name>";
const sasToken = "<sas-token>";
const accountURL = `https://${accountName}.blob.core.chinacloudapi.cn?${sasToken}`;
const blobServiceClient = new BlobServiceClient(accountURL);

此代码示例可用于 JavaScript 或 TypeScript 项目。

要详细了解如何生成和管理 SAS 令牌，请参阅以下文章:

• 使用共享访问签名 (SAS) 授予对 Azure 存储资源的有限访问权限
• 使用 JavaScript 创建帐户 SAS
• 使用 JavaScript 创建服务 SAS
• 使用 JavaScript 创建用户委托 SAS

若要使用存储帐户共享密钥，请提供字符串形式的密钥并初始化 BlobServiceClient 对象。

const credential = new StorageSharedKeyCredential(accountName, accountKey);
const blobServiceClient = new BlobServiceClient(
  `https://${accountName}.blob.core.chinacloudapi.cn`,
  credential
);

此代码示例可用于 JavaScript 或 TypeScript 项目。

还可以使用连接字符串创建 BlobServiceClient 对象。

const blobServiceClient = BlobServiceClient.fromConnectionString(connectionString);

有关如何获取帐户密钥的信息以及正确管理和保护密钥的最佳做法指导，请参阅管理存储帐户访问密钥。