Managed Restorable Dropped Database Backup Short Term Retention Policies - Update

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Nastaví zásady krátkodobého uchovávání informací pro databázi.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/restorableDroppedDatabases/{restorableDroppedDatabaseId}/backupShortTermRetentionPolicies/default?api-version=2021-11-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
managedInstanceName	path	True	string	Název spravované instance.
policyName	path	True	ManagedShortTermRetentionPolicyName	Název zásady. Mělo by být vždy "výchozí".
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.
restorableDroppedDatabaseId	path	True	string
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.

Text požadavku

Name	Typ	Description
properties.retentionDays	integer	Doba uchovávání záloh ve dnech. To znamená, kolik dní se bude podporovat obnovení k určitému bodu v čase.

Odpovědi

Name	Typ	Description
200 OK	ManagedBackupShortTermRetentionPolicy	Zásady se úspěšně aktualizovaly.
202 Accepted		Přijato
Other Status Codes		Chybové odpovědi: *** 400 InvalidRestorableDroppedDatabaseDeletionDate – zadané datum obnovení vyřazené databáze je neplatné. 400 InvalidRestorableDroppedDatabaseId – neplatný obnovitelný identifikátor vyřazené databáze. 400 InvalidBackupRetentionPeriod – počet dnů {0} uchovávání není platná konfigurace. Platné uchovávání záloh ve dnech musí být mezi {1} a {2} 400 InvalidBackupRetentionDays – počet dnů {0} uchovávání není platná konfigurace. Platné uchovávání záloh musí být v 7denních intervalech (7, 14, 21 atd.). 400 InvalidRestorableDroppedDatabaseDeletionDate – zadané datum obnovení vyřazené databáze je neplatné. 400 InvalidRestorableDroppedDatabaseId – neplatný obnovitelný identifikátor vyřazené databáze. 400 InvalidParameterValue – parametru byla přidělena neplatná hodnota. 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. 404 SourceDatabaseNotFound – zdrojová databáze neexistuje. 404 CannotFindObject – Objekt nelze najít, protože neexistuje nebo nemáte oprávnění. 404 OperationIdNotFound – operace s ID neexistuje. 409 OperationCancelled – operace byla zrušena uživatelem. 409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad maximální počet požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad maximální počet požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 504 RequestTimeout – Žádost o službu překročila povolený časový limit.

Příklady

Update the short term retention policy for the restorable dropped database.

Ukázkový požadavek

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/managedInstances/testsvr/restorableDroppedDatabases/testdb,131403269876900000/backupShortTermRetentionPolicies/default?api-version=2021-11-01

{
  "properties": {
    "retentionDays": 14
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.ManagedBackupShortTermRetentionPolicyInner;
import com.azure.resourcemanager.sql.models.ManagedShortTermRetentionPolicyName;

/**
 * Samples for ManagedRestorableDroppedDatabaseBackupShortTermRetentionPolicies CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * UpdateManagedShortTermRetentionPolicyRestorableDropped.json
     */
    /**
     * Sample code: Update the short term retention policy for the restorable dropped database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateTheShortTermRetentionPolicyForTheRestorableDroppedDatabase(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient()
            .getManagedRestorableDroppedDatabaseBackupShortTermRetentionPolicies().createOrUpdate("resourceGroup",
                "testsvr", "testdb,131403269876900000", ManagedShortTermRetentionPolicyName.DEFAULT,
                new ManagedBackupShortTermRetentionPolicyInner().withRetentionDays(14),
                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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/managedInstances/testsvr/restorableDroppedDatabases/testdb,131403269876900000/backupShortTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/managedInstances/restorableDroppedDatabases/backupShortTermRetentionPolicies",
  "properties": {
    "retentionDays": 14
  }
}

Stavový kód:

202

Definice

Name	Description
ManagedBackupShortTermRetentionPolicy	Zásady krátkodobého uchovávání informací.
ManagedShortTermRetentionPolicyName	Název zásady. Mělo by být vždy "výchozí".

ManagedBackupShortTermRetentionPolicy

Zásady krátkodobého uchovávání informací.

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.retentionDays	integer	Doba uchovávání záloh ve dnech. To znamená, kolik dní se bude podporovat obnovení k určitému bodu v čase.
type	string	Typ prostředku.

ManagedShortTermRetentionPolicyName

Název zásady. Mělo by být vždy "výchozí".

Name	Typ	Description
default	string