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 |
|---|---|---|---|---|
|
configuration
|
path | True |
string minLength: 1maxLength: 256 pattern: ^[-\w\._]+$ |
Name der Konfiguration (auch als Serverparameter bezeichnet). |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
|
server
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)* |
Name des Servers |
|
subscription
|
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
|
|
| Other Status Codes |
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 |
|---|---|
|
Configuration |
Datentyp der Konfiguration (auch als Serverparameter bezeichnet). |
|
Configuration |
Konfiguration (auch als Serverparameter bezeichnet). |
|
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
|
Error |
Das Fehlerdetails. |
|
Error |
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 |
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 |
Die zusätzlichen Informationen des Fehlers. |
|
| code |
string |
Der Fehlercode. |
| details |
Die Fehlerdetails. |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Das Fehlerobjekt. |