Compartilhar via


Configurations - Put

Atualiza, usando o verbo Put, o valor atribuído a uma configuração modificável específica (também conhecida como parâmetro de servidor) de um 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 URI

Nome Em Obrigatório Tipo Description
configurationName
path True

string

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

Nome da configuração (também conhecido como parâmetro de servidor).

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

serverName
path True

string

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

O nome do servidor.

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser uma UUID.

api-version
query True

string

minLength: 1

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Tipo Description
properties.source

string

Origem do valor atribuído à configuração (também conhecido como parâmetro de servidor). Necessário para atualizar o valor atribuído a uma configuração modificável específica.

properties.value

string

Valor da configuração (também conhecido como parâmetro de servidor). Necessário para atualizar o valor atribuído a uma configuração modificável específica.

Respostas

Nome Tipo Description
202 Accepted

Operação de recurso aceita.

Cabeçalhos

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

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

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

Solicitação de exemplo

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

Resposta de exemplo

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

Definições

Nome Description
ConfigurationDataType

Tipo de dados da configuração (também conhecido como parâmetro de servidor).

ConfigurationForUpdate

Configuração (também conhecida como parâmetro de servidor).

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

ConfigurationDataType

Tipo de dados da configuração (também conhecido como parâmetro de servidor).

Valor Description
Boolean
Numeric
Integer
Enumeration
String
Set

ConfigurationForUpdate

Configuração (também conhecida como parâmetro de servidor).

Nome Tipo Description
properties.allowedValues

string

Valores permitidos da configuração (também conhecido como parâmetro de servidor).

properties.dataType

ConfigurationDataType

Tipo de dados da configuração (também conhecido como parâmetro de servidor).

properties.defaultValue

string

Valor atribuído por padrão à configuração (também conhecido como parâmetro de servidor).

properties.description

string

Descrição da configuração (também conhecida como parâmetro de servidor).

properties.documentationLink

string

Link apontando para a documentação da configuração (também conhecido como parâmetro de servidor).

properties.isConfigPendingRestart

boolean

Indica se o valor atribuído à configuração (também conhecido como parâmetro do servidor) está pendente de uma reinicialização do servidor para que ela entre em vigor.

properties.isDynamicConfig

boolean

Indica se é uma configuração dinâmica (verdadeira) ou estática (falsa) (também conhecida como parâmetro de servidor). Os parâmetros estáticos do servidor exigem uma reinicialização do servidor após alterar o valor atribuído a eles, para que a alteração entre em vigor. Os parâmetros dinâmicos do servidor não exigem uma reinicialização do servidor após a alteração do valor atribuído a eles, para que a alteração entre em vigor.

properties.isReadOnly

boolean

Indica se é uma configuração somente leitura (true) ou modificável (false) (também conhecida como parâmetro de servidor).

properties.source

string

Origem do valor atribuído à configuração (também conhecido como parâmetro de servidor). Necessário para atualizar o valor atribuído a uma configuração modificável específica.

properties.unit

string

Unidades nas quais o valor de configuração (também conhecido como parâmetro de servidor) é expresso.

properties.value

string

Valor da configuração (também conhecido como parâmetro de servidor). Necessário para atualizar o valor atribuído a uma configuração modificável específica.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.