Long Term Retention Backups - Update By Resource Group

Atualiza um backup de retenção de 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=2021-08-01-preview

Parâmetros de URI

Name In Required Type Description
backupName
path True
  • string

O nome do backup.

locationName
path True
  • string

O local do banco de dados.

longTermRetentionDatabaseName
path True
  • string

O nome do banco 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. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.

subscriptionId
path True
  • string

A ID de assinatura que identifica uma assinatura do Azure.

api-version
query True
  • string

A versão da API a ser usada para a solicitação.

Corpo da solicitação

Name Type Description
properties.requestedBackupStorageRedundancy

O tipo de redundância de armazenamento do backup copiado

Respostas

Name Type Description
200 OK

Atualizou com êxito o backup.

202 Accepted

A atualização do backup 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 - Um valor inválido foi dado a um parâmetro.

  • 400 LongTermRetentionMismatchingSubscriptionId - A ID de assinatura fornecida não correspondia à ID na outra entrada

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

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

  • 400 LongTermRetentionMigrationRequestNotSupported - A assinatura não tem permissão para recurso de migração de backup ltr.

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported - Assinaturas de origem e destino não têm permissão para se comunicar para o recurso de cópia de backup LTR.

  • 400 LongTermRetentionMigrationParameterMissing – parâmetro obrigatório ausente para a operação.

  • 400 LongTermRetentionMigrationSameServerNotSupported - Não há suporte para o recurso de cópia LTR para copiar backups LTR no mesmo servidor.

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

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound – O Banco de Dados de Destino não existe no servidor.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported - Não há suporte para redundância de Backup Armazenamento especificada na região de destino.

  • 400 LongTermRetentionMigrationStorageMismatch – A redundância de backup ativa do banco de dados não corresponde à redundância de backup solicitada pelo cliente.

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported - A migração ltr só tem suporte para backups ltr de instância gerenciada e SQL do Azure DB.

  • 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - A alteração da redundância de armazenamento de backup não é permitida para operações de cópia LTR.

  • 400 LongTermRetentionMigrationSubscriptionNotFound - Não foi possível encontrar a assinatura.

  • 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado

  • 404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados.

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

  • 404 LongTermRetentionMigrationBackupNotFound - O backup LTR especificado não existe.

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

  • 409 LongTermRetentionMigrationBackupConflict - Existe outro backup LTR com o mesmo tempo de backup para o banco de dados de destino.

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget – falha ao iniciar a solicitação de cópia de backup LTR na região de destino.

  • 500 LongTermRetentionMigrationRequestCopyFailed - Falha na operação de cópia para blobs de backup LTR.

  • 500 LongTermRetentionMigrationRestoreVerExceeded - Falha na verificação de restauração após tentativas máximas.

  • 500 LongTermRetentionMigrationRestoreVerFailed - Falha na verificação de restauração.

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

Definições

BackupStorageRedundancy

O tipo de redundância de armazenamento do backup copiado

LongTermRetentionBackupOperationResult

Um recurso de resultado da operação LongTermRetentionBackup.

UpdateLongTermRetentionBackupParameters

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

BackupStorageRedundancy

O tipo de redundância de armazenamento do backup copiado

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

LongTermRetentionBackupOperationResult

Um recurso de resultado da operação LongTermRetentionBackup.

Name Type Description
id
  • string

ID do recurso.

name
  • string

Nome do recurso.

properties.fromBackupResourceId
  • string

ID do recurso de backup de origem

properties.message
  • string

Mensagem de progresso

properties.operationType
  • string

Tipo de operação.

properties.requestId
  • string

ID da solicitação.

properties.status
  • string

Status da operação

properties.targetBackupStorageRedundancy

O tipo de redundância de armazenamento do backup copiado

properties.toBackupResourceId
  • string

ID do recurso de backup de destino

type
  • string

Tipo de recurso.

UpdateLongTermRetentionBackupParameters

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

Name Type Description
properties.requestedBackupStorageRedundancy

O tipo de redundância de armazenamento do backup copiado