Long Term Retention Backups - Remove Time Based Immutability

Supprimez l’immuabilité basée sur le temps d’une sauvegarde de rétention à long terme existante.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}/removeTimeBasedImmutability?api-version=2025-01-01

Paramètres URI

Nom Dans Obligatoire Type Description
backupName
path True

string

Nom de sauvegarde.

locationName
path True

string

Emplacement de la base de données.

longTermRetentionDatabaseName
path True

string

Le nom de la base de données,

longTermRetentionServerName
path True

string

Nom du serveur

subscriptionId
path True

string (uuid)

ID de l’abonnement cible. La valeur doit être un UUID.

api-version
query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.

Réponses

Nom Type Description
200 OK

LongTermRetentionBackup

Opération Azure terminée avec succès.

202 Accepted

Exploitation des ressources acceptée.

En-têtes

Location: string

Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

Remove time based immutability of the long term retention backup.

Exemple de requête

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

Exemple de réponse

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

Définitions

Nom Description
BackupStorageAccessTier

BackupStorageAccessTier pour la sauvegarde LTR

BackupStorageRedundancy

Type de compte de stockage utilisé pour stocker des sauvegardes pour cette base de données.

createdByType

Type d’identité qui a créé la ressource.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

LongTermRetentionBackup

Sauvegarde de rétention à long terme.

SetLegalHoldImmutability

Paramètre permettant d’activer ou de désactiver LegalHold sur la sauvegarde LTR. Lorsque LegalHold est activé, la sauvegarde ne peut pas être supprimée tant que LegalHold n’est pas supprimé.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

TimeBasedImmutability

Paramètre permettant d’activer ou non l’immuabilité temporelle pour la sauvegarde LTR. Lorsque l’immuabilité temporelle est activée et verrouillée, la sauvegarde ne peut pas être supprimée avant BackupExpirationTime.

TimeBasedImmutabilityMode

Le mode d’immuabilité basé sur le temps. Applicable uniquement si l’immuabilité basée sur le temps est activée.

BackupStorageAccessTier

BackupStorageAccessTier pour la sauvegarde LTR

Valeur Description
Hot

Chaud

Archive

L'archive

BackupStorageRedundancy

Type de compte de stockage utilisé pour stocker des sauvegardes pour cette base de données.

Valeur Description
Geo

Zone géographique

Local

Local

Zone

Zone

GeoZone

GeoZone

createdByType

Type d’identité qui a créé la ressource.

Valeur Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.

type

string

Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

LongTermRetentionBackup

Sauvegarde de rétention à long terme.

Nom Type Description
id

string (arm-id)

ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »

name

string

Nom de la ressource

properties.backupExpirationTime

string (date-time)

Heure d’expiration de la sauvegarde de rétention à long terme.

properties.backupStorageAccessTier

BackupStorageAccessTier

BackupStorageAccessTier pour la sauvegarde LTR

properties.backupStorageRedundancy

BackupStorageRedundancy

Type de redondance de stockage de la sauvegarde

properties.backupTime

string (date-time)

Heure à laquelle la sauvegarde a été effectuée

properties.databaseDeletionTime

string (date-time)

Heure de suppression de la base de données

properties.databaseName

string

Nom de la base de données à laquelle appartient la sauvegarde

properties.isBackupImmutable

boolean

Paramètre indiquant si la sauvegarde LTR est immuable

properties.legalHoldImmutability

SetLegalHoldImmutability

Paramètre permettant d’activer ou de désactiver LegalHold sur la sauvegarde LTR. Lorsque LegalHold est activé, la sauvegarde ne peut pas être supprimée tant que LegalHold n’est pas supprimé.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Type de redondance de stockage de la sauvegarde

properties.serverCreateTime

string (date-time)

Heure de création du serveur.

properties.serverName

string

Nom du serveur auquel appartient la base de données de sauvegarde.

properties.timeBasedImmutability

TimeBasedImmutability

Paramètre permettant d’activer ou non l’immuabilité temporelle pour la sauvegarde LTR. Lorsque l’immuabilité temporelle est activée et verrouillée, la sauvegarde ne peut pas être supprimée avant BackupExpirationTime.

properties.timeBasedImmutabilityMode

TimeBasedImmutabilityMode

Le mode d’immuabilité basé sur le temps. Applicable uniquement si l’immuabilité basée sur le temps est activée.

systemData

systemData

Azure Resource Manager : métadonnées contenant des informations createdBy et modifiedBy.

type

string

Type de la ressource. Par exemple : « Microsoft. Calcul/virtualMachines » ou « Microsoft. StorageAccounts"

SetLegalHoldImmutability

Paramètre permettant d’activer ou de désactiver LegalHold sur la sauvegarde LTR. Lorsque LegalHold est activé, la sauvegarde ne peut pas être supprimée tant que LegalHold n’est pas supprimé.

Valeur Description
Enabled

Activé

Disabled

Désactivé

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string (date-time)

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string (date-time)

Horodatage de la dernière modification de ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.

lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.

TimeBasedImmutability

Paramètre permettant d’activer ou non l’immuabilité temporelle pour la sauvegarde LTR. Lorsque l’immuabilité temporelle est activée et verrouillée, la sauvegarde ne peut pas être supprimée avant BackupExpirationTime.

Valeur Description
Enabled

Activé

Disabled

Désactivé

TimeBasedImmutabilityMode

Le mode d’immuabilité basé sur le temps. Applicable uniquement si l’immuabilité basée sur le temps est activée.

Valeur Description
Locked

Verrouillé

Unlocked

Déverrouillé