Long Term Retention Policies - Get

Service:

SQL Database

API-versie:

2021-11-01

Hiermee haalt u het langetermijnretentiebeleid van een database op.

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

URI-parameters

Name	In	Vereist	Type	Description
databaseName	path	True	string	De naam van de database.
policyName	path	True	LongTermRetentionPolicyName	De naam van het beleid. Moet altijd Standaard zijn.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Antwoorden

Name	Type	Description
200 OK	LongTermRetentionPolicy	Het beleid is geïnstalleerd.
Other Status Codes		Foutreacties: *** 400 LTRNotSupportedForPerDBCMK - Langetermijnretentie van back-ups wordt niet ondersteund wanneer CMK op databaseniveau is geconfigureerd in de preview-versie. 400 LongTermRetentionPolicyNotSupported - Langetermijnretentie wordt niet ondersteund in deze database. 400 LongTermRetentionPolicyInvalid - Langetermijnretentiebeleid is ongeldig. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 ServerNotInSubscriptionResourceGroup : de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 404 ResourceNotFound - De aangevraagde resource is niet gevonden.

Voorbeelden

Get the long term retention policy for the database.

Voorbeeldaanvraag

HTTP

GET 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

Java

import com.azure.resourcemanager.sql.models.LongTermRetentionPolicyName;

/**
 * Samples for LongTermRetentionPolicies Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LongTermRetentionPolicyGet.json
     */
    /**
     * Sample code: Get the long term retention policy for the database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getTheLongTermRetentionPolicyForTheDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionPolicies().getWithResponse("resourceGroup",
            "testserver", "testDatabase", LongTermRetentionPolicyName.DEFAULT, com.azure.core.util.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

Voorbeeldrespons

Statuscode:

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

Definities

Name	Description
LongTermRetentionPolicy	Een langetermijnretentiebeleid.
LongTermRetentionPolicyName	De naam van het beleid. Moet altijd Standaard zijn.

LongTermRetentionPolicy

Object

Een langetermijnretentiebeleid.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.monthlyRetention	string	Het maandelijkse bewaarbeleid voor een LTR-back-up in een ISO 8601-indeling.
properties.weekOfYear	integer	De week van het jaar voor het maken van de jaarlijkse back-up in een ISO 8601-indeling.
properties.weeklyRetention	string	Het wekelijkse bewaarbeleid voor een LTR-back-up in een ISO 8601-indeling.
properties.yearlyRetention	string	Het jaarlijkse bewaarbeleid voor een LTR-back-up in een ISO 8601-indeling.
type	string	Resourcetype.

LongTermRetentionPolicyName

Enumeration

De naam van het beleid. Moet altijd Standaard zijn.

Waarde	Description
default