Servers - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

Erstellt oder aktualisiert einen Server.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2021-11-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
location	True	string	Ressourcenspeicherort
identity		ResourceIdentity	Die Azure Active Directory-Identität des Servers.
properties.administratorLogin		string	Administratorbenutzername für den Server. Nach der Erstellung kann es nicht mehr geändert werden.
properties.administratorLoginPassword		string	Das Administratoranmeldekennwort (erforderlich für die Servererstellung).
properties.administrators		ServerExternalAdministrator	Der Azure Active Directory-Administrator des Servers.
properties.federatedClientId		string	Die Client-ID, die für das mandantenübergreifende CMK-Szenario verwendet wird
properties.keyId		string	Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll.
properties.minimalTlsVersion		string	Minimale TLS-Version. Zulässige Werte: '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId		string	Die Ressourcen-ID einer benutzerseitig zugewiesenen Identität, die standardmäßig verwendet werden soll.
properties.publicNetworkAccess		ServerNetworkAccessFlag	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 "Aktiviert" oder "Deaktiviert" sein.
properties.restrictOutboundNetworkAccess		ServerNetworkAccessFlag	Gibt an, ob der ausgehende Netzwerkzugriff für diesen Server eingeschränkt werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss "Aktiviert" oder "Deaktiviert" sein.
properties.version		string	Die Serverversion.
tags		object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	Server	Der Server wurde erfolgreich aktualisiert.
201 Created	Server	Der Server wurde erfolgreich erstellt.
202 Accepted		Akzeptiert
Other Status Codes		Fehlerantworten: *** 400 MissingIdentityId: Es wird keine benutzerseitig zugewiesene Identität angegeben, wenn der Identitätstyp auf UserAssigned festgelegt ist. 400 InvalidPrimaryIdentityId : User stellt einen Wert für PrimaryUserIdentityId bereit, aber derselbe wird nicht im IdentityId-Parameter aufgeführt. 400 PECsNotExistingToDenyPublicNetworkAccess: Kann Deny Public Network Access nicht auf Ja festlegen, da kein privater Endpunkt für den Zugriff auf den Server aktiviert ist. Richten Sie private Endpunkte ein, und wiederholen Sie den Vorgang (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database). 400 NameAlreadyExists: Der angegebene Name ist bereits vorhanden. 400 UmiMissingAkvPermissions – PrimaryUserAssignedIdentityId, die vom Benutzer bereitgestellt wird, hat keinen Zugriff auf die bereitgestellte KeyId. 400 MissingPrimaryIdentity : PrimaryUserAssignedIdentityId, die vom Benutzer bereitgestellt wird, hat keinen Zugriff auf die bereitgestellte KeyId. 400 ProvisioningDisabled: Zeigt die Fehlermeldung des Ressourcenvorgangsautorisierer unverändert ohne Änderungen an. 400 PrimaryIdentityMissingPermissionForKeyId – KeyId wird vom Benutzer während der Erstellung bereitgestellt, aber PrimaryUserAssignedIdentityId wird nicht im API-Aufruf bereitgestellt. 400 InvalidIdentityTypeForKeyId: KeyId wird vom Benutzer während der Erstellung bereitgestellt, aber der Identitätstyp ist nicht auf "UserAssigned" festgelegt. 400 InvalidLoginName: Der angegebene Anmeldename ist ungültig. 400 InvalidUsername: Der angegebene Benutzername enthält ungültige Zeichen. 400 Ipv6FeatureNotEnabled: Der Benutzer hat versucht, die Ipv6-Unterstützung auf dem Server zu aktivieren, ohne das Featureflag für das Abonnement zu aktivieren, oder die Featureunterstützung ist derzeit in der Region deaktiviert. 400 PasswordTooShort: Das angegebene Kennwort ist zu kurz 400 AadOnlyAuthenticationIsEnabled: Die reine Azure Active Directory-Authentifizierung ist aktiviert. Wenden Sie sich an den Systemadministrator. 400 RegionDoesNotSupportVersion: Ein Benutzer hat versucht, einen Server einer angegebenen Version an einem Speicherort zu erstellen, an dem diese Serverversion nicht unterstützt wird. 400 PasswordTooLong: Das angegebene Kennwort ist zu lang. 400 PasswordNotComplex: Das angegebene Kennwort ist nicht komplex genug. 400 InvalidParameterValue: Einem Parameter wurde ein ungültiger Wert zugewiesen. 400 InvalidLocation: Ein ungültiger Speicherort wurde angegeben. 400 InvalidServerName: Ungültiger Servername angegeben. 400 InvalidIdentifier: Der Bezeichner enthält NULL oder ein ungültiges Unicode-Zeichen. 400 TokenTooLong: Das bereitgestellte Token ist zu lang. 400 RegionDoesNotAllowProvisioning: Der ausgewählte Speicherort akzeptiert keine neuen Windows Azure SQL Database-Server. Dies kann sich zu einem späteren Zeitpunkt ändern. 400 ServerNotFound: Der angeforderte Server wurde nicht gefunden. 400 InvalidMinimalTlsVersion: Ungültige TLS-Mindestversion. 400 InvalidExternalAdministratorLogin: Ungültiger oder fehlender Name der externen Administratoranmeldung. 400 InvalidExternalAdministratorSid: Ungültige oder fehlende externe Administratorobjekt-ID. 400 InvalidExternalAdministratorTenantId: Ungültige oder fehlende externe Administratormandanten-ID. 400 ExternalAdministratorPrincipalType: Ungültiger oder fehlender externer Administratorprinzipaltyp. Wählen Sie aus Benutzer, Anwendung oder Gruppe aus. 400 MissingExternalAdministratorWithAadOnlyAuth: Um die reine Azure AD-Authentifizierung zu verwenden, geben Sie Details zu einem externen Administrator an. 400 ExternalAdministratorLoginSameAsSqlAdmin: Die Namen des Azure Active Directory-Administrators und des Serveradministratorkontos müssen unterschiedlich sein. Geben Sie verschiedene Werte an. 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden. 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 404 SubscriptionNotFound: Das angeforderte Abonnement wurde nicht gefunden. 409 OperationCancelled: Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted: Der Vorgang für die Ressource konnte nicht abgeschlossen werden, da er durch einen anderen Vorgang für dieselbe Ressource unterbrochen wurde. 409 UpsertLogicalServerRequestAlreadyInProgress : Eine laufende logische Serveranforderung wird bereits ausgeführt. Versuchen Sie es später erneut. 409 ServerDisabled: Server ist deaktiviert. 409 ConflictingServerOperation: Für den Server wird derzeit ein Vorgang ausgeführt. 409 SubscriptionDisabled: Das Abonnement ist deaktiviert. 409 ServerQuotaExceeded: Server kann nicht zu einem Abonnement hinzugefügt werden, da er das Kontingent überschreitet. 409 ServerAlreadyExists: Doppelter Servername. 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 ConflictingSubscriptionOperation: Für das Abonnement wird derzeit ein Vorgang ausgeführt. 500 OperationTimedOut: Timeout des Vorgangs und automatisches Rollback. Wiederholen Sie den Vorgang. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

Create server

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645?api-version=2021-11-01

{
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled"
  },
  "location": "Japan East"
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ServerInner;
import com.azure.resourcemanager.sql.models.PrincipalType;
import com.azure.resourcemanager.sql.models.ServerExternalAdministrator;
import com.azure.resourcemanager.sql.models.ServerNetworkAccessFlag;
import java.util.UUID;

/** Samples for Servers CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerCreate.json
     */
    /**
     * Sample code: Create server.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().createOrUpdate("sqlcrudtest-7398", "sqlcrudtest-4645",
            new ServerInner().withLocation("Japan East").withAdministratorLogin("dummylogin")
                .withAdministratorLoginPassword("fakeTokenPlaceholder")
                .withPublicNetworkAccess(ServerNetworkAccessFlag.ENABLED)
                .withAdministrators(new ServerExternalAdministrator().withPrincipalType(PrincipalType.USER)
                    .withLogin("bob@contoso.com").withSid(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withTenantId(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withAzureADOnlyAuthentication(true))
                .withRestrictOutboundNetworkAccess(ServerNetworkAccessFlag.ENABLED),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
  "name": "sqlcrudtest-4645",
  "type": "Microsoft.Sql/servers",
  "location": "japaneast",
  "kind": "v12.0",
  "properties": {
    "fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
    "administratorLogin": "dummylogin",
    "version": "12.0",
    "state": "Ready",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "privateEndpointConnections": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/privateEndpointConnections/private-endpoint-name-00000000-1111-2222-3333-444444444444",
        "properties": {
          "provisioningState": "Ready",
          "privateEndpoint": {
            "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
          },
          "privateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "Auto-approved",
            "actionsRequired": "None"
          }
        }
      }
    ]
  }
}

Status code:

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
  "name": "sqlcrudtest-4645",
  "type": "Microsoft.Sql/servers",
  "location": "japaneast",
  "kind": "v12.0",
  "properties": {
    "fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
    "administratorLogin": "dummylogin",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "version": "12.0",
    "state": "Ready",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "privateEndpointConnections": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/privateEndpointConnections/private-endpoint-name-00000000-1111-2222-3333-444444444444",
        "properties": {
          "provisioningState": "Ready",
          "privateEndpoint": {
            "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
          },
          "privateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "Auto-approved",
            "actionsRequired": "None"
          }
        }
      }
    ]
  }
}

Status code:

202

Definitionen

Name	Beschreibung
AdministratorType	Typ des Serveradministrators.
IdentityType	Der Identitätstyp. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal für die Ressource zu erstellen und zuzuweisen.
PrincipalType	Prinzipaltyp des Serveradministrators.
PrivateEndpointConnectionProperties	Eigenschaften einer privaten Endpunktverbindung.
PrivateEndpointProperty
PrivateEndpointProvisioningState	Status der Verbindung mit dem privaten Endpunkt.
PrivateLinkServiceConnectionStateActionsRequire	Die für die Private Link-Dienstverbindung erforderlichen Aktionen.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	Die Private Link-Dienstverbindung status.
ResourceIdentity	Azure Active Directory-Identitätskonfiguration für eine Ressource.
Server	Ein Azure SQL-Datenbankserver.
ServerExternalAdministrator	Eigenschaften eines Active Directory-Administrators.
ServerNetworkAccessFlag	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 "Aktiviert" oder "Deaktiviert" sein.
ServerPrivateEndpointConnection	Eine private Endpunktverbindung unter einem Server
ServerWorkspaceFeature	Gibt an, ob ein vorhandener Server einen Arbeitsbereich erstellt hat und ob er eine Verbindung vom Arbeitsbereich aus zulässt.
UserIdentity	Azure Active Directory-Identitätskonfiguration für eine Ressource.

AdministratorType

Typ des Serveradministrators.

Name	Typ	Beschreibung
ActiveDirectory	string

IdentityType

Der Identitätstyp. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal für die Ressource zu erstellen und zuzuweisen.

Name	Typ	Beschreibung
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

PrincipalType

Prinzipaltyp des Serveradministrators.

Name	Typ	Beschreibung
Application	string
Group	string
User	string

PrivateEndpointConnectionProperties

Eigenschaften einer privaten Endpunktverbindung.

Name	Typ	Beschreibung
groupIds	string[]	Gruppen-IDs.
privateEndpoint	PrivateEndpointProperty	Privater Endpunkt, zu dem die Verbindung gehört.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Verbindungsstatus der Verbindung mit dem privaten Endpunkt.
provisioningState	PrivateEndpointProvisioningState	Status der Verbindung mit dem privaten Endpunkt.

PrivateEndpointProperty

Name	Typ	Beschreibung
id	string	Ressourcen-ID des privaten Endpunkts.

PrivateEndpointProvisioningState

Status der Verbindung mit dem privaten Endpunkt.

Name	Typ	Beschreibung
Approving	string
Dropping	string
Failed	string
Ready	string
Rejecting	string

PrivateLinkServiceConnectionStateActionsRequire

Die für die Private Link-Dienstverbindung erforderlichen Aktionen.

Name	Typ	Beschreibung
None	string

PrivateLinkServiceConnectionStateProperty

Name	Typ	Beschreibung
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	Die für die Private Link-Dienstverbindung erforderlichen Aktionen.
description	string	Die Verbindungsbeschreibung des Private Link-Diensts.
status	PrivateLinkServiceConnectionStateStatus	Die Private Link-Dienstverbindung status.

PrivateLinkServiceConnectionStateStatus

Die Private Link-Dienstverbindung status.

Name	Typ	Beschreibung
Approved	string
Disconnected	string
Pending	string
Rejected	string

ResourceIdentity

Azure Active Directory-Identitätskonfiguration für eine Ressource.

Name	Typ	Beschreibung
principalId	string	Die Azure Active Directory-Prinzipal-ID.
tenantId	string	Die Azure Active Directory-Mandanten-ID.
type	IdentityType	Der Identitätstyp. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal für die Ressource zu erstellen und zuzuweisen.
userAssignedIdentities	<string,  UserIdentity>	Die Ressourcen-IDs der vom Benutzer zugewiesenen Identitäten, die verwendet werden sollen

Server

Ein Azure SQL-Datenbankserver.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
identity	ResourceIdentity	Die Azure Active Directory-Identität des Servers.
kind	string	Art von SQL Server. Dies sind Metadaten, die für die Azure-Portal-Benutzeroberfläche verwendet werden.
location	string	Ressourcenspeicherort
name	string	Name der Ressource.
properties.administratorLogin	string	Administratorbenutzername für den Server. Nach der Erstellung kann es nicht mehr geändert werden.
properties.administratorLoginPassword	string	Das Administratoranmeldekennwort (erforderlich für die Servererstellung).
properties.administrators	ServerExternalAdministrator	Der Azure Active Directory-Administrator des Servers.
properties.federatedClientId	string	Die Client-ID, die für das mandantenübergreifende CMK-Szenario verwendet wird
properties.fullyQualifiedDomainName	string	Der vollqualifizierte Domänenname des Servers.
properties.keyId	string	Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll.
properties.minimalTlsVersion	string	Minimale TLS-Version. Zulässige Werte: '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId	string	Die Ressourcen-ID einer benutzerseitig zugewiesenen Identität, die standardmäßig verwendet werden soll.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Liste der Privaten Endpunktverbindungen auf einem Server
properties.publicNetworkAccess	ServerNetworkAccessFlag	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 "Aktiviert" oder "Deaktiviert" sein.
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Gibt an, ob der ausgehende Netzwerkzugriff für diesen Server eingeschränkt werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss "Aktiviert" oder "Deaktiviert" sein.
properties.state	string	Der Status des Servers.
properties.version	string	Die Serverversion.
properties.workspaceFeature	ServerWorkspaceFeature	Gibt an, ob ein vorhandener Server einen Arbeitsbereich erstellt hat und ob er eine Verbindung vom Arbeitsbereich aus zulässt.
tags	object	Ressourcentags.
type	string	Der Ressourcentyp.

ServerExternalAdministrator

Eigenschaften eines Active Directory-Administrators.

Name	Typ	Beschreibung
administratorType	AdministratorType	Typ des Serveradministrators.
azureADOnlyAuthentication	boolean	Nur Azure Active Directory-Authentifizierung aktiviert.
login	string	Anmeldename des Serveradministrators.
principalType	PrincipalType	Prinzipaltyp des Serveradministrators.
sid	string	SID (Objekt-ID) des Serveradministrators.
tenantId	string	Mandanten-ID des Administrators.

ServerNetworkAccessFlag

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 "Aktiviert" oder "Deaktiviert" sein.

Name	Typ	Beschreibung
Disabled	string
Enabled	string

ServerPrivateEndpointConnection

Eine private Endpunktverbindung unter einem Server

Name	Typ	Beschreibung
id	string	Ressourcen-ID
properties	PrivateEndpointConnectionProperties	Verbindungseigenschaften für private Endpunkte

ServerWorkspaceFeature

Gibt an, ob ein vorhandener Server einen Arbeitsbereich erstellt hat und ob er eine Verbindung vom Arbeitsbereich aus zulässt.

Name	Typ	Beschreibung
Connected	string
Disconnected	string

UserIdentity

Azure Active Directory-Identitätskonfiguration für eine Ressource.

Name	Typ	Beschreibung
clientId	string	Die Azure Active Directory-Client-ID.
principalId	string	Die Azure Active Directory-Prinzipal-ID.