Compartir a través de


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
configurationName
path True

string

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

Nombre de la configuración (también conocido como parámetro del servidor).

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

serverName
path True

string

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

El nombre del servidor.

subscriptionId
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

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

ErrorResponse

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
ConfigurationDataType

Tipo de datos de la configuración (también conocido como parámetro de servidor).

ConfigurationForUpdate

Configuración (también conocida como parámetro del servidor).

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

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

ConfigurationDataType

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

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Los detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.