Servers - Restart

Riavvia il motore di database PostgreSQL in un server.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}/restart?api-version=2025-08-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.

serverName
path True

string

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

Il nome del server.

subscriptionId
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.

Corpo della richiesta

Nome Tipo Descrizione
failoverMode

FailoverMode

Modalità di failover.

restartWithFailover

boolean

Indica se il riavvio del motore di database PostgreSQL deve eseguire il failover o il passaggio da primario a standby. Funziona solo se il server ha l'alta disponibilità abilitata.

Risposte

Nome Tipo Descrizione
202 Accepted

Operazione di risorsa accettata.

Intestazioni

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

ErrorResponse

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

Restart PostgreSQL database engine in a server with a forced failover to standby server.
Restart PostgreSQL database engine in a server.

Restart PostgreSQL database engine in a server with a forced failover to standby server.

Esempio di richiesta

POST https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver/restart?api-version=2025-08-01

{
  "failoverMode": "ForcedFailover",
  "restartWithFailover": true
}

Risposta di esempio

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

Restart PostgreSQL database engine in a server.

Esempio di richiesta

POST https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver/restart?api-version=2025-08-01

Risposta di esempio

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

Definizioni

Nome Descrizione
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

FailoverMode

Modalità di failover.

RestartParameter

Parametri di riavvio del motore di database PostgreSQL.

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

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

FailoverMode

Modalità di failover.

Valore Descrizione
PlannedFailover

Attiva un failover da primaria a standby senza prima interrompere il processo del database primario. Si tratta di un failover normale che tenta di mantenere la coerenza dei dati.

ForcedFailover

Termina prima il processo principale del database, poi attiva il failover. Questo è più aggressivo e viene utilizzato quando il primario non risponde o si trova in uno stato non integro.

PlannedSwitchover

Simile a 'PlannedFailover', ma preferisce un'operazione di commutazione in cui i ruoli vengono scambiati tra primario e standby.

ForcedSwitchover

Termina prima il processo principale del database, poi attiva il passaggio con il role swapping.

RestartParameter

Parametri di riavvio del motore di database PostgreSQL.

Nome Tipo Descrizione
failoverMode

FailoverMode

Modalità di failover.

restartWithFailover

boolean

Indica se il riavvio del motore di database PostgreSQL deve eseguire il failover o il passaggio da primario a standby. Funziona solo se il server ha l'alta disponibilità abilitata.