Long Term Retention Policies - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

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-11-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
databaseName	path	True	string	Nama database.
policyName	path	True	LongTermRetentionPolicyName	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

Nama	Jenis	Deskripsi
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

Nama	Jenis	Deskripsi
200 OK	LongTermRetentionPolicy	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 diperlukan untuk diatur antara 1 dan 52 untuk mengatur retensi tahunan. 400 LTRNotSupportedForPerDBCMK - Retensi Cadangan Jangka Panjang tidak didukung saat CMK tingkat Database dikonfigurasi dalam pratinjau. 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. 404 OperationIdNotFound - Operasi dengan Id tidak ada. 409 OperationCancelled - Operasi telah dibatalkan oleh pengguna. 409 OperationInterrupted - Operasi pada sumber daya tidak dapat diselesaikan karena terganggu oleh operasi lain pada sumber daya yang sama. 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 500 OperationTimedOut - Waktu operasi habis dan secara otomatis digulung balik. Silakan coba lagi operasi ini. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

Contoh

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

Sample Request

HTTP

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-11-01

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.LongTermRetentionPolicyInner;
import com.azure.resourcemanager.sql.models.LongTermRetentionPolicyName;

/** Samples for LongTermRetentionPolicies CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LongTermRetentionPolicyCreateOrUpdate
     * .json
     */
    /**
     * Sample code: Create or update the long term retention policy for the database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createOrUpdateTheLongTermRetentionPolicyForTheDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionPolicies().createOrUpdate("resourceGroup",
            "testserver", "testDatabase", LongTermRetentionPolicyName.DEFAULT, new LongTermRetentionPolicyInner()
                .withWeeklyRetention("P1M").withMonthlyRetention("P1Y").withYearlyRetention("P5Y").withWeekOfYear(5),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

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

Status code:

202

Definisi

Nama	Deskripsi
LongTermRetentionPolicy	Kebijakan penyimpanan jangka panjang.
LongTermRetentionPolicyName	Nama kebijakan. Harus selalu Default.

LongTermRetentionPolicy

Kebijakan penyimpanan jangka panjang.

Nama	Jenis	Deskripsi
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.

Nama	Jenis	Deskripsi
default	string