Servers - Create
Crea un nuovo server.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}?api-version=2021-06-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole. |
|
server
|
path | True |
string |
Il nome del server. |
|
subscription
|
path | True |
string minLength: 1 |
ID della sottoscrizione di destinazione. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| location | True |
string |
Posizione geografica in cui risiede la 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.administratorLoginPassword |
string (password) |
Password di accesso dell'amministratore (necessaria per la creazione del server). |
|
| properties.availabilityZone |
string |
informazioni sulla zona di disponibilità del server. |
|
| properties.backup |
Proprietà di backup di un server. |
||
| properties.createMode |
Modalità per creare un nuovo server PostgreSQL. |
||
| properties.highAvailability |
Proprietà a disponibilità elevata di un server. |
||
| properties.maintenanceWindow |
Proprietà della finestra di manutenzione di un server. |
||
| properties.network |
Proprietà di rete di un server. |
||
| properties.pointInTimeUTC |
string (date-time) |
Tempo di creazione del punto di ripristino (formato ISO8601), specificando il tempo da cui eseguire il ripristino. È necessario quando 'createMode' è 'PointInTimeRestore'. |
|
| properties.sourceServerResourceId |
string (arm-id) |
ID risorsa del server di origine da cui eseguire il ripristino. È necessario quando 'createMode' è 'PointInTimeRestore'. |
|
| properties.storage |
Proprietà di archiviazione di un server. |
||
| properties.version |
Versione del server PostgreSQL. |
||
| sku |
SKU (piano tariffario) del server. |
||
| tags |
object |
Tag di risorsa. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
Va bene |
|
| 201 Created |
Creato |
|
| 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
| Create a database as a point in time restore |
| Create a new server |
Create a database as a point in time restore
Esempio di richiesta
PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/flexibleServers/pgtestsvc5?api-version=2021-06-01
{
"location": "westus",
"properties": {
"createMode": "PointInTimeRestore",
"sourceServerResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/flexibleServers/sourcepgservername",
"pointInTimeUTC": "2021-06-27T00:04:59.4078005+00:00"
}
}
Risposta di esempio
{
"sku": {
"name": "Standard_D4s_v3",
"tier": "GeneralPurpose"
},
"properties": {
"fullyQualifiedDomainName": "pgtestsvc5.postgres.database.azure.com",
"version": "12",
"minorVersion": "6",
"administratorLogin": "cloudsa",
"state": "Ready",
"availabilityZone": "2",
"storage": {
"storageSizeGB": 512
},
"backup": {
"backupRetentionDays": 7,
"geoRedundantBackup": "Disabled",
"earliestRestoreDate": "2021-05-27T00:28:17.7279547+00:00"
},
"network": {
"publicNetworkAccess": "Enabled"
},
"highAvailability": {
"mode": "Disabled",
"state": "NotEnabled"
},
"maintenanceWindow": {
"customWindow": "Disabled",
"dayOfWeek": 0,
"startHour": 0,
"startMinute": 0
}
},
"location": "westus",
"tags": {
"ElasticServer": "1"
},
"id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/flexibleServers/pgtestsvc5",
"name": "pgtestsvc5",
"type": "Microsoft.DBforPostgreSQL/flexibleServers"
}
{
"sku": {
"name": "Standard_D4s_v3",
"tier": "GeneralPurpose"
},
"properties": {
"fullyQualifiedDomainName": "pgtestsvc5.postgres.database.azure.com",
"version": "12",
"minorVersion": "6",
"administratorLogin": "cloudsa",
"state": "Ready",
"availabilityZone": "2",
"storage": {
"storageSizeGB": 512
},
"backup": {
"backupRetentionDays": 7,
"geoRedundantBackup": "Disabled",
"earliestRestoreDate": "2021-05-27T00:28:17.7279547+00:00"
},
"network": {
"publicNetworkAccess": "Enabled"
},
"highAvailability": {
"mode": "Disabled",
"state": "NotEnabled"
},
"maintenanceWindow": {
"customWindow": "Disabled",
"dayOfWeek": 0,
"startHour": 0,
"startMinute": 0
}
},
"location": "westus",
"tags": {
"ElasticServer": "1"
},
"id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/flexibleServers/pgtestsvc5",
"name": "pgtestsvc5",
"type": "Microsoft.DBforPostgreSQL/flexibleServers"
}
Create a new server
Esempio di richiesta
PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/flexibleServers/pgtestsvc4?api-version=2021-06-01
{
"location": "westus",
"sku": {
"tier": "GeneralPurpose",
"name": "Standard_D4s_v3"
},
"properties": {
"administratorLogin": "cloudsa",
"administratorLoginPassword": "password",
"version": "12",
"availabilityZone": "1",
"createMode": "Create",
"storage": {
"storageSizeGB": 512
},
"backup": {
"backupRetentionDays": 7,
"geoRedundantBackup": "Disabled"
},
"network": {
"delegatedSubnetResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/test-vnet-subnet",
"privateDnsZoneArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourcegroups/testrg/providers/Microsoft.Network/privateDnsZones/test-private-dns-zone.postgres.database.azure.com"
},
"highAvailability": {
"mode": "ZoneRedundant"
}
},
"tags": {
"ElasticServer": "1"
}
}
Risposta di esempio
{
"sku": {
"name": "Standard_D4s_v3",
"tier": "GeneralPurpose"
},
"properties": {
"fullyQualifiedDomainName": "c7d7483a8ceb.test-private-dns-zone.postgres.database.azure.com",
"version": "12",
"minorVersion": "6",
"administratorLogin": "cloudsa",
"state": "Ready",
"availabilityZone": "1",
"storage": {
"storageSizeGB": 512
},
"backup": {
"backupRetentionDays": 7,
"geoRedundantBackup": "Disabled",
"earliestRestoreDate": "2021-05-26T01:08:06.7197478+00:00"
},
"network": {
"publicNetworkAccess": "Disabled",
"delegatedSubnetResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/test-vnet-subnet",
"privateDnsZoneArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.Network/privateDnsZones/test-private-dns-zone.postgres.database.azure.com"
},
"highAvailability": {
"mode": "ZoneRedundant",
"state": "Healthy",
"standbyAvailabilityZone": "2"
},
"maintenanceWindow": {
"customWindow": "Disabled",
"dayOfWeek": 0,
"startHour": 0,
"startMinute": 0
}
},
"location": "westus",
"tags": {
"ElasticServer": "1"
},
"id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/flexibleServers/pgtestsvc4",
"name": "pgtestsvc4",
"type": "Microsoft.DBforPostgreSQL/flexibleServers"
}
{
"sku": {
"name": "Standard_D4s_v3",
"tier": "GeneralPurpose"
},
"properties": {
"fullyQualifiedDomainName": "c7d7483a8ceb.test-private-dns-zone.postgres.database.azure.com",
"version": "12",
"minorVersion": "6",
"administratorLogin": "cloudsa",
"state": "Ready",
"availabilityZone": "1",
"storage": {
"storageSizeGB": 512
},
"backup": {
"backupRetentionDays": 7,
"geoRedundantBackup": "Disabled",
"earliestRestoreDate": "2021-05-26T01:08:06.7197478+00:00"
},
"network": {
"publicNetworkAccess": "Disabled",
"delegatedSubnetResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/test-vnet-subnet",
"privateDnsZoneArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.Network/privateDnsZones/test-private-dns-zone.postgres.database.azure.com"
},
"highAvailability": {
"mode": "ZoneRedundant",
"state": "Healthy",
"standbyAvailabilityZone": "2"
},
"maintenanceWindow": {
"customWindow": "Disabled",
"dayOfWeek": 0,
"startHour": 0,
"startMinute": 0
}
},
"location": "westus",
"tags": {
"ElasticServer": "1"
},
"id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/flexibleServers/pgtestsvc4",
"name": "pgtestsvc4",
"type": "Microsoft.DBforPostgreSQL/flexibleServers"
}
Definizioni
| Nome | Descrizione |
|---|---|
| Backup |
Proprietà di backup di un server |
|
Cloud |
Risposta di errore dal servizio Batch. |
|
created |
Tipo di identità che ha creato la risorsa. |
|
Create |
Modalità per creare un nuovo server PostgreSQL. |
|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
|
Error |
Risposta di errore |
|
Geo |
Valore che indica se Geo-Redundant backup è abilitato nel server. |
|
High |
Proprietà a disponibilità elevata di un server |
|
High |
Modalità a disponibilità elevata per il server. |
|
Maintenance |
Proprietà della finestra di manutenzione di un server. |
| Network |
Proprietà di rete di un server |
| Server |
Rappresenta un server. |
|
Server |
Stato di un server a disponibilità elevata visibile all'utente. |
|
Server |
l'accesso alla rete pubblica è abilitato o meno |
|
Server |
Stato di un server visibile all'utente. |
|
Server |
Versione di un server. |
| Sku |
Informazioni sullo SKU relative alle proprietà di un server. |
|
Sku |
Livello dello SKU specifico, ad esempio Burstable. |
| Storage |
Proprietà di archiviazione di un server |
|
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
Backup
Proprietà di backup di un server
| Nome | Tipo | Valore predefinito | Descrizione |
|---|---|---|---|
| backupRetentionDays |
integer (int32) |
7 |
Giorni di conservazione dei backup per il server. |
| earliestRestoreDate |
string (date-time) |
Ora del punto di ripristino meno recente (formato ISO8601) per il server. |
|
| geoRedundantBackup | Disabled |
Valore che indica se Geo-Redundant backup è abilitato nel server. |
CloudError
Risposta di errore dal servizio Batch.
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Risposta di errore |
createdByType
Tipo di identità che ha creato la risorsa.
| Valore | Descrizione |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
CreateMode
Modalità per creare un nuovo server PostgreSQL.
| Valore | Descrizione |
|---|---|
| Default | |
| Create | |
| Update | |
| PointInTimeRestore |
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. |
GeoRedundantBackupEnum
Valore che indica se Geo-Redundant backup è abilitato nel server.
| Valore | Descrizione |
|---|---|
| Enabled | |
| Disabled |
HighAvailability
Proprietà a disponibilità elevata di un server
| Nome | Tipo | Valore predefinito | Descrizione |
|---|---|---|---|
| mode | Disabled |
Modalità a disponibilità elevata per il server. |
|
| standbyAvailabilityZone |
string |
informazioni sulla zona di disponibilità dello standby. |
|
| state |
Stato di un server a disponibilità elevata visibile all'utente. |
HighAvailabilityMode
Modalità a disponibilità elevata per il server.
| Valore | Descrizione |
|---|---|
| Disabled | |
| ZoneRedundant |
MaintenanceWindow
Proprietà della finestra di manutenzione di un server.
| Nome | Tipo | Valore predefinito | Descrizione |
|---|---|---|---|
| customWindow |
string |
Disabled |
indica se la finestra personalizzata è abilitata o disabilitata |
| dayOfWeek |
integer (int32) |
0 |
giorno della settimana per la finestra di manutenzione |
| startHour |
integer (int32) |
0 |
ora di inizio per la finestra di manutenzione |
| startMinute |
integer (int32) |
0 |
inizio minuto per la finestra di manutenzione |
Network
Proprietà di rete di un server
| Nome | Tipo | Descrizione |
|---|---|---|
| delegatedSubnetResourceId |
string (arm-id) |
ID risorsa arm della subnet delegata. |
| privateDnsZoneArmResourceId |
string (arm-id) |
ID risorsa arm della zona DNS privata. |
| publicNetworkAccess |
l'accesso alla rete pubblica è abilitato o meno |
Server
Rappresenta un server.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string |
ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| 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.administratorLoginPassword |
string (password) |
Password di accesso dell'amministratore (necessaria per la creazione del server). |
| properties.availabilityZone |
string |
informazioni sulla zona di disponibilità del server. |
| properties.backup |
Proprietà di backup di un server. |
|
| properties.createMode |
Modalità per creare un nuovo server PostgreSQL. |
|
| properties.fullyQualifiedDomainName |
string |
Nome di dominio completo di un server. |
| properties.highAvailability |
Proprietà a disponibilità elevata di un server. |
|
| properties.maintenanceWindow |
Proprietà della finestra di manutenzione di un server. |
|
| properties.minorVersion |
string |
Versione secondaria del server. |
| properties.network |
Proprietà di rete di un server. |
|
| properties.pointInTimeUTC |
string (date-time) |
Tempo di creazione del punto di ripristino (formato ISO8601), specificando il tempo da cui eseguire il ripristino. È necessario quando 'createMode' è 'PointInTimeRestore'. |
| properties.sourceServerResourceId |
string (arm-id) |
ID risorsa del server di origine da cui eseguire il ripristino. È necessario quando 'createMode' è 'PointInTimeRestore'. |
| properties.state |
Stato di un server visibile all'utente. |
|
| properties.storage |
Proprietà di archiviazione di un server. |
|
| properties.version |
Versione del server PostgreSQL. |
|
| sku |
SKU (piano tariffario) del server. |
|
| systemData |
Metadati di sistema relativi a questa risorsa. |
|
| tags |
object |
Tag di risorsa. |
| type |
string |
Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
ServerHAState
Stato di un server a disponibilità elevata visibile all'utente.
| Valore | Descrizione |
|---|---|
| NotEnabled | |
| CreatingStandby | |
| ReplicatingData | |
| FailingOver | |
| Healthy | |
| RemovingStandby |
ServerPublicNetworkAccessState
l'accesso alla rete pubblica è abilitato o meno
| Valore | Descrizione |
|---|---|
| Enabled | |
| Disabled |
ServerState
Stato di un server visibile all'utente.
| Valore | Descrizione |
|---|---|
| Ready | |
| Dropping | |
| Disabled | |
| Starting | |
| Stopping | |
| Stopped | |
| Updating |
ServerVersion
Versione di un server.
| Valore | Descrizione |
|---|---|
| 14 | |
| 13 | |
| 12 | |
| 11 |
Sku
Informazioni sullo SKU relative alle proprietà di un server.
| Nome | Tipo | Descrizione |
|---|---|---|
| name |
string |
Nome dello SKU, in genere, tier + family + core, ad esempio Standard_D4s_v3. |
| tier |
Livello dello SKU specifico, ad esempio Burstable. |
SkuTier
Livello dello SKU specifico, ad esempio Burstable.
| Valore | Descrizione |
|---|---|
| Burstable | |
| GeneralPurpose | |
| MemoryOptimized |
Storage
Proprietà di archiviazione di un server
| Nome | Tipo | Descrizione |
|---|---|---|
| storageSizeGB |
integer (int32) |
Spazio di archiviazione massimo consentito per un server. |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
| Nome | Tipo | Descrizione |
|---|---|---|
| createdAt |
string (date-time) |
Timestamp della creazione della risorsa (UTC). |
| createdBy |
string |
Identità che ha creato la risorsa. |
| createdByType |
Tipo di identità che ha creato la risorsa. |
|
| lastModifiedAt |
string (date-time) |
Timestamp dell'ultima modifica della risorsa (UTC) |
| lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
| lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |