Workflow🚀 Deployment & Infrastruktur

Vercel Subdomain anlegen und DNS-Record setzen (REST-API)

Version 1.0·Stand 2026-06-17·Markdown · kostenlos

Auf Vercel eine Subdomain einem Projekt zuordnen und DNS-Records (bei Vercel DNS) per REST-API anlegen/aendern, ohne CLI, mit sauberer Token-Hygiene.

🧭Worum es geht

Vercel REST-API via PowerShell Invoke-RestMethod; DNS-Records innerhalb einer bereits bei Vercel gehosteten Zone plus Subdomain-Zuordnung zum Projekt.

📄Was die Datei enthält

Token sicher laden und Auth read-only validieren
Scope/Team bestimmen (Personal vs. Team, teamId/slug)
Subdomain einem Projekt zuordnen
DNS-Records auflisten, anlegen, aendern (DELETE plus POST)
Record-Presets (CNAME zu Vercel, A-Apex, A zu eigenem Server)
Verifizierung per nslookup und verified-Status
Abgrenzung DNS-Records vs. Domains/Registrar-API

🎯Welche Probleme sie löst

DNS/Subdomain-Setup ohne lokales Vercel-CLI
403-Fehler durch zu eng gescopte Tokens
Record-Wert aendern trotz fehlendem Value-Update
Subdomain auf eigenen Server statt Vercel zeigen lassen

⚠️Welche Fehler ohne diesen Workflow auftreten

403 bei Teams/Domains-Listing ohne teamId/slug
Hartes Skript-Abbruch bei HTTP-Fehler ohne try/catch -ErrorAction Stop (PS 5.1)
Falscher Record durch FQDN statt nur Label im name-Feld
Versuch eines nicht existierenden direkten Value-Updates

🏷️Themen

verceldnssubdomainrest-apicnamepowershelldeploymenttoken

Skill = eine einzelne Fähigkeit bzw. ein Schritt – fokussiert und sofort einsetzbar.

Workflow = ein kompletter Prozess, der mehrere Skills zu einem Ergebnis verkettet.