Managed Backup Short Term Retention Policies - Create Or Update

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Aktualizuje zásady krátkodobého uchovávání spravované databáze.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
databaseName	path	True	string	Název databáze.
managedInstanceName	path	True	string	Název spravované instance.
policyName	path	True	ManagedShortTermRetentionPolicyName	Název zásady. Měla by být vždy výchozí.
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo portálu.
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 (int32)	Doba uchovávání záloh ve dnech. To je počet dnů, které bude podporováno obnovení k určitému bodu v čase.

Odpovědi

Name	Typ	Description
200 OK	ManagedBackupShortTermRetentionPolicy	Zásady byly úspěšně aktualizovány.
202 Accepted		Přijato
Other Status Codes		Chybové odpovědi: *** 400 InvalidBackupRetentionDays – doba uchování {0} není platná konfigurace. Platné uchovávání záloh musí být v 7denních přírůstcích (7, 14, 21 atd.) 400 InvalidRestorableDroppedDatabaseDeletionDate – datum obnovení vyřazené databáze je neplatné. 400 InvalidRestorableDroppedDatabaseId – Neplatný obnovovatelný vynechaný identifikátor databáze 400 InvalidParameterValue – Parametr dostal neplatnou hodnotu. 400 InvalidBackupRetentionPeriod – doba uchování {0} není platná konfigurace. Platné uchovávání záloh ve dnech musí být mezi {1} a {2} 404 SubscriptionDoesNotHaveServer – Požadovaný server nebyl nalezen. 404 ServerNotInSubscriptionResourceGroup – Zadaný server neexistuje v zadané skupině prostředků a předplatném. 404 ResourceNotFound – Požadovaný prostředek nebyl nalezen. 404 SourceDatabaseNotFound – Zdrojová databáze neexistuje. 404 CannotFindObject – Nelze najít objekt, 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í na stejném prostředku. 429 SubscriptionTooManyCreateUpdateRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyCreateUpdateRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky. 500 OperationTimedOut – Vypršel časový limit operace a automaticky se vrátil zpět. Zkuste operaci zopakovat. 503 TooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky. 503 TooManyRequests – Požadavky nad rámec maximálních 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 database.

Ukázkový požadavek

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb/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 ManagedBackupShortTermRetentionPolicies CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/UpdateManagedShortTermRetentionPolicy
     * .json
     */
    /**
     * Sample code: Update the short term retention policy for the database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        updateTheShortTermRetentionPolicyForTheDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedBackupShortTermRetentionPolicies().createOrUpdate(
            "resourceGroup", "testsvr", "testdb", 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/databases/testdb/backupShortTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/managedInstances/databases/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ěla by být vždy výchozí.

ManagedBackupShortTermRetentionPolicy

Objekt

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 (int32)	Doba uchovávání záloh ve dnech. To je počet dnů, které bude podporováno obnovení k určitému bodu v čase.
type	string	Typ zdroje.

ManagedShortTermRetentionPolicyName

Výčet

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

Hodnota	Description
default