Udostępnij przez


Configurations - Put

Aktualizuje, przy użyciu czasownika Put, wartość przypisaną do określonej modyfikowalnej konfiguracji (nazywanej również parametrem serwera) serwera.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
configurationName
path True

string

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

Nazwa konfiguracji (nazywana również parametrem serwera).

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

serverName
path True

string

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

Nazwa serwera.

subscriptionId
path True

string (uuid)

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Typ Opis
properties.source

string

Źródło wartości przypisanej do konfiguracji (nazywanej również parametrem serwera). Wymagane do zaktualizowania wartości przypisanej do określonej konfiguracji modyfikowalnej.

properties.value

string

Wartość konfiguracji (nazywana również parametrem serwera). Wymagane do zaktualizowania wartości przypisanej do określonej konfiguracji modyfikowalnej.

Odpowiedzi

Nazwa Typ Opis
202 Accepted

Zaakceptowano operację zasobu.

Nagłówki

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

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresów

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

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

Przykładowe zapytanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
ConfigurationDataType

Typ danych konfiguracji (znany również jako parametr serwera).

ConfigurationForUpdate

Konfiguracja (nazywana również parametrem serwera).

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

ConfigurationDataType

Typ danych konfiguracji (znany również jako parametr serwera).

Wartość Opis
Boolean
Numeric
Integer
Enumeration
String
Set

ConfigurationForUpdate

Konfiguracja (nazywana również parametrem serwera).

Nazwa Typ Opis
properties.allowedValues

string

Dozwolone wartości konfiguracji (nazywane również parametrem serwera).

properties.dataType

ConfigurationDataType

Typ danych konfiguracji (znany również jako parametr serwera).

properties.defaultValue

string

Wartość domyślnie przypisana do konfiguracji (nazywana również parametrem serwera).

properties.description

string

Opis konfiguracji (znany również jako parametr serwera).

properties.documentationLink

string

Link wskazujący na dokumentację konfiguracji (znany również jako parametr serwera).

properties.isConfigPendingRestart

boolean

Wskazuje, czy wartość przypisana do konfiguracji (nazywana również parametrem serwera) oczekuje na ponowne uruchomienie serwera, aby została wprowadzona.

properties.isDynamicConfig

boolean

Wskazuje, czy jest to konfiguracja dynamiczna (true) czy statyczna (false) (znana również jako parametr serwera). Statyczne parametry serwera wymagają ponownego uruchomienia serwera po zmianie przypisanej do nich wartości, aby zmiana została wprowadzona. Dynamiczne parametry serwera nie wymagają ponownego uruchomienia serwera po zmianie przypisanej im wartości, aby zmiana odniosła skutek.

properties.isReadOnly

boolean

Wskazuje, czy jest to konfiguracja tylko do odczytu (true), czy modyfikowalna (false) (znana również jako parametr serwera).

properties.source

string

Źródło wartości przypisanej do konfiguracji (nazywanej również parametrem serwera). Wymagane do zaktualizowania wartości przypisanej do określonej konfiguracji modyfikowalnej.

properties.unit

string

Jednostki, w których wyrażona jest wartość konfiguracji (nazywana również parametrem serwera).

properties.value

string

Wartość konfiguracji (nazywana również parametrem serwera). Wymagane do zaktualizowania wartości przypisanej do określonej konfiguracji modyfikowalnej.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.