用於 js 的 azure sdk

適用於 JavaScript 的 Azure SDK

此儲存庫適用於 Azure SDK for JavaScript（Node.js 和瀏覽器）。它包含適用於各種 Azure 服務的程式庫。管理庫是用於預配和管理 Azure 資源的套件。客戶端程式庫是您用來使用這些資源並與它們互動的套件。

入門

一些有用的入門資源是：

• 每個包的自述文件包含程式碼範例和包資訊。該自述文件可以在此儲存庫的/sdk資料夾中您選擇的服務資料夾下的對應套件資料夾中找到。可以在 npm 中的套件的登入頁面上找到相同的自述文件。
• 這些軟體包最新版本的 API 參考文件可以在我們的公共開發人員文件中找到。
• 舊版的 API 參考文件可以在我們的版本化開發人員文件中找到。

每個服務可能有以下每個類別的多個可用庫：

• 客戶
• 管理

注意：其中一些軟體包有測試版。如果您需要確保程式碼已準備好用於生產，請使用穩定的非測試版軟體套件之一。

客戶

鑑於 Azure 資源已存在，您將使用用戶端程式庫來使用它並與其互動。這些庫中的大多數都遵循JavaScript 和TypeScript 的Azure SDK 設計指南，並共享許多核心功能，例如重試、日誌記錄、傳輸協定、身份驗證協定等。遵循這些指南。

若要取得遵循新準則的所有用戶端程式庫的列表，請造訪我們的 Azure SDK 版本頁面。

管理

管理庫可讓您透過 Azure 資源管理器（即 ARM）設定和管理 Azure 資源。您可以透過套件名稱中的@azure/arm-來識別這些庫。這些完全是根據代表資源管理 API 的 swagger 檔案自動產生的。

這些庫的較新版本遵循 TypeScript 的 Azure SDK 設計指南。這些新版本提供了所有 Azure SDK 之間共享的許多核心功能，包括直覺的 Azure Identity 程式庫、具有自訂策略的 HTTP 管道、錯誤處理、分散式追蹤等等。一些有用的資源包括：

• 遵循新指南的管理庫列表
• 文檔和程式碼範例。
• 遷移指南，展示如何從舊版本的庫進行過渡。

注意：如果您在升級某些軟體包後遇到管理庫的身份驗證問題，可能是您升級到新版本的 SDK 時未更改身份驗證程式碼，請參閱上面提到的遷移指南以取得正確的說明。

需要幫助嗎？

• 有關詳細文檔，請造訪我們的 Azure SDK for JavaScript 文檔
• 透過 GitHub Issues 提交問題
• 使用azure-sdk-js標籤在 StackOverflow 上檢查先前的問題或提出新問題。
• 請閱讀我們的支援文件。

社群

嘗試我們的社區資源。

報告安全問題和安全錯誤

安全性問題和錯誤應透過電子郵件私下回報給 Microsoft 安全回應中心 (MSRC) [email protected]。您應該會在 24 小時內收到回覆。如果您由於某種原因沒有這樣做，請透過電子郵件跟進，以確保我們收到您的原始訊息。可以在安全技術中心找到更多信息，包括 MSRC PGP 金鑰。

貢獻

有關對此存儲庫做出貢獻的詳細信息，請參閱貢獻指南。

該項目歡迎貢獻和建議。大多數貢獻都要求您同意貢獻者授權協議 (CLA)，聲明您有權並且實際上授予我們使用您的貢獻的權利。有關詳細信息，請訪問 https://cla.microsoft.com。

當您提交拉取請求時，CLA-bot 將自動確定您是否需要提供 CLA 並適當地裝飾 PR（例如標籤、評論）。只需按照機器人提供的說明進行操作即可。您只需使用我們的 CLA 在所有儲存庫中執行一次此操作。

該專案採用了微軟開源行為準則。有關詳細信息，請參閱行為準則常見問題解答或聯繫 [email protected] 提出任何其他問題或意見。