Aracılığıyla paylaş

JavaScript için Azure Otomatik Yönetim istemci kitaplığı - sürüm 1.0.2

Bu paket, Azure Otomatik Yönetim istemcisi için bir izomorfik SDK (hem Node.js hem de tarayıcılarda çalışır) içerir.

İstemciyi Otomatik Yönet

Kaynak kodu | Paket (NPM) | API başvuru belgeleri | Örnekleri

Başlarken

Şu anda desteklenen ortamlar

Daha fazla ayrıntı için destek ilkemize bakın.

Önkoşullar

@azure/arm-automanage paketini yükleyin

ile npmJavaScript için Azure Automanage istemci kitaplığını yükleyin:

npm install @azure/arm-automanage

Oluşturma ve kimlik doğrulaması AutomanageClient

Azure Otomatik Yönetim API'sine erişmek üzere bir istemci nesnesi oluşturmak için Azure Otomatik Yönetim kaynağınızın ve bir credentialöğesinin olması gerekirendpoint. Azure Otomatik Yönetim istemcisi kimlik doğrulaması için Azure Active Directory kimlik bilgilerini kullanabilir. Azure Otomatik Yönetimi kaynağınızın uç noktasını Azure Portal'da bulabilirsiniz.

@azure/kimlik kitaplığından veya mevcut bir AAD Belirtecinden kimlik bilgilerini kullanarak Azure Active Directory ile kimlik doğrulaması yapabilirsiniz.

Aşağıda gösterilen DefaultAzureCredential sağlayıcısını veya Azure SDK ile sağlanan diğer kimlik bilgileri sağlayıcılarını kullanmak için lütfen paketi yükleyin @azure/identity :

npm install @azure/identity

Ayrıca, hizmet sorumlunuza uygun rolü atayarak yeni bir AAD uygulaması kaydetmeniz ve Azure Otomatik Yönet'e erişim vermeniz gerekir (not: gibi "Owner" roller gerekli izinleri vermez). AAD uygulamasının istemci kimliği, kiracı kimliği ve istemci gizli dizisi değerlerini ortam değişkenleri olarak ayarlayın: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

Azure AD Uygulaması oluşturma hakkında daha fazla bilgi için bu kılavuzu gözden geçirin.

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);

Örnekler

Yapılandırma Profili Oluşturma veya Güncelleştirme

Bir dosyayı güncelleştirmek için özelliklerdeki değerlerden herhangi birini değiştirin ve createOrUpdate() işlevini yeniden çalıştırın.

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);

Yapılandırma Profilini Sil

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

En İyi Yöntemler Üretim Profili Ataması Oluşturma

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

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

Özel Profil Ataması Oluşturma

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

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

JavaScript Paketi

Bu istemci kitaplığını tarayıcıda kullanmak için önce bir paketleyici kullanmanız gerekir. Bunun nasıl yapılacağının ayrıntıları için lütfen paketleme belgelerimize bakın.

Önemli kavramlar

AutomanageClient

AutomanageClient , Azure Otomatik Yönetim istemci kitaplığını kullanan geliştiriciler için birincil arabirimdir. Azure Otomatik Yönetim hizmetinin erişebileceğiniz farklı özelliklerini anlamak için bu istemci nesnesinde yöntemleri keşfedin.

Sorun giderme

Günlüğe Kaydetme

Günlüğün etkinleştirilmesi hatalarla ilgili yararlı bilgilerin ortaya çıkarılmasına yardımcı olabilir. HTTP isteklerinin ve yanıtlarının günlüğünü görmek için ortam değişkenini AZURE_LOG_LEVEL olarak infoayarlayın. Alternatif olarak, günlüğü çalışma zamanında içinde çağrılarak setLogLevel@azure/loggeretkinleştirilebilir:

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

Günlükleri etkinleştirme hakkında daha ayrıntılı yönergeler için @azure/günlükçü paketi belgelerine bakabilirsiniz.

Sonraki adımlar

Bu kitaplığın nasıl kullanılacağına ilişkin ayrıntılı örnekler için lütfen samples dizinine göz atın.

Katkıda bulunma

Bu kitaplığa katkıda bulunmak isterseniz, kodu derleme ve test etme hakkında daha fazla bilgi edinmek için lütfen katkıda bulunma kılavuzunu okuyun.

İzlenimler

  • Last updated on