Backup Short Term Retention Policies - Update

Tjänst:

SQL Database

API-version:

2021-11-01

Uppdateringar en databass princip för kortsiktig kvarhållning.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
databaseName	path	True	string	Namnet på databasen.
policyName	path	True	ShortTermRetentionPolicyName	Principnamnet. Ska alltid vara "standard".
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName	path	True	string	Namnet på servern.
subscriptionId	path	True	string	Prenumerations-ID:t som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Typ	Description
properties.diffBackupIntervalInHours	DiffBackupIntervalInHours	Intervall för differentiell säkerhetskopiering i timmar. Så här många intervalltimmar mellan varje differentiell säkerhetskopiering stöds. Detta gäller endast för realtidsdatabaser men inte borttagna databaser.
properties.retentionDays	integer	Kvarhållningsperioden för säkerhetskopior i dagar. Så här många dagar stöds återställning till tidpunkt.

Svar

Name	Typ	Description
200 OK	BackupShortTermRetentionPolicy	Principen har uppdaterats.
202 Accepted		Har godkänts
Other Status Codes		Felsvar: *** 400 InvalidParameterValue – ett ogiltigt värde gavs till en parameter. 400 InvalidBackupRetentionPeriod – Kvarhållningsdagarna {0} för är inte en giltig konfiguration. Giltig kvarhållning av säkerhetskopior i dagar måste vara mellan {1} och {2} 400 InvalidDiffBackupIntervalHours – Intervalltimmarna {0} för differentiell säkerhetskopiering är inte en giltig konfiguration. Giltigt intervall för differentiell säkerhetskopiering måste vara {1} timmar. 400 FeatureDisabledOnSelectedEdition – Användaren försökte använda en funktion som är inaktiverad i den aktuella databasutgåvan. 404 SubscriptionDoesNotHaveServer – den begärda servern hittades inte 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 404 ResourceNotFound – Den begärda resursen hittades inte. 404 SourceDatabaseNotFound – källdatabasen finns inte. 404 CannotFindObject – Det går inte att hitta objektet eftersom det inte finns eller så har du inte behörighet 409 ConflictingDatabaseOperation – Det finns redan en åtgärd i databasen och den aktuella åtgärden bör vänta tills den är klar. 409 ConflictingSystemOperationInProgress – En systemunderhållsåtgärd pågår i databasen och ytterligare åtgärder måste vänta tills den har slutförts. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 504 RequestTimeout – Tjänstbegäran överskred den tillåtna tidsgränsen.

Exempel

Update the short term retention policy for the database.

Exempelbegäran

HTTP

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

{
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.BackupShortTermRetentionPolicyInner;
import com.azure.resourcemanager.sql.models.DiffBackupIntervalInHours;
import com.azure.resourcemanager.sql.models.ShortTermRetentionPolicyName;

/**
 * Samples for BackupShortTermRetentionPolicies Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/UpdateShortTermRetentionPolicy.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().getBackupShortTermRetentionPolicies().update("resourceGroup",
            "testsvr", "testdb", ShortTermRetentionPolicyName.DEFAULT, new BackupShortTermRetentionPolicyInner()
                .withRetentionDays(7).withDiffBackupIntervalInHours(DiffBackupIntervalInHours.TWO_FOUR),
            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

Exempelsvar

Statuskod:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/backupShortTermRetentionPolicies",
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}

Statuskod:

202

Definitioner

Name	Description
BackupShortTermRetentionPolicy	En kortsiktig kvarhållningsprincip.
DiffBackupIntervalInHours	Intervall för differentiell säkerhetskopiering i timmar. Så här många intervalltimmar mellan varje differentiell säkerhetskopiering stöds. Detta gäller endast för realtidsdatabaser men inte borttagna databaser.
ShortTermRetentionPolicyName	Principnamnet. Ska alltid vara "standard".

BackupShortTermRetentionPolicy

En kortsiktig kvarhållningsprincip.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.diffBackupIntervalInHours	DiffBackupIntervalInHours	Intervall för differentiell säkerhetskopiering i timmar. Så här många intervalltimmar mellan varje differentiell säkerhetskopiering stöds. Detta gäller endast för realtidsdatabaser men inte borttagna databaser.
properties.retentionDays	integer	Kvarhållningsperioden för säkerhetskopior i dagar. Så här många dagar stöds återställning till tidpunkt.
type	string	Resurstyp.

DiffBackupIntervalInHours

Intervall för differentiell säkerhetskopiering i timmar. Så här många intervalltimmar mellan varje differentiell säkerhetskopiering stöds. Detta gäller endast för realtidsdatabaser men inte borttagna databaser.

Name	Typ	Description
12	string
24	string

ShortTermRetentionPolicyName

Principnamnet. Ska alltid vara "standard".

Name	Typ	Description
default	string