Long Term Retention Backups - Update By Resource Group

Aktualizuje istniejącą kopię zapasową przechowywania długoterminowego.

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

Parametry identyfikatora URI

Name In Required Type Description
backupName
path True
  • string

Nazwa kopii zapasowej.

locationName
path True
  • string

Lokalizacja bazy danych.

longTermRetentionDatabaseName
path True
  • string

Nazwa bazy danych

longTermRetentionServerName
path True
  • string

Nazwa serwera

resourceGroupName
path True
  • string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.

subscriptionId
path True
  • string

Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.

api-version
query True
  • string

Wersja interfejsu API do użycia dla żądania.

Treść żądania

Name Type Description
properties.requestedBackupStorageRedundancy

Typ nadmiarowości magazynu kopii zapasowej kopii zapasowej

Odpowiedzi

Name Type Description
200 OK

Pomyślnie zaktualizowano kopię zapasową.

202 Accepted

Trwa aktualizowanie kopii zapasowej.

Other Status Codes

Odpowiedzi na błędy: ***

  • 400 InvalidLongTermRetentionBackupId — nieprawidłowy identyfikator kopii zapasowej przechowywania długoterminowego dla baz danych SQL.

  • 400 InvalidParameterValue — podano nieprawidłową wartość dla parametru.

  • 400 LongTermRetentionMismatchingSubscriptionId — podany identyfikator subskrypcji jest niezgodny z identyfikatorem w innych danych wejściowych

  • 400 LongTermRetentionMismatchingResourceGroupName — podana nazwa grupy zasobów nie jest zgodna z nazwą w innych danych wejściowych

  • 400 LongTermRetentionMismatchingServerName — podana nazwa serwera nie jest zgodna z nazwą w innych danych wejściowych

  • 400 LongTermRetentionMigrationRequestNotSupported — funkcja migracji kopii zapasowych LTR nie jest dozwolona.

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported — subskrypcje źródłowe i docelowe nie mogą komunikować się z funkcją kopiowania kopii zapasowej LTR.

  • 400 LongTermRetentionMigrationParameterMissing — brak wymaganego parametru dla operacji.

  • 400 LongTermRetentionMigrationSameServerNotSupported — funkcja kopiowania LTR nie jest obsługiwana do kopiowania kopii zapasowych LTR na tym samym serwerze.

  • 400 LongTermRetentionMigrationTargetServerNotFound — serwer docelowy nie istnieje lub nie jest gotowy do operacji kopiowania kopii zapasowej LTR.

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound — docelowa baza danych nie istnieje na serwerze.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported — określona Storage nadmiarowość kopii zapasowej nie jest obsługiwana w regionie docelowym.

  • 400 LongTermRetentionMigrationStorageMismatch — aktywna nadmiarowość kopii zapasowej bazy danych jest niezgodna z nadmiarowością kopii zapasowych żądaną przez klienta.

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported — migracja LTR jest obsługiwana tylko w przypadku wystąpień zarządzanych i Azure SQL kopii zapasowych LTR bazy danych.

  • 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed — zmiana nadmiarowości magazynu kopii zapasowej nie jest dozwolona dla operacji kopiowania LTR.

  • 400 LongTermRetentionMigrationSubscriptionNotFound — nie można odnaleźć subskrypcji.

  • 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera

  • 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

  • 404 ResourceNotFound — żądany zasób nie został znaleziony.

  • 404 LongTermRetentionMigrationBackupNotFound — określona kopia zapasowa LTR nie istnieje.

  • 409 LongTermRetentionMigrationRequestConflict — operacja powodująca konflikt dla tej kopii zapasowej LTR jest nadal w toku.

  • 409 LongTermRetentionMigrationBackupConflict — istnieje inna kopia zapasowa LTR z tym samym czasem tworzenia kopii zapasowej docelowej bazy danych.

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget — nie można uruchomić żądania kopii zapasowej LTR w regionie docelowym.

  • 500 LongTermRetentionMigrationRequestCopyFailed — operacja kopiowania nie powiodła się dla obiektów blob kopii zapasowej LTR.

  • 500 LongTermRetentionMigrationRestoreVerExceeded — weryfikacja przywracania nie powiodła się po osiągnięciu maksymalnej liczby prób.

  • 500 LongTermRetentionMigrationRestoreVerFailed — weryfikacja przywracania nie powiodła się.

Przykłady

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=2021-08-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"
  }
}

Definicje

BackupStorageRedundancy

Typ nadmiarowości magazynu kopii zapasowej kopii zapasowej

LongTermRetentionBackupOperationResult

Zasób wyniku operacji LongTermRetentionBackup.

UpdateLongTermRetentionBackupParameters

Zawiera informacje niezbędne do wykonania operacji aktualizacji kopii zapasowej przechowywania długoterminowego.

BackupStorageRedundancy

Typ nadmiarowości magazynu kopii zapasowej kopii zapasowej

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

LongTermRetentionBackupOperationResult

Zasób wyniku operacji LongTermRetentionBackup.

Name Type Description
id
  • string

Identyfikator zasobu.

name
  • string

Nazwa zasobu.

properties.fromBackupResourceId
  • string

Identyfikator zasobu kopii zapasowej źródła

properties.message
  • string

Komunikat o postępie

properties.operationType
  • string

Typ operacji.

properties.requestId
  • string

Identyfikator żądania.

properties.status
  • string

Stan operacji

properties.targetBackupStorageRedundancy

Typ nadmiarowości magazynu kopii zapasowej kopii zapasowej

properties.toBackupResourceId
  • string

Identyfikator zasobu docelowej kopii zapasowej

type
  • string

Typ zasobu.

UpdateLongTermRetentionBackupParameters

Zawiera informacje niezbędne do wykonania operacji aktualizacji kopii zapasowej przechowywania długoterminowego.

Name Type Description
properties.requestedBackupStorageRedundancy

Typ nadmiarowości magazynu kopii zapasowej kopii zapasowej