Configurations - Get
Ottiene informazioni su una configurazione specifica (nota anche come parametro server) di un server.
GET 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 |
|---|---|---|---|---|
|
configuration
|
path | True |
string minLength: 1maxLength: 256 pattern: ^[-\w\._]+$ |
Nome della configurazione (noto anche come parametro del server). |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole. |
|
server
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)* |
Il nome del server. |
|
subscription
|
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. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
Operazione Azure completata con successo. |
|
| Other Status Codes |
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
Get information about a specific configuration (also known as server parameter) of a server.
Esempio di richiesta
Risposta di esempio
{
"name": "array_nulls",
"type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
"id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver/configurations/array_nulls",
"properties": {
"description": "Enables input of NULL (case insensitive) to be considered as NULL value rather than the literal String 'NULL'.",
"allowedValues": "on,off",
"dataType": "Boolean",
"defaultValue": "on",
"documentationLink": "https://www.postgresql.org/docs/13/runtime-config-compatible.html#GUC-ARRAY-NULLS",
"isConfigPendingRestart": false,
"isDynamicConfig": true,
"isReadOnly": false,
"source": "system-default",
"value": "on"
}
}
Definizioni
| Nome | Descrizione |
|---|---|
| Configuration |
Configurazione (nota anche come parametro del server). |
|
Configuration |
Tipo di dati della configurazione (noto anche come parametro del server). |
|
created |
Tipo di identità che ha creato la risorsa. |
|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
|
Error |
Dettagli dell'errore. |
|
Error |
Risposta di errore |
|
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
Configuration
Configurazione (nota anche come parametro del server).
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string (arm-id) |
ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Nome della risorsa |
| properties.allowedValues |
string |
Valori consentiti della configurazione (noto anche come parametro del server). |
| properties.dataType |
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. |
| systemData |
Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy. |
|
| type |
string |
Tipo di risorsa. Ad esempio: "Microsoft. Compute/virtualMachines" oppure "Microsoft. Storage/storageAccounts" |
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. |
createdByType
Tipo di identità che ha creato la risorsa.
| Valore | Descrizione |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
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 |
Informazioni aggiuntive sull'errore. |
|
| code |
string |
Codice di errore. |
| details |
Dettagli dell'errore. |
|
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Oggetto error. |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
| Nome | Tipo | Descrizione |
|---|---|---|
| createdAt |
string (date-time) |
Timestamp della creazione della risorsa (UTC). |
| createdBy |
string |
Identità che ha creato la risorsa. |
| createdByType |
Tipo di identità che ha creato la risorsa. |
|
| lastModifiedAt |
string (date-time) |
Timestamp dell'ultima modifica della risorsa (UTC) |
| lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
| lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |