Managed Instance Long Term Retention Policies - Get

Service:

SQL Database

API-versie:

2021-11-01

Hiermee haalt u het langetermijnretentiebeleid van een beheerde database op.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/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.
managedInstanceName	path	True	string	De naam van het beheerde exemplaar.
policyName	path	True	ManagedInstanceLongTermRetentionPolicyName	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.
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	ManagedInstanceLongTermRetentionPolicy	LTR-beleid voor beheerde database is verkregen.
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 managed database.

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/managedInstances/testInstance/databases/testDatabase/backupLongTermRetentionPolicies/default?api-version=2021-11-01

Java

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

/**
 * Samples for ManagedInstanceLongTermRetentionPolicies Get.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceLongTermRetentionPolicyGet.json
     */
    /**
     * Sample code: Get the long term retention policy for the managed database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getTheLongTermRetentionPolicyForTheManagedDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceLongTermRetentionPolicies().getWithResponse(
            "testResourceGroup", "testInstance", "testDatabase", ManagedInstanceLongTermRetentionPolicyName.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/testResourceGroup/managedInstances/testInstance/databases/testDatabase/backupLongTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/resourceGroups/managedInstances/databases/backupLongTermRetentionPolicies",
  "properties": {
    "weeklyRetention": "P1M",
    "monthlyRetention": "P1Y",
    "yearlyRetention": "P5Y",
    "weekOfYear": 5
  }
}

Definities

Name	Description
ManagedInstanceLongTermRetentionPolicy	Een langetermijnretentiebeleid.
ManagedInstanceLongTermRetentionPolicyName	De naam van het beleid. Moet altijd Standaard zijn.

ManagedInstanceLongTermRetentionPolicy

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.

ManagedInstanceLongTermRetentionPolicyName

Enumeration

De naam van het beleid. Moet altijd Standaard zijn.

Waarde	Description
default