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 |
---|---|---|---|---|
resource
|
path | True |
string |
Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole. |
server
|
path | True |
string |
Nome del server. |
subscription
|
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 |
Identità di Azure Active Directory del server. |
|
properties.administratorLoginPassword |
string |
Password dell'account di accesso dell'amministratore. |
properties.minimalTlsVersion |
Applicare una versione minima di Tls per il server. |
|
properties.publicNetworkAccess |
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 |
Abilitare o meno l'imposizione ssl quando ci si connette al server. |
|
properties.storageProfile |
Profilo di archiviazione di un server. |
|
properties.version |
Versione di un server. |
|
sku |
SKU (piano tariffario) del server. |
|
tags |
object |
Metadati specifici dell'applicazione sotto forma di coppie chiave-valore. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
|
202 Accepted |
Accettato |
|
Other Status Codes |
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 |
---|---|
Cloud |
Risposta di errore dal servizio Batch. |
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
Error |
Risposta di errore |
Geo |
Abilitare o meno la ridondanza geografica per il backup del server. |
Identity |
Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa. |
Infrastructure |
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". |
Minimal |
Applicare una versione minima di Tls per il server. |
Private |
|
Private |
Stato della connessione dell'endpoint privato. |
Private |
Azioni necessarie per la connessione al servizio di collegamento privato. |
Private |
Stato della connessione al servizio di collegamento privato. |
Public |
Indica se l'accesso alla rete pubblica è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled' |
Resource |
Configurazione dell'identità di Azure Active Directory per una risorsa. |
Server |
Rappresenta un server. |
Server |
Una connessione endpoint privato in un server |
Server |
Proprietà di una connessione endpoint privato. |
Server |
|
Server |
Stato di un server visibile all'utente. |
Server |
Parametri consentiti per l'aggiornamento per un server. |
Server |
Versione di un server. |
Sku |
Proprietà correlate alle informazioni di fatturazione di un server. |
Sku |
Livello dello SKU specifico, ad esempio Basic. |
Ssl |
Abilitare o meno l'imposizione ssl quando ci si connette al server. |
Storage |
Abilitare l'aumento automatico dell'archiviazione. |
Storage |
Proprietà del profilo di archiviazione di un server |
CloudError
Risposta di errore dal servizio Batch.
Nome | Tipo | Descrizione |
---|---|---|
error |
Risposta di errore |
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 |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
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 |
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 |
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 |
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 |
Applicare una versione minima di Tls per il server. |
|
properties.privateEndpointConnections |
Elenco di connessioni di endpoint privato in un server |
|
properties.publicNetworkAccess |
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 |
Abilitare o meno l'imposizione ssl quando ci si connette al server. |
|
properties.storageProfile |
Profilo di archiviazione di un server. |
|
properties.userVisibleState |
Stato di un server visibile all'utente. |
|
properties.version |
Versione del server. |
|
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 |
Proprietà di connessione dell'endpoint privato |
ServerPrivateEndpointConnectionProperties
Proprietà di una connessione endpoint privato.
Nome | Tipo | Descrizione |
---|---|---|
privateEndpoint |
Endpoint privato a cui appartiene la connessione. |
|
privateLinkServiceConnectionState |
Stato di connessione della connessione dell'endpoint privato. |
|
provisioningState |
Stato della connessione dell'endpoint privato. |
ServerPrivateLinkServiceConnectionStateProperty
Nome | Tipo | Descrizione |
---|---|---|
actionsRequired |
Azioni necessarie per la connessione al servizio di collegamento privato. |
|
description |
string |
Descrizione della connessione al servizio di collegamento privato. |
status |
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 |
Identità di Azure Active Directory del server. |
|
properties.administratorLoginPassword |
string |
Password dell'account di accesso dell'amministratore. |
properties.minimalTlsVersion |
Applicare una versione minima di Tls per il server. |
|
properties.publicNetworkAccess |
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 |
Abilitare o meno l'imposizione ssl quando ci si connette al server. |
|
properties.storageProfile |
Profilo di archiviazione di un server. |
|
properties.version |
Versione di un server. |
|
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 |
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 |
Abilitare o meno la ridondanza geografica per il backup del server. |
|
storageAutogrow |
Abilitare l'aumento automatico dell'archiviazione. |
|
storageMB |
integer |
Spazio di archiviazione massimo consentito per un server. |