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 |
Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. |
server
|
path | True |
string |
Name des Servers |
subscription
|
path | True |
string |
Hierbei handelt es sich um die ID des Zielabonnements. |
api-version
|
query | True |
string |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
Anforderungstext
Name | Typ | Beschreibung |
---|---|---|
identity |
Die Azure Active Directory-Identität des Servers. |
|
properties.administratorLoginPassword |
string |
Das Kennwort der Administratoranmeldung. |
properties.minimalTlsVersion |
Erzwingen Sie eine minimale Tls-Version für den Server. |
|
properties.publicNetworkAccess |
Gibt an, ob der Öffentliche Netzwerkzugriff für diesen Server zulässig ist oder nicht. Der Wert ist optional, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein. |
|
properties.replicationRole |
string |
Die Replikationsrolle des Servers. |
properties.sslEnforcement |
Aktivieren Sie die 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 (Tarif) des Servers. |
|
tags |
object |
Anwendungsspezifische Metadaten in Form von Schlüssel-Wert-Paaren. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK |
|
202 Accepted |
Akzeptiert |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory-OAuth2-Flow
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 Batch-Diensts. |
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
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" (Aktiviert) sein. |
Minimal |
Erzwingen Sie eine tls-Mindestversion für den Server. |
Private |
|
Private |
Status der Verbindung mit dem privaten Endpunkt. |
Private |
Die für die Private Link-Dienstverbindung erforderlichen Aktionen. |
Private |
Die Private Link-Dienstverbindung status. |
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 "Aktiviert" oder "Deaktiviert" 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 Zustand 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 bezogene Eigenschaften eines Servers. |
Sku |
Die Ebene der jeweiligen SKU, z. B. Basic. |
Ssl |
Aktivieren Sie die 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 Batch-Diensts.
Name | Typ | Beschreibung |
---|---|---|
error |
Fehlerantwort |
ErrorAdditionalInfo
Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Zusätzliche Informationen. |
type |
string |
Typ der zusätzlichen Informationen. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Fehlerinformationen. |
|
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.
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
|
Enabled |
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 |
---|---|---|
SystemAssigned |
string |
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" (Aktiviert) sein.
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
Zusätzliche (2.) Verschlüsselungsebene für ruhende Daten |
Enabled |
string |
Standardwert für einzelne Verschlüsselungsebene für ruhende Daten. |
MinimalTlsVersionEnum
Erzwingen Sie eine tls-Mindestversion für den Server.
Name | Typ | Beschreibung |
---|---|---|
TLS1_0 |
string |
|
TLS1_1 |
string |
|
TLS1_2 |
string |
|
TLSEnforcementDisabled |
string |
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 |
PrivateLinkServiceConnectionStateStatus
Die Private Link-Dienstverbindung status.
Name | Typ | Beschreibung |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
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 "Aktiviert" oder "Deaktiviert" sein.
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
|
Enabled |
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 |
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. Beispiel: /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 kundenseitig verwalteten Schlüsseln aktiviert ist. |
properties.earliestRestoreDate |
string |
Erstellungszeit des frühesten Wiederherstellungspunkts (ISO8601 Format) |
properties.fullyQualifiedDomainName |
string |
Der vollqualifizierte Domänenname eines Servers. |
properties.infrastructureEncryption |
Status zeigt an, ob der Server die Infrastrukturverschlüsselung aktiviert hat. |
|
properties.masterServerId |
string |
Die master Server-ID eines Replikatservers. |
properties.minimalTlsVersion |
Erzwingen Sie eine tls-Mindestversion 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 "Aktiviert" oder "Deaktiviert" sein. |
|
properties.replicaCapacity |
integer |
Die maximale Anzahl von Replikaten, die ein master Server haben kann. |
properties.replicationRole |
string |
Die Replikationsrolle des Servers. |
properties.sslEnforcement |
Aktivieren Sie die SSL-Erzwingung oder nicht, wenn Sie eine Verbindung mit dem Server herstellen. |
|
properties.storageProfile |
Speicherprofil eines Servers. |
|
properties.userVisibleState |
Ein Zustand eines Servers, der für den Benutzer sichtbar ist. |
|
properties.version |
Serverversion. |
|
sku |
Die SKU (Tarif) 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 Verbindung mit dem privaten Endpunkt. |
properties |
Verbindungseigenschaften für private Endpunkte |
ServerPrivateEndpointConnectionProperties
Eigenschaften einer privaten Endpunktverbindung.
Name | Typ | Beschreibung |
---|---|---|
privateEndpoint |
Privater Endpunkt, zu dem die Verbindung gehört. |
|
privateLinkServiceConnectionState |
Verbindungsstatus der Verbindung mit dem privaten Endpunkt. |
|
provisioningState |
Status der Verbindung mit dem privaten Endpunkt. |
ServerPrivateLinkServiceConnectionStateProperty
Name | Typ | Beschreibung |
---|---|---|
actionsRequired |
Die für die Private Link-Dienstverbindung erforderlichen Aktionen. |
|
description |
string |
Die Verbindungsbeschreibung des Private Link-Diensts. |
status |
Die Private Link-Dienstverbindung status. |
ServerState
Ein Zustand eines Servers, der für den Benutzer sichtbar ist.
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
|
Dropping |
string |
|
Inaccessible |
string |
|
Ready |
string |
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 |
Das Kennwort der Administratoranmeldung. |
properties.minimalTlsVersion |
Erzwingen Sie eine tls-Mindestversion 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 "Aktiviert" oder "Deaktiviert" sein. |
|
properties.replicationRole |
string |
Die Replikationsrolle des Servers. |
properties.sslEnforcement |
Aktivieren Sie die 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 (Tarif) des Servers. |
|
tags |
object |
Anwendungsspezifische Metadaten in Form von Schlüssel-Wert-Paaren. |
ServerVersion
Die Version eines Servers.
Name | Typ | Beschreibung |
---|---|---|
10 |
string |
|
10.0 |
string |
|
10.2 |
string |
|
11 |
string |
|
9.5 |
string |
|
9.6 |
string |
Sku
Abrechnungsinformationen bezogene Eigenschaften eines Servers.
Name | Typ | Beschreibung |
---|---|---|
capacity |
integer |
Die Kapazität für hoch-/horizontales Hochskalieren, die die Computeeinheiten des Servers darstellt. |
family |
string |
Die Hardwarefamilie. |
name |
string |
Der Name der SKU, in der Regel Ebene + Familie + Kerne, z. B. B_Gen4_1, GP_Gen5_8. |
size |
string |
Der Größencode, der je nach Ressource interpretiert werden soll. |
tier |
Die Ebene der jeweiligen SKU, z. B. Basic. |
SkuTier
Die Ebene der jeweiligen SKU, z. B. Basic.
Name | Typ | Beschreibung |
---|---|---|
Basic |
string |
|
GeneralPurpose |
string |
|
MemoryOptimized |
string |
SslEnforcementEnum
Aktivieren Sie die SSL-Erzwingung oder nicht, wenn Sie eine Verbindung mit dem Server herstellen.
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
|
Enabled |
string |
StorageAutogrow
Aktivieren Sie die automatische Speichervergrößerung.
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
|
Enabled |
string |
StorageProfile
Speicherprofileigenschaften eines Servers
Name | Typ | Beschreibung |
---|---|---|
backupRetentionDays |
integer |
Sicherungsaufbewahrungstage für den Server. |
geoRedundantBackup |
Aktivieren Sie georedundant oder nicht für die Serversicherung. |
|
storageAutogrow |
Aktivieren Sie die automatische Speichervergrößerung. |
|
storageMB |
integer |
Maximal zulässiger Speicher für einen Server. |