Condividi tramite


Servers - Update

Aggiorna un server esistente. Il corpo della richiesta può contenere una a molte delle proprietà presenti nella definizione del server normale.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/servers/{serverName}?api-version=2017-12-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

serverName
path True

string

Nome del server.

subscriptionId
path True

string

ID della sottoscrizione di destinazione.

api-version
query True

string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome Tipo Descrizione
identity

ResourceIdentity

Identità di Azure Active Directory del server.

properties.administratorLoginPassword

string

Password dell'account di accesso dell'amministratore.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Applicare una versione minima di Tls per il server.

properties.publicNetworkAccess

PublicNetworkAccessEnum

Indica se l'accesso alla rete pubblica è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'

properties.replicationRole

string

Ruolo di replica del server.

properties.sslEnforcement

SslEnforcementEnum

Abilitare o meno l'imposizione ssl quando ci si connette al server.

properties.storageProfile

StorageProfile

Profilo di archiviazione di un server.

properties.version

ServerVersion

Versione di un server.

sku

Sku

SKU (piano tariffario) del server.

tags

object

Metadati specifici dell'applicazione sotto forma di coppie chiave-valore.

Risposte

Nome Tipo Descrizione
200 OK

Server

OK

202 Accepted

Accettato

Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

ServerUpdate

Esempio di richiesta

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/servers/pgtestsvc4?api-version=2017-12-01

{
  "properties": {
    "administratorLoginPassword": "<administratorLoginPassword>",
    "sslEnforcement": "Enabled",
    "minimalTlsVersion": "TLS1_2"
  }
}

Risposta di esempio

{
  "sku": {
    "name": "B_Gen4_2",
    "tier": "Basic",
    "family": "Gen4",
    "capacity": 2
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 7,
      "geoRedundantBackup": "Disabled"
    },
    "version": "9.6",
    "sslEnforcement": "Enabled",
    "minimalTlsVersion": "TLS1_2",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "pgtestsvc4.postgres.database.azure.com",
    "earliestRestoreDate": "2018-03-14T21:08:24.637+00:00"
  },
  "location": "westus",
  "tags": {
    "ElasticServer": "1"
  },
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/servers/pgtestsvc4",
  "name": "pgtestsvc4",
  "type": "Microsoft.DBforPostgreSQL/servers"
}

Definizioni

Nome Descrizione
CloudError

Risposta di errore dal servizio Batch.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorResponse

Risposta di errore

GeoRedundantBackup

Abilitare o meno la ridondanza geografica per il backup del server.

IdentityType

Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.

InfrastructureEncryption

Aggiungere un secondo livello di crittografia per i dati usando un nuovo algoritmo di crittografia che offre ulteriore protezione dei dati. Il valore è facoltativo, ma se passato, deve essere "Disabilitato" o "Abilitato".

MinimalTlsVersionEnum

Applicare una versione minima di Tls per il server.

PrivateEndpointProperty
PrivateEndpointProvisioningState

Stato della connessione dell'endpoint privato.

PrivateLinkServiceConnectionStateActionsRequire

Azioni necessarie per la connessione al servizio di collegamento privato.

PrivateLinkServiceConnectionStateStatus

Stato della connessione al servizio di collegamento privato.

PublicNetworkAccessEnum

Indica se l'accesso alla rete pubblica è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'

ResourceIdentity

Configurazione dell'identità di Azure Active Directory per una risorsa.

Server

Rappresenta un server.

ServerPrivateEndpointConnection

Una connessione endpoint privato in un server

ServerPrivateEndpointConnectionProperties

Proprietà di una connessione endpoint privato.

ServerPrivateLinkServiceConnectionStateProperty
ServerState

Stato di un server visibile all'utente.

ServerUpdateParameters

Parametri consentiti per l'aggiornamento per un server.

ServerVersion

Versione di un server.

Sku

Proprietà correlate alle informazioni di fatturazione di un server.

SkuTier

Livello dello SKU specifico, ad esempio Basic.

SslEnforcementEnum

Abilitare o meno l'imposizione ssl quando ci si connette al server.

StorageAutogrow

Abilitare l'aumento automatico dell'archiviazione.

StorageProfile

Proprietà del profilo di archiviazione di un server

CloudError

Risposta di errore dal servizio Batch.

Nome Tipo Descrizione
error

ErrorResponse

Risposta di errore
Risposta di errore comune per tutte le API Resource Manager di Azure per restituire i dettagli dell'errore per le operazioni non riuscite. Segue anche il formato di risposta di errore OData.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorResponse[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

GeoRedundantBackup

Abilitare o meno la ridondanza geografica per il backup del server.

Nome Tipo Descrizione
Disabled

string

Enabled

string

IdentityType

Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.

Nome Tipo Descrizione
SystemAssigned

string

InfrastructureEncryption

Aggiungere un secondo livello di crittografia per i dati usando un nuovo algoritmo di crittografia che offre ulteriore protezione dei dati. Il valore è facoltativo, ma se passato, deve essere "Disabilitato" o "Abilitato".

Nome Tipo Descrizione
Disabled

string

Ulteriore livello di crittografia (secondo) per i dati inattivi

Enabled

string

Valore predefinito per un singolo livello di crittografia per i dati inattivi.

MinimalTlsVersionEnum

Applicare una versione minima di Tls per il server.

Nome Tipo Descrizione
TLS1_0

string

TLS1_1

string

TLS1_2

string

TLSEnforcementDisabled

string

PrivateEndpointProperty

Nome Tipo Descrizione
id

string

ID risorsa dell'endpoint privato.

PrivateEndpointProvisioningState

Stato della connessione dell'endpoint privato.

Nome Tipo Descrizione
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

Azioni necessarie per la connessione al servizio di collegamento privato.

Nome Tipo Descrizione
None

string

PrivateLinkServiceConnectionStateStatus

Stato della connessione al servizio di collegamento privato.

Nome Tipo Descrizione
Approved

string

Disconnected

string

Pending

string

Rejected

string

PublicNetworkAccessEnum

Indica se l'accesso alla rete pubblica è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'

Nome Tipo Descrizione
Disabled

string

Enabled

string

ResourceIdentity

Configurazione dell'identità di Azure Active Directory per una risorsa.

Nome Tipo Descrizione
principalId

string

ID entità di Azure Active Directory.

tenantId

string

ID tenant di Azure Active Directory.

type

IdentityType

Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.

Server

Rappresenta un server.

Nome Tipo Descrizione
id

string

ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ResourceIdentity

Identità di Azure Active Directory del server.

location

string

Posizione geografica in cui risiede la risorsa

name

string

nome della risorsa.

properties.administratorLogin

string

Nome di accesso dell'amministratore di un server. Può essere specificato solo quando il server viene creato (ed è necessario per la creazione).

properties.byokEnforcement

string

Stato che indica se la crittografia dei dati del server è abilitata con chiavi gestite dal cliente.

properties.earliestRestoreDate

string

Tempo di creazione del punto di ripristino meno recente (formato ISO8601)

properties.fullyQualifiedDomainName

string

Nome di dominio completo di un server.

properties.infrastructureEncryption

InfrastructureEncryption

Stato che indica se la crittografia dell'infrastruttura è abilitata per il server.

properties.masterServerId

string

ID server master di un server di replica.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Applicare una versione minima di Tls per il server.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Elenco di connessioni di endpoint privato in un server

properties.publicNetworkAccess

PublicNetworkAccessEnum

Indica se l'accesso alla rete pubblica è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'

properties.replicaCapacity

integer

Numero massimo di repliche che un server master può avere.

properties.replicationRole

string

Ruolo di replica del server.

properties.sslEnforcement

SslEnforcementEnum

Abilitare o meno l'imposizione ssl quando ci si connette al server.

properties.storageProfile

StorageProfile

Profilo di archiviazione di un server.

properties.userVisibleState

ServerState

Stato di un server visibile all'utente.

properties.version

ServerVersion

Versione del server.

sku

Sku

SKU (piano tariffario) del server.

tags

object

Tag delle risorse.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ServerPrivateEndpointConnection

Una connessione endpoint privato in un server

Nome Tipo Descrizione
id

string

ID risorsa della connessione dell'endpoint privato.

properties

ServerPrivateEndpointConnectionProperties

Proprietà di connessione dell'endpoint privato

ServerPrivateEndpointConnectionProperties

Proprietà di una connessione endpoint privato.

Nome Tipo Descrizione
privateEndpoint

PrivateEndpointProperty

Endpoint privato a cui appartiene la connessione.

privateLinkServiceConnectionState

ServerPrivateLinkServiceConnectionStateProperty

Stato di connessione della connessione dell'endpoint privato.

provisioningState

PrivateEndpointProvisioningState

Stato della connessione dell'endpoint privato.

ServerPrivateLinkServiceConnectionStateProperty

Nome Tipo Descrizione
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

Azioni necessarie per la connessione al servizio di collegamento privato.

description

string

Descrizione della connessione al servizio di collegamento privato.

status

PrivateLinkServiceConnectionStateStatus

Stato della connessione al servizio di collegamento privato.

ServerState

Stato di un server visibile all'utente.

Nome Tipo Descrizione
Disabled

string

Dropping

string

Inaccessible

string

Ready

string

ServerUpdateParameters

Parametri consentiti per l'aggiornamento per un server.

Nome Tipo Descrizione
identity

ResourceIdentity

Identità di Azure Active Directory del server.

properties.administratorLoginPassword

string

Password dell'account di accesso dell'amministratore.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Applicare una versione minima di Tls per il server.

properties.publicNetworkAccess

PublicNetworkAccessEnum

Indica se l'accesso alla rete pubblica è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'

properties.replicationRole

string

Ruolo di replica del server.

properties.sslEnforcement

SslEnforcementEnum

Abilitare o meno l'imposizione ssl quando ci si connette al server.

properties.storageProfile

StorageProfile

Profilo di archiviazione di un server.

properties.version

ServerVersion

Versione di un server.

sku

Sku

SKU (piano tariffario) del server.

tags

object

Metadati specifici dell'applicazione sotto forma di coppie chiave-valore.

ServerVersion

Versione di un server.

Nome Tipo Descrizione
10

string

10.0

string

10.2

string

11

string

9.5

string

9.6

string

Sku

Proprietà correlate alle informazioni di fatturazione di un server.

Nome Tipo Descrizione
capacity

integer

Capacità di aumento/riduzione, che rappresenta le unità di calcolo del server.

family

string

Famiglia di hardware.

name

string

Nome dello SKU, in genere, tier + family + cores, ad esempio B_Gen4_1, GP_Gen5_8.

size

string

Codice delle dimensioni da interpretare in base alla risorsa in base alle esigenze.

tier

SkuTier

Livello dello SKU specifico, ad esempio Basic.

SkuTier

Livello dello SKU specifico, ad esempio Basic.

Nome Tipo Descrizione
Basic

string

GeneralPurpose

string

MemoryOptimized

string

SslEnforcementEnum

Abilitare o meno l'imposizione ssl quando ci si connette al server.

Nome Tipo Descrizione
Disabled

string

Enabled

string

StorageAutogrow

Abilitare l'aumento automatico dell'archiviazione.

Nome Tipo Descrizione
Disabled

string

Enabled

string

StorageProfile

Proprietà del profilo di archiviazione di un server

Nome Tipo Descrizione
backupRetentionDays

integer

Giorni di conservazione dei backup per il server.

geoRedundantBackup

GeoRedundantBackup

Abilitare o meno la ridondanza geografica per il backup del server.

storageAutogrow

StorageAutogrow

Abilitare l'aumento automatico dell'archiviazione.

storageMB

integer

Spazio di archiviazione massimo consentito per un server.