Partilhar 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 do URI

Name Em Necessário Tipo Description
configurationName
path True

string

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

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

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 um UUID.

api-version
query True

string

minLength: 1

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

Corpo do Pedido

Name Tipo Description
properties.source

string

Origem do valor atribuído à configuração (também conhecido como parâmetro server). 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 server). Necessário para atualizar o valor atribuído a uma configuração modificável específica.

Respostas

Name 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 OAuth2 do Azure Ative Directory.

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

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

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

Pedido de amostra

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 da amostra

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

Name Description
ConfigurationDataType

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

ConfigurationForUpdate

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

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

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 conhecido como parâmetro de servidor).

Name Tipo Description
properties.allowedValues

string

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

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 server).

properties.description

string

Descrição da configuração (também conhecido como parâmetro server).

properties.documentationLink

string

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

properties.isConfigPendingRestart

boolean

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

properties.isDynamicConfig

boolean

Indica se é uma configuração dinâmica (true) ou estática (false) (também conhecida como parâmetro server). Os parâmetros estáticos do servidor 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. 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 server).

properties.source

string

Origem do valor atribuído à configuração (também conhecido como parâmetro server). 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 server). Necessário para atualizar o valor atribuído a uma configuração modificável específica.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

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

Name Tipo Description
error

ErrorDetail

O objeto de erro.