Configurations - Update

Aggiorna il valore assegnato a una specifica configurazione modificabile (nota anche come parametro server) di un server.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
configurationName
path True

string

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

Nome della configurazione (noto anche come parametro del server).

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.

serverName
path True

string

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

Il nome del server.

subscriptionId
path True

string (uuid)

ID della sottoscrizione di destinazione. Il valore deve essere un UUID.

api-version
query True

string

minLength: 1

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome Tipo Descrizione
properties.source

string

Origine del valore assegnato alla configurazione (noto anche come parametro del server). Necessario per aggiornare il valore assegnato a una specifica configurazione modificabile.

properties.value

string

Valore della configurazione (noto anche come parametro del server). Necessario per aggiornare il valore assegnato a una specifica configurazione modificabile.

Risposte

Nome Tipo Descrizione
202 Accepted

Operazione di risorsa accettata.

Intestazioni

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

ErrorResponse

Risposta di errore imprevista.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

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

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
ConfigurationDataType

Tipo di dati della configurazione (noto anche come parametro del server).

ConfigurationForUpdate

Configurazione (nota anche come parametro del server).

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

ConfigurationDataType

Tipo di dati della configurazione (noto anche come parametro del server).

Valore Descrizione
Boolean

Un valore booleano.

Numeric

Valore numerico.

Integer

Valore intero.

Enumeration

Valore di enumerazione.

String

Valore stringa.

Set

Un insieme di valori.

ConfigurationForUpdate

Configurazione (nota anche come parametro del server).

Nome Tipo Descrizione
properties.allowedValues

string

Valori consentiti della configurazione (noto anche come parametro del server).

properties.dataType

ConfigurationDataType

Tipo di dati della configurazione (noto anche come parametro del server).

properties.defaultValue

string

Valore assegnato per impostazione predefinita alla configurazione (noto anche come parametro del server).

properties.description

string

Descrizione della configurazione (nota anche come parametro del server).

properties.documentationLink

string

Link che punta alla documentazione della configurazione (noto anche come parametro server).

properties.isConfigPendingRestart

boolean

Indica se il valore assegnato alla configurazione (noto anche come parametro server) è in attesa di un riavvio del server per renderlo effettivo.

properties.isDynamicConfig

boolean

Indica se si tratta di una configurazione dinamica (true) o statica (false) (nota anche come parametro server). I parametri statici del server richiedono un riavvio del server dopo aver modificato il valore loro assegnato, affinché la modifica abbia effetto. I parametri dinamici del server non richiedono il riavvio del server dopo la modifica del valore loro assegnato, affinché la modifica abbia effetto.

properties.isReadOnly

boolean

Indica se si tratta di una configurazione di sola lettura (true) o modificabile (false) (nota anche come parametro del server).

properties.source

string

Origine del valore assegnato alla configurazione (noto anche come parametro del server). Necessario per aggiornare il valore assegnato a una specifica configurazione modificabile.

properties.unit

string

Unità in cui viene espresso il valore di configurazione (noto anche come parametro del server).

properties.value

string

Valore della configurazione (noto anche come parametro del server). Necessario per aggiornare il valore assegnato a una specifica configurazione modificabile.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.