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=2020-11-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

Backup atualizado com êxito.

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 bancos de dado SQL.

  • 400 InvalidParameterValue-um valor inválido foi fornecido a um parâmetro.

  • 400 LongTermRetentionMismatchingSubscriptionId-a ID de assinatura fornecida não correspondeu à ID na outra entrada

  • 400 LongTermRetentionMismatchingResourceGroupName-o nome do grupo de recursos fornecido não correspondia 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 o recurso de migração de backup EPD.

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

  • 400 LongTermRetentionMigrationParameterMissing-parâmetro necessário ausente para a operação.

  • 400 o recurso de cópia LongTermRetentionMigrationSameServerNotSupported-EPD não tem suporte para copiar backups EPD 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 EPD.

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound-o banco de dados de destino não existe no servidor.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported não há suporte para a redundância de armazenamento de backup especificada na região de destino.

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

  • 400 a migração LongTermRetentionMigrationDatabaseTypeNotSupported-EPD só tem suporte para backups de instância gerenciada e do banco de BD SQL do Azure.

  • 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 o backup LongTermRetentionMigrationBackupNotFound-EPD especificado não existe.

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

  • 409 LongTermRetentionMigrationBackupConflict-outro backup EPD com o mesmo horário de backup para o banco de dados de destino existe.

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

  • 500 LongTermRetentionMigrationRequestCopyFailed-operação de cópia falhou para BLOBs de backup EPD.

  • 500 LongTermRetentionMigrationRestoreVerExceeded-falha na verificação de restauração após o atingido o máximo de tentativas.

  • 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=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 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
Local
  • string
Zone
  • string

LongTermRetentionBackupOperationResult

Um recurso de resultado de 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 de recurso de backup de destino

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