Partager via

Managed Backup Short Term Retention Policies - Create Or Update

  • Référence
Service:
SQL Database
Version d'API:
2021-11-01

Mises à jour la stratégie de rétention à court terme d’une base de données managée.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/backupShortTermRetentionPolicies/default?api-version=2021-11-01

Paramètres URI

Nom Dans Obligatoire Type Description
databaseName
 path True

string

Nom de la base de données.
managedInstanceName
 path True

string

Nom de l'instance managée.
policyName
 path True

ManagedShortTermRetentionPolicyName

Nom de la stratégie. Doit toujours être « par défaut ».
resourceGroupName
 path True

string

Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
subscriptionId
 path True

string

L’ID d’abonnement d’un abonnement Azure.
api-version
 query True

string

Version de l’API à utiliser pour la requête.

Corps de la demande

Nom Type Description
properties.retentionDays

integer

Période de rétention de la sauvegarde, en jours. Il s’agit du nombre de jours pendant lesquels la restauration dans le temps sera prise en charge.

Réponses

Nom Type Description
200 OK

ManagedBackupShortTermRetentionPolicy

Mise à jour réussie de la stratégie.
202 Accepted

Accepté
Other Status Codes

Réponses d’erreur : ***

  • 400 InvalidBackupRetentionDays : les jours de rétention de n’est {0} pas une configuration valide. La rétention de sauvegarde valide doit être par incréments de 7 jours (7, 14, 21, etc.)

  • 400 InvalidRestorableDroppedDatabaseDeletionDate : la date de suppression de la base de données supprimée restaurable donnée n’est pas valide

  • 400 InvalidRestorableDroppedDatabaseId - Identificateur de base de données supprimé restaurable non valide

  • 400 InvalidParameterValue : une valeur non valide a été donnée à un paramètre.

  • 400 InvalidBackupRetentionPeriod : les jours de rétention de n’est {0} pas une configuration valide. La rétention de sauvegarde valide en jours doit être comprise entre {1} et {2}

  • 404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable

  • 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.

  • 404 ResourceNotFound : la ressource demandée est introuvable.

  • 404 SourceDatabaseNotFound : la base de données source n’existe pas.

  • 404 CannotFindObject - Impossible de trouver l’objet parce qu’il n’existe pas ou que vous ne disposez pas d’autorisations

  • 404 OperationIdNotFound : l’opération avec ID n’existe pas.

  • 409 OperationCancelled : l’opération a été annulée par l’utilisateur.

  • 409 Opération interrompue : l’opération sur la ressource n’a pas pu être terminée, car elle a été interrompue par une autre opération sur la même ressource.

  • 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles.

  • 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles.

  • 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles.

  • 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles.

  • 500 OperationTimedOut : l’opération a expiré et a été restaurée automatiquement. Réessayez l’opération.

  • 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

  • 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

  • 504 RequestTimeout - La demande de service a dépassé le délai d’expiration autorisé.

Exemples

Update the short term retention policy for the database.

Exemple de requête

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb/backupShortTermRetentionPolicies/default?api-version=2021-11-01

{
  "properties": {
    "retentionDays": 14
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb/backupShortTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/managedInstances/databases/backupShortTermRetentionPolicies",
  "properties": {
    "retentionDays": 14
  }
}
Code d’état:
202

Définitions

Nom Description
ManagedBackupShortTermRetentionPolicy

Stratégie de rétention à court terme.
ManagedShortTermRetentionPolicyName

Nom de la stratégie. Doit toujours être « par défaut ».

ManagedBackupShortTermRetentionPolicy

Object

Stratégie de rétention à court terme.

Nom Type Description
id

string

ID de la ressource
name

string

Nom de la ressource.
properties.retentionDays

integer

Période de rétention de la sauvegarde, en jours. Il s’agit du nombre de jours pendant lesquels la restauration dans le temps sera prise en charge.
type

string

Type de ressource.

ManagedShortTermRetentionPolicyName

Enumeration

Nom de la stratégie. Doit toujours être « par défaut ».

Valeur Description
default