適用于 JavaScript 的 Azure Automanage 用戶端程式庫 - 1.0.2 版
此套件包含 (在 azure Automanage 用戶端) Node.js和瀏覽器中執行的等型 SDK。
Automanage 用戶端
| 原始程式碼套件 (NPM) | API 參考檔 | 樣品
開始使用
目前支援的環境
- Node.js 的 LTS 版本
- 最新版的 Safari、Chrome、Edge 和 Firefox。
如需詳細資訊,請參閱我們的支援原則。
必要條件
安裝 @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_ID
AZURE_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 套件文件。
下一步
如需如何使用此程式庫的詳細 範例 ,請參閱範例目錄。
參與
如果您希望向此程式庫投稿,請參閱投稿指南,深入瞭解如何組建與測試程式碼。