Managed Databases - Update
Aggiorna un database esistente.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2025-01-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
database
|
path | True |
string |
Nome del database. |
|
managed
|
path | True |
string |
Nome dell'istanza gestita. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole. |
|
subscription
|
path | True |
string (uuid) |
ID della sottoscrizione di destinazione. Il valore deve essere un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
| Nome | Tipo | Descrizione |
|---|---|---|
| properties.autoCompleteRestore |
boolean |
Indica se completare automaticamente il ripristino di questo database gestito. |
| properties.catalogCollation |
Regole di confronto del catalogo di metadati. |
|
| properties.collation |
string |
Regole di confronto del database gestito. |
| properties.createMode |
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.crossSubscriptionRestorableDroppedDatabaseId |
string |
L'ID risorsa del database rimosso tra sottoscrizioni ripristinabili per il ripristino durante la creazione di questo database. |
| properties.crossSubscriptionSourceDatabaseId |
string |
Identificatore della risorsa del database di origine tra sottoscrizioni associato all'operazione di creazione del database. |
| properties.crossSubscriptionTargetManagedInstanceId |
string |
ID istanza gestita di destinazione usato nel ripristino tra sottoscrizioni. |
| properties.isLedgerOn |
boolean |
Indipendentemente dal fatto che questo database sia un database libro mastro, ovvero tutte le tabelle del database sono tabelle libro mastro. Nota: il valore di questa proprietà non può essere modificato dopo la creazione del database. |
| properties.lastBackupName |
string |
Cognome del file di backup per il ripristino di questo database gestito. |
| properties.longTermRetentionBackupResourceId |
string |
Nome del backup di conservazione a lungo termine da usare per il ripristino di questo database gestito. |
| properties.recoverableDatabaseId |
string |
Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database. |
| properties.restorableDroppedDatabaseId |
string |
ID risorsa del database eliminato ripristinabile da ripristinare durante la creazione del database. |
| properties.restorePointInTime |
string (date-time) |
Conditional. 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 |
Identificatore della risorsa del database di origine associato all'operazione di creazione del database. |
| properties.storageContainerIdentity |
string |
Conditional. Se createMode è RestoreExternalBackup, questo valore viene usato. Specifica l'identità usata per l'autenticazione del contenitore di archiviazione. Può essere 'SharedAccessSignature' o 'ManagedIdentity'; se non è specificato 'SharedAccessSignature' viene utilizzato. |
| properties.storageContainerSasToken |
string |
Conditional. Se createMode è RestoreExternalBackup e storageContainerIdentity non è ManagedIdentity, questo valore è obbligatorio. Specifica il token di firma di accesso condiviso del contenitore di archiviazione. |
| properties.storageContainerUri |
string |
Conditional. 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 |
Operazione Azure completata con successo. |
|
| 202 Accepted |
Richiesta di aggiornamento delle risorse accettata. Intestazioni
|
|
| Other Status Codes |
Risposta di errore imprevista. |
Sicurezza
azure_auth
Azure Active Directory OAuth2 Flow.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | rappresentare l'account utente |
Esempio
| Updates a managed database with maximal properties |
| Updates a managed database with minimal properties |
Updates a managed database with maximal properties
Esempio di richiesta
Risposta di esempio
{
"name": "testdb",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
"location": "southeastasia",
"tags": {
"tagKey1": "TagValue1"
}
}
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
Esempio di richiesta
Risposta di esempio
{
"name": "testdb",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
"location": "southeastasia",
"tags": {
"tagKey1": "TagValue1"
}
}
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
Definizioni
| Nome | Descrizione |
|---|---|
|
Catalog |
Regole di confronto del catalogo di metadati. |
|
created |
Tipo di identità che ha creato la risorsa. |
|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
|
Error |
Dettagli dell'errore. |
|
Error |
Risposta di errore |
|
Inaccessibility |
Tipo di causa principale. I valori consentiti sono "TransparentDataEncryption", "DatabaseReplication" e "Unknown". |
|
Managed |
Una risorsa di database gestita. |
|
Managed |
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). |
|
Managed |
Informazioni sull'accessibilità estesa del database gestito |
|
Managed |
Stato del database. |
|
Managed |
Aggiornamento del database gestito. |
|
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
CatalogCollationType
Regole di confronto del catalogo di metadati.
| Valore | Descrizione |
|---|---|
| DATABASE_DEFAULT |
DATABASE_DEFAULT |
| SQL_Latin1_General_CP1_CI_AS |
SQL_Latin1_General_CP1_CI_AS |
createdByType
Tipo di identità che ha creato la risorsa.
| Valore | Descrizione |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
| Nome | Tipo | Descrizione |
|---|---|---|
| info |
object |
Informazioni aggiuntive. |
| type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'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. |
ErrorResponse
Risposta di errore
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Oggetto error. |
InaccessibilityReason
Tipo di causa principale. I valori consentiti sono "TransparentDataEncryption", "DatabaseReplication" e "Unknown".
| Valore | Descrizione |
|---|---|
| Unknown |
Sconosciuto |
| TransparentDataEncryption |
Crittografia TransparentData |
| DatabaseReplication |
Replicazione del database |
ManagedDatabase
Una risorsa di database gestita.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string (arm-id) |
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.autoCompleteRestore |
boolean |
Indica se completare automaticamente il ripristino di questo database gestito. |
| properties.catalogCollation |
Regole di confronto del catalogo di metadati. |
|
| properties.collation |
string |
Regole di confronto del database gestito. |
| properties.createMode |
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.crossSubscriptionRestorableDroppedDatabaseId |
string |
L'ID risorsa del database rimosso tra sottoscrizioni ripristinabili per il ripristino durante la creazione di questo database. |
| properties.crossSubscriptionSourceDatabaseId |
string |
Identificatore della risorsa del database di origine tra sottoscrizioni associato all'operazione di creazione del database. |
| properties.crossSubscriptionTargetManagedInstanceId |
string |
ID istanza gestita di destinazione usato nel ripristino tra sottoscrizioni. |
| properties.defaultSecondaryLocation |
string |
Area geografica associata. |
| properties.earliestRestorePoint |
string (date-time) |
Punto di ripristino meno recente nel tempo per il ripristino temporizzato. |
| properties.extendedAccessibilityInfo |
Ulteriori informazioni sull'osservabilità e sulla risoluzione dei problemi per i database in stato "Inaccessibile". |
|
| properties.failoverGroupId |
string |
Identificatore di risorsa gruppo di failover dell'istanza a cui appartiene il database gestito. |
| properties.isLedgerOn |
boolean |
Indipendentemente dal fatto che questo database sia un database libro mastro, ovvero tutte le tabelle del database sono tabelle libro mastro. Nota: il valore di questa proprietà non può essere modificato dopo la creazione del database. |
| properties.lastBackupName |
string |
Cognome del file di backup per il ripristino di questo database gestito. |
| properties.longTermRetentionBackupResourceId |
string |
Nome del backup di conservazione a lungo termine da usare per il ripristino di questo database gestito. |
| properties.recoverableDatabaseId |
string |
Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database. |
| properties.restorableDroppedDatabaseId |
string |
ID risorsa del database eliminato ripristinabile da ripristinare durante la creazione del database. |
| properties.restorePointInTime |
string (date-time) |
Conditional. 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 |
Identificatore della risorsa del database di origine associato all'operazione di creazione del database. |
| properties.status |
Stato del database. |
|
| properties.storageContainerIdentity |
string |
Conditional. Se createMode è RestoreExternalBackup, questo valore viene usato. Specifica l'identità usata per l'autenticazione del contenitore di archiviazione. Può essere 'SharedAccessSignature' o 'ManagedIdentity'; se non è specificato 'SharedAccessSignature' viene utilizzato. |
| properties.storageContainerSasToken |
string |
Conditional. Se createMode è RestoreExternalBackup e storageContainerIdentity non è ManagedIdentity, questo valore è obbligatorio. Specifica il token di firma di accesso condiviso del contenitore di archiviazione. |
| properties.storageContainerUri |
string |
Conditional. Se createMode è RestoreExternalBackup, questo valore è obbligatorio. Specifica l'URI del contenitore di archiviazione in cui vengono archiviati i backup per questo ripristino. |
| systemData |
Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy. |
|
| tags |
object |
Tag di risorsa. |
| type |
string |
Tipo di risorsa. Ad esempio: "Microsoft. Compute/virtualMachines" oppure "Microsoft. Storage/storageAccounts" |
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 |
Valore predefinito |
| RestoreExternalBackup |
RestoreExternalBackup |
| PointInTimeRestore |
PointInTimeRestore |
| Recovery |
Recupero |
| RestoreLongTermRetentionBackup |
RipristinoLongtermRetentionBackup |
ManagedDatabaseExtendedAccessibilityInfo
Informazioni sull'accessibilità estesa del database gestito
| Nome | Tipo | Descrizione |
|---|---|---|
| inaccessibilityReasonDescription |
string |
Spiegazione della causa principale e azione di mitigazione. |
| inaccessibilityReasonErrorCode |
string |
Codice di errore di SQL Server collegato alla causa principale dell'inaccessibilità. |
| inaccessibilityReasonKind |
Tipo di causa principale. I valori consentiti sono "TransparentDataEncryption", "DatabaseReplication" e "Unknown". |
|
| inaccessibilityReasonTdeKeyUri |
string |
Per il tipo di causa radice "TransparentDataEncryption", l'URI CMK. |
ManagedDatabaseStatus
Stato del database.
| Valore | Descrizione |
|---|---|
| Online |
In linea |
| Offline |
Offline |
| Shutdown |
Spegnimento |
| Creating |
Creazione |
| Inaccessible |
Inaccessibile |
| Restoring |
Ripristino |
| Updating |
Aggiornamento |
| Stopping |
Interruzione |
| Stopped |
Fermato |
| Starting |
Inizio |
| DbMoving |
DbMoving |
| DbCopying |
Copia di DbCopiatura |
ManagedDatabaseUpdate
Aggiornamento del database gestito.
| Nome | Tipo | Descrizione |
|---|---|---|
| properties.autoCompleteRestore |
boolean |
Indica se completare automaticamente il ripristino di questo database gestito. |
| properties.catalogCollation |
Regole di confronto del catalogo di metadati. |
|
| properties.collation |
string |
Regole di confronto del database gestito. |
| properties.createMode |
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.crossSubscriptionRestorableDroppedDatabaseId |
string |
L'ID risorsa del database rimosso tra sottoscrizioni ripristinabili per il ripristino durante la creazione di questo database. |
| properties.crossSubscriptionSourceDatabaseId |
string |
Identificatore della risorsa del database di origine tra sottoscrizioni associato all'operazione di creazione del database. |
| properties.crossSubscriptionTargetManagedInstanceId |
string |
ID istanza gestita di destinazione usato nel ripristino tra sottoscrizioni. |
| properties.defaultSecondaryLocation |
string |
Area geografica associata. |
| properties.earliestRestorePoint |
string (date-time) |
Punto di ripristino meno recente nel tempo per il ripristino temporizzato. |
| properties.extendedAccessibilityInfo |
Ulteriori informazioni sull'osservabilità e sulla risoluzione dei problemi per i database in stato "Inaccessibile". |
|
| properties.failoverGroupId |
string |
Identificatore di risorsa gruppo di failover dell'istanza a cui appartiene il database gestito. |
| properties.isLedgerOn |
boolean |
Indipendentemente dal fatto che questo database sia un database libro mastro, ovvero tutte le tabelle del database sono tabelle libro mastro. Nota: il valore di questa proprietà non può essere modificato dopo la creazione del database. |
| properties.lastBackupName |
string |
Cognome del file di backup per il ripristino di questo database gestito. |
| properties.longTermRetentionBackupResourceId |
string |
Nome del backup di conservazione a lungo termine da usare per il ripristino di questo database gestito. |
| properties.recoverableDatabaseId |
string |
Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database. |
| properties.restorableDroppedDatabaseId |
string |
ID risorsa del database eliminato ripristinabile da ripristinare durante la creazione del database. |
| properties.restorePointInTime |
string (date-time) |
Conditional. 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 |
Identificatore della risorsa del database di origine associato all'operazione di creazione del database. |
| properties.status |
Stato del database. |
|
| properties.storageContainerIdentity |
string |
Conditional. Se createMode è RestoreExternalBackup, questo valore viene usato. Specifica l'identità usata per l'autenticazione del contenitore di archiviazione. Può essere 'SharedAccessSignature' o 'ManagedIdentity'; se non è specificato 'SharedAccessSignature' viene utilizzato. |
| properties.storageContainerSasToken |
string |
Conditional. Se createMode è RestoreExternalBackup e storageContainerIdentity non è ManagedIdentity, questo valore è obbligatorio. Specifica il token di firma di accesso condiviso del contenitore di archiviazione. |
| properties.storageContainerUri |
string |
Conditional. 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. |
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) |
Il 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. |