Delen via

Managed Instance Long Term Retention Policies - Create Or Update

  • Referentie
Service:
SQL Database
API-versie:
2021-11-01

Hiermee stelt u het langetermijnretentiebeleid van een beheerde database in.

PUT 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.

Aanvraagbody

Name Type Description
properties.monthlyRetention

string

Het maandelijkse bewaarbeleid voor een LTR-back-up in een ISO 8601-indeling.
properties.weekOfYear

integer

De week van het jaar om de jaarlijkse back-up in ISO 8601-indeling te maken.
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.

Antwoorden

Name Type Description
200 OK

ManagedInstanceLongTermRetentionPolicy

Het LTR-beleid voor beheerde database is ingesteld.
202 Accepted

Geaccepteerd
Other Status Codes

Foutreacties: ***

  • 400 InvalidResourceRequestBody : de resource of resource-eigenschappen in de aanvraagtekst zijn leeg of ongeldig.

  • 400 InvalidParameterValue : er is een ongeldige waarde opgegeven voor een parameter.

  • 400 LongTermRetentionMissingWeekOfYear - WeekOfYear moet worden ingesteld tussen 1 en 52 om jaarlijkse retentie in te stellen.

  • 400 LTRNotSupportedForPerDBCMK - Langetermijnretentie van back-ups wordt niet ondersteund wanneer CMK op databaseniveau is geconfigureerd in preview.

  • 400 LongTermRetentionPolicyNotSupported - Langetermijnretentie wordt niet ondersteund in deze database.

  • 400 LongTermRetentionPolicyInvalid - Beleid voor langetermijnretentie 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.

  • 404 OperationIdNotFound - De bewerking met id bestaat niet.

  • 409 OperationCancelled : de bewerking is geannuleerd door de gebruiker.

  • 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource.

  • 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren.

  • 503 TooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

Voorbeelden

Create or update the LTR policy for the managed database.

Voorbeeldaanvraag

PUT 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

{
  "properties": {
    "weeklyRetention": "P1M",
    "monthlyRetention": "P1Y",
    "yearlyRetention": "P5Y",
    "weekOfYear": 5
  }
}

Voorbeeldrespons

Statuscode:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/managedInstances/testInstance/databases/testDatabase/backupLongTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/resourceGroups/managedInstances/databases/backupLongTermRetentionPolicies",
  "properties": {
    "weeklyRetention": "P1M",
    "monthlyRetention": "P1Y",
    "yearlyRetention": "P5Y",
    "weekOfYear": 5
  }
}
Statuscode:
202

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 om de jaarlijkse back-up in ISO 8601-indeling te maken.
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