Long Term Retention Backups - Update By Resource Group

Service:

SQL Database

API Version:

2021-11-01

Atualizações uma cópia de segurança 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-11-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
backupName	path	True	string	O nome da cópia de segurança.
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 da API do Azure Resource Manager ou do portal.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Corpo do Pedido

Name	Tipo	Description
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	O tipo de redundância de armazenamento da cópia de segurança copiada

Respostas

Name	Tipo	Description
200 OK	LongTermRetentionBackupOperationResult	A cópia de segurança foi atualizada com êxito.
202 Accepted		A atualização da cópia de segurança está em curso.
Other Status Codes		Respostas de Erro: *** 400 InvalidLongTermRetentionBackupId – Identificador de cópia de segurança de retenção de longo prazo inválido para BDs SQL. 400 InvalidParameterValue – foi atribuído 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 funcionalidade de Migração da cópia de segurança LTR não é permitida. 400 LongTermRetentionMigrationCrossClusterRequestNotSupported – as subscrições de origem e destino não estão autorizadas a comunicar para a funcionalidade de cópia de segurança LTR. 400 LongTermRetentionMigrationParameterMissing – Parâmetro necessário em falta para a operação. 400 LongTermRetentionMigrationSameServerNotSupported – a funcionalidade Cópia LTR não é suportada para copiar cópias de segurança 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 segurança LTR. 400 LongTermRetentionMigrationTargetDatabaseNotFound – A Base de Dados de Destino não existe no servidor. 400 LongTermRetentionMigrationStorageTypeNotSupported - A Redundância de Armazenamento de Cópias de Segurança Especificada não é suportada na região de destino. 400 LongTermRetentionMigrationStorageMismatch – A redundância de cópia de segurança ativa da base de dados não corresponde à redundância de cópia de segurança pedida pelo cliente. 400 LongTermRetentionMigrationDatabaseTypeNotSupported – a migração LTR só é suportada para cópias de segurança ltR de instância gerida e SQL do Azure DB. 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed – a alteração da redundância do armazenamento de cópias de segurança não é permitida para operações de Cópia LTR. 400 LongTermRetentionMigrationSubscriptionNotFound – não foi possível localizar a subscrição. 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e subscrição especificados. 404 ResourceNotFound – o recurso pedido não foi encontrado. 404 LongTermRetentionMigrationBackupNotFound - A cópia de segurança LTR especificada não existe. 404 OperationIdNotFound - A operação com o ID não existe. 409 LongTermRetentionMigrationRequestConflict – uma operação de conflito nesta cópia de segurança LTR ainda está em curso. 409 LongTermRetentionMigrationBackupConflict - Existe outra cópia de segurança LTR com o mesmo tempo de cópia de segurança para a base de dados de destino. 409 OperationCancelled - A operação foi cancelada pelo utilizador. 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 500 LongTermRetentionMigrationRequestFailedToStartOnTarget – Falha ao iniciar o pedido de cópia de segurança LTR na região de destino. 500 LongTermRetentionMigrationRequestCopyFailed – A operação de cópia falhou para blobs de cópia de segurança LTR. 500 LongTermRetentionMigrationRestoreVerExceeded – A verificação do restauro falhou após o alcance máximo das tentativas. 500 LongTermRetentionMigrationRestoreVerFailed – Falha na verificação do restauro. 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação. 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

Exemplos

Update the long term retention backup.

Sample Request

HTTP

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

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.BackupStorageRedundancy;
import com.azure.resourcemanager.sql.models.UpdateLongTermRetentionBackupParameters;

/** Samples for LongTermRetentionBackups UpdateByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupUpdate.json
     */
    /**
     * Sample code: Update the long term retention backup.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateTheLongTermRetentionBackup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().updateByResourceGroup(
            "testResourceGroup", "japaneast", "testserver", "testDatabase",
            "55555555-6666-7777-8888-999999999999;131637960820000000", new UpdateLongTermRetentionBackupParameters()
                .withRequestedBackupStorageRedundancy(BackupStorageRedundancy.GEO),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

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

Status code:

202

Definições

Name	Description
BackupStorageRedundancy	O tipo de redundância de armazenamento da cópia de segurança copiada
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 da cópia de segurança de retenção de longo prazo.

BackupStorageRedundancy

O tipo de redundância de armazenamento da cópia de segurança copiada

Name	Tipo	Description
Geo	string
GeoZone	string
Local	string
Zone	string

LongTermRetentionBackupOperationResult

Um recurso de resultado da operação LongTermRetentionBackup.

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.fromBackupResourceId	string	ID do recurso de cópia de segurança de origem
properties.message	string	Mensagem de progresso
properties.operationType	string	Tipo de operação.
properties.requestId	string	ID do pedido.
properties.status	string	Estado da operação
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	O tipo de redundância de armazenamento da cópia de segurança copiada
properties.toBackupResourceId	string	ID do recurso de cópia de segurança de destino
type	string	Tipo de recurso.

UpdateLongTermRetentionBackupParameters

Contém as informações necessárias para executar a operação de atualização da cópia de segurança de retenção de longo prazo.

Name	Tipo	Description
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	O tipo de redundância de armazenamento da cópia de segurança copiada