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
backupName
path True

string

Nome del backup.

locationName
path True

string

Posizione del database.

longTermRetentionDatabaseName
path True

string

Il nome del database.

longTermRetentionServerName
path True

string

Nome del server

subscriptionId
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

LongTermRetentionBackup

Operazione Azure completata con successo.

202 Accepted

Operazione sulle risorse accettata.

Intestazioni

Location: string

Other Status Codes

ErrorResponse

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
BackupStorageAccessTier

BackupStorageAccessTier per il backup con conservazione a lungo termine

BackupStorageRedundancy

Tipo di account di archiviazione usato per archiviare i backup per questo database.

createdByType

Tipo di identità che ha creato la risorsa.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

LongTermRetentionBackup

Backup di conservazione a lungo termine.

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.

systemData

Metadati relativi alla creazione e all'ultima modifica della 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.

TimeBasedImmutabilityMode

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

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

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

BackupStorageAccessTier per il backup con conservazione a lungo termine

properties.backupStorageRedundancy

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

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.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

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

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

TimeBasedImmutabilityMode

La modalità di immutabilità basata sul tempo. Applicabile solo se l'immutabilità basata sul tempo è abilitata.

systemData

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

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

createdByType

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