Managed Databases - Create Or Update

  • Odwołanie
Service:
SQL Database
API Version:
2021-11-01

Tworzy nową bazę danych lub aktualizuje istniejącą bazę danych.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
databaseName
 path True

string

Nazwa bazy danych.
managedInstanceName
 path True

string

Nazwa wystąpienia zarządzanego.
resourceGroupName
 path True

string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.
subscriptionId
 path True

string

Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version
 query True

string

Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa Wymagane Typ Opis
location True

string

Lokalizacja zasobu.
properties.autoCompleteRestore

boolean

Czy automatyczne przywracanie tej zarządzanej bazy danych ma być ukończone automatycznie.
properties.catalogCollation

CatalogCollationType

Sortowanie wykazu metadanych.
properties.collation

string

Sortowanie zarządzanej bazy danych.
properties.createMode

ManagedDatabaseCreateMode

Tryb tworzenia zarządzanej bazy danych. PointInTimeRestore: utwórz bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. Należy określić wartości SourceDatabaseName, SourceManagedInstanceName i PointInTime. RestoreExternalBackup: utwórz bazę danych, przywracając z zewnętrznych plików kopii zapasowej. Należy określić sortowanie, wartości StorageContainerUri i StorageContainerSasToken. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. W celu przywrócenia identyfikator zasobu bazy danych możliwy do odzyskania należy określić parametr RecoverableDatabaseId. RestoreLongTermRetentionBackup: utwórz bazę danych przez przywrócenie z kopii zapasowej długoterminowego przechowywania (wymagana wartość longTermRetentionBackupResourceId).
properties.lastBackupName

string

Ostatnia nazwa pliku kopii zapasowej na potrzeby przywracania tej zarządzanej bazy danych.
properties.longTermRetentionBackupResourceId

string

Nazwa kopii zapasowej przechowywania długoterminowego, która ma być używana do przywracania tej zarządzanej bazy danych.
properties.recoverableDatabaseId

string

Identyfikator zasobu możliwej do odzyskania bazy danych skojarzony z operacją tworzenia tej bazy danych.
properties.restorableDroppedDatabaseId

string

Przywracalny identyfikator usuniętego zasobu bazy danych do przywrócenia podczas tworzenia tej bazy danych.
properties.restorePointInTime

string

Warunkowe. Jeśli parametr createMode to PointInTimeRestore, ta wartość jest wymagana. Określa punkt w czasie (format ISO8601) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych.
properties.sourceDatabaseId

string

Identyfikator zasobu źródłowej bazy danych skojarzonej z operacją tworzenia tej bazy danych.
properties.storageContainerSasToken

string

Warunkowe. Jeśli parametr createMode to RestoreExternalBackup, ta wartość jest wymagana. Określa token sas kontenera magazynu.
properties.storageContainerUri

string

Warunkowe. Jeśli parametr createMode to RestoreExternalBackup, ta wartość jest wymagana. Określa identyfikator URI kontenera magazynu, w którym są przechowywane kopie zapasowe dla tego przywracania.
tags

object

Tagi zasobów.

Odpowiedzi

Nazwa Typ Opis
200 OK

ManagedDatabase

Pomyślnie zaktualizowano bazę danych.
201 Created

ManagedDatabase

Pomyślnie utworzono bazę danych.
202 Accepted

Zaakceptowano
Other Status Codes

Odpowiedzi na błędy: ***

  • 400 PitrPointInTimeInvalid — punkt w czasie {0} jest nieprawidłowy. Prawidłowy punkt w czasie waha się od {1} dni na początku do teraz, a nie przed czasem utworzenia serwera źródłowego.

  • 400 CannotUseTrailingWhitespacesInDatabaseName — sprawdzanie poprawności nazwy bazy danych nie powiodło się.

  • 400 StorageAccountFull — wystąpienie zarządzane osiągnęło całkowitą pojemność bazowego konta usługi Azure Storage. Konto usługi Azure Premium Storage jest ograniczone do 35 TB przydzielonego miejsca.

  • 400 AkvHostNotResolvingFromNode — host AKV "{0}" nie jest rozpoznawalny z programu SQL na serwerze "{1}".

  • 400 InvalidBackupRetentionPeriod — dni {0} przechowywania elementu nie są prawidłową konfiguracją. Prawidłowe przechowywanie kopii zapasowej w dniach musi być między {1} i {2}

  • 400 ManagedDatabaseNameInUse — baza danych "{0}" już istnieje. Wybierz inną nazwę bazy danych.

  • 400 NoMoreSpaceInManagedInstance — wystąpienie zarządzane osiągnęło limit magazynu. Użycie magazynu dla wystąpienia zarządzanego nie może przekraczać (%d) mb/s.

  • 400 ManagedInstanceUpdateSloInProgress — "Nie można ukończyć operacji, ponieważ zmiana warstwy usługi jest w toku dla wystąpienia zarządzanego "{0}". Poczekaj na zakończenie trwającej operacji i spróbuj ponownie”.

  • 400 SameKeyMaterialNotFoundOnRemoteServer — serwer pomocniczy nie ma materiału klucza ochrony szyfrowania serwera podstawowego.

  • 400 SourceDatabaseNotFound — źródłowa baza danych nie istnieje.

  • 400 RegionDoesNotSupportVersion — użytkownik próbował utworzyć serwer określonej wersji w lokalizacji, w której ta wersja serwera nie jest obsługiwana.

  • 400 PasswordNotComplex — podane hasło nie jest wystarczająco złożone.

  • 400 CannotUseReservedDatabaseName — nie można użyć nazwy zarezerwowanej bazy danych w tej operacji.

  • 400 InvalidServerName — podano nieprawidłową nazwę serwera.

  • 400 SourceServerNotFound — część serwera źródłowej bazy danych podana w wywołaniu interfejsu API CreateDatabaseAsCopy nie jest mapowana na istniejący serwer.

  • 400 TokenTooLong — podany token jest za długi.

  • 400 CurrentDatabaseSizeExceedsMaxSize — użytkownik próbował zmniejszyć maksymalny rozmiar bazy danych do rozmiaru mniejszego niż bieżące użycie.

  • 400 InvalidCollation — sortowanie nie jest rozpoznawane przez serwer.

  • 400 AkvEndpointNotReachableFromNode — punkt końcowy USŁUGI AKV "{0}" nie jest osiągalny z bazy danych SQL na serwerze "{1}".

  • 400 ServerNotFound — nie można odnaleźć żądanego serwera.

  • 400 UnsupportedServiceName — określona nazwa jest nieprawidłową nazwą, ponieważ zawiera co najmniej jeden nieobsługiwany znak Unicode.

  • 400 CurrentDatabaseLogSizeExceedsMaxSize — użytkownik próbował zmienić bazę danych na jednostkę SKU o niższym maksymalnym rozmiarze dziennika niż bieżące użycie.

  • 400 DatabaseNumberLimitReached — osiągnięto maksymalną liczbę baz danych dla wystąpienia zarządzanego SQL Database.

  • 400 InvalidDatabaseCreateOrUpdateRequest — treść żądania dla operacji tworzenia lub aktualizowania bazy danych jest nieprawidłowa.

  • 400 InvalidResourceId — nieprawidłowy identyfikator zasobu.

  • 400 InvalidSourceDatabaseId — nieprawidłowy identyfikator źródłowej bazy danych.

  • 400 InvalidRestorableDroppedDatabaseId — nieprawidłowy identyfikator usuniętej bazy danych, który można przywrócić

  • 400 MismatchingResourceGroupNameWithUrl — podana nazwa grupy zasobów nie jest zgodna z nazwą w adresie URL.

  • 400 NiezgodnośćServerNameWithUrl — podana nazwa serwera nie jest zgodna z nazwą w adresie URL.

  • 400 NiezgodnośćSubscriptionWithUrl — podana subskrypcja nie jest zgodna z subskrypcją w adresie URL.

  • 400 MissingCollation — wymagane jest sortowanie.

  • 400 MissingSourceDatabaseId — brak identyfikatora źródłowej bazy danych.

  • 400 MissingRestorePointInTime — brak punktu przywracania w czasie

  • 400 MissingStorageContainerSasToken — brak tokenu SAS kontenera magazynu

  • 400 MissingStorageContainerUri — brak identyfikatora URI kontenera magazynu

  • 400 RestoreableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId — nie można określić wartości restoreableDroppedDatabaseId, gdy parametr sourceDatabaseId jest już podany w trybie tworzenia przywracania

  • 400 CannotUseReservedDatabaseName — nie można użyć nazwy zarezerwowanej bazy danych w tej operacji.

  • 400 InvalidLongTermRetentionManagedInstanceBackupId — nieprawidłowy identyfikator kopii zapasowej długoterminowego przechowywania dla wystąpień zarządzanych.

  • 400 MiGeoRestoreWithWrongBackupStorageRedundancy — Geo-Restore nie jest dozwolona dla wystąpień zarządzanych z nadmiarowością magazynu kopii zapasowych LRS/ZRS.

  • 400 UpdatingInstanceAndBackupRedundancy — nadmiarowość strefy wystąpienia i nadmiarowość magazynu kopii zapasowych nie może zostać zaktualizowana w tym samym żądaniu.

  • 400 ProvisioningDisabled — wyświetla komunikat o błędzie z autoryzatora operacji zasobów bez zmian

  • 400 AadOnlyAuthenticationIsEnabled — włączono uwierzytelnianie tylko w usłudze Azure Active Directory. Skontaktuj się z administratorem systemu.

  • 400 ManagementServiceFeatureDisabled — użytkownik próbował użyć funkcji, która jest wyłączona.

  • 400 TargetServerDoesNotExist — serwer {0} docelowy nie istnieje lub nie jest jeszcze gotowy. Sprawdź, czy istnieje i ponów próbę żądania przywrócenia.

  • 400 TargetServerRestoreNotAllowed — serwer {0} docelowy nie jest obecnie w stanie umożliwiającym uruchomienie przywracania.

  • 400 BackupSetNotFound — nie znaleziono kopii zapasowych w celu przywrócenia bazy danych. Skontaktuj się z pomocą techniczną, aby przywrócić bazę danych.

  • 400 FullBackupNotFound — nie można odnaleźć pełnej kopii zapasowej.

  • 400 MissingThumbprint — nie można odnaleźć certyfikatu serwera.

  • 400 RestoreFromStripedBackupsNotEnabled — przywracanie z kopii zapasowych rozłożonych nie jest obsługiwane.

  • 400 BackupSetBroken — zestaw kopii zapasowych jest uszkodzony.

  • 400 BrokenRestorePlanNoFullBackup — plan przywracania jest uszkodzony, ponieważ nie ma pełnej kopii zapasowej.

  • 400 SqlRestoreError — wystąpił błąd niemożliwy do ponawiania podczas przywracania kopii zapasowej z indeksem {0} — {1}{2}

  • 400 BrokenRestorePlanWrongLogBackupLSN — plan przywracania jest uszkodzony, ponieważ pierwszylsn bieżącej kopii zapasowej dziennika nie <jest = lastLsn następnej kopii zapasowej dziennika.

  • 400 BrokenRestorePlanWrongDiffBackupLSN — plan przywracania jest uszkodzony, ponieważ pierwszylsn kopii zapasowej różnic nie >jest = firstLsn pełnej kopii zapasowej.

  • 400 BrokenRestorePlanGapInLogBackups — plan przywracania jest uszkodzony, ponieważ pierwszylsn bieżącej kopii zapasowej dziennika nie jest równy lastLsn kopii zapasowej dziennika wstępnego.

  • 400 PartiallyContainedDatabaseUnsupported — "Tworzenie kopii zapasowej częściowo zawartej bazy danych nie jest obsługiwane".

  • 400 RequiredBackupIsNotLastRestored — nie można ukończyć migracji, ponieważ podana nazwa pliku kopii zapasowej nie jest nazwą ostatniego przywróconego pliku kopii zapasowej.

  • 400 XtpInitializedDuringRestore — grupa plików zoptymalizowana pod kątem pamięci musi być pusta, aby można je było przywrócić w warstwie Ogólnego przeznaczenia wystąpienia zarządzanego SQL Database.

  • 400 FullBackupMissingChecksum — podana pełna kopia zapasowa nie zawiera sumy kontrolnej.

  • 400 FullBackupDamaged — pod warunkiem, że pełna kopia zapasowa jest uszkodzona.

  • 400 MissingStripeInBackupSet — podany zestaw kopii zapasowych ma co najmniej jeden brak pasków.

  • 400 BrokenRestorePlanWrongDiffBaseGUID — plan przywracania jest uszkodzony, ponieważ funkcja DifferentialBaseGuid kopii zapasowej różnicowej jest niezgodna z wartością BackupSetGuid pełnej kopii zapasowej.

  • 400 IncompatiblePhysicalLayoutTooFewDataFiles — kopia zapasowa bazy danych zawiera niezgodny układ fizyczny. W kopii zapasowej nie znaleziono żadnych plików danych.

  • 400 CorruptedPagesInBackupSet — operacja została przerwana, ponieważ funkcja RESTORE wykryła co najmniej jedną uszkodzoną stronę w zestawie kopii zapasowych.

  • 400 IncompatiblePhysicalLayoutNonOnlineDataFilesExist — kopia zapasowa bazy danych zawiera niezgodny układ fizyczny. Istnieją pliki danych innych niż online.

  • 400 Uszkodzone stronyListMaintenance — operacja została przerwana, ponieważ wystąpił błąd wewnętrzny podczas przetwarzania kopii zapasowej wykonanej bez sumy kontrolnej.

  • 400 IncompatiblePhysicalLayoutWrongNumberOfLogFiles — kopia zapasowa bazy danych zawiera niezgodny układ fizyczny. Wiele plików dziennika nie jest obsługiwanych.

  • 400 IncompatiblePhysicalLayoutNonOnlineLogFilesExist — kopia zapasowa bazy danych zawiera niezgodny układ fizyczny. Istnieją pliki dziennika spoza trybu online.

  • 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles — kopia zapasowa bazy danych zawiera niezgodny układ fizyczny. Zbyt wiele plików niezwiązanych z danymi/dziennikami.

  • 400 ExternalBackupAlreadySignalaledToComplete — żądanie przywrócenia zostało już zasygnalizowane do ukończenia.

  • 400 ExternalBackupRestoreHasNotBeenStarted — żądanie przywracania można wykonać tylko po rozpoczęciu przywracania.

  • 400 ExternalBackupUpgradeInProgress — nie można ukończyć żądania przywracania, ponieważ trwa uaktualnianie.

  • 400 IncompatiblePhysicalLayoutTooManyXTPFiles — kopia zapasowa bazy danych zawiera niezgodny układ fizyczny. Wiele plików znajdujących się w grupie plików zawierającej MEMORY_OPTIMIZED_DATA.

  • 400 BlobStorageFailure — wystąpił błąd magazynu obiektów blob.

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart — istnieją kopie zapasowe z wielu baz danych w folderze kontenera. Upewnij się, że folder kontenera zawiera kopie zapasowe z pojedynczej bazy danych.{0}

  • 400 ManagedIdentityIssueDetectedFromTheStart — tożsamość zarządzana nie jest poprawnie skonfigurowana. Sprawdź i spróbuj ponownie.

  • 400 ManagedInstanceStorageLimitHit — wystąpienie zarządzane osiągnęło limit magazynu.

  • 400 AutoUzupełnianieMissingLastBackupName — podano parametr lastBackupName autouzupełniania przywracania.

  • 400 BlobStorageServerFailure — wystąpił błąd serwera usługi Blob Storage.

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress — istnieją kopie zapasowe z wielu baz danych w folderze kontenera. Upewnij się, że folder kontenera zawiera kopie zapasowe z pojedynczej bazy danych.{0}

  • 400 ManagedIdentityIssueDetectedWhileRestoreInProgress — tożsamość zarządzana nie jest poprawnie skonfigurowana. Sprawdź i spróbuj ponownie.

  • 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera

  • 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

  • 404 ResourceNotFound — żądany zasób nie został znaleziony.

  • 404 CannotFindServerCertificateWithThumbprint — nie można odnaleźć certyfikatu serwera z odciskiem palca "{0}". Aby utworzyć certyfikat, użyj polecenia cmdlet programu PowerShell "Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate".

  • 404 CannotFindObject — nie można odnaleźć obiektu, ponieważ nie istnieje lub nie masz uprawnień

  • 404 SubscriptionNotFound — nie można odnaleźć żądanej subskrypcji.

  • 404 DatabaseDoesNotExist — użytkownik określił nazwę bazy danych, która nie istnieje w tym wystąpieniu serwera.

  • 404 ServerNotInSubscription — określony serwer nie istnieje w określonej subskrypcji.

  • 404 RestoreSourceDatabaseNotFound — nie można odnaleźć bazy danych "{0}" w czasie "{1}", którą można przywrócić.

  • 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

  • 409 RemoteDatabaseExists — nazwa docelowej bazy danych już istnieje na serwerze docelowym.

  • 409 ConflictingDatabaseOperation — istnieje już pewna operacja w bazie danych, a bieżąca operacja powinna czekać, aż zostanie wykonana.

  • 409 SubscriptionDisabled — subskrypcja jest wyłączona.

  • 409 ManagementServiceDatabaseBusy — baza danych "{0}" jest zajęta inną operacją. Spróbuj wykonać operację później.

  • 409 ConflictingSystemOperationInProgress — trwa operacja konserwacji systemu w bazie danych i dalsze operacje muszą czekać, aż zostanie ukończona.

  • 409 ConflictingManagedInstanceOperation — operacja jest obecnie w toku dla wystąpienia zarządzanego.

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict — wystąpienie to multi-az, ale magazyn kopii zapasowych jest aktualizowany ze strefy nadmiarowej do strefowo nadmiarowej.

  • 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress — nie można zaktualizować nadmiarowości wystąpienia, ponieważ trwa aktualizacja nadmiarowości magazynu kopii zapasowych.

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict — magazyn kopii zapasowych jest strefowo nadmiarowy, ale nadmiarowość wystąpień jest aktualizowana do strefowo nadmiarowej.

  • 409 BackupRedundancyUpdateConflict — nie można zaktualizować nadmiarowości magazynu kopii zapasowych, ponieważ trwa już aktualizacja nadmiarowości magazynu kopii zapasowych.

  • 409 MiDropFailedOnAuthLocks — użytkownik próbował usunąć ostatnie wystąpienie zarządzane w podsieci, która ma blokadę zastosowaną do zasobów.

  • 409 MiCreateFailedNonDelegatedSubnet — użytkownik próbował wdrożyć wystąpienie zarządzane lub pulę wystąpień zarządzanych w podsieci, która nie jest delegowana do usługi Microsoft.Sql/managedInstances.

  • 412 InstanceNotReadyForBackupRedundancyUpdate — nie można zaktualizować nadmiarowości magazynu kopii zapasowych, ponieważ wystąpienie nie jest gotowe.

  • 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 ConflictingSubscriptionOperation — operacja jest obecnie w toku dla subskrypcji.

  • 500 ActivateOrDeactivateWorkflowThrottling — przepływ pracy aktywacji lub dezaktywacji zakończył się niepowodzeniem, ponieważ istnieje zbyt wiele współbieżnych przepływów pracy

  • 503 DatabaseUnavailable — operacja nie powiodła się, ponieważ baza danych jest niedostępna.

  • 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 504 RequestTimeout — żądanie usługi przekroczyło dozwolony limit czasu.

  • 504 RequestTimeout — żądanie usługi przekroczyło dozwolony limit czasu.

Przykłady

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

Sample Request

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"
}

Sample Response

Status code:
200 
{
  "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"
}
Status code:
201 
{
  "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"
}
Status code:
202

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

Sample Request

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"
  }
}

Sample Response

Status code:
200 
{
  "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"
}
Status code:
201 
{
  "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"
}
Status code:
202

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

Sample Request

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"
}

Sample Response

Status code:
200 
{
  "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"
}
Status code:
201 
{
  "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"
}
Status code:
202

Creates a new managed database using point in time restore

Sample Request

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"
  }
}

Sample Response

Status code:
200 
{
  "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"
}
Status code:
201 
{
  "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"
}
Status code:
202

Creates a new managed database with maximal properties

Sample Request

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"
}

Sample Response

Status code:
200 
{
  "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"
}
Status code:
201 
{
  "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"
}
Status code:
202

Creates a new managed database with minimal properties

Sample Request

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"
}

Sample Response

Status code:
200 
{
  "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"
}
Status code:
201 
{
  "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"
}
Status code:
202

Definicje

Nazwa Opis
CatalogCollationType

Sortowanie wykazu metadanych.
ManagedDatabase

Zasób zarządzanej bazy danych.
ManagedDatabaseCreateMode

Tryb tworzenia zarządzanej bazy danych. PointInTimeRestore: utwórz bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. Należy określić wartości SourceDatabaseName, SourceManagedInstanceName i PointInTime. RestoreExternalBackup: utwórz bazę danych, przywracając z zewnętrznych plików kopii zapasowej. Należy określić sortowanie, wartości StorageContainerUri i StorageContainerSasToken. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. W celu przywrócenia identyfikator zasobu bazy danych możliwy do odzyskania należy określić parametr RecoverableDatabaseId. RestoreLongTermRetentionBackup: utwórz bazę danych przez przywrócenie z kopii zapasowej długoterminowego przechowywania (wymagana wartość longTermRetentionBackupResourceId).
ManagedDatabaseStatus

Stan bazy danych.

CatalogCollationType

Sortowanie wykazu metadanych.

Nazwa Typ Opis
DATABASE_DEFAULT

string

SQL_Latin1_General_CP1_CI_AS

string

ManagedDatabase

Zasób zarządzanej bazy danych.

Nazwa Typ Opis
id

string

Identyfikator zasobu.
location

string

Lokalizacja zasobu.
name

string

Nazwa zasobu.
properties.autoCompleteRestore

boolean

Czy automatyczne przywracanie tej zarządzanej bazy danych ma być ukończone automatycznie.
properties.catalogCollation

CatalogCollationType

Sortowanie wykazu metadanych.
properties.collation

string

Sortowanie zarządzanej bazy danych.
properties.createMode

ManagedDatabaseCreateMode

Tryb tworzenia zarządzanej bazy danych. PointInTimeRestore: utwórz bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. Należy określić wartości SourceDatabaseName, SourceManagedInstanceName i PointInTime. RestoreExternalBackup: utwórz bazę danych, przywracając z zewnętrznych plików kopii zapasowej. Należy określić sortowanie, wartości StorageContainerUri i StorageContainerSasToken. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. W celu przywrócenia identyfikator zasobu bazy danych możliwy do odzyskania należy określić parametr RecoverableDatabaseId. RestoreLongTermRetentionBackup: utwórz bazę danych przez przywrócenie z kopii zapasowej długoterminowego przechowywania (wymagana wartość longTermRetentionBackupResourceId).
properties.creationDate

string

Data utworzenia bazy danych.
properties.defaultSecondaryLocation

string

Region sparowany geograficznie.
properties.earliestRestorePoint

string

Najwcześniejszy punkt przywracania w czasie dla przywracania do punktu w czasie.
properties.failoverGroupId

string

Identyfikator zasobu grupy trybu failover wystąpienia, do którego należy ta zarządzana baza danych.
properties.lastBackupName

string

Ostatnia nazwa pliku kopii zapasowej na potrzeby przywracania tej zarządzanej bazy danych.
properties.longTermRetentionBackupResourceId

string

Nazwa kopii zapasowej przechowywania długoterminowego, która ma być używana do przywracania tej zarządzanej bazy danych.
properties.recoverableDatabaseId

string

Identyfikator zasobu możliwej do odzyskania bazy danych skojarzony z operacją tworzenia tej bazy danych.
properties.restorableDroppedDatabaseId

string

Przywracalny identyfikator usuniętego zasobu bazy danych do przywrócenia podczas tworzenia tej bazy danych.
properties.restorePointInTime

string

Warunkowe. Jeśli parametr createMode to PointInTimeRestore, ta wartość jest wymagana. Określa punkt w czasie (format ISO8601) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych.
properties.sourceDatabaseId

string

Identyfikator zasobu źródłowej bazy danych skojarzonej z operacją tworzenia tej bazy danych.
properties.status

ManagedDatabaseStatus

Stan bazy danych.
properties.storageContainerSasToken

string

Warunkowe. Jeśli parametr createMode to RestoreExternalBackup, ta wartość jest wymagana. Określa token sas kontenera magazynu.
properties.storageContainerUri

string

Warunkowe. Jeśli parametr createMode to RestoreExternalBackup, ta wartość jest wymagana. Określa identyfikator URI kontenera magazynu, w którym są przechowywane kopie zapasowe dla tego przywracania.
tags

object

Tagi zasobów.
type

string

Typ zasobu.

ManagedDatabaseCreateMode

Tryb tworzenia zarządzanej bazy danych. PointInTimeRestore: utwórz bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. Należy określić wartości SourceDatabaseName, SourceManagedInstanceName i PointInTime. RestoreExternalBackup: utwórz bazę danych, przywracając z zewnętrznych plików kopii zapasowej. Należy określić sortowanie, wartości StorageContainerUri i StorageContainerSasToken. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. W celu przywrócenia identyfikator zasobu bazy danych możliwy do odzyskania należy określić parametr RecoverableDatabaseId. RestoreLongTermRetentionBackup: utwórz bazę danych przez przywrócenie z kopii zapasowej długoterminowego przechowywania (wymagana wartość longTermRetentionBackupResourceId).

Nazwa Typ Opis
Default

string

PointInTimeRestore

string

Recovery

string

RestoreExternalBackup

string

RestoreLongTermRetentionBackup

string

ManagedDatabaseStatus

Stan bazy danych.

Nazwa Typ Opis
Creating

string

Inaccessible

string

Offline

string

Online

string

Restoring

string

Shutdown

string

Updating

string