Microsoft. SQL-Server 2026-08-01-Vorschau

Bicep-Ressourcendefinition

Der Serverressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Verwendungsbeispiele

Beispiele für Bicep

Ein grundlegendes Beispiel für die Bereitstellung des Microsoft SQL Azure Database Server.

param resourceName string = 'acctest0001'
param location string = 'westeurope'
@secure()
@description('The administrator password for the SQL server')
param sqlAdministratorPassword string

resource server 'Microsoft.Sql/servers@2021-02-01-preview' = {
  name: resourceName
  location: location
  properties: {
    administratorLogin: 'mradministrator'
    administratorLoginPassword: sqlAdministratorPassword
    minimalTlsVersion: '1.2'
    publicNetworkAccess: 'Enabled'
    restrictOutboundNetworkAccess: 'Disabled'
    version: '12.0'
  }
}

Von Azure verifizierte Module

Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.

Modul Description
Azure SQL Server AVM Resource Module für Azure SQL Server

Azure-Schnellstartbeispiele

Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.

Bicep-Datei Description
Azure SQL Server mit Auditing auf Log Analytics Diese Vorlage ermöglicht es Ihnen, einen Azure SQL-Server mit aktiviertem Auditing bereitzustellen, um Audit-Logs in Log Analytics (OMS-Arbeitsbereich) zu schreiben
Erstellen Sie eine SQL Server und Datenbank Mit dieser Vorlage können Sie SQL-Datenbank und -Server erstellen.
Dedizierter SQL-Pool mit transparenter Verschlüsselung Erstellt einen SQL Server und einen dedizierten SQL-Pool (früher SQL DW) mit Transparent Data Encryption.
Bereitstellen der Sports Analytics auf azure Architecture Erstellt ein Azure-Speicherkonto mit aktiviertem ADLS Gen 2, einer Azure Data Factory-Instanz mit verknüpften Diensten für das Speicherkonto (eine Azure SQL-Datenbank, sofern bereitgestellt) und eine Azure Databricks-Instanz. Die AAD-Identität für den Benutzer, der die Vorlage bereitstellt, und die verwaltete Identität für die ADF-Instanz wird der Rolle "Mitwirkender von Speicher-BLOB-Daten" für das Speicherkonto gewährt. Es gibt auch Optionen zum Bereitstellen einer Azure Key Vault-Instanz, einer Azure SQL-Datenbank und eines Azure Event Hub (für Streaming-Anwendungsfälle). Wenn ein Azure Key Vault bereitgestellt wird, erhalten die vom Datenfactory verwaltete Identität und die AAD-Identität für den Benutzer, der die Vorlage bereitstellt, die Rolle "Key Vault Secrets User".
private Endpunkt-Beispiel Diese Vorlage zeigt, wie Sie einen privaten Endpunkt erstellen, der auf Azure SQL Server verweist.
Bereitstellen einer Web App mit einer SQL-Datenbank Diese Vorlage enthält eine Web App, eine SQL-Datenbank, AutoScale-Einstellungen, Warnungsregeln und App Insights. Sie konfiguriert eine Verbindungszeichenfolge in der Web-App für die Datenbank.
Sonarqube Docker Web App unter Linux mit Azure SQL Diese Vorlage stellt Sonarqube in einem Azure App Web App-Linux-Container mit dem offiziellen Sonarqube-Image bereit und wird von einem Azure SQL Server unterstützt.
SQL-logischer Server Mit dieser Vorlage können Sie SQL-logischen Server erstellen.
Web App mit verwalteter Identität, SQL Server und ΑΙ Einfaches Beispiel für die Bereitstellung der Azure-Infrastruktur für App + Daten + verwaltete Identität + Überwachung

Ressourcenformat

Um ein Microsoft zu schaffen. SQL/Server-Ressource, fügen Sie folgenden Bicep Ihrer Vorlage hinzu.

resource symbolicname 'Microsoft.Sql/servers@2026-08-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    administratorLogin: 'string'
    administratorLoginPassword: 'string'
    administrators: {
      administratorType: 'string'
      azureADOnlyAuthentication: bool
      login: 'string'
      principalType: 'string'
      sid: 'string'
      tenantId: 'string'
    }
    createMode: 'string'
    federatedClientId: 'string'
    isIPv6Enabled: 'string'
    keyId: 'string'
    minimalTlsVersion: 'string'
    primaryUserAssignedIdentityId: 'string'
    publicNetworkAccess: 'string'
    restrictOutboundNetworkAccess: 'string'
    retentionDays: int
    version: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschaftswerte

Microsoft.Sql/servers

Name Description Wert
identity Die Azure Active Directory-Identität des Servers. ResourceIdentity
location Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
properties Ressourceneigenschaften. ServerProperties
Stichwörter Ressourcenetiketten Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

ResourceIdentity

Name Description Wert
type Der Identitätstyp. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal für die Ressource zu erstellen und zuzuweisen. "Keine"
'SystemZugewiesen'
"SystemAssigned,UserAssigned"
'UserAssigned'
userAssignedIdentities Die Ressourcen-IDs der vom Benutzer zugewiesenen Identitäten, die verwendet werden sollen ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Wert

ServerExternalAdministrator

Name Description Wert
administratorType Typ des Serveradministrators. 'ActiveDirectory'
azureADOnlyAuthentication Nur Azure Active Directory-Authentifizierung aktiviert. bool
Anmelden Anmeldename des Serveradministrators. string
principalType Prinzipaltyp des Serveradministrators. 'Application'
"Gruppe"
'User'
sid SID (Objekt-ID) des Serveradministrators. string

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
tenantId Mandanten-ID des Administrators. string

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ServerProperties

Name Description Wert
administratorLogin Administratorbenutzername für den Server. Nach der Erstellung kann sie nicht mehr geändert werden. string
Administrator-Login-Passwort Das Administratoranmeldungskennwort (erforderlich für die Servererstellung). string

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
Administratoren Der Azure Active Directory-Administrator kann während der Servererstellung und für Serverupdates verwendet werden, mit Ausnahme der azureADOnlyAuthentication-Eigenschaft. Zum Aktualisieren der azureADOnlyAuthentication-Eigenschaft muss eine einzelne API verwendet werden. ServerExternalAdministrator
createMode Erstellungsmodus für Server, nur gültige Werte dafür sind Normal und Wiederherstellen. 'Normal'
"Wiederherstellen"
federatedClientId Die Client-ID, die für das mandantenübergreifende CMK-Szenario verwendet wird string

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
isIPv6Enabled Gibt an, ob die IPv6-Unterstützung für diesen Server aktiviert werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein. "Deaktiviert"
"Aktiviert"
"SecuredByPerimeter"
Schlüssel-ID Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll. string
minimalTlsVersion Minimale TLS-Version. Zulässige Werte: 'None', 1.0', '1.1', '1.2', '1.3' '1.0'
'1.1'
'1.2'
'1.3'
"Keine"
primaryUserAssignedIdentityId Die Ressourcen-ID einer vom Benutzer zugewiesenen Identität, die standardmäßig verwendet werden soll. string
publicNetworkAccess Gibt an, ob der Zugriff auf öffentliche Endpunkte für diesen Server zulässig ist. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' oder 'SecuredByPerimeter' sein. "Deaktiviert"
"Aktiviert"
"SecuredByPerimeter"
restrictOutboundNetworkAccess Gibt an, ob der ausgehende Netzwerkzugriff für diesen Server eingeschränkt werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein. "Deaktiviert"
"Aktiviert"
"SecuredByPerimeter"
retentionDays Anzahl der Tage, für die dieser Server vorläufig gelöscht wird. int
version Die Version des Servers. string

Verfolgte ResourceTags

Name Description Wert

UserIdentity

Name Description Wert

ARM-Vorlagenressourcendefinition

Der Serverressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Verwendungsbeispiele

Azure-Schnellstartvorlagen

Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.

Template Description
App Service-Umgebung mit Azure SQL-Back-End-

In Azure bereitstellen
Diese Vorlage erstellt eine App Service-Umgebung mit einem Azure SQL-Back-End zusammen mit privaten Endpunkten sowie zugeordneten Ressourcen, die normalerweise in einer privaten/isolierten Umgebung verwendet werden.
Autoscale LANSA Windows VM ScaleSet mit Azure SQL-Datenbank

In Azure bereitstellen
Die Vorlage stellt eine Windows-VMSS mit einer gewünschten Anzahl von VMs im Skalierungssatz und einer LANSA-MSI bereit, die in jedem virtuellen Computer installiert werden soll. Sobald der VM-Skalierungssatz bereitgestellt wurde, wird eine benutzerdefinierte Skripterweiterung verwendet, um die LANSA MSI zu installieren)
Azure SQL Server mit Überwachung, die in eine Blobspeicher-

In Azure bereitstellen
Mit dieser Vorlage können Sie einen Azure SQL-Server mit aktivierter Überwachung bereitstellen, um Überwachungsprotokolle in einen BLOB-Speicher zu schreiben.
Azure SQL Server mit Auditing an Event Hub

In Azure bereitstellen
Diese Vorlage ermöglicht es Ihnen, einen Azure SQL-Server mit aktiviertem Auditing bereitzustellen, um Audit-Logs auf Event Hub zu schreiben
Azure SQL Server mit Auditing auf Log Analytics

In Azure bereitstellen
Diese Vorlage ermöglicht es Ihnen, einen Azure SQL-Server mit aktiviertem Auditing bereitzustellen, um Audit-Logs in Log Analytics (OMS-Arbeitsbereich) zu schreiben
Erstellen Sie eine SQL Server und Datenbank

In Azure bereitstellen
Mit dieser Vorlage können Sie SQL-Datenbank und -Server erstellen.
Erstellen einer Web App + Redis Cache + SQL DB mit einer Vorlage

In Azure bereitstellen
Diese Vorlage erstellt eine Azure Web App mit Redis-Cache und einer SQL-Datenbank.
Erstellen Sie ein Azure SQL Server mit Datenverschlüsselungsschutz

In Azure bereitstellen
Diese Vorlage erstellt einen Azure SQL-Server und aktiviert den Datenverschlüsselungsschutz mit einem bestimmten Schlüssel, der in einem bestimmten Key Vault gespeichert ist
Erstelle Azure SQL Server und Datenbank mit Failover-Gruppe

In Azure bereitstellen
Erstellt zwei Azure SQL-Server, eine Datenbank und eine Failover-Gruppe.
Erstellen, Konfigurieren und Bereitstellen von Webanwendungen auf einer Azure-VM-

In Azure bereitstellen
Erstellen und Konfigurieren einer Windows-VM mit SQL Azure-Datenbank und Bereitstellen einer Webanwendung in der Umgebung mithilfe von PowerShell DSC
Dedizierter SQL-Pool mit transparenter Verschlüsselung

In Azure bereitstellen
Erstellt einen SQL Server und einen dedizierten SQL-Pool (früher SQL DW) mit Transparent Data Encryption.
Bereitstellen eines HDInsight-Clusters und einer SQL-Datenbank

In Azure bereitstellen
Mit dieser Vorlage können Sie einen HDInsight-Cluster und eine SQL-Datenbank zum Testen von Sqoop erstellen.
Einen neuen SQL Elastic Pool ausrollen

In Azure bereitstellen
Diese Vorlage ermöglicht es Ihnen, einen neuen SQL Elastic Pool mit dem zugehörigen SQL Server und neuen SQL-Datenbanken zu installieren.
Bereitstellen von Octopus Deploy 3.0 mit einer Testlizenz

In Azure bereitstellen
Mit dieser Vorlage können Sie einen einzelnen Octopus Deploy 3.0-Server mit einer Testlizenz bereitstellen. Dadurch wird eine einzelne Windows Server 2012R2-VM (Standard D2) und SQL DB (S1-Ebene) an dem für die Ressourcengruppe angegebenen Speicherort bereitgestellt.
Bereitstellen der Sports Analytics auf azure Architecture

In Azure bereitstellen
Erstellt ein Azure-Speicherkonto mit aktiviertem ADLS Gen 2, einer Azure Data Factory-Instanz mit verknüpften Diensten für das Speicherkonto (eine Azure SQL-Datenbank, sofern bereitgestellt) und eine Azure Databricks-Instanz. Die AAD-Identität für den Benutzer, der die Vorlage bereitstellt, und die verwaltete Identität für die ADF-Instanz wird der Rolle "Mitwirkender von Speicher-BLOB-Daten" für das Speicherkonto gewährt. Es gibt auch Optionen zum Bereitstellen einer Azure Key Vault-Instanz, einer Azure SQL-Datenbank und eines Azure Event Hub (für Streaming-Anwendungsfälle). Wenn ein Azure Key Vault bereitgestellt wird, erhalten die vom Datenfactory verwaltete Identität und die AAD-Identität für den Benutzer, der die Vorlage bereitstellt, die Rolle "Key Vault Secrets User".
Django-App mit SQL-Datenbanken

In Azure bereitstellen
Diese Vorlage verwendet die Azure Linux CustomScript-Erweiterung, um eine Anwendung bereitzustellen. In diesem Beispiel wird eine Ubuntu-VM erstellt, eine automatische Installation von Python, Django und Apache durchgeführt und dann eine einfache Django-App erstellt. Die Vorlage erstellt außerdem eine SQL-Datenbank mit einer Beispieltabelle mit einigen Beispieldaten, die im Webbrowser mithilfe einer Abfrage angezeigt werden
Enterprise Governance-AppService, SQL DB, AD, OMS, Runbooks

In Azure bereitstellen
Die Cloudakzeptanz für ein Unternehmen, klein oder groß, erfordert verantwortungsvolle und effiziente Governancemodelle, um einen Nutzen aus ihren Cloudbereitstellungen abzuleiten. CloudWise (ein Codename für die Lösung) ist eine zusammengesetzte Lösung, die von Azure Partner QuickStarts zur Verfügung steht, ist ein Einführungsaktivierer für Kunden, Systemintegratoren und Partner gleichermaßen, die eine selbstverwendbare, automatisierte Governance- und Betriebslösung bietet, die sich auf die Optimierung Ihrer Kosten, Verbesserung der Zuverlässigkeit Ihrer Anwendungen, Verringerung des Geschäftsrisikos konzentriert. Die Lösung hebt die wichtigsten Governance-Säulen der Sichtbarkeit und Kontrolle hervor.
EPiserverCMS in Azure

In Azure bereitstellen
Mit dieser Vorlage können Sie Ressourcen erstellen, die für die EpiServerCMS-Bereitstellung in Azure erforderlich sind.
eShop-Website mit ILB ASE

In Azure bereitstellen
Eine App Service-Umgebung ist eine Premium-Serviceplanoption von Azure App Service, die eine vollständig isolierte und dedizierte Umgebung für die sichere Ausführung von Azure App Service-Apps im großen Maßstab bereitstellt, einschließlich Web-Apps, Mobile Apps und API-Apps.
Kentico Xperience

In Azure bereitstellen
Diese Vorlage erleichtert die Bereitstellung von Ressourcen, die zum Hosten von Kentico Xperience-Umgebungen in Microsoft Azure erforderlich sind.
Migrieren zur Azure SQL-Datenbank mithilfe von Azure DMS

In Azure bereitstellen
Der Azure Database Migration Service (DMS) wurde entwickelt, um den Prozess der Migration lokaler Datenbanken zu Azure zu optimieren. DMS vereinfacht die Migration vorhandener lokaler SQL Server- und Oracle-Datenbanken zu Azure SQL-Datenbank, azure SQL Managed Instance oder Microsoft SQL Server in einem virtuellen Azure-Computer. Diese Vorlage würde eine Instanz des Azure-Datenbankmigrationsdiensts bereitstellen, eine Azure-VM, auf der sql server installiert ist, die als Quellserver mit vorab erstellter Datenbank fungiert, und einen Ziel-Azure SQL DB-Server, der über ein vordefiniertes Schema der Datenbank verfügt, das von Source zu Zielserver migriert werden soll. Die Vorlage stellt außerdem die erforderlichen Ressourcen wie NIC, vnet usw. bereit, um den Quellcomputer, den DMS-Dienst und den Zielserver zu unterstützen.
Obstgarten CMS VideoPortal Web App

In Azure bereitstellen
Diese Vorlage bietet eine einfache Möglichkeit zum Bereitstellen von Orchard CMS in Azure App Service Web-Apps mit aktiviertem und konfiguriertem Azure Media Services-Modul.
private Endpunkt-Beispiel

In Azure bereitstellen
Diese Vorlage zeigt, wie Sie einen privaten Endpunkt erstellen, der auf Azure SQL Server verweist.
Bereitstellen einer mobilen App mit einer SQL-Datenbank

In Azure bereitstellen
Diese Vorlage stellt eine mobile App, SQL-Datenbank und einen Benachrichtigungshub zur Anwendung. Sie konfiguriert eine Verbindungszeichenfolge in der mobilen App für die Datenbank und den Benachrichtigungshub.
Bereitstellen Sie eine SQL-Datenbank mit TDE

In Azure bereitstellen
Diese Vorlage stellt einen SQL Server mit geöffneter Firewall für Azure-Datenverkehr und eine SQL-Datenbank mit Transparent Data Encryption (TDE) bereit.
Bereitstellen einer Web App mit einer SQL-Datenbank

In Azure bereitstellen
Diese Vorlage enthält eine Web App, eine SQL-Datenbank, AutoScale-Einstellungen, Warnungsregeln und App Insights. Sie konfiguriert eine Verbindungszeichenfolge in der Web-App für die Datenbank.
Remotedesktopdienste mit hoher Verfügbarkeit

In Azure bereitstellen
Dieser ARM-Vorlagenbeispielcode stellt eine Remotedesktopdienste 2019 Session Collection Lab mit hoher Verfügbarkeit bereit. Ziel ist die Bereitstellung einer vollständig redundanten, hoch verfügbaren Lösung für Remotedesktopdienste unter Verwendung von Windows Server 2019.
skalierbare Umbraco CMS Web App-

In Azure bereitstellen
Diese Vorlage bietet eine einfache Möglichkeit, umbraco CMS Web App in Azure App Service Web-Apps bereitzustellen.
Einfache Umbraco CMS Web App

In Azure bereitstellen
Diese Vorlage bietet eine einfache Möglichkeit, umbraco CMS Web App in Azure App Service Web-Apps bereitzustellen.
Sonarqube Docker Web App unter Linux mit Azure SQL

In Azure bereitstellen
Diese Vorlage stellt Sonarqube in einem Azure App Web App-Linux-Container mit dem offiziellen Sonarqube-Image bereit und wird von einem Azure SQL Server unterstützt.
SQL-logischer Server

In Azure bereitstellen
Mit dieser Vorlage können Sie SQL-logischen Server erstellen.
SQL-Server mit Azure reiner AD-Authentifizierung

In Azure bereitstellen
Diese Vorlage ermöglicht es, einen SQL-Server in Azure mit aktiviertem Azure AD Admin-Set und aktivierter Azure AD-Only-Authentifizierungsfunktion zu erstellen.
Web App mit einer SQL-Datenbank, Azure Cosmos DB, Azure Search

In Azure bereitstellen
Diese Vorlage enthält eine Web App, eine SQL-Datenbank, Azure Cosmos DB, Azure Search und Application Insights.
Web App mit verwalteter Identität, SQL Server und ΑΙ

In Azure bereitstellen
Einfaches Beispiel für die Bereitstellung der Azure-Infrastruktur für App + Daten + verwaltete Identität + Überwachung
WebApp, die einen privaten Azure SQL-Endpunkt

In Azure bereitstellen
Diese Vorlage zeigt, wie Sie eine Web-App erstellen, die einen privaten Endpunkt verwendet, der auf Azure SQL Server verweist.

Ressourcenformat

Um ein Microsoft zu schaffen. SQL/Server-Resource, füge das folgende JSON zu deiner Vorlage hinzu.

{
  "type": "Microsoft.Sql/servers",
  "apiVersion": "2026-08-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "administrators": {
      "administratorType": "string",
      "azureADOnlyAuthentication": "bool",
      "login": "string",
      "principalType": "string",
      "sid": "string",
      "tenantId": "string"
    },
    "createMode": "string",
    "federatedClientId": "string",
    "isIPv6Enabled": "string",
    "keyId": "string",
    "minimalTlsVersion": "string",
    "primaryUserAssignedIdentityId": "string",
    "publicNetworkAccess": "string",
    "restrictOutboundNetworkAccess": "string",
    "retentionDays": "int",
    "version": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschaftswerte

Microsoft.Sql/servers

Name Description Wert
apiVersion (Englisch) Die API-Version '2026-08-01-Vorschau'
identity Die Azure Active Directory-Identität des Servers. ResourceIdentity
location Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
properties Ressourceneigenschaften. ServerProperties
Stichwörter Ressourcenetiketten Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
type Der Ressourcentyp 'Microsoft.Sql/Server'

ResourceIdentity

Name Description Wert
type Der Identitätstyp. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal für die Ressource zu erstellen und zuzuweisen. "Keine"
'SystemZugewiesen'
"SystemAssigned,UserAssigned"
'UserAssigned'
userAssignedIdentities Die Ressourcen-IDs der vom Benutzer zugewiesenen Identitäten, die verwendet werden sollen ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Wert

ServerExternalAdministrator

Name Description Wert
administratorType Typ des Serveradministrators. 'ActiveDirectory'
azureADOnlyAuthentication Nur Azure Active Directory-Authentifizierung aktiviert. bool
Anmelden Anmeldename des Serveradministrators. string
principalType Prinzipaltyp des Serveradministrators. 'Application'
"Gruppe"
'User'
sid SID (Objekt-ID) des Serveradministrators. string

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
tenantId Mandanten-ID des Administrators. string

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ServerProperties

Name Description Wert
administratorLogin Administratorbenutzername für den Server. Nach der Erstellung kann sie nicht mehr geändert werden. string
Administrator-Login-Passwort Das Administratoranmeldungskennwort (erforderlich für die Servererstellung). string

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
Administratoren Der Azure Active Directory-Administrator kann während der Servererstellung und für Serverupdates verwendet werden, mit Ausnahme der azureADOnlyAuthentication-Eigenschaft. Zum Aktualisieren der azureADOnlyAuthentication-Eigenschaft muss eine einzelne API verwendet werden. ServerExternalAdministrator
createMode Erstellungsmodus für Server, nur gültige Werte dafür sind Normal und Wiederherstellen. 'Normal'
"Wiederherstellen"
federatedClientId Die Client-ID, die für das mandantenübergreifende CMK-Szenario verwendet wird string

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
isIPv6Enabled Gibt an, ob die IPv6-Unterstützung für diesen Server aktiviert werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein. "Deaktiviert"
"Aktiviert"
"SecuredByPerimeter"
Schlüssel-ID Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll. string
minimalTlsVersion Minimale TLS-Version. Zulässige Werte: 'None', 1.0', '1.1', '1.2', '1.3' '1.0'
'1.1'
'1.2'
'1.3'
"Keine"
primaryUserAssignedIdentityId Die Ressourcen-ID einer vom Benutzer zugewiesenen Identität, die standardmäßig verwendet werden soll. string
publicNetworkAccess Gibt an, ob der Zugriff auf öffentliche Endpunkte für diesen Server zulässig ist. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' oder 'SecuredByPerimeter' sein. "Deaktiviert"
"Aktiviert"
"SecuredByPerimeter"
restrictOutboundNetworkAccess Gibt an, ob der ausgehende Netzwerkzugriff für diesen Server eingeschränkt werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein. "Deaktiviert"
"Aktiviert"
"SecuredByPerimeter"
retentionDays Anzahl der Tage, für die dieser Server vorläufig gelöscht wird. int
version Die Version des Servers. string

Verfolgte ResourceTags

Name Description Wert

UserIdentity

Name Description Wert

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Serverressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Change Log.

Verwendungsbeispiele

Terraform-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung des Microsoft SQL Azure Database Server.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

variable "sql_administrator_password" {
  type        = string
  description = "The administrator password for the SQL server"
  sensitive   = true
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "server" {
  type      = "Microsoft.Sql/servers@2021-02-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      administratorLogin            = "mradministrator"
      administratorLoginPassword    = var.sql_administrator_password
      minimalTlsVersion             = "1.2"
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = "Disabled"
      version                       = "12.0"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Von Azure verifizierte Module

Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.

Modul Description
Azure SQL Server AVM Resource Module für Azure SQL Server

Ressourcenformat

Um ein Microsoft zu schaffen. SQL/Server-Ressource, füge folgendes Terraform deiner Vorlage hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers@2026-08-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      administrators = {
        administratorType = "string"
        azureADOnlyAuthentication = bool
        login = "string"
        principalType = "string"
        sid = "string"
        tenantId = "string"
      }
      createMode = "string"
      federatedClientId = "string"
      isIPv6Enabled = "string"
      keyId = "string"
      minimalTlsVersion = "string"
      primaryUserAssignedIdentityId = "string"
      publicNetworkAccess = "string"
      restrictOutboundNetworkAccess = "string"
      retentionDays = int
      version = "string"
    }
  }
}

Eigenschaftswerte

Microsoft.Sql/servers

Name Description Wert
identity Die Azure Active Directory-Identität des Servers. ResourceIdentity
location Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
properties Ressourceneigenschaften. ServerProperties
Stichwörter Ressourcenetiketten Wörterbuch der Tagnamen und -werte.
type Der Ressourcentyp "Microsoft. SQL/servers@2026-08-01-preview"

ResourceIdentity

Name Description Wert
type Der Identitätstyp. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal für die Ressource zu erstellen und zuzuweisen. "Keine"
'SystemZugewiesen'
"SystemAssigned,UserAssigned"
'UserAssigned'
userAssignedIdentities Die Ressourcen-IDs der vom Benutzer zugewiesenen Identitäten, die verwendet werden sollen ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name Description Wert

ServerExternalAdministrator

Name Description Wert
administratorType Typ des Serveradministrators. 'ActiveDirectory'
azureADOnlyAuthentication Nur Azure Active Directory-Authentifizierung aktiviert. bool
Anmelden Anmeldename des Serveradministrators. string
principalType Prinzipaltyp des Serveradministrators. 'Application'
"Gruppe"
'User'
sid SID (Objekt-ID) des Serveradministrators. string

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
tenantId Mandanten-ID des Administrators. string

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ServerProperties

Name Description Wert
administratorLogin Administratorbenutzername für den Server. Nach der Erstellung kann sie nicht mehr geändert werden. string
Administrator-Login-Passwort Das Administratoranmeldungskennwort (erforderlich für die Servererstellung). string

Zwänge:
Vertraulicher Wert. Übergeben Als sicherer Parameter.
Administratoren Der Azure Active Directory-Administrator kann während der Servererstellung und für Serverupdates verwendet werden, mit Ausnahme der azureADOnlyAuthentication-Eigenschaft. Zum Aktualisieren der azureADOnlyAuthentication-Eigenschaft muss eine einzelne API verwendet werden. ServerExternalAdministrator
createMode Erstellungsmodus für Server, nur gültige Werte dafür sind Normal und Wiederherstellen. 'Normal'
"Wiederherstellen"
federatedClientId Die Client-ID, die für das mandantenübergreifende CMK-Szenario verwendet wird string

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
isIPv6Enabled Gibt an, ob die IPv6-Unterstützung für diesen Server aktiviert werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein. "Deaktiviert"
"Aktiviert"
"SecuredByPerimeter"
Schlüssel-ID Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll. string
minimalTlsVersion Minimale TLS-Version. Zulässige Werte: 'None', 1.0', '1.1', '1.2', '1.3' '1.0'
'1.1'
'1.2'
'1.3'
"Keine"
primaryUserAssignedIdentityId Die Ressourcen-ID einer vom Benutzer zugewiesenen Identität, die standardmäßig verwendet werden soll. string
publicNetworkAccess Gibt an, ob der Zugriff auf öffentliche Endpunkte für diesen Server zulässig ist. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' oder 'SecuredByPerimeter' sein. "Deaktiviert"
"Aktiviert"
"SecuredByPerimeter"
restrictOutboundNetworkAccess Gibt an, ob der ausgehende Netzwerkzugriff für diesen Server eingeschränkt werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein. "Deaktiviert"
"Aktiviert"
"SecuredByPerimeter"
retentionDays Anzahl der Tage, für die dieser Server vorläufig gelöscht wird. int
version Die Version des Servers. string

Verfolgte ResourceTags

Name Description Wert

UserIdentity

Name Description Wert