Long Term Retention Policies - Create Or Update

Menetapkan kebijakan penyimpanan jangka panjang database.

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

Parameter URI

Name In Required Type Description
databaseName
path True
  • string

Nama database.

policyName
path True

Nama kebijakan. Harus selalu Default.

resourceGroupName
path True
  • string

Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.

serverName
path True
  • string

Nama server.

subscriptionId
path True
  • string

ID langganan yang mengidentifikasi langganan Azure.

api-version
query True
  • string

Versi API yang digunakan untuk permintaan.

Isi Permintaan

Name Type Description
properties.monthlyRetention
  • string

Kebijakan penyimpanan bulanan untuk cadangan LTR dalam format ISO 8601.

properties.weekOfYear
  • integer

Minggu dalam setahun untuk mengambil cadangan tahunan dalam format ISO 8601.

properties.weeklyRetention
  • string

Kebijakan penyimpanan mingguan untuk cadangan LTR dalam format ISO 8601.

properties.yearlyRetention
  • string

Kebijakan penyimpanan tahunan untuk cadangan LTR dalam format ISO 8601.

Respons

Name Type Description
200 OK

Berhasil menetapkan kebijakan.

202 Accepted

Diterima

Other Status Codes

Respons Kesalahan: ***

  • 400 InvalidResourceRequestBody - Properti sumber daya atau sumber daya dalam isi permintaan kosong atau tidak valid.

  • 400 InvalidParameterValue - Nilai yang tidak valid diberikan ke parameter.

  • 400 LongTermRetentionMissingWeekOfYear - WeekOfYear harus diatur antara 1 dan 52 untuk mengatur retensi tahunan.

  • 400 LongTermRetentionPolicyNotSupported - Retensi Jangka Panjang tidak didukung pada database ini.

  • 400 LongTermRetentionPolicyInvalid - Kebijakan Penyimpanan Jangka Panjang tidak valid.

  • 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan

  • 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan.

  • 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan.

Contoh

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
  }
}

Definisi

LongTermRetentionPolicy

Kebijakan penyimpanan jangka panjang.

LongTermRetentionPolicyName

Nama kebijakan. Harus selalu Default.

LongTermRetentionPolicy

Kebijakan penyimpanan jangka panjang.

Name Type Description
id
  • string

ID Sumber Daya.

name
  • string

Nama sumber daya.

properties.monthlyRetention
  • string

Kebijakan penyimpanan bulanan untuk cadangan LTR dalam format ISO 8601.

properties.weekOfYear
  • integer

Minggu dalam setahun untuk mengambil cadangan tahunan dalam format ISO 8601.

properties.weeklyRetention
  • string

Kebijakan penyimpanan mingguan untuk cadangan LTR dalam format ISO 8601.

properties.yearlyRetention
  • string

Kebijakan penyimpanan tahunan untuk cadangan LTR dalam format ISO 8601.

type
  • string

Jenis sumber daya

LongTermRetentionPolicyName

Nama kebijakan. Harus selalu Default.

Name Type Description
default
  • string