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
resourceGroupName
path True

string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

serverName
path True

string

Name des Servers

subscriptionId
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

ResourceIdentity

Die Azure Active Directory-Identität des Servers.

properties.administratorLoginPassword

string

Das Kennwort der Administratoranmeldung.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Erzwingen Sie eine minimale Tls-Version für den Server.

properties.publicNetworkAccess

PublicNetworkAccessEnum

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

SslEnforcementEnum

Aktivieren Sie die SSL-Erzwingung oder nicht, wenn Sie eine Verbindung mit dem Server herstellen.

properties.storageProfile

StorageProfile

Speicherprofil eines Servers.

properties.version

ServerVersion

Die Version eines Servers.

sku

Sku

Die SKU (Tarif) des Servers.

tags

object

Anwendungsspezifische Metadaten in Form von Schlüssel-Wert-Paaren.

Antworten

Name Typ Beschreibung
200 OK

Server

OK

202 Accepted

Akzeptiert

Other Status Codes

CloudError

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

ServerUpdate

Sample Request

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"
  }
}

Sample Response

{
  "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
CloudError

Eine Fehlerantwort des Batch-Diensts.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorResponse

Fehlerantwort

GeoRedundantBackup

Aktivieren Sie georedundant oder nicht für die Serversicherung.

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.

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.

MinimalTlsVersionEnum

Erzwingen Sie eine tls-Mindestversion für den Server.

PrivateEndpointProperty
PrivateEndpointProvisioningState

Status der Verbindung mit dem privaten Endpunkt.

PrivateLinkServiceConnectionStateActionsRequire

Die für die Private Link-Dienstverbindung erforderlichen Aktionen.

PrivateLinkServiceConnectionStateStatus

Die Private Link-Dienstverbindung status.

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.

ResourceIdentity

Azure Active Directory-Identitätskonfiguration für eine Ressource.

Server

Stellt einen Server dar.

ServerPrivateEndpointConnection

Eine private Endpunktverbindung unter einem Server

ServerPrivateEndpointConnectionProperties

Eigenschaften einer privaten Endpunktverbindung.

ServerPrivateLinkServiceConnectionStateProperty
ServerState

Ein Zustand eines Servers, der für den Benutzer sichtbar ist.

ServerUpdateParameters

Parameter, die für einen Server aktualisiert werden dürfen.

ServerVersion

Die Version eines Servers.

Sku

Abrechnungsinformationen bezogene Eigenschaften eines Servers.

SkuTier

Die Ebene der jeweiligen SKU, z. B. Basic.

SslEnforcementEnum

Aktivieren Sie die SSL-Erzwingung oder nicht, wenn Sie eine Verbindung mit dem Server herstellen.

StorageAutogrow

Aktivieren Sie die automatische Speichervergrößerung.

StorageProfile

Speicherprofileigenschaften eines Servers

CloudError

Eine Fehlerantwort des Batch-Diensts.

Name Typ Beschreibung
error

ErrorResponse

Fehlerantwort
Allgemeine Fehlerantwort für alle Azure Resource Manager-APIs, zur Rückgabe von Fehlerdetails für fehlgeschlagene Vorgänge. (Dies folgt auch dem OData-Fehlerantwortformat.)

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

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorResponse[]

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

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.

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

ResourceIdentity

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

InfrastructureEncryption

Status zeigt an, ob der Server die Infrastrukturverschlüsselung aktiviert hat.

properties.masterServerId

string

Die master Server-ID eines Replikatservers.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Erzwingen Sie eine tls-Mindestversion für den Server.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Liste der Privaten Endpunktverbindungen auf einem Server

properties.publicNetworkAccess

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.

properties.replicaCapacity

integer

Die maximale Anzahl von Replikaten, die ein master Server haben kann.

properties.replicationRole

string

Die Replikationsrolle des Servers.

properties.sslEnforcement

SslEnforcementEnum

Aktivieren Sie die SSL-Erzwingung oder nicht, wenn Sie eine Verbindung mit dem Server herstellen.

properties.storageProfile

StorageProfile

Speicherprofil eines Servers.

properties.userVisibleState

ServerState

Ein Zustand eines Servers, der für den Benutzer sichtbar ist.

properties.version

ServerVersion

Serverversion.

sku

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

ServerPrivateEndpointConnectionProperties

Verbindungseigenschaften für private Endpunkte

ServerPrivateEndpointConnectionProperties

Eigenschaften einer privaten Endpunktverbindung.

Name Typ Beschreibung
privateEndpoint

PrivateEndpointProperty

Privater Endpunkt, zu dem die Verbindung gehört.

privateLinkServiceConnectionState

ServerPrivateLinkServiceConnectionStateProperty

Verbindungsstatus der Verbindung mit dem privaten Endpunkt.

provisioningState

PrivateEndpointProvisioningState

Status der Verbindung mit dem privaten Endpunkt.

ServerPrivateLinkServiceConnectionStateProperty

Name Typ Beschreibung
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

Die für die Private Link-Dienstverbindung erforderlichen Aktionen.

description

string

Die Verbindungsbeschreibung des Private Link-Diensts.

status

PrivateLinkServiceConnectionStateStatus

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

ResourceIdentity

Die Azure Active Directory-Identität des Servers.

properties.administratorLoginPassword

string

Das Kennwort der Administratoranmeldung.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Erzwingen Sie eine tls-Mindestversion für den Server.

properties.publicNetworkAccess

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.

properties.replicationRole

string

Die Replikationsrolle des Servers.

properties.sslEnforcement

SslEnforcementEnum

Aktivieren Sie die SSL-Erzwingung oder nicht, wenn Sie eine Verbindung mit dem Server herstellen.

properties.storageProfile

StorageProfile

Speicherprofil eines Servers.

properties.version

ServerVersion

Die Version eines Servers.

sku

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

SkuTier

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

GeoRedundantBackup

Aktivieren Sie georedundant oder nicht für die Serversicherung.

storageAutogrow

StorageAutogrow

Aktivieren Sie die automatische Speichervergrößerung.

storageMB

integer

Maximal zulässiger Speicher für einen Server.