Servers - Create Or Update
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 |
---|---|---|---|---|
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 | Erforderlich | Typ | Beschreibung |
---|---|---|---|
location | True |
string |
Ressourcenspeicherort. |
identity |
Die Azure Active Directory-Identität des Servers. |
||
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. |
||
properties.federatedClientId |
string (uuid) |
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 (arm-id) |
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' 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. |
|
201 Created |
Der Server wurde erfolgreich erstellt. |
|
202 Accepted |
Angenommen |
|
Other Status Codes |
Fehlerantworten: ***
|
Beispiele
Create server
Beispielanforderung
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"
}
Beispiel für eine Antwort
{
"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"
}
}
}
]
}
}
{
"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"
}
}
}
]
}
}
Definitionen
Name | Beschreibung |
---|---|
Administrator |
Typ des Serveradministrators. |
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. |
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 Zugriff auf öffentliche Endpunkte für diesen Server zulässig ist. 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 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 |
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 |
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. |
|
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.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 (arm-id) |
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' 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 Zugriff auf öffentliche Endpunkte für diesen Server zulässig ist. 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 |
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. |