Delen via

Managed Backup Short Term Retention Policies - Create Or Update

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

Updates het kortetermijnretentiebeleid van een beheerde database.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/backupShortTermRetentionPolicies/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

ManagedShortTermRetentionPolicyName

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

integer

De bewaarperiode voor back-ups in dagen. Dit is hoeveel dagen herstel naar een bepaald tijdstip wordt ondersteund.

Antwoorden

Name Type Description
200 OK

ManagedBackupShortTermRetentionPolicy

Het beleid is bijgewerkt.
202 Accepted

Geaccepteerd
Other Status Codes

Foutreacties: ***

  • 400 InvalidBackupRetentionDays - De retentiedagen van {0} is geen geldige configuratie. Geldige back-upretentie moet in stappen van 7 dagen zijn (7, 14, 21, enzovoort)

  • 400 InvalidRestorableDroppedDatabaseDeletionDate - De opgegeven verwijderingsdatum van de herstelbare verwijderde database is ongeldig

  • 400 InvalidRestorableDroppedDatabaseId - Ongeldige herstelbare verwijderde database-id

  • 400 InvalidParameterValue - Er is een ongeldige waarde gegeven aan een parameter.

  • 400 InvalidBackupRetentionPeriod- De retentiedagen van {0} is geen geldige configuratie. Geldige back-upretentie in dagen moet tussen {1} en {2}

  • 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 SourceDatabaseNotFound - De brondatabase bestaat niet.

  • 404 CannotFindObject - Kan het object niet vinden omdat het niet bestaat of omdat u geen machtigingen hebt

  • 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 maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 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 maximumaantal 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.

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

  • 504 RequestTimeout - Serviceaanvraag heeft de toegestane time-out overschreden.

Voorbeelden

Update the short term retention policy for the database.

Voorbeeldaanvraag

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
  }
}

Voorbeeldrespons

Statuscode:
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
  }
}
Statuscode:
202

Definities

Name Description
ManagedBackupShortTermRetentionPolicy

Een kortetermijnretentiebeleid.
ManagedShortTermRetentionPolicyName

De naam van het beleid. Moet altijd 'standaard' zijn.

ManagedBackupShortTermRetentionPolicy

Object

Een kortetermijnretentiebeleid.

Name Type Description
id

string

Resource-id.
name

string

Resourcenaam.
properties.retentionDays

integer

De bewaarperiode voor back-ups in dagen. Dit is hoeveel dagen herstel naar een bepaald tijdstip wordt ondersteund.
type

string

Resourcetype.

ManagedShortTermRetentionPolicyName

Enumeration

De naam van het beleid. Moet altijd 'standaard' zijn.

Waarde Description
default