Freigeben über


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

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

serverName
path True

string

Der Name des Servers.

subscriptionId
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

ResourceIdentity

Die Azure Active Directory-Identität des Servers.

properties.administratorLoginPassword

string (password)

Das Kennwort der Administratoranmeldung.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Erzwingen Sie eine minimale Tls-Version 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 'Enabled' oder 'Disabled' sein.

properties.replicationRole

string

Die Replikationsrolle des Servers.

properties.sslEnforcement

SslEnforcementEnum

Aktivieren Sie 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 (Preisebene) des Servers.

tags

object

Anwendungsspezifische Metadaten in Form von Schlüsselwertpaaren.

Antworten

Name Typ Beschreibung
200 OK

Server

OKAY

202 Accepted

Angenommen

Other Status Codes

CloudError

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
CloudError

Eine Fehlerantwort des Batchdiensts.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

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' sein.

MinimalTlsVersionEnum

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

PrivateEndpointProperty
PrivateEndpointProvisioningState

Status der privaten Endpunktverbindung.

PrivateLinkServiceConnectionStateActionsRequire

Die aktionen, die für die Verbindung mit privatem Linkdienst erforderlich sind.

PrivateLinkServiceConnectionStateStatus

Der Verbindungsstatus des privaten Verknüpfungsdiensts.

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.

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 Status 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 im Zusammenhang mit Eigenschaften eines Servers.

SkuTier

Die Ebene der jeweiligen SKU, z. B. "Einfach".

SslEnforcementEnum

Aktivieren Sie 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 Batchdiensts.

Name Typ Beschreibung
error

ErrorResponse

Fehlerantwort
Häufige Fehlerantwort für alle Azure Resource Manager-APIs, um Fehlerdetails für fehlgeschlagene Vorgänge zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)

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

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

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.

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

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. Ex - /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 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

InfrastructureEncryption

Status, der anzeigt, ob die Serverinfrastrukturverschlüsselung aktiviert ist.

properties.masterServerId

string

Die Masterserver-ID eines Replikatservers.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Erzwingen Sie eine minimale Tls-Version 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 '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

SslEnforcementEnum

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

properties.storageProfile

StorageProfile

Speicherprofil eines Servers.

properties.userVisibleState

ServerState

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

properties.version

ServerVersion

Serverversion.

sku

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

ServerPrivateEndpointConnectionProperties

Eigenschaften der privaten Endpunktverbindung

ServerPrivateEndpointConnectionProperties

Eigenschaften einer privaten Endpunktverbindung.

Name Typ Beschreibung
privateEndpoint

PrivateEndpointProperty

Privater Endpunkt, zu dem die Verbindung gehört.

privateLinkServiceConnectionState

ServerPrivateLinkServiceConnectionStateProperty

Verbindungsstatus der privaten Endpunktverbindung.

provisioningState

PrivateEndpointProvisioningState

Status der privaten Endpunktverbindung.

ServerPrivateLinkServiceConnectionStateProperty

Name Typ Beschreibung
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

Die aktionen, die für die Verbindung mit privatem Linkdienst erforderlich sind.

description

string

Die Verbindungsbeschreibung des privaten Linksdiensts.

status

PrivateLinkServiceConnectionStateStatus

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

ResourceIdentity

Die Azure Active Directory-Identität des Servers.

properties.administratorLoginPassword

string (password)

Das Kennwort der Administratoranmeldung.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Erzwingen Sie eine minimale Tls-Version 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 'Enabled' oder 'Disabled' sein.

properties.replicationRole

string

Die Replikationsrolle des Servers.

properties.sslEnforcement

SslEnforcementEnum

Aktivieren Sie 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 (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

SkuTier

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

GeoRedundantBackup

Aktivieren Sie georedundant oder nicht für die Serversicherung.

storageAutogrow

StorageAutogrow

Aktivieren Sie die automatische Speichervergrößerung.

storageMB

integer (int32)

Maximal zulässiger Speicher für einen Server.