Long Term Retention Backups - Update By Resource Group

Uppdaterar en befintlig säkerhetskopia av långsiktig kvarhållning.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}/update?api-version=2020-11-01-preview

URI-parametrar

Name In Required Type Description
backupName
path True
  • string

Säkerhetskopieringsnamnet.

locationName
path True
  • string

Databasens plats.

longTermRetentionDatabaseName
path True
  • string

Namnet på databasen

longTermRetentionServerName
path True
  • string

Namnet på servern

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.

subscriptionId
path True
  • string

Det prenumerations-ID som identifierar en Azure-prenumeration.

api-version
query True
  • string

DEN API-version som ska användas för begäran.

Begärandetext

Name Type Description
properties.requestedBackupStorageRedundancy

Lagringsredundanstypen för den kopierade säkerhetskopian

Svar

Name Type Description
200 OK

Säkerhetskopieringen har uppdaterats.

202 Accepted

Säkerhetskopieringen uppdateras.

Other Status Codes

Felsvar: ***

  • 400 InvalidLongTermRetentionBackupId – Ogiltig identifierare för långsiktig säkerhetskopia för SQL databaser.

  • 400 InvalidParameterValue – ett ogiltigt värde angavs till en parameter.

  • 400 LongTermRetentionMismatchingSubscriptionId – det angivna prenumerations-ID:t matchade inte ID:t i de andra indata

  • 400 LongTermRetentionMismatchingResourceGroupName – Det angivna resursgruppsnamnet matchade inte namnet i de andra indata

  • 400 LongTermRetentionMismatchingServerName – Det angivna servernamnet matchade inte namnet i de andra indata

  • 400 LongTermRetentionMigrationRequestNotSupported – Prenumerationen tillåts inte funktionen migrering av LTR-säkerhetskopiering.

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported – Käll- och målprenumerationer får inte kommunicera för funktionen för LTR-säkerhetskopieringskopiering.

  • 400 LongTermRetentionMigrationParameterMissing – obligatorisk parameter saknas för åtgärden.

  • 400 LongTermRetentionMigrationSameServerNotSupported – FUNKTIONEN LTR-kopiering stöds inte för att kopiera LTR-säkerhetskopior på samma server.

  • 400 LongTermRetentionMigrationTargetServerNotFound – Målservern finns inte eller är inte redo för kopiering av LTR-säkerhetskopiering.

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound – Måldatabasen finns inte på servern.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported – Angiven Backup Storage redundans stöds inte i målregionen.

  • 400 LongTermRetentionMigrationStorageMismatch – Aktiv redundans för säkerhetskopiering av databasen matchar inte den säkerhetskopieringsredundans som kunden har begärt.

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported – LTR-migrering stöds endast för hanterade instanser och Azure SQL DB LTR-säkerhetskopieringar.

  • 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 LongTermRetentionMigrationBackupNotFound – den angivna LTR-säkerhetskopieringen finns inte.

  • 409 LongTermRetentionMigrationRequestConflict – En konfliktåtgärd på den här LTR-säkerhetskopieringen pågår fortfarande.

  • 409 LongTermRetentionMigrationBackupConflict – Det finns en annan LTR-säkerhetskopiering med samma säkerhetskopieringstid för måldatabasen.

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget – Det gick inte att starta begäran om LTR-säkerhetskopieringskopiering i målregionen.

  • 500 LongTermRetentionMigrationRequestCopyFailed – Kopieringsåtgärden misslyckades för LTR-säkerhetskopieringsblobar.

  • 500 LongTermRetentionMigrationRestoreVerExceeded – Återställningsverifieringen misslyckades efter att maximalt antal försök har uppnåtts.

  • 500 LongTermRetentionMigrationRestoreVerFailed – Återställningsverifieringen misslyckades.

Exempel

Update the long term retention backup.

Sample Request

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000/update?api-version=2020-11-01-preview

{
  "properties": {
    "requestedBackupStorageRedundancy": "Geo"
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japanEast/longTermRetentionBackupOperationResults/a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "name": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "type": "Microsoft.Sql/locations/longTermRetentionBackupOperationResults",
  "properties": {
    "requestId": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
    "fromBackupResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver/longterRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
    "operationType": "UpdateBackup",
    "status": "Succeeded",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Definitioner

BackupStorageRedundancy

Lagringsredundanstypen för den kopierade säkerhetskopian

LongTermRetentionBackupOperationResult

En resultatresurs för LongTermRetentionBackup-åtgärden.

RequestedBackupStorageRedundancy

Lagringsredundanstypen för den kopierade säkerhetskopian

UpdateLongTermRetentionBackupParameters

Innehåller den information som krävs för att utföra en långsiktig uppdatering av säkerhetskopian av kvarhållning.

BackupStorageRedundancy

Lagringsredundanstypen för den kopierade säkerhetskopian

Name Type Description
Geo
  • string
Local
  • string
Zone
  • string

LongTermRetentionBackupOperationResult

En resultatresurs för LongTermRetentionBackup-åtgärden.

Name Type Description
id
  • string

Resurs-ID.

name
  • string

Resursnamn.

properties.fromBackupResourceId
  • string

Resurs-ID för källsäkerhetskopiering

properties.message
  • string

Förloppsmeddelande

properties.operationType
  • string

Åtgärdstyp.

properties.requestId
  • string

Begärande-ID.

properties.status
  • string

Åtgärdsstatus

properties.targetBackupStorageRedundancy

Lagringsredundanstypen för den kopierade säkerhetskopian

properties.toBackupResourceId
  • string

Resurs-ID för målsäkerhetskopiering

type
  • string

Resurstyp.

RequestedBackupStorageRedundancy

Lagringsredundanstypen för den kopierade säkerhetskopian

Name Type Description
Geo
  • string
Local
  • string
Zone
  • string

UpdateLongTermRetentionBackupParameters

Innehåller den information som krävs för att utföra en långsiktig uppdatering av säkerhetskopian av kvarhållning.

Name Type Description
properties.requestedBackupStorageRedundancy

Lagringsredundanstypen för den kopierade säkerhetskopian