Long Term Retention Backups - Copy By Resource Group

Serviço:

SQL Database

Versão da API:

2021-11-01

Copie uma cópia de segurança de retenção de longo prazo existente para um servidor diferente.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}/copy?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.targetBackupStorageRedundancy	BackupStorageRedundancy	O tipo de redundância de armazenamento da cópia de segurança copiada
properties.targetDatabaseName	string	O nome da base de dados é o proprietário da cópia de segurança copiada.
properties.targetResourceGroup	string	O grupo de recursos que detém o servidor de destino
properties.targetServerFullyQualifiedDomainName	string	O nome de domínio completamente qualificado do servidor de destino
properties.targetServerResourceId	string	O ID de recurso do servidor de destino que detém a base de dados
properties.targetSubscriptionId	string	A subscrição proprietária do servidor de destino

Respostas

Name	Tipo	Description
200 OK	LongTermRetentionBackupOperationResult	Copiou a cópia de segurança com êxito.
202 Accepted		A 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 correspondeu 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 correspondeu 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 do 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 da 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 LTR. 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 na subscrição especificados. 404 ResourceNotFound – o recurso pedido não foi encontrado. 404 LongTermRetentionMigrationBackupNotFound – 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 do máximo de pedidos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos 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 máximo de 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 do máximo de pedidos que podem ser processados por recursos disponíveis.

Exemplos

Copy the long term retention backup.

Pedido de amostra

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/copy?api-version=2021-11-01

{
  "properties": {
    "targetServerResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testserver2",
    "targetDatabaseName": "testDatabase2",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Java

import com.azure.resourcemanager.sql.models.BackupStorageRedundancy;
import com.azure.resourcemanager.sql.models.CopyLongTermRetentionBackupParameters;

/**
 * Samples for LongTermRetentionBackups CopyByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupCopy.json
     */
    /**
     * Sample code: Copy the long term retention backup.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void copyTheLongTermRetentionBackup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().copyByResourceGroup(
            "testResourceGroup", "japaneast", "testserver", "testDatabase",
            "55555555-6666-7777-8888-999999999999;131637960820000000",
            new CopyLongTermRetentionBackupParameters().withTargetServerResourceId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testserver2")
                .withTargetDatabaseName("testDatabase2").withTargetBackupStorageRedundancy(BackupStorageRedundancy.GEO),
            com.azure.core.util.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

Resposta da amostra

Código de estado:

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": "CopyBackup",
    "status": "Succeeded",
    "toBackupResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver2/longterRetentionDatabases/testDatabase2/longTermRetentionBackups/55555555-6666-7777-8888-111111111111;131637960820000000",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Código de estado:

202

Definições

Name	Description
BackupStorageRedundancy	O tipo de redundância de armazenamento da cópia de segurança copiada
CopyLongTermRetentionBackupParameters	Contém as informações necessárias para executar a operação de cópia de segurança de retenção de longa duração.
LongTermRetentionBackupOperationResult	Um recurso de resultado da operação LongTermRetentionBackup.

BackupStorageRedundancy

Enumeration

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

Valor	Description
Geo
GeoZone
Local
Zone

CopyLongTermRetentionBackupParameters

Object

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

Name	Tipo	Description
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	O tipo de redundância de armazenamento da cópia de segurança copiada
properties.targetDatabaseName	string	O nome da base de dados é o proprietário da cópia de segurança copiada.
properties.targetResourceGroup	string	O grupo de recursos que detém o servidor de destino
properties.targetServerFullyQualifiedDomainName	string	O nome de domínio completamente qualificado do servidor de destino
properties.targetServerResourceId	string	O ID de recurso do servidor de destino que detém a base de dados
properties.targetSubscriptionId	string	A subscrição proprietária do servidor de destino

LongTermRetentionBackupOperationResult

Object

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.