Benutzerdaten für Azure Virtual Machines

Benutzerdaten ermöglichen Ihnen, eigene Skripts oder Metadaten an Ihre VM zu übergeben.

Was sind „Benutzerdaten“?

Benutzerdaten sind eine Menge von Skripts oder anderer Metadaten, die zum Zeitpunkt der Bereitstellung in eine Azure-VM eingefügt werden. Jede Anwendung auf der VM kann nach der Bereitstellung über Azure Instance Metadata Service (IMDS) auf die Benutzerdaten zugreifen.

Benutzerdaten sind eine neue Version von benutzerdefinierten Daten mit zusätzlichen Vorteilen:

• Benutzerdaten können nach der Bereitstellung über Azure Instance Metadata Service (IMDS) abgerufen werden.

• Benutzerdaten sind persistent. Sie bleiben während der Lebensdauer der VM verfügbar.

• Benutzerdaten können von außerhalb der VM aktualisiert werden, ohne diese zu beenden oder neu zu starten.

• Benutzerdaten können über die GET-VM-/VMSS-API mit der Option $expand abgefragt werden.

Wenn Benutzerdaten nicht während dem Zeitpunkt der Bereitstellung hinzugefügt werden, können sie auch nach der Bereitstellung noch hinzugefügt werden.

Sicherheitswarnung

Stellen Sie sicher, dass Sie die neueste Azure Resource Manager-API nutzen, um die neuen Benutzerdatenfeatures zu verwenden. Der Inhalt sollte Base64-codiert werden, bevor er an die API übergeben wird. Die Dateigröße darf 64 KB nicht überschreiten.

Erstellen von Benutzerdaten für Azure-VMs/-VMSS

Hinzufügen von Benutzerdaten beim Erstellen einer neuen VM

Verwenden Sie diese Azure Resource Manager-Vorlage, um eine neue VM mit Benutzerdaten zu erstellen. Wenn Sie die REST-API verwenden, fügen Sie bei einzelnen VMs im Abschnitt „properties“ den Eintrag „UserData“ mithilfe einer PUT-Anforderung zum Erstellen der VM hinzu.

{
  "name": "testVM",
  "location": "West US",
  "properties": {
    "hardwareProfile": {
      "vmSize": "Standard_A1"
    },
    "storageProfile": {
      "osDisk": {
        "osType": "Windows",
        "name": "osDisk",
        "createOption": "Attach",
        "vhd": {
          "uri": "http://myaccount.blob.core.windows.net/container/directory/blob.vhd"
        }
      }
    },
    "userData": "c2FtcGxlIHVzZXJEYXRh",
    "networkProfile": { "networkInterfaces" : [ { "name" : "nic1" } ] },
  }
}

Hinzufügen von Benutzerdaten beim Erstellen einer neuen VM-Skalierungsgruppe

Wenn Sie die REST-API verwenden, fügen Sie beim Erstellen der VM-Skalierungsgruppe im Abschnitt „virtualMachineProfile“ den Eintrag „UserData“ mit der PUT-Anforderung hinzu.

{
  "location": "West US",
  "sku": {
    "name": "Standard_A1",
    "capacity": 1
  },
  "properties": {
    "upgradePolicy": {
      "mode": "Automatic"
    },
    "virtualMachineProfile": {
      "userData": "VXNlckRhdGE=",
      "osProfile": {
        "computerNamePrefix": "TestVM",
        "adminUsername": "TestUserName",
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "timeZone": "Dateline Standard Time"
        }
      },
      "storageProfile": {
        "osDisk": {
          "createOption": "FromImage",
          "caching": "ReadOnly"
        },
        "imageReference": {
          "publisher": "publisher",
          "offer": "offer",
          "sku": "sku",
          "version": "1.2.3"
        }
      },
      "networkProfile": {"networkInterfaceConfigurations":[{"name":"nicconfig1","properties":{"ipConfigurations":[{"name":"ip1","properties":{"subnet":{"id":"vmssSubnet0"}}}]}}]},
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "enabled": true,
          "storageUri": "https://crputest.blob.core.windows.net"
        }
      }
    },
    "provisioningState": 0,
    "overprovision": false,
    "uniqueId": "00000000-0000-0000-0000-000000000000"
  }
}

Abrufen von Benutzerdaten

Anwendungen, die auf der VM ausgeführt werden, können Benutzerdaten über den IMDS-Endpunkt abrufen. Weitere Informationen finden Sie hier im IMDS-Beispielcode.

Kunden können den vorhandenen Wert von Benutzerdaten über die REST-API mithilfe des Endpunkts „$expand=userData“ abrufen (der Anforderungstext kann leer gelassen werden).

Einzelne VMs:

GET "/subscriptions/{guid}/resourceGroups/{RGName}/providers/Microsoft.Compute/virtualMachines/{VMName}?$expand=userData"

VM-Skalierungsgruppe:

GET "/subscriptions/{guid}/resourceGroups/{RGName}/providers/Microsoft.Compute/virtualMachineScaleSets/{VMSSName}?$expand=userData"

VMSS-VM:

GET "/subscriptions/{guid}/resourceGroups/{RGName}/providers/Microsoft.Compute/virtualMachineScaleSets/{VMSSName}/virtualmachines/{vmss instance id}?$expand=userData"

Aktualisieren von Benutzerdaten

Sie können mit der REST-API eine normale PUT- oder PATCH-Anforderung verwenden, um die Benutzerdaten zu aktualisieren. Die Benutzerdaten werden aktualisiert, ohne dass die VM beendet oder neu gestartet werden muss.

PUT "/subscriptions/{guid}/resourceGroups/{RGName}/providers/Microsoft.Compute/ virtualMachines/{VMName}

PATCH "/subscriptions/{guid}/resourceGroups/{RGName}/providers/Microsoft.Compute/ virtualMachines/{VMName}

In dieser Anforderung sollte „VM.Properties“ das gewünschte Feld „UserData“ wie folgt enthalten:

"properties": {
        "hardwareProfile": {
          "vmSize": "Standard_D1_v2"
        },
        "storageProfile": {
          "imageReference": {
            "sku": "2016-Datacenter",
            "publisher": "MicrosoftWindowsServer",
            "version": "latest",
            "offer": "WindowsServer"
          },
          "osDisk": {
            "caching": "ReadWrite",
            "managedDisk": {
              "storageAccountType": "StandardSSD_LRS"
            },
            "name": "vmOSdisk",
            "createOption": "FromImage"
          }
        },
        "networkProfile": {
          "networkInterfaces": [
            {
              "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{existing-nic-name}",
              "properties": {
                "primary": true
              }
            }
          ]
        },
        "osProfile": {
          "adminUsername": "{your-username}",
          "computerName": "{vm-name}",
          "adminPassword": "{your-password}"
        },
        "diagnosticsProfile": {
          "bootDiagnostics": {
            "storageUri": "http://{existing-storage-account-name}.blob.core.windows.net",
            "enabled": true
          }
        },
        "userData": "U29tZSBDdXN0b20gRGF0YQ=="
      } 

Benutzerdaten und benutzerdefinierte Daten

Benutzerdefinierte Daten funktionieren nach wie vor auf die gleiche Weise wie heute. Beachten Sie, dass Sie benutzerdefinierte Daten nicht über IMDS abrufen können.

Hinzufügen von Benutzerdaten zu einer vorhandenen VM

Wenn Sie über eine VM/VMSS ohne Benutzerdaten verfügen, können Sie dieser VM immer noch Benutzerdaten hinzufügen, indem Sie die Aktualisierungsbefehle wie im Abschnitt Aktualisieren der Benutzerdaten beschrieben verwenden. Stellen Sie sicher, dass Sie ein Upgrade auf die neueste Version der Azure Resource Manager-API durchführen.

Nächste Schritte

Probieren Sie den Azure Instance Metadata Service aus, und erfahren Sie, wie Sie die Metadaten und Benutzerdaten der VM-Instanz über deren Endpunkt abrufen.