Long Term Retention Backups - Update By Resource Group

Atualiza uma cópia de segurança de retenção a longo prazo existente.

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

Parâmetros do URI

Name In Required Type Description
backupName
path True
  • string

O nome reserva.

locationName
path True
  • string

A localização da base de dados.

longTermRetentionDatabaseName
path True
  • string

O nome da base de dados

longTermRetentionServerName
path True
  • string

O nome do servidor

resourceGroupName
path True
  • string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir do Azure Resource Manager API ou do portal.

subscriptionId
path True
  • string

O ID de subscrição que identifica uma subscrição do Azure.

api-version
query True
  • string

A versão API a utilizar para o pedido.

Corpo do Pedido

Name Type Description
properties.requestedBackupStorageRedundancy

O tipo de redundância de armazenamento do backup copiado

Respostas

Name Type Description
200 OK

Atualizou com sucesso a cópia de segurança.

202 Accepted

A atualização da cópia de segurança está em andamento.

Other Status Codes

Respostas de erro: ***

  • 400 InvalidLongTermRetentionBackupId - Identificador de backup de retenção de longo prazo inválido para SQL DBs.

  • 400 InvalidParameterValue - Foi dado um valor inválido a um parâmetro.

  • 400 LongTermRetentionMismatchingSubscriptionId - O id de subscrição fornecido não corresponde ao id na outra entrada

  • 400 LongTermRetentionMismatchingResourceGroupName - O nome do grupo de recursos fornecido não corresponde ao nome na outra entrada

  • 400 LongTermRetentionMismatchingServerName - O nome do servidor fornecido não corresponde ao nome na outra entrada

  • 400 LongTermRetentionMigrationRequestNotSupported - A subscrição não é permitida pela funcionalidade de migração de backup LTR.

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported - As assinaturas de origem e alvo não estão autorizadas a comunicar para a funcionalidade de cópia de backup LTR.

  • 400 LongTermRetentionMigrationParameterMissing - Parâmetro necessário em falta para a operação.

  • 400 LongTermRetentionMigrationSameServerNotSupported - LTR Copy não é suportado para copiar cópias de backups LTR dentro do mesmo servidor.

  • 400 LongTermRetentionMigrationTargetServerNotFound - O servidor alvo não existe ou não está pronto para a operação de cópia de backup LTR.

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound - Base de dados-alvo não existe no servidor.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported - Especificado Backup Armazenamento Redundância não é suportado na região alvo.

  • 400 LongTermRetentionMigrationStorageMismatch - Redundância de backup ativa da base de dados não corresponde a redundância de backup solicitada pelo cliente.

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported - A migração LTR é suportada apenas para cópias de segurança geridas e SQL do Azure DB LTR.

  • 404 SubscriçãoDoesNotHaveServer - O servidor solicitado não foi encontrado

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos especificado e na subscrição.

  • 404 ResourceNotFound - O recurso solicitado não foi encontrado.

  • 404 LongTermRetentionMigrationBackupNotFound - cópia de segurança LTR especificada não existe.

  • 409 LongTermRetentionMigrationRequestConflict - Uma operação de conflito neste backup LTR ainda está em andamento.

  • 409 LongTermRetentionMigrationBackupConflict - Existe outra cópia de segurança LTR com o mesmo tempo de backup para base de dados-alvo.

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - Falhou no início do pedido de cópia de cópia de backup LTR na região alvo.

  • 500 LongTermRetentionMigrationRequestCopyFailed - A operação de cópia falhou para as bolhas de backup LTR.

  • 500 LongTermRetentionMigrationRestoreExceeded - Verificação de restauro falhou após as tentativas máximas terem sido alcançadas.

  • 500 LongTermRetentionMigrationRestoreFailed - Verificação de restauro falhou.

Exemplos

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

Definições

BackupStorageRedundancy

O tipo de redundância de armazenamento do backup copiado

LongTermRetentionBackupOperationResult

Um recurso de resultado de operação LongTermRetentionBackup.

RequestedBackupStorageRedundancy

O tipo de redundância de armazenamento do backup copiado

UpdateLongTermRetentionBackupParameters

Contém as informações necessárias para a realização de uma operação de atualização de backup de retenção a longo prazo.

BackupStorageRedundancy

O tipo de redundância de armazenamento do backup copiado

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

LongTermRetentionBackupOperationResult

Um recurso de resultado de operação LongTermRetentionBackup.

Name Type Description
id
  • string

Identificação de recursos.

name
  • string

Nome de recurso.

properties.fromBackupResourceId
  • string

Id de recursos de backup de fonte

properties.message
  • string

Mensagem de progresso

properties.operationType
  • string

Tipo de operação.

properties.requestId
  • string

Pedir identificação.

properties.status
  • string

Estado da operação

properties.targetBackupStorageRedundancy

O tipo de redundância de armazenamento do backup copiado

properties.toBackupResourceId
  • string

Id de recursos de backup alvo

type
  • string

Tipo de recurso.

RequestedBackupStorageRedundancy

O tipo de redundância de armazenamento do backup copiado

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

UpdateLongTermRetentionBackupParameters

Contém as informações necessárias para a realização de uma operação de atualização de backup de retenção a longo prazo.

Name Type Description
properties.requestedBackupStorageRedundancy

O tipo de redundância de armazenamento do backup copiado