共用方式為

適用于 JavaScript 的 Azure Automanage 用戶端程式庫 - 1.0.2 版

  • 發行項

此套件包含 (在 azure Automanage 用戶端) Node.js和瀏覽器中執行的等型 SDK。

Automanage 用戶端

| 原始程式碼套件 (NPM) | API 參考檔 | 樣品

開始使用

目前支援的環境

如需詳細資訊，請參閱我們的支援原則。

必要條件

安裝 @azure/arm-automanage 套件

使用 npm 安裝適用于 JavaScript 的 Azure Automanage 用戶端程式庫：

npm install @azure/arm-automanage

建立和驗證 AutomanageClient

若要建立用戶端物件來存取 Azure Automanage API，您需要 endpoint Azure Automanage 資源和 credential 的 。 Azure Automanage 用戶端可以使用 Azure Active Directory 認證進行驗證。 您可以在 Azure入口網站中找到 Azure Automanage 資源的端點。

您可以使用 來自@azure/身分識別 程式庫或 現有 AAD 權杖的認證向 Azure Active Directory 進行驗證。

若要使用如下所示的 DefaultAzureCredential 提供者，或其他 Azure SDK 提供的認證提供者，請安裝 @azure/identity 套件：

npm install @azure/identity

您也需要 註冊新的 AAD 應用程式，並將 適當的角色指派給服務主體，以授與 Azure Automanage 的存取權 (附注：這類 "Owner" 角色不會授與必要的許可權) 。 將 AAD 應用程式的用戶端識別碼、租使用者識別碼和用戶端密碼的值設定為環境變數： AZURE_CLIENT_ID 、、 AZURE_TENANT_IDAZURE_CLIENT_SECRET 。

如需如何建立 Azure AD 應用程式的詳細資訊，請參閱 本指南。

const { AutomanageClient } = require("@azure/arm-automanage");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new AutomanageClient(new DefaultAzureCredential(), subscriptionId);

// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
//   tenantId: "<YOUR_TENANT_ID>",
//   clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new AutomanageClient(credential, subscriptionId);

範例

建立或更新組態設定檔

若要更新檔案，只要取代 屬性 中的任何值，然後再次執行 createOrUpdate () 函式即可。

const newProfile = {
    "location": "eastus",
    "tags": {
        "environment": "prod"
    },
    "properties": {
        "configuration": {
            "Antimalware/Enable": true,
            "Antimalware/EnableRealTimeProtection": true,
            "Antimalware/RunScheduledScan": true,
            "Antimalware/ScanType": "Quick",
            "Antimalware/ScanDay": 7,
            "Antimalware/ScanTimeInMinutes": 120,
            "Backup/Enable": true,
            "Backup/PolicyName": "dailyBackupPolicy",
            "Backup/TimeZone": "UTC",
            "Backup/InstantRpRetentionRangeInDays": 2,
            "Backup/SchedulePolicy/ScheduleRunFrequency": "Daily",
            "Backup/SchedulePolicy/SchedulePolicyType": "SimpleSchedulePolicy",
            "Backup/RetentionPolicy/RetentionPolicyType": "LongTermRetentionPolicy",
            "Backup/RetentionPolicy/DailySchedule/RetentionDuration/Count": 180,
            "Backup/RetentionPolicy/DailySchedule/RetentionDuration/DurationType": "Days",
            "WindowsAdminCenter/Enable": false,
            "VMInsights/Enable": true,
            "AzureSecurityCenter/Enable": true,
            "UpdateManagement/Enable": true,
            "ChangeTrackingAndInventory/Enable": true,
            "GuestConfiguration/Enable": true,
            "AutomationAccount/Enable": true,
            "LogAnalytics/Enable": true,
            "BootDiagnostics/Enable": true
        }
    }
}

await client.configurationProfiles.createOrUpdate("configurationProfileName", "resourceGroupName", newProfile);

刪除組態設定檔

await client.configurationProfiles.delete("resourceGroupName", "configurationProfileName");

建立最佳做法生產設定檔指派

let assignment = {
    "properties": {
        "configurationProfile": "/providers/Microsoft.Automanage/bestPractices/AzureBestPracticesProduction"
    }
}

await client.configurationProfileAssignments.createOrUpdate("default", "resourceGroupName", "vmName", assignment);

建立自訂設定檔指派

let assignment = {
    "properties": {
        "configurationProfile": "/subscriptions/<subscription ID>/resourceGroups/resourceGroupName/providers/Microsoft.Automanage/configurationProfiles/configurationProfileName"
    }
}

await client.configurationProfileAssignments.createOrUpdate("default", "resourceGroupName", "vmName", assignment);

JavaScript 套件組合

若要在瀏覽器中使用此用戶端程式庫，您必須先使用套件組合器。 如需如何執行這項操作的詳細資訊，請參閱我們的 統合檔。

重要概念

AutomanageClient

AutomanageClient 是使用 Azure Automanage 用戶端程式庫的開發人員的主要介面。 探索此用戶端物件上的方法，以瞭解您可以存取之 Azure Automanage 服務的不同功能。

疑難排解

記錄

啟用記錄有助於找出失敗的相關實用資訊。 若要查看 HTTP 的要求和回應記錄，請將 AZURE_LOG_LEVEL 環境變數設定為 info。 或者，您可以在 @azure/logger 中呼叫 setLogLevel，以在執行階段啟用記錄：

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

如需如何啟用記錄的詳細指示，可參閱 @azure/logger 套件文件。

下一步

如需如何使用此程式庫的詳細 範例 ，請參閱範例目錄。

參與

如果您希望向此程式庫投稿，請參閱投稿指南，深入瞭解如何組建與測試程式碼。

曝光數