Managed Databases - Update
Aktualizuje existující databázi.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2023-08-01
Parametry identifikátoru URI
| Name | V | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
database
|
path | True |
string |
Název databáze. |
|
managed
|
path | True |
string |
Název spravované instance. |
|
resource
|
path | True |
string |
Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo portálu. |
|
subscription
|
path | True |
string |
ID předplatného, které identifikuje předplatné Azure. |
|
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro požadavek. |
Text požadavku
| Name | Typ | Description |
|---|---|---|
| properties.autoCompleteRestore |
boolean |
Určuje, jestli se má automaticky dokončit obnovení této spravované databáze. |
| properties.catalogCollation |
Kolace katalogu metadat. |
|
| properties.collation |
string |
Kolace spravované databáze. |
| properties.createMode |
Režim vytvoření spravované databáze PointInTimeRestore: Vytvořte databázi obnovením zálohy existující databáze k určitému bodu v čase. Je nutné zadat SourceDatabaseName, SourceManagedInstanceName a PointInTime. RestoreExternalBackup: Vytvořte databázi obnovením z externích záložních souborů. Musí být zadány kolace, StorageContainerUri a StorageContainerSasToken. Obnovení: Vytvoří databázi obnovením geograficky replikované zálohy. Obnovitelné Id prostředku databáze musí být zadáno jako ID obnovitelného databázového prostředku. RestoreLongTermRetentionBackup: Vytvořte databázi obnovením z dlouhodobé zálohy uchovávání (vyžaduje se longTermRetentionBackupResourceId). |
|
| properties.crossSubscriptionRestorableDroppedDatabaseId |
string |
Obnovitelné ID prostředku databáze vyřazeného mezi předplatnými, které se má obnovit při vytváření této databáze. |
| properties.crossSubscriptionSourceDatabaseId |
string |
Identifikátor prostředku zdrojové databáze mezi předplatnými přidružený k operaci vytvoření této databáze. |
| properties.crossSubscriptionTargetManagedInstanceId |
string |
ID cílové spravované instance použité při obnovení mezi předplatnými |
| properties.isLedgerOn |
boolean |
Bez ohledu na to, jestli se jedná o databázi registru, znamená to, že všechny tabulky v databázi jsou tabulky registru. Poznámka: Hodnotu této vlastnosti nelze po vytvoření databáze změnit. |
| properties.lastBackupName |
string |
Název posledního záložního souboru pro obnovení této spravované databáze. |
| properties.longTermRetentionBackupResourceId |
string |
Název zálohy dlouhodobého uchovávání, který se má použít k obnovení této spravované databáze. |
| properties.recoverableDatabaseId |
string |
Identifikátor prostředku obnovitelné databáze přidružené k operaci vytvoření této databáze. |
| properties.restorableDroppedDatabaseId |
string |
Id obnovovatelného vyřazeného prostředku databáze, které se má obnovit při vytváření této databáze. |
| properties.restorePointInTime |
string (date-time) |
Podmíněný. Pokud je createMode PointInTimeRestore, je tato hodnota povinná. Určuje bod v čase (formát ISO8601) zdrojové databáze, která se obnoví a vytvoří novou databázi. |
| properties.sourceDatabaseId |
string |
Identifikátor prostředku zdrojové databáze přidružené k operaci vytvoření této databáze. |
| properties.storageContainerIdentity |
string |
Podmíněný. Pokud createMode je RestoreExternalBackup, použije se tato hodnota. Určuje identitu použitou pro ověřování kontejneru úložiště. Může být SharedAccessSignature nebo ManagedIdentity; Pokud není zadán parametr SharedAccessSignature, předpokládá se. |
| properties.storageContainerSasToken |
string |
Podmíněný. Pokud createMode je RestoreExternalBackup a storageContainerIdentity není ManagedIdentity, je tato hodnota povinná. Určuje token SAS kontejneru úložiště. |
| properties.storageContainerUri |
string |
Podmíněný. Pokud createMode je RestoreExternalBackup, je tato hodnota povinná. Určuje identifikátor URI kontejneru úložiště, ve kterém jsou uloženy zálohy pro toto obnovení. |
| tags |
object |
Značky prostředků |
Odpovědi
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Databáze byla úspěšně aktualizována. |
|
| 202 Accepted |
Probíhá aktualizace spravované databáze. Hlavičky Location: string |
|
| Other Status Codes |
Chybové odpovědi: ***
|
Příklady
| Updates a managed database with maximal properties |
| Updates a managed database with minimal properties |
Updates a managed database with maximal properties
Ukázkový požadavek
PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/testdb?api-version=2023-08-01
{
"tags": {
"tagKey1": "TagValue1"
}
}
Ukázková odpověď
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
"name": "testdb"
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/locations/southeastasia/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-03-01
Updates a managed database with minimal properties
Ukázkový požadavek
PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/testdb?api-version=2023-08-01
{
"tags": {
"tagKey1": "TagValue1"
}
}
Ukázková odpověď
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "southeastasia",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
"name": "testdb"
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/locations/southeastasia/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-03-01
Definice
| Name | Description |
|---|---|
|
Catalog |
Kolace katalogu metadat. |
|
Error |
Další informace o chybě správy prostředků |
|
Error |
Podrobnosti o chybě. |
|
Error |
Chybová odpověď |
|
Managed |
Spravovaný databázový prostředek. |
|
Managed |
Režim vytvoření spravované databáze PointInTimeRestore: Vytvořte databázi obnovením zálohy existující databáze k určitému bodu v čase. Je nutné zadat SourceDatabaseName, SourceManagedInstanceName a PointInTime. RestoreExternalBackup: Vytvořte databázi obnovením z externích záložních souborů. Musí být zadány kolace, StorageContainerUri a StorageContainerSasToken. Obnovení: Vytvoří databázi obnovením geograficky replikované zálohy. Obnovitelné Id prostředku databáze musí být zadáno jako ID obnovitelného databázového prostředku. RestoreLongTermRetentionBackup: Vytvořte databázi obnovením z dlouhodobé zálohy uchovávání (vyžaduje se longTermRetentionBackupResourceId). |
|
Managed |
Stav databáze. |
|
Managed |
Aktualizace spravované databáze. |
CatalogCollationType
Kolace katalogu metadat.
| Hodnota | Description |
|---|---|
| DATABASE_DEFAULT | |
| SQL_Latin1_General_CP1_CI_AS |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
| Name | Typ | Description |
|---|---|---|
| info |
object |
Další informace. |
| type |
string |
Další typ informací. |
ErrorDetail
Podrobnosti o chybě.
| Name | Typ | Description |
|---|---|---|
| additionalInfo |
Další informace o chybě. |
|
| code |
string |
Kód chyby. |
| details |
Podrobnosti o chybě. |
|
| message |
string |
Chybová zpráva. |
| target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
| Name | Typ | Description |
|---|---|---|
| error |
Objekt chyby. |
ManagedDatabase
Spravovaný databázový prostředek.
| Name | Typ | Description |
|---|---|---|
| id |
string |
ID prostředku. |
| location |
string |
Umístění prostředku |
| name |
string |
Název prostředku |
| properties.autoCompleteRestore |
boolean |
Určuje, jestli se má automaticky dokončit obnovení této spravované databáze. |
| properties.catalogCollation |
Kolace katalogu metadat. |
|
| properties.collation |
string |
Kolace spravované databáze. |
| properties.createMode |
Režim vytvoření spravované databáze PointInTimeRestore: Vytvořte databázi obnovením zálohy existující databáze k určitému bodu v čase. Je nutné zadat SourceDatabaseName, SourceManagedInstanceName a PointInTime. RestoreExternalBackup: Vytvořte databázi obnovením z externích záložních souborů. Musí být zadány kolace, StorageContainerUri a StorageContainerSasToken. Obnovení: Vytvoří databázi obnovením geograficky replikované zálohy. Obnovitelné Id prostředku databáze musí být zadáno jako ID obnovitelného databázového prostředku. RestoreLongTermRetentionBackup: Vytvořte databázi obnovením z dlouhodobé zálohy uchovávání (vyžaduje se longTermRetentionBackupResourceId). |
|
| properties.creationDate |
string (date-time) |
Datum vytvoření databáze. |
| properties.crossSubscriptionRestorableDroppedDatabaseId |
string |
Obnovitelné ID prostředku databáze vyřazeného mezi předplatnými, které se má obnovit při vytváření této databáze. |
| properties.crossSubscriptionSourceDatabaseId |
string |
Identifikátor prostředku zdrojové databáze mezi předplatnými přidružený k operaci vytvoření této databáze. |
| properties.crossSubscriptionTargetManagedInstanceId |
string |
ID cílové spravované instance použité při obnovení mezi předplatnými |
| properties.defaultSecondaryLocation |
string |
Geograficky spárovaná oblast |
| properties.earliestRestorePoint |
string (date-time) |
Nejstarší bod obnovení v čase pro obnovení k určitému bodu v čase. |
| properties.failoverGroupId |
string |
Identifikátor prostředku skupiny převzetí služeb při selhání instance, do kterého tato spravovaná databáze patří. |
| properties.isLedgerOn |
boolean |
Bez ohledu na to, jestli se jedná o databázi registru, znamená to, že všechny tabulky v databázi jsou tabulky registru. Poznámka: Hodnotu této vlastnosti nelze po vytvoření databáze změnit. |
| properties.lastBackupName |
string |
Název posledního záložního souboru pro obnovení této spravované databáze. |
| properties.longTermRetentionBackupResourceId |
string |
Název zálohy dlouhodobého uchovávání, který se má použít k obnovení této spravované databáze. |
| properties.recoverableDatabaseId |
string |
Identifikátor prostředku obnovitelné databáze přidružené k operaci vytvoření této databáze. |
| properties.restorableDroppedDatabaseId |
string |
Id obnovovatelného vyřazeného prostředku databáze, které se má obnovit při vytváření této databáze. |
| properties.restorePointInTime |
string (date-time) |
Podmíněný. Pokud je createMode PointInTimeRestore, je tato hodnota povinná. Určuje bod v čase (formát ISO8601) zdrojové databáze, která se obnoví a vytvoří novou databázi. |
| properties.sourceDatabaseId |
string |
Identifikátor prostředku zdrojové databáze přidružené k operaci vytvoření této databáze. |
| properties.status |
Stav databáze. |
|
| properties.storageContainerIdentity |
string |
Podmíněný. Pokud createMode je RestoreExternalBackup, použije se tato hodnota. Určuje identitu použitou pro ověřování kontejneru úložiště. Může být SharedAccessSignature nebo ManagedIdentity; Pokud není zadán parametr SharedAccessSignature, předpokládá se. |
| properties.storageContainerSasToken |
string |
Podmíněný. Pokud createMode je RestoreExternalBackup a storageContainerIdentity není ManagedIdentity, je tato hodnota povinná. Určuje token SAS kontejneru úložiště. |
| properties.storageContainerUri |
string |
Podmíněný. Pokud createMode je RestoreExternalBackup, je tato hodnota povinná. Určuje identifikátor URI kontejneru úložiště, ve kterém jsou uloženy zálohy pro toto obnovení. |
| tags |
object |
Značky prostředků |
| type |
string |
Typ prostředku. |
ManagedDatabaseCreateMode
Režim vytvoření spravované databáze PointInTimeRestore: Vytvořte databázi obnovením zálohy existující databáze k určitému bodu v čase. Je nutné zadat SourceDatabaseName, SourceManagedInstanceName a PointInTime. RestoreExternalBackup: Vytvořte databázi obnovením z externích záložních souborů. Musí být zadány kolace, StorageContainerUri a StorageContainerSasToken. Obnovení: Vytvoří databázi obnovením geograficky replikované zálohy. Obnovitelné Id prostředku databáze musí být zadáno jako ID obnovitelného databázového prostředku. RestoreLongTermRetentionBackup: Vytvořte databázi obnovením z dlouhodobé zálohy uchovávání (vyžaduje se longTermRetentionBackupResourceId).
| Hodnota | Description |
|---|---|
| Default | |
| RestoreExternalBackup | |
| PointInTimeRestore | |
| Recovery | |
| RestoreLongTermRetentionBackup |
ManagedDatabaseStatus
Stav databáze.
| Hodnota | Description |
|---|---|
| Online | |
| Offline | |
| Shutdown | |
| Creating | |
| Inaccessible | |
| Restoring | |
| Updating | |
| Stopping | |
| Stopped | |
| Starting | |
| DbMoving | |
| DbCopying |
ManagedDatabaseUpdate
Aktualizace spravované databáze.
| Name | Typ | Description |
|---|---|---|
| properties.autoCompleteRestore |
boolean |
Určuje, jestli se má automaticky dokončit obnovení této spravované databáze. |
| properties.catalogCollation |
Kolace katalogu metadat. |
|
| properties.collation |
string |
Kolace spravované databáze. |
| properties.createMode |
Režim vytvoření spravované databáze PointInTimeRestore: Vytvořte databázi obnovením zálohy existující databáze k určitému bodu v čase. Je nutné zadat SourceDatabaseName, SourceManagedInstanceName a PointInTime. RestoreExternalBackup: Vytvořte databázi obnovením z externích záložních souborů. Musí být zadány kolace, StorageContainerUri a StorageContainerSasToken. Obnovení: Vytvoří databázi obnovením geograficky replikované zálohy. Obnovitelné Id prostředku databáze musí být zadáno jako ID obnovitelného databázového prostředku. RestoreLongTermRetentionBackup: Vytvořte databázi obnovením z dlouhodobé zálohy uchovávání (vyžaduje se longTermRetentionBackupResourceId). |
|
| properties.creationDate |
string (date-time) |
Datum vytvoření databáze. |
| properties.crossSubscriptionRestorableDroppedDatabaseId |
string |
Obnovitelné ID prostředku databáze vyřazeného mezi předplatnými, které se má obnovit při vytváření této databáze. |
| properties.crossSubscriptionSourceDatabaseId |
string |
Identifikátor prostředku zdrojové databáze mezi předplatnými přidružený k operaci vytvoření této databáze. |
| properties.crossSubscriptionTargetManagedInstanceId |
string |
ID cílové spravované instance použité při obnovení mezi předplatnými |
| properties.defaultSecondaryLocation |
string |
Geograficky spárovaná oblast |
| properties.earliestRestorePoint |
string (date-time) |
Nejstarší bod obnovení v čase pro obnovení k určitému bodu v čase. |
| properties.failoverGroupId |
string |
Identifikátor prostředku skupiny převzetí služeb při selhání instance, do kterého tato spravovaná databáze patří. |
| properties.isLedgerOn |
boolean |
Bez ohledu na to, jestli se jedná o databázi registru, znamená to, že všechny tabulky v databázi jsou tabulky registru. Poznámka: Hodnotu této vlastnosti nelze po vytvoření databáze změnit. |
| properties.lastBackupName |
string |
Název posledního záložního souboru pro obnovení této spravované databáze. |
| properties.longTermRetentionBackupResourceId |
string |
Název zálohy dlouhodobého uchovávání, který se má použít k obnovení této spravované databáze. |
| properties.recoverableDatabaseId |
string |
Identifikátor prostředku obnovitelné databáze přidružené k operaci vytvoření této databáze. |
| properties.restorableDroppedDatabaseId |
string |
Id obnovovatelného vyřazeného prostředku databáze, které se má obnovit při vytváření této databáze. |
| properties.restorePointInTime |
string (date-time) |
Podmíněný. Pokud je createMode PointInTimeRestore, je tato hodnota povinná. Určuje bod v čase (formát ISO8601) zdrojové databáze, která se obnoví a vytvoří novou databázi. |
| properties.sourceDatabaseId |
string |
Identifikátor prostředku zdrojové databáze přidružené k operaci vytvoření této databáze. |
| properties.status |
Stav databáze. |
|
| properties.storageContainerIdentity |
string |
Podmíněný. Pokud createMode je RestoreExternalBackup, použije se tato hodnota. Určuje identitu použitou pro ověřování kontejneru úložiště. Může být SharedAccessSignature nebo ManagedIdentity; Pokud není zadán parametr SharedAccessSignature, předpokládá se. |
| properties.storageContainerSasToken |
string |
Podmíněný. Pokud createMode je RestoreExternalBackup a storageContainerIdentity není ManagedIdentity, je tato hodnota povinná. Určuje token SAS kontejneru úložiště. |
| properties.storageContainerUri |
string |
Podmíněný. Pokud createMode je RestoreExternalBackup, je tato hodnota povinná. Určuje identifikátor URI kontejneru úložiště, ve kterém jsou uloženy zálohy pro toto obnovení. |
| tags |
object |
Značky prostředků |