Long Term Retention Backups - Copy By Resource Group

참조

Service:: SQL Database

API Version:: 2021-11-01

기존 장기 보존 백업을 다른 서버에 복사합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
backupName	path	True	string	백업 이름입니다.
locationName	path	True	string	데이터베이스의 위치입니다.
longTermRetentionDatabaseName	path	True	string	데이터베이스의 이름
longTermRetentionServerName	path	True	string	서버 이름
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	복사한 백업의 스토리지 중복성 유형
properties.targetDatabaseName	string	데이터베이스의 이름은 복사된 백업을 소유합니다.
properties.targetResourceGroup	string	대상 서버를 소유하는 리소스 그룹
properties.targetServerFullyQualifiedDomainName	string	대상 서버의 정규화된 도메인 이름
properties.targetServerResourceId	string	데이터베이스를 소유하는 대상 서버의 리소스 ID
properties.targetSubscriptionId	string	대상 서버를 소유하는 구독

응답

Name	형식	Description
200 OK	LongTermRetentionBackupOperationResult	백업을 복사했습니다.
202 Accepted		백업 복사가 진행 중입니다.
Other Status Codes		오류 응답: *** 400 InvalidLongTermRetentionBackupId - SQL DB에 대한 잘못된 장기 보존 백업 식별자입니다. 400 InvalidParameterValue - 매개 변수에 잘못된 값이 지정되었습니다. 400 LongTermRetentionMismatchingSubscriptionId - 제공된 구독 ID가 다른 입력의 ID와 일치하지 않음 400 LongTermRetentionMismatchingResourceGroupName - 제공된 리소스 그룹 이름이 다른 입력의 이름과 일치하지 않음 400 LongTermRetentionMismatchingServerName - 제공된 서버 이름이 다른 입력의 이름과 일치하지 않음 400 LongTermRetentionMigrationRequestNotSupported - 구독은 LTR 백업 마이그레이션 기능이 허용되지 않습니다. 400 LongTermRetentionMigrationCrossClusterRequestNotSupported - 원본 및 대상 구독은 LTR 백업 복사 기능에 대해 통신할 수 없습니다. 400 LongTermRetentionMigrationParameterMissing - 작업에 필요한 매개 변수가 없습니다. 400 LongTermRetentionMigrationSameServerNotSupported - LTR 복사 기능은 동일한 서버 내에서 LTR 백업을 복사하는 데 지원되지 않습니다. 400 LongTermRetentionMigrationTargetServerNotFound - 대상 서버가 없거나 LTR 백업 복사 작업을 수행할 준비가 되지 않았습니다. 400 LongTermRetentionMigrationTargetDatabaseNotFound - 대상 데이터베이스가 서버에 없습니다. 400 LongTermRetentionMigrationStorageTypeNotSupported - 지정된 백업 스토리지 중복성은 대상 지역에서 지원되지 않습니다. 400 LongTermRetentionMigrationStorageMismatch - 데이터베이스의 활성 백업 중복성이 고객이 요청한 백업 중복성과 일치하지 않습니다. 400 LongTermRetentionMigrationDatabaseTypeNotSupported - LTR 마이그레이션은 관리되는 instance 및 Azure SQL DB LTR 백업에 대해서만 지원됩니다. 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - LTR 복사 작업에 백업 스토리지 중복성 변경은 허용되지 않습니다. 400 LongTermRetentionMigrationSubscriptionNotFound - 구독을 찾을 수 없습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다. 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다. 404 LongTermRetentionMigrationBackupNotFound - 지정된 LTR 백업이 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 409 LongTermRetentionMigrationRequestConflict - 이 LTR 백업에 대한 충돌 작업이 아직 진행 중입니다. 409 LongTermRetentionMigrationBackupConflict - 대상 데이터베이스에 대해 동일한 백업 시간이 있는 다른 LTR 백업이 있습니다. 409 OperationCancelled - 사용자가 작업을 취소했습니다. 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - 대상 지역에서 LTR 백업 복사 요청을 시작하지 못했습니다. 500 LongTermRetentionMigrationRequestCopyFailed - LTR 백업 Blob에 대해 복사 작업이 실패했습니다. 500 LongTermRetentionMigrationRestoreVerExceeded - 최대 시도에 도달한 후 복원 확인에 실패했습니다. 500 LongTermRetentionMigrationRestoreVerFailed - 복원 확인에 실패했습니다. 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

Name

형식

Description

200 OK

LongTermRetentionBackupOperationResult

백업을 복사했습니다.

202 Accepted

백업 복사가 진행 중입니다.

Other Status Codes

오류 응답: ***

400 InvalidLongTermRetentionBackupId - SQL DB에 대한 잘못된 장기 보존 백업 식별자입니다.
400 InvalidParameterValue - 매개 변수에 잘못된 값이 지정되었습니다.
400 LongTermRetentionMismatchingSubscriptionId - 제공된 구독 ID가 다른 입력의 ID와 일치하지 않음
400 LongTermRetentionMismatchingResourceGroupName - 제공된 리소스 그룹 이름이 다른 입력의 이름과 일치하지 않음
400 LongTermRetentionMismatchingServerName - 제공된 서버 이름이 다른 입력의 이름과 일치하지 않음
400 LongTermRetentionMigrationRequestNotSupported - 구독은 LTR 백업 마이그레이션 기능이 허용되지 않습니다.
400 LongTermRetentionMigrationCrossClusterRequestNotSupported - 원본 및 대상 구독은 LTR 백업 복사 기능에 대해 통신할 수 없습니다.
400 LongTermRetentionMigrationParameterMissing - 작업에 필요한 매개 변수가 없습니다.
400 LongTermRetentionMigrationSameServerNotSupported - LTR 복사 기능은 동일한 서버 내에서 LTR 백업을 복사하는 데 지원되지 않습니다.
400 LongTermRetentionMigrationTargetServerNotFound - 대상 서버가 없거나 LTR 백업 복사 작업을 수행할 준비가 되지 않았습니다.
400 LongTermRetentionMigrationTargetDatabaseNotFound - 대상 데이터베이스가 서버에 없습니다.
400 LongTermRetentionMigrationStorageTypeNotSupported - 지정된 백업 스토리지 중복성은 대상 지역에서 지원되지 않습니다.
400 LongTermRetentionMigrationStorageMismatch - 데이터베이스의 활성 백업 중복성이 고객이 요청한 백업 중복성과 일치하지 않습니다.
400 LongTermRetentionMigrationDatabaseTypeNotSupported - LTR 마이그레이션은 관리되는 instance 및 Azure SQL DB LTR 백업에 대해서만 지원됩니다.
400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - LTR 복사 작업에 백업 스토리지 중복성 변경은 허용되지 않습니다.
400 LongTermRetentionMigrationSubscriptionNotFound - 구독을 찾을 수 없습니다.
404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.
404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.
404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다.
404 LongTermRetentionMigrationBackupNotFound - 지정된 LTR 백업이 없습니다.
404 OperationIdNotFound - ID가 있는 작업이 없습니다.
409 LongTermRetentionMigrationRequestConflict - 이 LTR 백업에 대한 충돌 작업이 아직 진행 중입니다.
409 LongTermRetentionMigrationBackupConflict - 대상 데이터베이스에 대해 동일한 백업 시간이 있는 다른 LTR 백업이 있습니다.
409 OperationCancelled - 사용자가 작업을 취소했습니다.
409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다.
429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
500 LongTermRetentionMigrationRequestFailedToStartOnTarget - 대상 지역에서 LTR 백업 복사 요청을 시작하지 못했습니다.
500 LongTermRetentionMigrationRequestCopyFailed - LTR 백업 Blob에 대해 복사 작업이 실패했습니다.
500 LongTermRetentionMigrationRestoreVerExceeded - 최대 시도에 도달한 후 복원 확인에 실패했습니다.
500 LongTermRetentionMigrationRestoreVerFailed - 복원 확인에 실패했습니다.
500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요.
503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Copy the long term retention backup.

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


import com.azure.core.util.Context;
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),
            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": "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"
  }
}

Status code:: 202

정의

Name	Description
BackupStorageRedundancy	복사한 백업의 스토리지 중복성 유형
CopyLongTermRetentionBackupParameters	장기 보존 백업 복사 작업을 수행하는 데 필요한 정보를 포함합니다.
LongTermRetentionBackupOperationResult	LongTermRetentionBackup 작업 결과 리소스입니다.

BackupStorageRedundancy

복사한 백업의 스토리지 중복성 유형

Name	형식	Description
Geo	string
GeoZone	string
Local	string
Zone	string

CopyLongTermRetentionBackupParameters

장기 보존 백업 복사 작업을 수행하는 데 필요한 정보를 포함합니다.

Name	형식	Description
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	복사한 백업의 스토리지 중복성 유형
properties.targetDatabaseName	string	데이터베이스의 이름은 복사된 백업을 소유합니다.
properties.targetResourceGroup	string	대상 서버를 소유하는 리소스 그룹
properties.targetServerFullyQualifiedDomainName	string	대상 서버의 정규화된 도메인 이름
properties.targetServerResourceId	string	데이터베이스를 소유하는 대상 서버의 리소스 ID
properties.targetSubscriptionId	string	대상 서버를 소유하는 구독

LongTermRetentionBackupOperationResult

LongTermRetentionBackup 작업 결과 리소스입니다.

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.fromBackupResourceId	string	원본 백업 리소스 ID
properties.message	string	진행률 메시지
properties.operationType	string	작업 유형입니다.
properties.requestId	string	요청 ID입니다.
properties.status	string	작업 상태
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	복사한 백업의 스토리지 중복성 유형
properties.toBackupResourceId	string	대상 백업 리소스 ID
type	string	리소스 종류.

Long Term Retention Backups - Copy By Resource Group

URI 매개 변수

요청 본문

응답

예제

Copy the long term retention backup.

Sample Request

Sample Response

정의

BackupStorageRedundancy

CopyLongTermRetentionBackupParameters

LongTermRetentionBackupOperationResult

추가 리소스