Freigeben über


Servers - Update

Aktualisiert einen Server.

PATCH 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 Typ Beschreibung
identity

ResourceIdentity

Serveridentität

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

Client-ID, die für mandantenübergreifendes 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, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein.

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Gibt an, ob der ausgehende Netzwerkzugriff für diesen Server eingeschränkt werden soll oder nicht. Der Wert ist optional, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein.

properties.version

string

Die Serverversion.

tags

object

Ressourcentags.

Antworten

Name Typ Beschreibung
200 OK

Server

Der Server wurde erfolgreich aktualisiert.

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 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 vom Ressourcenbetriebsautorisierer unverändert an, ohne Änderungen

  • 400 PrimaryIdentityMissingPermissionForKeyId: KeyId wird vom Benutzer während der Erstellung bereitgestellt, aber PrimaryUserAssignedIdentityId wird im API-Aufruf nicht 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: Azure Active Directory Only Authentication 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 Datenbankserver. 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 externer Administratoranmeldungsname.

  • 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 bitte 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 fortlaufende Anforderung für logische Server ist bereits in Bearbeitung. Versuchen Sie ihre Anforderung später erneut.

  • 409 ServerDisabled: Server ist deaktiviert.

  • 409 ConflictingServerOperation: Derzeit wird ein Vorgang für den Server ausgeführt.

  • 409 SubscriptionDisabled: Das Abonnement ist deaktiviert.

  • 409 ServerQuotaExceeded: Der Server kann einem Abonnement nicht 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: Der Vorgang ist timeout und wird automatisch zurückgesetzt. 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

Update a server

Beispielanforderung

PATCH 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",
    "publicNetworkAccess": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled"
  }
}

Beispiel für eine Antwort

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "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": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "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"
          }
        }
      }
    ]
  }
}

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

Zustand der Verbindung mit dem privaten Endpunkt.

PrivateLinkServiceConnectionStateActionsRequire

Die aktionen, die für die Private Link-Dienstverbindung erforderlich sind.

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, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein.

ServerPrivateEndpointConnection

Eine private Endpunktverbindung unter einem Server

ServerUpdate

Eine Updateanforderung für einen Azure SQL Datenbankserver.

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 privaten Endpunktverbindung.

provisioningState

PrivateEndpointProvisioningState

Zustand der Verbindung mit dem privaten Endpunkt.

PrivateEndpointProperty

Name Typ Beschreibung
id

string

Ressourcen-ID des privaten Endpunkts.

PrivateEndpointProvisioningState

Zustand der Verbindung mit dem privaten Endpunkt.

Name Typ Beschreibung
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

Die aktionen, die für die Private Link-Dienstverbindung erforderlich sind.

Name Typ Beschreibung
None

string

PrivateLinkServiceConnectionStateProperty

Name Typ Beschreibung
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

Die aktionen, die für die Private Link-Dienstverbindung erforderlich sind.

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-ID der zu verwendenden benutzerseitig zugewiesenen Identitäten

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

Client-ID, die für mandantenübergreifendes 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, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein.

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Gibt an, ob der ausgehende Netzwerkzugriff für diesen Server eingeschränkt werden soll oder nicht. Der Wert ist optional, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein.

properties.state

string

Der Zustand 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, muss aber bei Übergabe "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

ServerUpdate

Eine Updateanforderung für einen Azure SQL Datenbankserver.

Name Typ Beschreibung
identity

ResourceIdentity

Serveridentität

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

Client-ID, die für mandantenübergreifendes 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, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein.

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Gibt an, ob der ausgehende Netzwerkzugriff für diesen Server eingeschränkt werden soll oder nicht. Der Wert ist optional, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein.

properties.state

string

Der Zustand 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.

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.