Servers - Update
Aktualisiert einen vorhandenen Server. Der Anforderungstext kann eine bis viele der Eigenschaften enthalten, die in der normalen Serverdefinition vorhanden sind.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/servers/{serverName}?api-version=2017-12-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
server
|
path | True |
string |
Der Name des Servers. |
subscription
|
path | True |
string minLength: 1 |
Die ID des Zielabonnements. |
api-version
|
query | True |
string minLength: 1 |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
Anforderungstext
Name | Typ | Beschreibung |
---|---|---|
identity |
Die Azure Active Directory-Identität des Servers. |
|
properties.administratorLoginPassword |
string (password) |
Das Kennwort der Administratoranmeldung. |
properties.minimalTlsVersion |
Erzwingen Sie eine minimale Tls-Version für den Server. |
|
properties.publicNetworkAccess |
Gibt an, ob der Zugriff auf öffentliche Netzwerke für diesen Server zulässig ist. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein. |
|
properties.replicationRole |
string |
Die Replikationsrolle des Servers. |
properties.sslEnforcement |
Aktivieren Sie ssl-Erzwingung, oder nicht, wenn Sie eine Verbindung mit dem Server herstellen. |
|
properties.storageProfile |
Speicherprofil eines Servers. |
|
properties.version |
Die Version eines Servers. |
|
sku |
Die SKU (Preisebene) des Servers. |
|
tags |
object |
Anwendungsspezifische Metadaten in Form von Schlüsselwertpaaren. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OKAY |
|
202 Accepted |
Angenommen |
|
Other Status Codes |
Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Fluss
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
ServerUpdate
Beispielanforderung
PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/servers/pgtestsvc4?api-version=2017-12-01
{
"properties": {
"administratorLoginPassword": "<administratorLoginPassword>",
"sslEnforcement": "Enabled",
"minimalTlsVersion": "TLS1_2"
}
}
Beispiel für eine Antwort
{
"sku": {
"name": "B_Gen4_2",
"tier": "Basic",
"family": "Gen4",
"capacity": 2
},
"properties": {
"administratorLogin": "cloudsa",
"storageProfile": {
"storageMB": 128000,
"backupRetentionDays": 7,
"geoRedundantBackup": "Disabled"
},
"version": "9.6",
"sslEnforcement": "Enabled",
"minimalTlsVersion": "TLS1_2",
"userVisibleState": "Ready",
"fullyQualifiedDomainName": "pgtestsvc4.postgres.database.azure.com",
"earliestRestoreDate": "2018-03-14T21:08:24.637+00:00"
},
"location": "westus",
"tags": {
"ElasticServer": "1"
},
"id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/servers/pgtestsvc4",
"name": "pgtestsvc4",
"type": "Microsoft.DBforPostgreSQL/servers"
}
Definitionen
Name | Beschreibung |
---|---|
Cloud |
Eine Fehlerantwort des Batchdiensts. |
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
Error |
Fehlerantwort |
Geo |
Aktivieren Sie georedundant oder nicht für die Serversicherung. |
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. |
Infrastructure |
Fügen Sie eine zweite Verschlüsselungsebene für Ihre Daten hinzu, indem Sie einen neuen Verschlüsselungsalgorithmus verwenden, der zusätzlichen Datenschutz bietet. Der Wert ist optional, aber wenn er übergeben wird, muss 'Disabled' oder 'Enabled' sein. |
Minimal |
Erzwingen Sie eine minimale Tls-Version für den Server. |
Private |
|
Private |
Status der privaten Endpunktverbindung. |
Private |
Die aktionen, die für die Verbindung mit privatem Linkdienst erforderlich sind. |
Private |
Der Verbindungsstatus des privaten Verknüpfungsdiensts. |
Public |
Gibt an, ob der Zugriff auf öffentliche Netzwerke für diesen Server zulässig ist. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein. |
Resource |
Azure Active Directory-Identitätskonfiguration für eine Ressource. |
Server |
Stellt einen Server dar. |
Server |
Eine private Endpunktverbindung unter einem Server |
Server |
Eigenschaften einer privaten Endpunktverbindung. |
Server |
|
Server |
Ein Status eines Servers, der für den Benutzer sichtbar ist. |
Server |
Parameter, die für einen Server aktualisiert werden dürfen. |
Server |
Die Version eines Servers. |
Sku |
Abrechnungsinformationen im Zusammenhang mit Eigenschaften eines Servers. |
Sku |
Die Ebene der jeweiligen SKU, z. B. "Einfach". |
Ssl |
Aktivieren Sie ssl-Erzwingung, oder nicht, wenn Sie eine Verbindung mit dem Server herstellen. |
Storage |
Aktivieren Sie die automatische Speichervergrößerung. |
Storage |
Speicherprofileigenschaften eines Servers |
CloudError
Eine Fehlerantwort des Batchdiensts.
Name | Typ | Beschreibung |
---|---|---|
error |
Fehlerantwort |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Die zusätzlichen Informationen. |
type |
string |
Der zusätzliche Informationstyp. |
ErrorResponse
Fehlerantwort
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. |
GeoRedundantBackup
Aktivieren Sie georedundant oder nicht für die Serversicherung.
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 |
---|---|
SystemAssigned |
InfrastructureEncryption
Fügen Sie eine zweite Verschlüsselungsebene für Ihre Daten hinzu, indem Sie einen neuen Verschlüsselungsalgorithmus verwenden, der zusätzlichen Datenschutz bietet. Der Wert ist optional, aber wenn er übergeben wird, muss 'Disabled' oder 'Enabled' sein.
Wert | Beschreibung |
---|---|
Disabled |
Zusätzliche (2.) Verschlüsselungsebene für ruhende Daten |
Enabled |
Standardwert für einzelne Verschlüsselungsebenen für ruhende Daten. |
MinimalTlsVersionEnum
Erzwingen Sie eine minimale Tls-Version für den Server.
Wert | Beschreibung |
---|---|
TLS1_0 | |
TLS1_1 | |
TLS1_2 | |
TLSEnforcementDisabled |
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 |
PrivateLinkServiceConnectionStateStatus
Der Verbindungsstatus des privaten Verknüpfungsdiensts.
Wert | Beschreibung |
---|---|
Approved | |
Disconnected | |
Pending | |
Rejected |
PublicNetworkAccessEnum
Gibt an, ob der Zugriff auf öffentliche Netzwerke 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 |
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. |
Server
Stellt einen Server dar.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
identity |
Die Azure Active Directory-Identität des Servers. |
|
location |
string |
Der geografische Standort, an dem sich die Ressource befindet |
name |
string |
Der Name der Ressource |
properties.administratorLogin |
string |
Der Anmeldename des Administrators eines Servers. Kann nur angegeben werden, wenn der Server erstellt wird (und für die Erstellung erforderlich ist). |
properties.byokEnforcement |
string |
Status, der anzeigt, ob die Serverdatenverschlüsselung mit vom Kunden verwalteten Schlüsseln aktiviert ist. |
properties.earliestRestoreDate |
string (date-time) |
Früheste Zeit für die Erstellung von Wiederherstellungspunkten (ISO8601 Format) |
properties.fullyQualifiedDomainName |
string |
Der vollqualifizierte Domänenname eines Servers. |
properties.infrastructureEncryption |
Status, der anzeigt, ob die Serverinfrastrukturverschlüsselung aktiviert ist. |
|
properties.masterServerId |
string |
Die Masterserver-ID eines Replikatservers. |
properties.minimalTlsVersion |
Erzwingen Sie eine minimale Tls-Version für den Server. |
|
properties.privateEndpointConnections |
Liste der privaten Endpunktverbindungen auf einem Server |
|
properties.publicNetworkAccess |
Gibt an, ob der Zugriff auf öffentliche Netzwerke für diesen Server zulässig ist. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein. |
|
properties.replicaCapacity |
integer (int32) minimum: 0 |
Die maximale Anzahl von Replikaten, die ein Masterserver aufweisen kann. |
properties.replicationRole |
string |
Die Replikationsrolle des Servers. |
properties.sslEnforcement |
Aktivieren Sie ssl-Erzwingung, oder nicht, wenn Sie eine Verbindung mit dem Server herstellen. |
|
properties.storageProfile |
Speicherprofil eines Servers. |
|
properties.userVisibleState |
Ein Status eines Servers, der für den Benutzer sichtbar ist. |
|
properties.version |
Serverversion. |
|
sku |
Die SKU (Preisebene) des Servers. |
|
tags |
object |
Ressourcentags. |
type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
ServerPrivateEndpointConnection
Eine private Endpunktverbindung unter einem Server
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID der privaten Endpunktverbindung. |
properties |
Eigenschaften der privaten Endpunktverbindung |
ServerPrivateEndpointConnectionProperties
Eigenschaften einer privaten Endpunktverbindung.
Name | Typ | Beschreibung |
---|---|---|
privateEndpoint |
Privater Endpunkt, zu dem die Verbindung gehört. |
|
privateLinkServiceConnectionState |
Verbindungsstatus der privaten Endpunktverbindung. |
|
provisioningState |
Status der privaten Endpunktverbindung. |
ServerPrivateLinkServiceConnectionStateProperty
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. |
ServerState
Ein Status eines Servers, der für den Benutzer sichtbar ist.
Wert | Beschreibung |
---|---|
Disabled | |
Dropping | |
Inaccessible | |
Ready |
ServerUpdateParameters
Parameter, die für einen Server aktualisiert werden dürfen.
Name | Typ | Beschreibung |
---|---|---|
identity |
Die Azure Active Directory-Identität des Servers. |
|
properties.administratorLoginPassword |
string (password) |
Das Kennwort der Administratoranmeldung. |
properties.minimalTlsVersion |
Erzwingen Sie eine minimale Tls-Version für den Server. |
|
properties.publicNetworkAccess |
Gibt an, ob der Zugriff auf öffentliche Netzwerke für diesen Server zulässig ist. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein. |
|
properties.replicationRole |
string |
Die Replikationsrolle des Servers. |
properties.sslEnforcement |
Aktivieren Sie ssl-Erzwingung, oder nicht, wenn Sie eine Verbindung mit dem Server herstellen. |
|
properties.storageProfile |
Speicherprofil eines Servers. |
|
properties.version |
Die Version eines Servers. |
|
sku |
Die SKU (Preisebene) des Servers. |
|
tags |
object |
Anwendungsspezifische Metadaten in Form von Schlüsselwertpaaren. |
ServerVersion
Die Version eines Servers.
Wert | Beschreibung |
---|---|
10 | |
10.0 | |
10.2 | |
11 | |
9.5 | |
9.6 |
Sku
Abrechnungsinformationen im Zusammenhang mit Eigenschaften eines Servers.
Name | Typ | Beschreibung |
---|---|---|
capacity |
integer (int32) minimum: 0 |
Die Skalierungskapazität, die die Computeeinheiten des Servers darstellt. |
family |
string |
Die Hardwarefamilie. |
name |
string |
Der Name der Sku, in der Regel tier + family + cores, z. B. B_Gen4_1, GP_Gen5_8. |
size |
string |
Der Größencode, der von der Ressource entsprechend interpretiert werden soll. |
tier |
Die Ebene der jeweiligen SKU, z. B. "Einfach". |
SkuTier
Die Ebene der jeweiligen SKU, z. B. "Einfach".
Wert | Beschreibung |
---|---|
Basic | |
GeneralPurpose | |
MemoryOptimized |
SslEnforcementEnum
Aktivieren Sie ssl-Erzwingung, oder nicht, wenn Sie eine Verbindung mit dem Server herstellen.
Wert | Beschreibung |
---|---|
Disabled | |
Enabled |
StorageAutogrow
Aktivieren Sie die automatische Speichervergrößerung.
Wert | Beschreibung |
---|---|
Disabled | |
Enabled |
StorageProfile
Speicherprofileigenschaften eines Servers
Name | Typ | Beschreibung |
---|---|---|
backupRetentionDays |
integer (int32) |
Sicherungsaufbewahrungstage für den Server. |
geoRedundantBackup |
Aktivieren Sie georedundant oder nicht für die Serversicherung. |
|
storageAutogrow |
Aktivieren Sie die automatische Speichervergrößerung. |
|
storageMB |
integer (int32) |
Maximal zulässiger Speicher für einen Server. |