Freigeben über


Configurations - Put

Aktualisiert mit dem Put-Verb den Wert, der einer bestimmten änderbaren Konfiguration (auch als Serverparameter bezeichnet) eines Servers zugewiesen ist.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}/configurations/{configurationName}?api-version=2025-08-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
configurationName
path True

string

minLength: 1
maxLength: 256
pattern: ^[-\w\._]+$

Name der Konfiguration (auch als Serverparameter bezeichnet).

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

minLength: 3
maxLength: 63
pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*

Name des Servers

subscriptionId
path True

string (uuid)

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Typ Beschreibung
properties.source

string

Quelle des Werts, der der Konfiguration zugewiesen ist (auch als Serverparameter bezeichnet). Erforderlich, um den Wert zu aktualisieren, der einer bestimmten änderbaren Konfiguration zugewiesen ist.

properties.value

string

Wert der Konfiguration (auch als Serverparameter bezeichnet). Erforderlich, um den Wert zu aktualisieren, der einer bestimmten änderbaren Konfiguration zugewiesen ist.

Antworten

Name Typ Beschreibung
202 Accepted

Ressourcenvorgang akzeptiert.

Header

  • Azure-AsyncOperation: string
  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

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

Update, using Put verb, the value assigned to a specific modifiable configuration (also known as server parameter) of a server.

Beispielanforderung

PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver/configurations/constraint_exclusion?api-version=2025-08-01

{
  "properties": {
    "source": "user-override",
    "value": "on"
  }
}

Beispiel für eine Antwort

Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/azureAsyncOperation/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa?api-version=2025-06-01-preview
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/operationResults/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb?api-version=2025-06-01-preview

Definitionen

Name Beschreibung
ConfigurationDataType

Datentyp der Konfiguration (auch als Serverparameter bezeichnet).

ConfigurationForUpdate

Konfiguration (auch als Serverparameter bezeichnet).

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

ConfigurationDataType

Datentyp der Konfiguration (auch als Serverparameter bezeichnet).

Wert Beschreibung
Boolean
Numeric
Integer
Enumeration
String
Set

ConfigurationForUpdate

Konfiguration (auch als Serverparameter bezeichnet).

Name Typ Beschreibung
properties.allowedValues

string

Zulässige Werte der Konfiguration (auch als Serverparameter bezeichnet).

properties.dataType

ConfigurationDataType

Datentyp der Konfiguration (auch als Serverparameter bezeichnet).

properties.defaultValue

string

Der Konfiguration standardmäßig zugewiesener Wert (auch als Serverparameter bezeichnet).

properties.description

string

Beschreibung der Konfiguration (auch als Serverparameter bezeichnet).

properties.documentationLink

string

Link, der auf die Dokumentation der Konfiguration verweist (auch als Serverparameter bezeichnet).

properties.isConfigPendingRestart

boolean

Gibt an, ob der der Konfiguration zugewiesene Wert (auch als Serverparameter bezeichnet) auf einen Neustart des Servers wartet, damit er wirksam wird.

properties.isDynamicConfig

boolean

Gibt an, ob es sich um eine dynamische (true) oder statische (false) Konfiguration (auch als Serverparameter bezeichnet) handelt. Statische Serverparameter erfordern einen Neustart des Servers, nachdem der ihnen zugewiesene Wert geändert wurde, damit die Änderung wirksam wird. Dynamische Serverparameter erfordern keinen Neustart des Servers, nachdem der ihnen zugewiesene Wert geändert wurde, damit die Änderung wirksam wird.

properties.isReadOnly

boolean

Gibt an, ob es sich um eine schreibgeschützte (true) oder änderbare (false) Konfiguration (auch als Serverparameter bezeichnet) handelt.

properties.source

string

Quelle des Werts, der der Konfiguration zugewiesen ist (auch als Serverparameter bezeichnet). Erforderlich, um den Wert zu aktualisieren, der einer bestimmten änderbaren Konfiguration zugewiesen ist.

properties.unit

string

Units, in denen der Konfigurationswert (auch als Serverparameter bezeichnet) angegeben wird.

properties.value

string

Wert der Konfiguration (auch als Serverparameter bezeichnet). Erforderlich, um den Wert zu aktualisieren, der einer bestimmten änderbaren Konfiguration zugewiesen ist.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.