Configurations - Put
Actualiza, mediante el verbo Put, el valor asignado a una configuración modificable específica (también conocida como parámetro de servidor) de un servidor.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}/configurations/{configurationName}?api-version=2025-08-01
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
configuration
|
path | True |
string minLength: 1maxLength: 256 pattern: ^[-\w\._]+$ |
Nombre de la configuración (también conocido como parámetro del servidor). |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
|
server
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)* |
El nombre del servidor. |
|
subscription
|
path | True |
string (uuid) |
Identificador de la suscripción de destino. El valor debe ser un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versión de API que se usará para la operación. |
Cuerpo de la solicitud
| Nombre | Tipo | Description |
|---|---|---|
| properties.source |
string |
Origen del valor asignado a la configuración (también conocido como parámetro de servidor). Necesario para actualizar el valor asignado a una configuración modificable específica. |
| properties.value |
string |
Valor de la configuración (también conocido como parámetro de servidor). Necesario para actualizar el valor asignado a una configuración modificable específica. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 202 Accepted |
Operación de recurso aceptada. Encabezados
|
|
| Other Status Codes |
Una respuesta de error inesperada. |
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory.
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
| Nombre | Description |
|---|---|
| user_impersonation | suplantar la cuenta de usuario |
Ejemplos
Update, using Put verb, the value assigned to a specific modifiable configuration (also known as server parameter) of a server.
Solicitud de ejemplo
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"
}
}
Respuesta de muestra
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
Definiciones
| Nombre | Description |
|---|---|
|
Configuration |
Tipo de datos de la configuración (también conocido como parámetro de servidor). |
|
Configuration |
Configuración (también conocida como parámetro del servidor). |
|
Error |
Información adicional sobre el error de administración de recursos. |
|
Error |
Detalle del error. |
|
Error |
Respuesta de error |
ConfigurationDataType
Tipo de datos de la configuración (también conocido como parámetro de servidor).
| Valor | Description |
|---|---|
| Boolean | |
| Numeric | |
| Integer | |
| Enumeration | |
| String | |
| Set |
ConfigurationForUpdate
Configuración (también conocida como parámetro del servidor).
| Nombre | Tipo | Description |
|---|---|---|
| properties.allowedValues |
string |
Valores permitidos de la configuración (también conocido como parámetro del servidor). |
| properties.dataType |
Tipo de datos de la configuración (también conocido como parámetro de servidor). |
|
| properties.defaultValue |
string |
Valor asignado por defecto a la configuración (también conocido como parámetro de servidor). |
| properties.description |
string |
Descripción de la configuración (también conocida como parámetro del servidor). |
| properties.documentationLink |
string |
Enlace que apunta a la documentación de la configuración (también conocido como parámetro de servidor). |
| properties.isConfigPendingRestart |
boolean |
Indica si el valor asignado a la configuración (también conocido como parámetro de servidor) está pendiente de reiniciar el servidor para que surta efecto. |
| properties.isDynamicConfig |
boolean |
Indica si se trata de una configuración dinámica (true) o estática (false) (también conocida como parámetro de servidor). Los parámetros estáticos del servidor requieren un reinicio del servidor después de cambiar el valor asignado a ellos, para que el cambio surta efecto. Los parámetros dinámicos del servidor no requieren un reinicio del servidor después de cambiar el valor asignado para que el cambio surta efecto. |
| properties.isReadOnly |
boolean |
Indica si se trata de una configuración de solo lectura (true) o modificable (false) (también conocida como parámetro de servidor). |
| properties.source |
string |
Origen del valor asignado a la configuración (también conocido como parámetro de servidor). Necesario para actualizar el valor asignado a una configuración modificable específica. |
| properties.unit |
string |
Unidades en las que se expresa el valor de configuración (también conocido como parámetro de servidor). |
| properties.value |
string |
Valor de la configuración (también conocido como parámetro de servidor). Necesario para actualizar el valor asignado a una configuración modificable específica. |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
| Nombre | Tipo | Description |
|---|---|---|
| info |
object |
Información adicional. |
| type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
| Nombre | Tipo | Description |
|---|---|---|
| additionalInfo |
Información adicional del error. |
|
| code |
string |
Código de error. |
| details |
Los detalles del error. |
|
| message |
string |
El mensaje de error. |
| target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
| Nombre | Tipo | Description |
|---|---|---|
| error |
Objeto de error. |