Long Term Retention Backups - Remove Time Based Immutability
Rimuovere l'immutabilità basata sul tempo di un backup di conservazione a lungo termine esistente.
POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}/removeTimeBasedImmutability?api-version=2025-01-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
backup
|
path | True |
string |
Nome del backup. |
|
location
|
path | True |
string |
Posizione del database. |
|
long
|
path | True |
string |
Il nome del database. |
|
long
|
path | True |
string |
Nome del server |
|
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. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
Operazione Azure completata con successo. |
|
| 202 Accepted |
Operazione sulle risorse accettata. Intestazioni Location: string |
|
| 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
Remove time based immutability of the long term retention backup.
Esempio di richiesta
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000;Hot/removeTimeBasedImmutability?api-version=2025-01-01
Risposta di esempio
{
"name": "01234567-890a-bcde-f012-34567890abcd",
"type": "Microsoft.Sql/locations/longTermRetentionBackupOperationResults",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionBackupOperationResults/01234567-890a-bcde-f012-34567890abcd",
"properties": {}
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionBackupAzureAsyncOperation/01234567-890a-bcde-f012-34567890abcd?api-version=2025-01-01
Definizioni
| Nome | Descrizione |
|---|---|
|
Backup |
BackupStorageAccessTier per il backup con conservazione a lungo termine |
|
Backup |
Tipo di account di archiviazione usato per archiviare i backup per questo database. |
|
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 |
|
Long |
Backup di conservazione a lungo termine. |
|
Set |
L'impostazione per l'attivazione o la disabilitazione di LegalHold nel backup LTR. Quando LegalHold è abilitato, il backup non può essere eliminato fino a quando LegalHold non viene rimosso. |
|
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
|
Time |
L'impostazione per l'abilitazione o meno dell'immutabilità basata sul tempo per il backup LTR. Quando l'immutabilità basata sul tempo è abilitata e bloccata, il backup non può essere eliminato fino a BackupExpirationTime. |
|
Time |
La modalità di immutabilità basata sul tempo. Applicabile solo se l'immutabilità basata sul tempo è abilitata. |
BackupStorageAccessTier
BackupStorageAccessTier per il backup con conservazione a lungo termine
| Valore | Descrizione |
|---|---|
| Hot |
Hot |
| Archive |
Archivio |
BackupStorageRedundancy
Tipo di account di archiviazione usato per archiviare i backup per questo database.
| Valore | Descrizione |
|---|---|
| Geo |
Geo |
| Local |
Locale |
| Zone |
Zona |
| GeoZone |
GeoZone |
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. |
LongTermRetentionBackup
Backup di conservazione a lungo termine.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string (arm-id) |
ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Nome della risorsa |
| properties.backupExpirationTime |
string (date-time) |
Il periodo di scadenza del backup di conservazione a lungo termine. |
| properties.backupStorageAccessTier |
BackupStorageAccessTier per il backup con conservazione a lungo termine |
|
| properties.backupStorageRedundancy |
Tipo di ridondanza dell'archiviazione del backup |
|
| properties.backupTime |
string (date-time) |
Ora in cui è stato eseguito il backup |
| properties.databaseDeletionTime |
string (date-time) |
Ora di eliminazione del database |
| properties.databaseName |
string |
Nome del database a cui appartiene il backup |
| properties.isBackupImmutable |
boolean |
Impostazione che indica se il backup di conservazione a lungo termine non è modificabile |
| properties.legalHoldImmutability |
L'impostazione per l'attivazione o la disabilitazione di LegalHold nel backup LTR. Quando LegalHold è abilitato, il backup non può essere eliminato fino a quando LegalHold non viene rimosso. |
|
| properties.requestedBackupStorageRedundancy |
Tipo di ridondanza dell'archiviazione del backup |
|
| properties.serverCreateTime |
string (date-time) |
Ora di creazione del server. |
| properties.serverName |
string |
Nome del server a cui appartiene il database di backup. |
| properties.timeBasedImmutability |
L'impostazione per l'abilitazione o meno dell'immutabilità basata sul tempo per il backup LTR. Quando l'immutabilità basata sul tempo è abilitata e bloccata, il backup non può essere eliminato fino a BackupExpirationTime. |
|
| properties.timeBasedImmutabilityMode |
La modalità di immutabilità basata sul tempo. Applicabile solo se l'immutabilità basata sul tempo è abilitata. |
|
| systemData |
Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy. |
|
| type |
string |
Tipo di risorsa. Ad esempio: "Microsoft. Compute/virtualMachines" oppure "Microsoft. Storage/storageAccounts" |
SetLegalHoldImmutability
L'impostazione per l'attivazione o la disabilitazione di LegalHold nel backup LTR. Quando LegalHold è abilitato, il backup non può essere eliminato fino a quando LegalHold non viene rimosso.
| Valore | Descrizione |
|---|---|
| Enabled |
Enabled |
| Disabled |
Disattivato |
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. |
TimeBasedImmutability
L'impostazione per l'abilitazione o meno dell'immutabilità basata sul tempo per il backup LTR. Quando l'immutabilità basata sul tempo è abilitata e bloccata, il backup non può essere eliminato fino a BackupExpirationTime.
| Valore | Descrizione |
|---|---|
| Enabled |
Enabled |
| Disabled |
Disattivato |
TimeBasedImmutabilityMode
La modalità di immutabilità basata sul tempo. Applicabile solo se l'immutabilità basata sul tempo è abilitata.
| Valore | Descrizione |
|---|---|
| Locked |
Bloccato |
| Unlocked |
Sbloccato |