Long Term Retention Policies - Create Or Update

Beállítja egy adatbázis hosszú távú adatmegőrzési szabályzatát.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/backupLongTermRetentionPolicies/default?api-version=2021-08-01-preview

URI-paraméterek

Name In Required Type Description
databaseName
path True
  • string

Az adatbázis neve.

policyName
path True

A szabályzat neve. Mindig alapértelmezettnek kell lennie.

resourceGroupName
path True
  • string

Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.

serverName
path True
  • string

A kiszolgáló neve.

subscriptionId
path True
  • string

Az Azure-előfizetést azonosító előfizetés-azonosító.

api-version
query True
  • string

A kéréshez használni kívánt API-verzió.

Kérelem törzse

Name Type Description
properties.monthlyRetention
  • string

Az ISO 8601 formátumú LTR biztonsági másolatok havi adatmegőrzési szabályzata.

properties.weekOfYear
  • integer

Az éves biztonsági mentés ISO 8601 formátumban történő készítésének hetét.

properties.weeklyRetention
  • string

Az LTR biztonsági mentés heti adatmegőrzési szabályzata ISO 8601 formátumban.

properties.yearlyRetention
  • string

Az LTR biztonsági másolatok éves adatmegőrzési szabályzata ISO 8601 formátumban.

Válaszok

Name Type Description
200 OK

Sikeresen beállította a szabályzatot.

202 Accepted

Elfogadva

Other Status Codes

Hibaválaszok: ***

  • 400 InvalidResourceRequestBody – A kérelem törzsében lévő erőforrás- vagy erőforrástulajdonságok üresek vagy érvénytelenek.

  • 400 InvalidParameterValue – Érvénytelen értéket adott meg egy paraméter.

  • A 400 LongTermRetentionMissingWeekOfYear – WeekOfYear értéket 1 és 52 között kell beállítani az éves adatmegőrzés beállításához.

  • 400 LongTermRetentionPolicyNotSupported – A hosszú távú adatmegőrzés nem támogatott ezen az adatbázisban.

  • 400 LongTermRetentionPolicyInvalid – A hosszú távú adatmegőrzési szabályzat érvénytelen.

  • 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található

  • 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és előfizetésben.

  • 404 ResourceNotFound – A kért erőforrás nem található.

Példák

Create or update the long term retention policy for the database.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/backupLongTermRetentionPolicies/default?api-version=2021-08-01-preview

{
  "properties": {
    "weeklyRetention": "P1M",
    "monthlyRetention": "P1Y",
    "yearlyRetention": "P5Y",
    "weekOfYear": 5
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testserver/databases/testDatabase/backupLongTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/resourceGroups/servers/databases/backupLongTermRetentionPolicies",
  "properties": {
    "weeklyRetention": "P1M",
    "monthlyRetention": "P1Y",
    "yearlyRetention": "P5Y",
    "weekOfYear": 5
  }
}

Definíciók

LongTermRetentionPolicy

Hosszú távú adatmegőrzési szabályzat.

LongTermRetentionPolicyName

A szabályzat neve. Mindig alapértelmezettnek kell lennie.

LongTermRetentionPolicy

Hosszú távú adatmegőrzési szabályzat.

Name Type Description
id
  • string

Erőforrás-azonosító.

name
  • string

Erőforrás neve.

properties.monthlyRetention
  • string

Az ISO 8601 formátumú LTR biztonsági másolatok havi adatmegőrzési szabályzata.

properties.weekOfYear
  • integer

Az éves biztonsági mentés ISO 8601 formátumban történő készítésének hetét.

properties.weeklyRetention
  • string

Az LTR biztonsági mentés heti adatmegőrzési szabályzata ISO 8601 formátumban.

properties.yearlyRetention
  • string

Az LTR biztonsági másolatok éves adatmegőrzési szabályzata ISO 8601 formátumban.

type
  • string

Erőforrástípus.

LongTermRetentionPolicyName

A szabályzat neve. Mindig alapértelmezettnek kell lennie.

Name Type Description
default
  • string