Condividi tramite


Managed Databases - Create Or Update

Crea un nuovo database o aggiorna un database esistente.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2021-11-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
databaseName
path True

string

Nome del database.

managedInstanceName
path True

string

Nome dell'istanza gestita.

resourceGroupName
path True

string

Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.

subscriptionId
path True

string

ID sottoscrizione che identifica una sottoscrizione di Azure.

api-version
query True

string

Versione dell'API da usare per la richiesta.

Corpo della richiesta

Nome Necessario Tipo Descrizione
location True

string

Percorso della risorsa.

properties.autoCompleteRestore

boolean

Indica se completare automaticamente il ripristino di questo database gestito.

properties.catalogCollation

CatalogCollationType

Regole di confronto del catalogo di metadati.

properties.collation

string

Regole di confronto del database gestito.

properties.createMode

ManagedDatabaseCreateMode

Modalità di creazione del database gestito. PointInTimeRestore: creare un database ripristinando un backup temporizzato di un database esistente. È necessario specificare SourceDatabaseName, SourceManagedInstanceName e PointInTime. RestoreExternalBackup: creare un database ripristinando da file di backup esterni. È necessario specificare regole di confronto, StorageContainerUri e StorageContainerSasToken. Ripristino: crea un database ripristinando un backup con replica geografica. RecoverableDatabaseId deve essere specificato come ID risorsa di database ripristinabile da ripristinare. RestoreLongTermRetentionBackup: creare un database ripristinando da un backup di conservazione a lungo termine (longTermRetentionBackupResourceId obbligatorio).

properties.lastBackupName

string

Cognome del file di backup per il ripristino di questo database gestito.

properties.longTermRetentionBackupResourceId

string (arm-id)

Nome del backup di conservazione a lungo termine da usare per il ripristino di questo database gestito.

properties.recoverableDatabaseId

string (arm-id)

Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database.

properties.restorableDroppedDatabaseId

string (arm-id)

ID risorsa del database eliminato ripristinabile da ripristinare durante la creazione del database.

properties.restorePointInTime

string (date-time)

Condizionale. Se createMode è PointInTimeRestore, questo valore è obbligatorio. Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database.

properties.sourceDatabaseId

string (arm-id)

Identificatore della risorsa del database di origine associato all'operazione di creazione del database.

properties.storageContainerSasToken

string

Condizionale. Se createMode è RestoreExternalBackup, questo valore è obbligatorio. Specifica il token di firma di accesso condiviso del contenitore di archiviazione.

properties.storageContainerUri

string

Condizionale. Se createMode è RestoreExternalBackup, questo valore è obbligatorio. Specifica l'URI del contenitore di archiviazione in cui vengono archiviati i backup per questo ripristino.

tags

object

Tag di risorsa.

Risposte

Nome Tipo Descrizione
200 OK

ManagedDatabase

Aggiornamento corretto del database.

201 Created

ManagedDatabase

Creazione del database completata.

202 Accepted

Accettato

Other Status Codes

Risposte di errore:

  • 400 PitrPointInTimeInvalid - Il punto nel tempo {0} non è valido. Intervallo di tempo valido da {1} giorni all'inizio e non prima dell'ora di creazione del server di origine.

  • 400 CannotUseTrailingWhitespacesInDatabaseName- La convalida del nome del database non è riuscita.

  • 400 StorageAccountFull - Istanza gestita ha raggiunto la capacità totale dell'account di archiviazione di Azure sottostante. L'account di Archiviazione Premium di Azure è limitato a 35 TB di spazio allocato.

  • 400 AkvHostNotResolvingFromNode - Host AKV '{0}' non è risolvibile da SQL, nel server '{1}'.

  • 400 InvalidBackupRetentionPeriod: i giorni di conservazione dei {0} non sono una configurazione valida. La conservazione dei backup valida in giorni deve essere compresa tra {1} e {2}

  • 400 ManagedDatabaseNameInUse - Database '{0}' esiste già. Scegliere un nome di database diverso.

  • 400 NoMoreSpaceInManagedInstance: l'istanza gestita ha raggiunto il limite di archiviazione. L'utilizzo dello spazio di archiviazione per l'istanza gestita non può superare (%d) MB.

  • 400 ManagedInstanceUpdateSloInProgress - "Impossibile completare l'operazione perché è in corso una modifica del livello di servizio per l'istanza gestita '{0}.' Attendere il completamento dell'operazione e riprovare."

  • 400 SameKeyMaterialNotFoundOnRemoteServer - Il server secondario non dispone del materiale della chiave della protezione di crittografia del server primario.

  • 400 SourceDatabaseNotFound - Il database di origine non esiste.

  • 400 RegionDoesNotSupportVersion: un utente ha tentato di creare un server di una versione specificata in un percorso in cui tale versione del server non è supportata.

  • 400 PasswordNotComplex - La password specificata non è abbastanza complessa.

  • 400 CannotUseReservedDatabaseName: impossibile utilizzare il nome del database riservato in questa operazione.

  • 400 InvalidServerName - Nome server non valido specificato.

  • 400 SourceServerNotFound: la parte server di un ID di database di origine fornito in una chiamata API CreateDatabaseAsCopy non esegue il mapping a un server esistente.

  • 400 TokenTooLong: il token fornito è troppo lungo.

  • 400 CurrentDatabaseSizeExceedsMaxSize- L'utente ha tentato di ridurre le dimensioni massime per un database a una dimensione inferiore all'utilizzo corrente.

  • 400 InvalidCollation : le regole di confronto non sono riconosciute dal server.

  • 400 AkvEndpointNotReachableFromNode - Endpoint AKV '{0}' non è raggiungibile da SQL, nel server '{1}'.

  • 400 ServerNotFound - Il server richiesto non è stato trovato.

  • 400 UnsupportedServiceName: il nome specificato non è valido perché contiene uno o più caratteri Unicode non supportati.

  • 400 CurrentDatabaseLogSizeExceedsMaxSize- L'utente ha tentato di modificare il database in uno SKU con dimensioni massime massime inferiori rispetto all'utilizzo corrente.

  • 400 DatabaseNumberLimitReached: è stato raggiunto il numero massimo di database per Istanza gestita di database SQL.

  • 400 InvalidDatabaseCreateOrUpdateRequest: il corpo della richiesta per l'operazione di creazione o aggiornamento del database non è valido.

  • 400 InvalidResourceId - Identificatore di risorsa non valido.

  • 400 InvalidSourceDatabaseId - Identificatore di database di origine non valido.

  • 400 InvalidRestorableDroppedDatabaseId - Identificatore del database eliminato ripristinabile non valido

  • 400 Mancata corrispondenzaResourceGroupNameWithUrl- Il nome del gruppo di risorse specificato non corrisponde al nome nell'URL.

  • 400 MismatchingServerNameWithUrl: il nome del server specificato non corrisponde al nome nell'URL.

  • 400 Mancata corrispondenzaSubscriptionWithUrl: la sottoscrizione specificata non corrisponde alla sottoscrizione nell'URL.

  • 400 MissingCollation: sono necessarie regole di confronto.

  • 400 MissingSourceDatabaseId - Identificatore del database di origine mancante.

  • 400 MissingRestorePointInTime - Punto di ripristino mancante nel tempo

  • 400 MissingStorageContainerSasToken - Token di firma di accesso condiviso del contenitore di archiviazione mancante

  • 400 MissingStorageContainerUri - URI contenitore di archiviazione mancante

  • 400 RestorableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId - Impossibile specificare restorableDroppedDatabaseId quando sourceDatabaseId è già specificato in modalità di ripristino

  • 400 CannotUseReservedDatabaseName: impossibile utilizzare il nome del database riservato in questa operazione.

  • 400 InvalidLongTermRetentionManagedInstanceBackupId - Identificatore di backup della conservazione a lungo termine non valido per le istanze gestite.

  • 400 MiGeoRestoreWithWbackupStorageRedundancy: Geo-Restore non è consentito per le istanze gestite con ridondanza dell'archiviazione di backup LRS/ZRS.

  • 400 UpdatingInstanceAndBackupRedundancy- La ridondanza della zona dell'istanza e la ridondanza dell'archiviazione di backup non possono essere aggiornate nella stessa richiesta.

  • 400 ProvisioningDisabled - Visualizza il messaggio di errore dell'autorizzatore dell'operazione delle risorse così come è, senza modifiche

  • 400 AadOnlyAuthenticationIsEnabled - È abilitata solo l'autenticazione di Azure Active Directory. Contattare l'amministratore di sistema.

  • 400 ManagementServiceFeatureDisabled - L'utente ha tentato di usare una funzionalità disabilitata.

  • 400 TargetServerDoesNotExist: il server di destinazione {0} non esiste o non è ancora pronto. Verificare che esista e ripetere la richiesta di ripristino.

  • 400 TargetServerRestoreNotAllowed: il server di destinazione {0} non è attualmente in uno stato che consente l'avvio di un ripristino.

  • 400 BackupSetNotFound- Non sono stati trovati backup per ripristinare il database. Contattare il supporto tecnico per ripristinare il database.

  • 400 FullBackupNotFound - Impossibile trovare il backup completo.

  • 400 MissingThumbprint : non è possibile trovare il certificato del server.

  • 400 RestoreFromStripedBackupsNotEnabled: il ripristino da backup con striping non è supportato.

  • 400 BackupSetBroken - Il set di backup è interrotto.

  • 400 BrokenRestorePlanNoFullBackup - Il piano di ripristino viene interrotto perché non è presente alcun backup completo.

  • 400 SqlRestoreError - Errore non ritentabile durante il ripristino del backup con indice {0} - {1}{2}

  • 400 BrokenRestorePlanWlationLogBackupLSN- Il piano di ripristino viene interrotto perché firstLsn del backup del log corrente non è <= lastLsn del backup del log successivo.

  • 400 BrokenRestorePlanWbackupDiffBackupLSN- Il piano di ripristino viene interrotto perché firstLsn di backup diff non è >= firstLsn del backup completo.

  • 400 BrokenRestorePlanGapInLogBackups - Il piano di ripristino viene interrotto perché firstLsn del backup del log corrente non è uguale a lastLsn del backup del log precedente.

  • 400 PartiallyContainedDatabaseUnsupported : "Il backup per un database parzialmente indipendente non è supportato".

  • 400 RequiredBackupIsNotLastRestored - Impossibile completare la migrazione perché il nome del file di backup specificato non è il nome dell'ultimo file di backup ripristinato.

  • 400 XtpInitializedDuringRestore: il filegroup ottimizzato per la memoria deve essere vuoto per poter essere ripristinato nel livello Utilizzo generico dell'istanza gestita di database SQL.

  • 400 FullBackupMissingChecksum - Il backup completo specificato non è presente.

  • 400 FullBackupDamaged - Il backup completo fornito è danneggiato.

  • 400 MissingStripeInBackupSet- Il set di backup fornito include una o più strisce mancanti.

  • 400 BrokenRestorePlanWlationDiffBaseGUID - Il piano di ripristino viene interrotto perché DifferentialBaseGuid del backup diff non corrisponde a BackupSetGuid del backup completo.

  • 400 IncompatiblePhysicalLayoutTooFewDataFiles - Il backup del database contiene un layout fisico incompatibile. Nessun file di dati trovato nel backup.

  • 400 CorruptedPagesInBackupSet - Operazione interrotta perché RESTORE ha rilevato una o più pagine danneggiate nel set di backup.

  • 400 IncompatiblePhysicalLayoutNonOnlineDataFilesExist - Il backup del database contiene un layout fisico incompatibile. Esistono file di dati non online.

  • 400 CorruptedPagesListMaintenance - Operazione interrotta perché si è verificato un errore interno durante l'elaborazione del backup eseguito senza checksum.

  • 400 IncompatiblePhysicalLayoutWintuneNumberOfLogFiles - Il backup del database contiene un layout fisico incompatibile. Non sono supportati più file di log.

  • 400 IncompatiblePhysicalLayoutNonOnlineLogFilesExist - Il backup del database contiene un layout fisico incompatibile. Esistono file di log non online.

  • 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles - Il backup del database contiene un layout fisico incompatibile. Troppi file non di dati/log.

  • 400 ExternalBackupAlreadySignaledToComplete: la richiesta di ripristino è già stata segnalata per il completamento.

  • 400 ExternalBackupRestoreHasNotBeenStarted: la richiesta di ripristino può essere completata solo dopo l'avvio del ripristino.

  • 400 ExternalBackupUpgradeInProgress - Impossibile completare la richiesta di ripristino, perché l'aggiornamento è in corso.

  • 400 IncompatiblePhysicalLayoutTooManyXTPFiles - Il backup del database contiene un layout fisico incompatibile. Più file trovati nel filegroup che contiene MEMORY_OPTIMIZED_DATA.

  • 400 BlobStorageFailure - Si è verificato un errore di archiviazione BLOB.

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart: sono presenti backup da più database nella cartella contenitore. Assicurarsi che la cartella contenitore disponga di backup da un database singolo.{0}

  • 400 ManagedIdentityIssueDetectedFromTheStart - L'identità gestita non è configurata correttamente. Verificare e riprovare.

  • 400 ManagedInstanceStorageLimitHit: l'istanza gestita ha raggiunto il limite di archiviazione.

  • 400 AutoCompleteMissingLastBackupName- La richiesta di ripristino automatico deve avere il parametro lastBackupName specificato.

  • 400 BlobStorageServerFailure - Si è verificato un errore del server di archiviazione BLOB.

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress: sono presenti backup da più database nella cartella contenitore. Assicurarsi che la cartella contenitore disponga di backup da un database singolo.{0}

  • 400 ManagedIdentityIssueDetectedWhileRestoreInProgress : l'identità gestita non è configurata correttamente. Verificare e riprovare.

  • 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

  • 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.

  • 404 ResourceNotFound: la risorsa richiesta non è stata trovata.

  • 404 CannotFindServerCertificateWithThumbprint - Impossibile trovare il certificato del server con identificazione personale '{0}'. Usare il cmdlet di PowerShell 'Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate' per creare il certificato.

  • 404 CannotFindObject - Impossibile trovare l'oggetto perché non esiste o non si dispone delle autorizzazioni

  • 404 SubscriptionNotFound - La sottoscrizione richiesta non è stata trovata.

  • 404 DatabaseDoesNotExist: l'utente ha specificato un nome di database che non esiste in questa istanza del server.

  • 404 ServerNotInSubscription - Il server specificato non esiste nella sottoscrizione specificata.

  • 404 RestoreSourceDatabaseNotFound - Impossibile trovare il database '{0}' all'ora '{1}' che può essere ripristinato.

  • 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.

  • 409 RemoteDatabaseExists: il nome del database di destinazione esiste già nel server di destinazione.

  • 409 ConflictingDatabaseOperation: nel database è già presente un'operazione e l'operazione corrente deve attendere fino a quando non viene eseguita.

  • 409 SubscriptionDisabled : la sottoscrizione è disabilitata.

  • 409 ManagementServiceDatabaseBusy - Database '{0}' è occupato con un'altra operazione. Provare l'operazione in un secondo momento.

  • 409 ConflictingSystemOperationInProgress - È in corso un'operazione di manutenzione del sistema nel database e altre operazioni devono attendere il completamento.

  • 409 ConflictingManagedInstanceOperation: un'operazione è attualmente in corso per l'istanza gestita.

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict: l'istanza è multi-az ma l'archiviazione di backup viene aggiornata dalla ridondanza della zona alla ridondanza della zona.

  • 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress - Impossibile aggiornare la ridondanza dell'istanza perché l'aggiornamento della ridondanza dell'archiviazione di backup è in corso.

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict: l'archiviazione di backup è ridondante per la zona, ma la ridondanza dell'istanza viene aggiornata con ridondanza della zona.

  • 409 BackupRedundancyUpdateConflict - Impossibile aggiornare la ridondanza dell'archiviazione di backup perché è già in corso un aggiornamento della ridondanza dell'archiviazione di backup.

  • 409 MiDropFailedOnAuthLocks - L'utente ha tentato di eliminare l'ultima istanza gestita nella subnet con blocco applicato alle risorse.

  • 409 MiCreateFailedNonDelegatedSubnet- L'utente ha tentato di distribuire Istanza gestita o pool di Istanza gestita nella subnet non delegata a Microsoft.Sql/managedInstances.

  • 412 InstanceNotReadyForBackupRedundancyUpdate - Impossibile aggiornare la ridondanza dell'archiviazione di backup perché l'istanza non è pronta.

  • 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 ConflictingSubscriptionOperation: un'operazione è attualmente in corso per la sottoscrizione.

  • 500 ActivateOrDeactivateWorkflowThrottling - L'attivazione o la disattivazione del flusso di lavoro non è riuscita perché sono presenti troppi flussi di lavoro simultanei

  • 503 DatabaseUnavailable: operazione non riuscita perché il database non è disponibile.

  • 503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 504 RequestTimeout : la richiesta di servizio ha superato il timeout consentito.

  • 504 RequestTimeout : la richiesta di servizio ha superato il timeout consentito.

Esempio

Creates a new managed database by restoring from an external backup
Creates a new managed database from restoring a geo-replicated backup
Creates a new managed database from restoring a long term retention backup
Creates a new managed database using point in time restore
Creates a new managed database with maximal properties
Creates a new managed database with minimal properties

Creates a new managed database by restoring from an external backup

Esempio di richiesta

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "properties": {
    "createMode": "RestoreExternalBackup",
    "storageContainerUri": "https://myaccountname.blob.core.windows.net/backups",
    "storageContainerSasToken": "sv=2015-12-11&sr=c&sp=rl&sig=1234",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "autoCompleteRestore": true,
    "lastBackupName": "last_backup_name"
  },
  "location": "southeastasia"
}

Risposta di esempio

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Creates a new managed database from restoring a geo-replicated backup

Esempio di richiesta

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/server1/databases/testdb_recovered?api-version=2021-11-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "Recovery",
    "recoverableDatabaseId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/Default-SQL-WestEurope/providers/Microsoft.Sql/managedInstances/testsvr/recoverableDatabases/testdb"
  }
}

Risposta di esempio

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/server1/recoverableDatabases/testdb_recovered",
  "name": "testdb_recovered",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2018-11-07T04:41:33.937Z"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/recoverableDatabases/testdb_recovered",
  "name": "testdb_recovered",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2018-11-07T04:41:33.937Z"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Creates a new managed database from restoring a long term retention backup

Esempio di richiesta

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "properties": {
    "createMode": "RestoreExternalBackup",
    "storageContainerUri": "https://myaccountname.blob.core.windows.net/backups",
    "storageContainerSasToken": "sv=2015-12-11&sr=c&sp=rl&sig=1234",
    "collation": "SQL_Latin1_General_CP1_CI_AS"
  },
  "location": "southeastasia"
}

Risposta di esempio

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Creates a new managed database using point in time restore

Esempio di richiesta

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "PointInTimeRestore",
    "sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb",
    "restorePointInTime": "2017-07-14T05:35:31.503Z"
  }
}

Risposta di esempio

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Creates a new managed database with maximal properties

Esempio di richiesta

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia"
}

Risposta di esempio

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Creates a new managed database with minimal properties

Esempio di richiesta

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "location": "southeastasia"
}

Risposta di esempio

{
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}
{
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Definizioni

Nome Descrizione
CatalogCollationType

Regole di confronto del catalogo di metadati.

ManagedDatabase

Una risorsa di database gestita.

ManagedDatabaseCreateMode

Modalità di creazione del database gestito. PointInTimeRestore: creare un database ripristinando un backup temporizzato di un database esistente. È necessario specificare SourceDatabaseName, SourceManagedInstanceName e PointInTime. RestoreExternalBackup: creare un database ripristinando da file di backup esterni. È necessario specificare regole di confronto, StorageContainerUri e StorageContainerSasToken. Ripristino: crea un database ripristinando un backup con replica geografica. RecoverableDatabaseId deve essere specificato come ID risorsa di database ripristinabile da ripristinare. RestoreLongTermRetentionBackup: creare un database ripristinando da un backup di conservazione a lungo termine (longTermRetentionBackupResourceId obbligatorio).

ManagedDatabaseStatus

Stato del database.

CatalogCollationType

Regole di confronto del catalogo di metadati.

Valore Descrizione
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

ManagedDatabase

Una risorsa di database gestita.

Nome Tipo Descrizione
id

string

ID risorsa.

location

string

Percorso della risorsa.

name

string

Nome risorsa.

properties.autoCompleteRestore

boolean

Indica se completare automaticamente il ripristino di questo database gestito.

properties.catalogCollation

CatalogCollationType

Regole di confronto del catalogo di metadati.

properties.collation

string

Regole di confronto del database gestito.

properties.createMode

ManagedDatabaseCreateMode

Modalità di creazione del database gestito. PointInTimeRestore: creare un database ripristinando un backup temporizzato di un database esistente. È necessario specificare SourceDatabaseName, SourceManagedInstanceName e PointInTime. RestoreExternalBackup: creare un database ripristinando da file di backup esterni. È necessario specificare regole di confronto, StorageContainerUri e StorageContainerSasToken. Ripristino: crea un database ripristinando un backup con replica geografica. RecoverableDatabaseId deve essere specificato come ID risorsa di database ripristinabile da ripristinare. RestoreLongTermRetentionBackup: creare un database ripristinando da un backup di conservazione a lungo termine (longTermRetentionBackupResourceId obbligatorio).

properties.creationDate

string (date-time)

Data di creazione del database.

properties.defaultSecondaryLocation

string

Area geografica associata.

properties.earliestRestorePoint

string (date-time)

Punto di ripristino meno recente nel tempo per il ripristino temporizzato.

properties.failoverGroupId

string

Identificatore di risorsa gruppo di failover dell'istanza a cui appartiene il database gestito.

properties.lastBackupName

string

Cognome del file di backup per il ripristino di questo database gestito.

properties.longTermRetentionBackupResourceId

string (arm-id)

Nome del backup di conservazione a lungo termine da usare per il ripristino di questo database gestito.

properties.recoverableDatabaseId

string (arm-id)

Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database.

properties.restorableDroppedDatabaseId

string (arm-id)

ID risorsa del database eliminato ripristinabile da ripristinare durante la creazione del database.

properties.restorePointInTime

string (date-time)

Condizionale. Se createMode è PointInTimeRestore, questo valore è obbligatorio. Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database.

properties.sourceDatabaseId

string (arm-id)

Identificatore della risorsa del database di origine associato all'operazione di creazione del database.

properties.status

ManagedDatabaseStatus

Stato del database.

properties.storageContainerSasToken

string

Condizionale. Se createMode è RestoreExternalBackup, questo valore è obbligatorio. Specifica il token di firma di accesso condiviso del contenitore di archiviazione.

properties.storageContainerUri

string

Condizionale. Se createMode è RestoreExternalBackup, questo valore è obbligatorio. Specifica l'URI del contenitore di archiviazione in cui vengono archiviati i backup per questo ripristino.

tags

object

Tag di risorsa.

type

string

Tipo di risorsa.

ManagedDatabaseCreateMode

Modalità di creazione del database gestito. PointInTimeRestore: creare un database ripristinando un backup temporizzato di un database esistente. È necessario specificare SourceDatabaseName, SourceManagedInstanceName e PointInTime. RestoreExternalBackup: creare un database ripristinando da file di backup esterni. È necessario specificare regole di confronto, StorageContainerUri e StorageContainerSasToken. Ripristino: crea un database ripristinando un backup con replica geografica. RecoverableDatabaseId deve essere specificato come ID risorsa di database ripristinabile da ripristinare. RestoreLongTermRetentionBackup: creare un database ripristinando da un backup di conservazione a lungo termine (longTermRetentionBackupResourceId obbligatorio).

Valore Descrizione
Default
PointInTimeRestore
Recovery
RestoreExternalBackup
RestoreLongTermRetentionBackup

ManagedDatabaseStatus

Stato del database.

Valore Descrizione
Creating
Inaccessible
Offline
Online
Restoring
Shutdown
Updating