Erstellen eines neuen STACKIT Windows Server mit der API

Das richtige STACKIT Windows Server Image finden

Der erste wichtige Schritt zum Erstellen eines Servers mit der STACKIT IAAS API oder CLI besteht darin, das passende STACKIT-Image für Ihre Betriebssystemversion zu finden. STACKIT bietet derzeit Images für die folgenden Windows Server-Versionen an:

• Windows Server 2016
• Windows Server 2019
• Windows Server 2022
• Windows Server 2025

Sie können eine Liste aller allgemein verfügbaren oder aller aktuell veröffentlichten Windows Server-Images erstellen, indem Sie einen der unten stehenden STACKIT IAAS CLI-Befehle verwenden.

Alle allgemein verfügbaren Images auflisten

Bitte stellen Sie sicher, dass Sie Ihre projectID im Befehl angeben.

stackit curl [https://iaas.api.eu01.stackit.cloud/v1/projects/](https://iaas.api.eu01.stackit.cloud/v1/projects/){projectID}/images | jq '.items[] | select(.name == "^Windows Server (2016|2019|2022|2025) Standard") | {id, name, status, scope}'

Alle aktuell veröffentlichten Images auflisten

Bitte stellen Sie sicher, dass Sie Ihre projectID im Befehl angeben.

stackit curl https://iaas.api.eu01.stackit.cloud/v1/projects/{projectID}/images | jq '.items[] | select(.name == "^Windows Server (2016|2019|2022|2025) Standard$") | {id, name, status, scope}'

Beispielausgabe

{
 "id": "0a179f46-16ef-4862-b57b-756c15a902a5",
 "name": "Windows Server 2016 Standard",
 "status": "AVAILABLE",
 "scope": "public"
},
{
 "id": "70a1fc51-c43c-4e0e-9d2c-d40433640cad",
 "name": "Windows Server 2019 Standard",
 "status": "AVAILABLE",
 "scope": "public"
},
{
 "id": "e22f8a22-334c-4294-991c-bd5158380155",
 "name": "Windows Server 2022 Standard",
 "status": "AVAILABLE",
 "scope": "public"
},
{
 "id": "03e41242-6d4a-4432-bd56-41f8d00a4202",
 "name": "Windows Server 2025 Standard",
 "status": "AVAILABLE",
 "scope": "public"
}

Bitte beachten Sie, dass STACKIT-Images nach einem Jahr unwiderruflich gelöscht werden.

Wenn Sie zudem ältere STACKIT-Images verwenden, um neue Server zu spawnen, könnten diese Server inkompatibel mit dem neuesten STACKIT-Feature-Stack sein und eventuell nicht mehr jede Funktion unterstützen.

Einen STACKIT Windows Server erstellen

Wir stellen ein OS-Image zur Verfügung, mit dem Sie STACKIT Windows Server-Instanzen bereitstellen können.

STACKIT IAAS API

Stellen Sie zusätzlich sicher, dass Sie die korrekten Benutzerdaten (User Data) angeben, um Ihre Zugangsdaten an den neuen Server zu übergeben. Dieser Schritt ist erforderlich, um sich nach Abschluss der Erstkonfiguration beim ersten Start anmelden zu können.

Der folgende Abschnitt erklärt, wie Sie die Benutzerdaten vorbereiten.

Injizieren von Zugangsdaten über benutzerdefinierte User Data

Wenn Sie benutzerdefinierte Skripte verwenden möchten, um Ihren Server beim ersten Start individuell zu konfigurieren, unterstützen wir derzeit cloud-config und x-shellscript (z. B. PowerShell für Windows oder Bash für Linux), um benutzerdefinierte User Data in Ihre Maschine zu injizieren.

Wichtig: Der Wert des Feldes "userData" in der API-Anfrage muss beim Senden der Anfrage in Base64 kodiert sein. Sie können kostenlose Online-Tools zur Base64-Kodierung/-Dekodierung verwenden, wie: https://www.base64decode.org

Angeben von Benutzernamen(n) und Passwörter im Klartext

Um den Server mit vordefinierten Zugangsdaten zu erstellen, geben Sie diese in einer YAML-Datei als User Data an, wie in den folgenden Beispielen gezeigt.

Beispiel 1: Nur das Passwort des Standard-Administrators festlegen

#cloud-config
users:
  - name: Administrator
    passwd: 'Your\_at\_least\_15\_characters\_password'
    groups: Administrators

Beispiel 2: Passwörter für zusätzliche Benutzer festlegen

#cloud-config
users:
  - name: AdditionalUserName1
    passwd: 'Your\_at\_least\_15\_characters\_password'
    groups: Administrators
  - name: AdditionalUserName2
    passwd: 'Your\_at\_least\_15\_characters\_password'
    groups: Administrators

Im obigen Beispiel erhält das Standardkonto Administrator ein zufällig generiertes Passwort, da sein Benutzername nicht umbenannt werden kann.

Hinweis: Wenn die angegebenen Passwörter nicht den erforderlichen Komplexitätskriterien entsprechen, können Sie diese nicht für die Anmeldung an der Instanz verwenden.

Passwortanforderungen:

• Mindestens 15 Zeichen
• Mindestens 1 Sonderzeichen
• Mindestens 1 Zahl
• Mindestens 1 Großbuchstabe

Ihren Server einer Domäne hinzufügen

Sie können Ihren Server einer Domäne hinzufügen und sich mit einem Domänenbenutzer anmelden, indem Sie die folgenden Daten in der User-Data-Konfiguration in Form eines PowerShell-Skripts angeben.

Beispiel: Domain-Join-Setup

$host_name = 'Server-Test' # Rename the computer during the AD join
$dns1 = '10.1.0.214'
$dns2 = '10.1.0.214' # Optional
$DomainName = 'contoso.local'
$DomainUser = 'contoso.local\stackituser'
$DomainPassword = 'PutYourPasswordHere'

Stellen Sie sicher, dass die angegebenen Zugangsdaten und Domäneneinstellungen mit Ihrer Active Directory-Konfiguration übereinstimmen.

Weitere Details zu User Data finden Sie in der offiziellen cloudbase-init-Dokumentation: Userdata — cloudbase-init 1.1.7 documentation

Zusätzlich lesen Sie bitte die FAQs & Bekannte Probleme Windows Server für weitere Informationen.