Long Term Retention Policies - List By Database

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Získá zásady dlouhodobého uchovávání databáze.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
databaseName	path	True	string	Název databáze.
resourceGroupName	path	True	string	Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API Resource Manager Azure nebo z portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Odpovědi

Name	Typ	Description
200 OK	LongTermRetentionPolicyListResult	Zásady se úspěšně získaly.
Other Status Codes		Chybové odpovědi: *** 400 LTRNotSupportedForPerDBCMK – Dlouhodobé uchovávání záloh se nepodporuje, pokud je klíč CMK na úrovni databáze nakonfigurovaný ve verzi Preview. 400 LongTermRetentionPolicyNotSupported – Tato databáze nepodporuje dlouhodobé uchovávání. 400 LongTermRetentionPolicyInvalid – zásady dlouhodobého uchovávání jsou neplatné. 404 SubscriptionDoesNotHaveServer – Požadovaný server se nenašel. 404 ServerNotInSubscriptionResourceGroup – zadaný server v zadané skupině prostředků a předplatném neexistuje. 404 ResourceNotFound – Požadovaný prostředek se nenašel.

Příklady

Get the long term retention policy for the database.

Ukázkový požadavek

HTTP

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

Java

/**
 * Samples for LongTermRetentionPolicies ListByDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LongTermRetentionPolicyListByDatabase
     * .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().listByDatabase("resourceGroup",
            "testserver", "testDatabase", 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

Ukázková odpověď

Stavový kód:

200

{
  "value": [
    {
      "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
      }
    }
  ]
}

Definice

Name	Description
LongTermRetentionPolicy	Zásady dlouhodobého uchovávání informací.
LongTermRetentionPolicyListResult	Seznam zásad dlouhodobého uchovávání.

LongTermRetentionPolicy

Zásady dlouhodobého uchovávání informací.

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.monthlyRetention	string	Zásady měsíčního uchovávání záloh LTR ve formátu ISO 8601.
properties.weekOfYear	integer	Týden v roce pro pořízení roční zálohy ve formátu ISO 8601.
properties.weeklyRetention	string	Zásady týdenního uchovávání záloh LTR ve formátu ISO 8601.
properties.yearlyRetention	string	Zásady ročního uchovávání záloh LTR ve formátu ISO 8601.
type	string	Typ prostředku.

LongTermRetentionPolicyListResult

Seznam zásad dlouhodobého uchovávání.

Name	Typ	Description
nextLink	string	Odkaz na načtení další stránky výsledků
value	LongTermRetentionPolicy[]	Pole výsledků