Servers - Update
Aktualisiert einen Server.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2023-08-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
resource
|
path | True |
string |
Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen. |
server
|
path | True |
string |
Der Name des Servers. |
subscription
|
path | True |
string |
Die Abonnement-ID, die ein Azure-Abonnement identifiziert. |
api-version
|
query | True |
string |
Die API-Version, die für die Anforderung verwendet werden soll. |
Anforderungstext
Name | Typ | Beschreibung |
---|---|---|
identity |
Serveridentität |
|
properties.administratorLogin |
string |
Administratorbenutzername für den Server. Nach der Erstellung kann sie nicht mehr geändert werden. |
properties.administratorLoginPassword |
string |
Das Administratoranmeldungskennwort (erforderlich für die Servererstellung). |
properties.administrators |
Der Azure Active Directory-Administrator des Servers. Dies kann nur zum Zeitpunkt der Servererstellung verwendet werden. Wenn sie für die Serveraktualisierung verwendet wird, wird sie ignoriert, oder sie führt zu einem Fehler. Für Updates müssen einzelne APIs verwendet werden. |
|
properties.federatedClientId |
string (uuid) |
Die Client-ID, die für das mandantenübergreifende CMK-Szenario verwendet wird |
properties.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. |
|
properties.keyId |
string |
Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll. |
properties.minimalTlsVersion |
Minimale TLS-Version. Zulässige Werte: 'None', 1.0', '1.1', '1.2', '1.3' |
|
properties.primaryUserAssignedIdentityId |
string |
Die Ressourcen-ID einer vom Benutzer zugewiesenen Identität, die standardmäßig verwendet werden soll. |
properties.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. |
|
properties.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. |
|
properties.version |
string |
Die Version des Servers. |
tags |
object |
Ressourcentags. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Der Server wurde erfolgreich aktualisiert. |
|
202 Accepted |
Angenommen Header Location: string |
|
Other Status Codes |
Fehlerantworten: ***
|
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=2023-08-01
{
"properties": {
"administratorLogin": "dummylogin",
"administratorLoginPassword": "placeholder",
"publicNetworkAccess": "Disabled",
"restrictOutboundNetworkAccess": "Enabled",
"isIPv6Enabled": "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",
"isIPv6Enabled": "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"
}
}
}
]
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/serverOperationResults/00000000-0000-0000-0000-000000000000?api-version=2023-05-01
Definitionen
Name | Beschreibung |
---|---|
Administrator |
Typ des Serveradministrators. |
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
Error |
Das Fehlerdetails. |
Error |
Fehlerantwort |
External |
Status der externen Governance. |
Identity |
Der Identitätstyp. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal für die Ressource zu erstellen und zuzuweisen. |
Minimal |
Minimale TLS-Version. Zulässige Werte: 'None', 1.0', '1.1', '1.2', '1.3' |
Principal |
Prinzipaltyp des Serveradministrators. |
Private |
Eigenschaften einer privaten Endpunktverbindung. |
Private |
|
Private |
Status der privaten Endpunktverbindung. |
Private |
Die aktionen, die für die Verbindung mit privatem Linkdienst erforderlich sind. |
Private |
|
Private |
Der Verbindungsstatus des privaten Verknüpfungsdiensts. |
Resource |
Azure Active Directory-Identitätskonfiguration für eine Ressource. |
Server |
Ein Azure SQL-Datenbankserver. |
Server |
Eigenschaften eines Active Directory-Administrators. |
Server |
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. |
Server |
Eine private Endpunktverbindung unter einem Server |
Server |
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. |
Server |
Eine Aktualisierungsanforderung für einen Azure SQL-Datenbankserver. |
Server |
Gibt an, ob ein vorhandener Server einen Arbeitsbereich erstellt hat und ob die Verbindung vom Arbeitsbereich aus zulässig ist. |
User |
Azure Active Directory-Identitätskonfiguration für eine Ressource. |
AdministratorType
Typ des Serveradministrators.
Wert | Beschreibung |
---|---|
ActiveDirectory |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Die zusätzlichen Informationen. |
type |
string |
Der zusätzliche Informationstyp. |
ErrorDetail
Das Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Informationen des Fehlers. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
ExternalGovernanceStatus
Status der externen Governance.
Wert | Beschreibung |
---|---|
Disabled | |
Enabled |
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.
Wert | Beschreibung |
---|---|
None | |
SystemAssigned | |
SystemAssigned,UserAssigned | |
UserAssigned |
MinimalTlsVersion
Minimale TLS-Version. Zulässige Werte: 'None', 1.0', '1.1', '1.2', '1.3'
Wert | Beschreibung |
---|---|
1.0 | |
1.1 | |
1.2 | |
1.3 | |
None |
PrincipalType
Prinzipaltyp des Serveradministrators.
Wert | Beschreibung |
---|---|
Application | |
Group | |
User |
PrivateEndpointConnectionProperties
Eigenschaften einer privaten Endpunktverbindung.
Name | Typ | Beschreibung |
---|---|---|
groupIds |
string[] |
Gruppen-IDs. |
privateEndpoint |
Privater Endpunkt, zu dem die Verbindung gehört. |
|
privateLinkServiceConnectionState |
Verbindungsstatus der privaten Endpunktverbindung. |
|
provisioningState |
Status der privaten Endpunktverbindung. |
PrivateEndpointProperty
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID des privaten Endpunkts. |
PrivateEndpointProvisioningState
Status der privaten Endpunktverbindung.
Wert | Beschreibung |
---|---|
Approving | |
Dropping | |
Failed | |
Ready | |
Rejecting |
PrivateLinkServiceConnectionStateActionsRequire
Die aktionen, die für die Verbindung mit privatem Linkdienst erforderlich sind.
Wert | Beschreibung |
---|---|
None |
PrivateLinkServiceConnectionStateProperty
Name | Typ | Beschreibung |
---|---|---|
actionsRequired |
Die aktionen, die für die Verbindung mit privatem Linkdienst erforderlich sind. |
|
description |
string |
Die Verbindungsbeschreibung des privaten Linksdiensts. |
status |
Der Verbindungsstatus des privaten Verknüpfungsdiensts. |
PrivateLinkServiceConnectionStateStatus
Der Verbindungsstatus des privaten Verknüpfungsdiensts.
Wert | Beschreibung |
---|---|
Approved | |
Disconnected | |
Pending | |
Rejected |
ResourceIdentity
Azure Active Directory-Identitätskonfiguration für eine Ressource.
Name | Typ | Beschreibung |
---|---|---|
principalId |
string (uuid) |
Die Azure Active Directory-Prinzipal-ID. |
tenantId |
string (uuid) |
Die Azure Active Directory-Mandanten-ID. |
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. |
|
userAssignedIdentities |
<string,
User |
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 |
Die Azure Active Directory-Identität des Servers. |
|
kind |
string |
Art von SQL Server. Dies sind Metadaten, die für die Azure-Portaloberfläche verwendet werden. |
location |
string |
Ressourcenspeicherort. |
name |
string |
Ressourcenname. |
properties.administratorLogin |
string |
Administratorbenutzername für den Server. Nach der Erstellung kann sie nicht mehr geändert werden. |
properties.administratorLoginPassword |
string |
Das Administratoranmeldungskennwort (erforderlich für die Servererstellung). |
properties.administrators |
Der Azure Active Directory-Administrator des Servers. Dies kann nur zum Zeitpunkt der Servererstellung verwendet werden. Wenn sie für die Serveraktualisierung verwendet wird, wird sie ignoriert, oder sie führt zu einem Fehler. Für Updates müssen einzelne APIs verwendet werden. |
|
properties.externalGovernanceStatus |
Status der externen Governance. |
|
properties.federatedClientId |
string (uuid) |
Die Client-ID, die für das mandantenübergreifende CMK-Szenario verwendet wird |
properties.fullyQualifiedDomainName |
string |
Der vollqualifizierte Domänenname des Servers. |
properties.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. |
|
properties.keyId |
string |
Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll. |
properties.minimalTlsVersion |
Minimale TLS-Version. Zulässige Werte: 'None', 1.0', '1.1', '1.2', '1.3' |
|
properties.primaryUserAssignedIdentityId |
string |
Die Ressourcen-ID einer vom Benutzer zugewiesenen Identität, die standardmäßig verwendet werden soll. |
properties.privateEndpointConnections |
Liste der privaten Endpunktverbindungen auf einem Server |
|
properties.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. |
|
properties.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. |
|
properties.state |
string |
Der Status des Servers. |
properties.version |
string |
Die Version des Servers. |
properties.workspaceFeature |
Gibt an, ob ein vorhandener Server einen Arbeitsbereich erstellt hat und ob die Verbindung vom Arbeitsbereich aus zulässig ist. |
|
tags |
object |
Ressourcentags. |
type |
string |
Ressourcentyp. |
ServerExternalAdministrator
Eigenschaften eines Active Directory-Administrators.
Name | Typ | Beschreibung |
---|---|---|
administratorType |
Typ des Serveradministrators. |
|
azureADOnlyAuthentication |
boolean |
Nur Azure Active Directory-Authentifizierung aktiviert. |
login |
string |
Anmeldename des Serveradministrators. |
principalType |
Prinzipaltyp des Serveradministrators. |
|
sid |
string (uuid) |
SID (Objekt-ID) des Serveradministrators. |
tenantId |
string (uuid) |
Mandanten-ID des Administrators. |
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 'Enabled' oder 'Disabled' sein.
Wert | Beschreibung |
---|---|
Disabled | |
Enabled |
ServerPrivateEndpointConnection
Eine private Endpunktverbindung unter einem Server
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID. |
properties |
Eigenschaften der privaten Endpunktverbindung |
ServerPublicNetworkAccessFlag
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.
Wert | Beschreibung |
---|---|
Disabled | |
Enabled | |
SecuredByPerimeter |
ServerUpdate
Eine Aktualisierungsanforderung für einen Azure SQL-Datenbankserver.
Name | Typ | Beschreibung |
---|---|---|
identity |
Serveridentität |
|
properties.administratorLogin |
string |
Administratorbenutzername für den Server. Nach der Erstellung kann sie nicht mehr geändert werden. |
properties.administratorLoginPassword |
string |
Das Administratoranmeldungskennwort (erforderlich für die Servererstellung). |
properties.administrators |
Der Azure Active Directory-Administrator des Servers. Dies kann nur zum Zeitpunkt der Servererstellung verwendet werden. Wenn sie für die Serveraktualisierung verwendet wird, wird sie ignoriert, oder sie führt zu einem Fehler. Für Updates müssen einzelne APIs verwendet werden. |
|
properties.externalGovernanceStatus |
Status der externen Governance. |
|
properties.federatedClientId |
string (uuid) |
Die Client-ID, die für das mandantenübergreifende CMK-Szenario verwendet wird |
properties.fullyQualifiedDomainName |
string |
Der vollqualifizierte Domänenname des Servers. |
properties.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. |
|
properties.keyId |
string |
Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll. |
properties.minimalTlsVersion |
Minimale TLS-Version. Zulässige Werte: 'None', 1.0', '1.1', '1.2', '1.3' |
|
properties.primaryUserAssignedIdentityId |
string |
Die Ressourcen-ID einer vom Benutzer zugewiesenen Identität, die standardmäßig verwendet werden soll. |
properties.privateEndpointConnections |
Liste der privaten Endpunktverbindungen auf einem Server |
|
properties.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. |
|
properties.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. |
|
properties.state |
string |
Der Status des Servers. |
properties.version |
string |
Die Version des Servers. |
properties.workspaceFeature |
Gibt an, ob ein vorhandener Server einen Arbeitsbereich erstellt hat und ob die Verbindung vom Arbeitsbereich aus zulässig ist. |
|
tags |
object |
Ressourcentags. |
ServerWorkspaceFeature
Gibt an, ob ein vorhandener Server einen Arbeitsbereich erstellt hat und ob die Verbindung vom Arbeitsbereich aus zulässig ist.
Wert | Beschreibung |
---|---|
Connected | |
Disconnected |
UserIdentity
Azure Active Directory-Identitätskonfiguration für eine Ressource.
Name | Typ | Beschreibung |
---|---|---|
clientId |
string (uuid) |
Die Azure Active Directory-Client-ID. |
principalId |
string (uuid) |
Die Azure Active Directory-Prinzipal-ID. |